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, SA32-0991.
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).