The PRTOV macro controls the page format for a directly-allocated printer when carriage control characters are not used or to supplement the carriage control characters being used. A directly-allocated (online) printer is allocated to the application program and is not a spooled data set.

The PRTOV macro tests for an overflow condition on the specified channel (either channel 9 or channel 12) of the printer carriage control, and either skips the printer carriage to the line corresponding to channel 1, or transfers control to the exit address, if one is specified. Overflow is detected after printing the line that follows the line corresponding to channel 9 or channel 12. You should issue the PRTOV macro each time you want the system to test for an overflow condition.

When the PRTOV macro is used with a 3525 card punch, print feature, channel 9 or 12 can be tested. If an overflow condition occurs, control is passed to the overflow exit routine if the overflow exit address is coded, or a skip to channel 1 (first print-line of the next card) occurs.

When requesting overprinting (for example, to underscore a line), issue the PRTOV macro before the first PUT or WRITE macro only. The PRTOV macro is useful only for directly-allocated printers. PRTOV has no effect for other devices, such as SYSOUT data sets or the 3525 card punch without the printing feature. You cannot use PRTOV to request overprinting on the 3525. The effect of overprinting differs for various printer models. See the appropriate device reference manual.

The PRTOV macro may be issued in 24- or 31-bit addressing mode. When issued in 31-bit addressing mode, all addresses must be valid 31-bit addresses.

The format of the PRTOV macro is:

dcb address—RX-Type Address or (2-12)

specifies the address of the data control block opened for output to a directly-allocated printer or 3525 card punch with a print feature.

9

12

These parameters specify the channel to be tested by the PRTOV macro. For a directly-allocated printer, 9 and 12 correspond to carriage control channels 9 and 12. For the 3525 card punch, 9 corresponds to print line number 17, and 12 corresponds to print line number 23.

overflow exit address—RX-type address or (2-12)

specifies the address of the user-supplied routine given control when an overflow condition is detected on the specified channel. If this parameter is omitted, the printer carriage skips to the first line of the next page or the 3525 skips to the first line of the next card before executing the next PUT or WRITE macro.

The overflow exit routine receives control in the addressing mode in which you issue the PRTOV macro. If you issue PRTOV in 31-bit addressing mode, the overflow exit routine may reside above the 16MB line.

When the overflow exit routine is given control, the contents of the registers are as follows: