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

Function

To advance printer output a specified number of pages, a specified number of pages from the most recent checkpoint, or to the end of a data set.

Syntax


       .-,------------------------------.   
       V                                |   
>>-$F----+------------+--+-,D---------+-+----------------------->
         +-PRT--nnnnn-+  +-,pages-----+     
         '-R--nnnnn---'  '-,pages--,C-'     

>--+-,PRT--nnnnn--+-,D---------+---------+---------------------><
   |              +-,pages-----+         |   
   |              '-,pages--,C-'         |   
   '-,R--nnnnn--.--PR--m--+-,D---------+-'   
                          +-,pages-----+     
                          '-,pages--,C-'

Parameters

nnnnn

For PRT, the identifier of the local printer (1-32767) to advance output on. 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).

C

Specifies that starting from the most recent checkpoint, output is advanced the number of pages (specified by pages). JES2 assumes that all data up to the most recent checkpoint has printed successfully. Therefore, advancing output from the most recent checkpoint is the only way JES2 can ensure no loss of data for remote printers.

D

Output is advanced to the end of the data set. Printing resumes with the next data set or the next copy of the current data set.

Note: The action of the CANCEL key on the 3800 printer emulates this operation.

pages

Specifies the number of pages, or for FSS printers, the number of sides, that the output is to be advanced.

For FSS devices, this number can be up to 8 digits in length (1-99999999). For other devices, this number can be up to 4 digits in length (1-9999).

Note: If you are using an impact printer and you specify pages for data sets with a line count of zero and no channel skips, JES2 advances output to the end of the data set. This happens regardless of the value specified for pages The line count for a data set is specified by the LINECT parameter on the PRINTDEF initialization statement or the LINECT parameter on the /*JOBPARM JES2 control statement, /*OUTPUT JES2 statement, in the JOB statement accounting field, or on the OUTPUT JCL statement.)

For the 3800 printer running in JES mode, specifying 1-9999 causes advancing of the output for the specified number of physical pages.

For FSS mode devices, specifying 1-99999999 causes advancing of the output for the specified number of sides. When simplex printing, there is one side per sheet of paper. When duplex printing, there are two sides per sheet of paper.

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

If you omit D, C and nnnnn, one page is the default advance.
For data sets with no channel skips and a line count of zero, the number of lines in a checkpoint page is specified by either:
- the CKPTLNS parameter on the /*OUTPUT JES2 statement
- the CKPTLINE parameter on the PRTnnnnn and Rnnnnn.PRm initialization statements, the OUTPUT JCL statement, or specified using the $T device command
Note: This applies to 3800 printers in compatibility mode and printers under FSS control.
The amount of output between checkpoints (checkpoint interval) is controlled by either:
- the CKPTLNS and CKPTPGS parameters on the /*OUTPUT JES2 statement
- the CKPTLINE and CKPTPAGE parameters on the PRTnnnnn and Rnnnnn.PRm initialization statements, the OUTPUT JCL statement, or specified using the $T device command
A backspace results if the printer is printing more than nnnnn pages ahead of the most recent checkpoint and you specify an advance of C,nnnnn. The backspace amount is the difference between the page indicated by C,nnnn and the current print page. For example, if page 275 is currently being printed and the most recent checkpoint is at page 225, specifying $F Rnnnnn.PRm,15,C causes the printer to backspace to page 240.
If you try to advance the printer relative to a checkpoint (by specifying C) and no checkpoint exists, the printer backspaces to the beginning of the data set.
For the 3800 printer, forward spacing is relative to the page that is visible at the transfer station.
You can use this command to skip the printing of unneeded information.
The printer must be physically stopped before entering a forward space command for that printer in order to maintain proper line count displays using the $DU,PRTx command.
If you are using an impact printer and specify n for data sets with a line count of zero and no channel skips, the data set is advanced to the end. JES2 treats the data set as one contiguous page of data. A $B PRTx or $F PRTx command with the n parameter will either backspace to the beginning of the data set or forward space to the end of the data set, regardless of the value specified for CKPTLINE. before the printer jam and resume printing.
For impact printers, the number of pages to logically advance is affected by skip-to-channel commands. JES2 counts all skip-to-channel commands as new pages.

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   $f r9.pr1,4,c,prt4

  $HASP170 R9.PR1 FWD-SPACED
  $HASP170 R9.PR2 FWD-SPACED

JES2 advances the output on printer 1 of remote 9 four pages forward of the most recent checkpoint. For exceptions, see processing considerations 4 and 5. JES2 advances the output on local printer 4 one page (see processing consideration 1).