This API controls the truncation and concatenation of print streams for network printers. ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ON ³ REGISTER ³
³ ENTRY ³ CONTENTS ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ AH ³ 06 ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ AL ³ 01 ; Set print output into ³
³ ³ Concatenation mode ³
³ ³ 02 ; Set print output into ³
³ ³ Truncation mode ³
³ ³ 03 ; Truncate print stream ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ON ³ REGISTER ³
³ RETURN ³ CONTENTS ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ AX ³ DOS error code if carry set ³
³ ³ None if carry flag not set ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

Remarks

DOS defines separate print streams for each of up to nine redirected printers. These printers are LPT1 (or PRN)-LPT9.

Note: PC LAN Program had only one print stream for each redirected print device. DLS has one interrupt 17H print stream for each redirected print device and multiple interrupt 21H print streams for each redirected print device.

Interrupt 17H print streams are delimited by the following events:

• End of program
  
• Printing with interrupt 17H from a different DOS process (created by the DOS EXEC function)
  
• Opening and closing of the file LPTx (1-9) without sending any data to it

DOS interrupt 21H printing is delimited by the following events:

• Closing the file LPTx (1-9) 
  Ending the DOS process that opened the file LPTx (1-9)

  DOS normally is in Truncation mode, which means the interrupt 17H print stream delimiters previously listed take effect. Concatenation mode (AL=01) causes DOS to ignore the interrupt 17H stream delimiters. In this mode, the interrupt 17H print stream is delimited only when a single DOS command ends or when a DOS batch (.BAT) process ends. This allows output from several commands to be kept together if the commands are in a batch file. Set Concatenation mode changes the stream state for all redirected printers. It has no effect on nonredirected printers or file handle printing.

  Set Truncation mode (AL=02) returns DOS to Truncation mode. It is used to cancel the Set Concatenation mode function. This call does not truncate streams; the next stream delimiter causes the truncation. Truncation mode is set automatically at the end of all DOS batch files and at the end of any command not in a batch file. Set Truncation mode changes the stream state for all redirected printers. It has no effect on nonredirected printers.

  Not all programs print output in such a way that DOS can determine when a print stream ends. This situation occurs most often when interrupt 17H is used for printing. Truncate Print Stream (AL=03) allows a program to indicate that the data currently printed is a complete stream and should be ended and printed.

  This function serves the same purpose as the Ctrl+Alt+* (on the numeric keypad) key sequence that is available to users to end print streams. Truncate Print Stream truncates all interrupt 17H print streams. It has no affect on nonredirected printers or file handle printing. The DLS program must be started for this function call to work.

  ---

  [Back] [Next]