$I PRT(nnnnn) and $I R(nnnnn).PR(m)

Function

To terminate the printing of the current output group and return the output to the output queue.

Syntax


>>-$I--+-PRTnnnnn---+--+-------------+-------------------------><
       '-Rnnnnn.PRm-'  +-,PRTnnnnn---+   
                       '-,Rnnnnn.PRm-'

Parameters

nnnnn: For PRT, the identifier of the local printer (1-32767) to interrupt. For R, the identifier of the remote workstation (1-32767) that is attached to printer m (1-7).
m: The identifier of the printer (1-7) that is attached to the remote workstation Rnnnnn (1-32767).

Authority Required

This command requires device authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires update security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Processing Considerations

For the 3800 printer, JES2 interrupts the output group that is visible at the transfer station.
If a checkpoint interval was designated on a device initialization statement, this command causes the printer to backspace to the last checkpoint taken (based on that interval) and requeue the printer data at that point. Otherwise, the printer backspaces 1 or more pages and requeues the data at that point.
For printers controlled by JES2, a page is defined as:
1. The last page eject (skip to channel 1) supplied by JES2 (LINECT value) when the programmer did not supply any page ejects (skip to channel commands). The LINECT value (system default page value) is specified on the PRINTDEF initialization statement.
2. The entire output group, if the programmer supplied LINECT=0 on the /*JOBPARM statement, the /*OUTPUT JES2 statement, in the accounting field on the JOB statement, or on the OUTPUT JCL statement. For a description of the /*OUTPUT JES2 statement and OUTPUT JCL statement, see z/OS MVS JCL Reference, SA23-1385.
3. The last page eject (skip to any channel) supplied by the programmer, if that eject is not further back than the value of the LINECT parameter specified on the JOB or JOBPARM statement or on the OUTPUT JES2 statement or OUTPUT JCL statement or on the PRINTDEF initialization statement.
For printers controlled by the print services facility (PSF), a page is defined as the data bracketed by begin page (BPG) and end page (EPG) PSF control records. These records delimit one “impression”, or one side, of a sheet of paper. BPG and EPG records are present on the JES2 spool for data sets created by DCF, GDDM®®, and other applications that produce output data in composed-text form. For line-mode data sets sent to a page-mode printer, PSF adds the BPG and EPG records when it processes the spool data. PSF communicates the page count information back to JES2.

Note: A skip to any channel, when supplied by the programmer, is a JES2 logical page. The backspace operation will use the logical page defined by LINECT, or the programmer supplied skip, depending on which was last used to define the current page.

Scope

Single member. This command will be in effect for this member only. There is no need to have this command issued to all members of the MAS.

Messages

The $HASP170 message displays the status of output processing on the specified printer.

Example

 1   $i prt2,prt4

  $HASP170 PRT2 INTERRUPTED
  $HASP170 PRT4 INTERRUPTED

Printers 2 and 4 stop printing their current output, and JES2 returns the output to the output queue. These printers select the next available output groups for processing.