$F PUN(nn) and $F R(nnnnn).PU(m) - Logically advance punch output
Function
To advance punch output a specified number of cards, a specified number of cards from the most recent checkpoint, or to the end of a data set.
Syntax
.-,-------------------------------------. V | >>-$F----+--------------------+--+-,D--------+-+----------------> +-PUN--nn------------+ +-,nnnn-----+ '-R--nnnnn--.--PU--m-' '-,nnnn--,C-' >--+-PUN--nn--+-,D--------+-----------+------------------------>< | +-,nnnn-----+ | | '-,nnnn--,C-' | '-R--nnnn--.--PU--m--+-,D--------+-' +-,nnnn-----+ '-,nnnn--,C-'
Parameters
- nn
- The identifier of the local punch (1-99) to advance.
- nnnnn
- The identifier of the remote workstation R (1-32767) that is attached to punch m (1-7).
- m
- The identifier of the punch (1-7) that is attached to the remote workstation Rnnnnn (1-32767).
- D
- Output is advanced to the end of the data set. Punching resumes with the next data set or the next copy of the current data set.
- nnnn
- Output is advanced nnnn (1-9999) cards.
- nnnn,C
- Output is advanced nnnn (1-9999) cards from the most recent checkpoint. JES2 assumes that all data up to the most recent checkpoint has punched successfully. Therefore, advancing output from the most recent checkpoint is the only way JES2 can ensure no loss of data for remote punches.
- PUNnn
- The identifier of the local punch (1-99) on which JES2 advances output.
- Rnn.PUm
- The identifier of the remote punch (1-99) on which JES2 advances output.
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.
Processing Considerations
- If you omit D, C, and nnnnn, one card is the default advance.
- The amount of output between checkpoints is controlled by either:
- The CKPTLNS and CKPTPGS parameters on the /*OUTPUT JES2 statement
- The CKPTLINE and CKPTPAGE parameters on the PRTnnnn and Rnnnn.PRm initialization statements, the OUTPUT JCL statement, or specified using the $T device command.
- If the punch is punching more than nnnn cards ahead of the most recent checkpoint and you specify an advance of C,nnnn, a backspace results. The amount of backspace is the difference between the card indicated by C,nnnn and the current punch card. For example, if card 275 is currently being punched and the most recent checkpoint is at card 225, specifying $F Rnnnn.PUm,15,C causes the punch to backspace to card 240.
- If you try to advance the punch relative to a checkpoint (by specifying C) and no checkpoint exists, the punch backspaces to the beginning of the data set.
- You can use this command to skip punching of unneeded cards.
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 punch.
Example
1 $f r9.pu1,1,c,pun2
$HASP170 R9.PU1 FWD-SPACED
$HASP170 R9.PU2 FWD-SPACED
JES2 advances the output on punch 1 of remote 9 one card forward of the most recent checkpoint. For exceptions, see processing considerations 3 and 4. JES2 advances the output on local punch 2 one card (see processing consideration 1).