home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / OPBONUS.ZIP / BIOSPRN.LZH / BIOSPRN.DOC next >
Encoding:
Text File  |  1990-04-09  |  2.7 KB  |  58 lines
  1. BIOSPRN.DOC - Enhanced BiosPrinter Object
  2. -------------------------------------------------------
  3. TurboPower Software
  4. 4/90
  5.  
  6. A new object type has been derived from the BasePrinter object in
  7. OPPRNLOW.PAS. This new object, BiosPrinterWithRetry, is implemented in the
  8. unit BIOSPRN.PAS. It differs from the plain BiosPrinter object in the
  9. following manner:
  10.  
  11.   * Supports separate printer test number and success mask information for
  12.     printer status and printer output calls.
  13.  
  14.   * Can automatically retry a specific number of times or based on a timeout
  15.     value.
  16.  
  17. If an object is instantiated as a BiosPrinterWithRetry using either the Init
  18. or InitCustom constructors, then it operates the same as a plain BiosPrinter.
  19.  
  20. BiosPrinterWithRetry adds a new constructor, InitDeluxe, defined as follows:
  21.  
  22. Declaration
  23.   constructor BiosPrinterWithRetry.InitDeluxe(LPTNumber : LPTType;
  24.                                               StatusTestNumber, StatusMask,
  25.                                               PutTestNumber, PutMask : Byte;
  26.                                               Retries : Word;
  27.                                               TimeOut : LongInt);
  28. Purpose
  29.   Create a BiosPrinterWithRetry instance with custom parameters.
  30. Description
  31.   Instantiates a BiosPrinterWithRetry object with complete control over
  32.   printer test masks for printer status and character output functions, as
  33.   well as number of automatic retries and timeout values.
  34.  
  35.   The TimeOut value has meaning only if Retries is zero. If Retries is zero
  36.   and TimeOut is non-zero, then TimeOut is interpreted as the amount of time
  37.   the instance will retry before giving up. This value is in ticks (1/18.2
  38.   seconds). For example, a TimeOut value of 182 means to wait for the printer
  39.   to become ready no longer than 10 seconds.
  40.  
  41. The following new methods are provided by BiosPrinterWithRetry:
  42.  
  43.   procedure SetTestAndMaskCustom(StatusTestNo, StatusMask,
  44.                                  PutTestNo, PutMask : Byte);
  45.     {-Set the printer test and success mask for Status and Put calls}
  46.   procedure GetTestAndMaskCustom(var StatusTestNo, StatusMask,
  47.                                  PutTestNo, PutMask : Byte);
  48.     {-Return the printer test and success mask for Status and Put calls}
  49.   procedure SetRetryAndTimeOut(Retries : Word; TimeOut : LongInt);
  50.     {-Set Retry and timeout values}
  51.   procedure GetRetryAndTimeOut(var Retries : Word; var TimeOut : LongInt);
  52.     {-Return Retry and timeout values}
  53.  
  54.  
  55. This unit was implemented based on interaction with OPRO users on PCVENB of
  56. Compuserve. Thanks to John Ackermann for testing this unit. Even though this
  57. unit appears on the BONUS disk, we are interested in feedback about this unit.
  58.