$T PUN(nn) and $T R(nnnnn).PU(m) - Control a punch
Function
- Specify punch work selection and processing characteristics.
- Override a system request for a setup you are unable to fulfill.
- Start or stop tracing of the JES2 processor associated with the specified punch.
One or more parameters on this command accepts wildcards. Parameter descriptions note that.
Syntax
Parameters
- nn
- The identifier of the local punch (1-99) to control.
- 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).
- CCTL={YES|NO}
- Specifies whether (YES) or not (NO) JES2 places carriage control
characters in the output stream transmitted to this remote punch.
If you specify CCTL=NO, JES2 does not compress (COMPRESS=NO) or compact
(COMPACT=NO) data, and standard character string (SCS) control characters
are not placed in the output string. Note that the CCTL= parameter:
- Must be specified as CCTL=NO if you also specify SELECT=BASICnn
- Applies to remote punches only
- Can be changed only when the punch is inactive
- Can be used with SNA devices only.
- CKPTLINE=nnnnn
- The maximum number of lines (range 0-32767) in
a logical page. JES2 uses this value, with the CKPTPAGE value, to
determine when to take output checkpoints. Note: CKPTLINE is the only value used to define a logical page for punch devices.
- CKPTPAGE=nnnnn
- The number (1-32767) of logical pages to be punched before each output checkpoint is taken by JES2. This parameter and CKPTLINE control the amount of checkpoint activity to spool.
- CMPCT={YES|NO}
- Specifies whether
(YES) or not (NO) this remote SNA punch has compaction capabilities.
If it does and the corresponding RJE workstation definition (RMTnnnn
initialization statement) specifies COMPACT=YES, JES2 forces this
remote punch to use compaction.
If you specify CMPCT=YES, JES2 forces compression of the data (COMPRESS=YES). If you specify CMPCT=NO, JES2 turns off compaction, even if it is specified on the RJE workstation definition.
Note that the CMPCT= parameter:- Is ignored for BSC devices
- Applies to remote punches only
- Can be changed only when the punch is inactive
- Must be CMPCT=NO if CCTL=NO
- COMPACT|Z={nn|cccccccc}
- Specifies the compact table number or the 1 to 8 character compact
table name that must be defined through a COMPACT initialization statement.
Note that the COMPACT= parameter:
- Applies to SNA remote punches only
- Can be changed only when the punch is inactive.
- COMPRESS={YES|NO}
- Specifies whether (YES) or not (NO) this remote SNA punch has compression/expansion
capabilities.
If you specify COMPRESS=YES and the corresponding RJE workstation and LINE(nnnn) initialization statement specify COMPRESS=YES, JES2 forces this remote SNA punch to use compression. If you specify COMPRESS=NO, JES2 turns off compression, even if the corresponding RJE workstation specifies COMPRESS=YES.
Note that the COMPRESS= parameter:- Is ignored for BSC devices
- Applies to remote punches only
- Can be changed only when the punch is inactive
For SNA RJE workstations only:- COMPRESS=NO must be specified if you also specify CCTL=NO
- Sets on the corresponding bit setting in the RJE BIND if COMPRESS=YES.
- CReator=jccccccc
- Specifies the 1
through 8 character user ID that creates the SYSOUT data sets to be
processed. You can also specify wildcards on this parameter. See Using wildcards for additional information.
- j
- An alphabetic character (A-Z) or any of the special characters ($, #, or @).
- ccccccc
- Any combination of EBCDIC characters except a comma, a right parenthesis, or an equal sign.
- Forms=form
- The 1 to 8 alphanumeric or special characters ($ # @) character name of the forms that are loaded into this punch. You can also specify wildcards on this parameter. See Using wildcards for additional information. You may specify up to 8 forms.
- FLUSH={Yes|No}
- Specifies whether
JES2 punches a blank card following each data set or data set copy
processed by this device. Note:
- Applies only to remote punches.
- This parameter can only be changed when the session is inactive.
- JOBname=jobname
- The 1 to 8
character name of jobs whose output is to be selected by this punch.
You can also specify wildcards on this parameter. See Using wildcards for additional information. A null parameter of (JOBNAME=) specifies that jobname is not a criterion for output selection.
- LIMit=m|m-n|m-*
- Specifies the
lower and upper limits (in records) for the size of output that is
to be selected by this punch.
For both variables m and n, you can specify a range of values 0-4294967295. m and n can be equal. If they are not equal, n must be larger than m.
If you code only m, that value becomes both the lower and upper limit. If m-* is specified, the upper limit is set to the default value of 4294967295.
Note: If the punching of an output group is interrupted, JES2 compares the original size of the output (the number of cards prior to any punching rather than the cards remaining) with the LIM= specifications. - LRECL=nnn
- For SNA RJE
workstations only, specifies the logical record length (1-255)
of data transmitted to this remote punch. Note: You can change the value of LRECL= only when this remote punch is inactive.
- Pause=[No|Yes]
- Specifies whether the local punch is to pause between data sets. If you specify Y, the punch can be restarted by changing it from a not-ready to a ready state or by entering a $S command.
- PRMode=(mode1[,...mode8])
- The SYSOUT mode(s)
(1 to 8 alphanumeric characters) to be processed by this punch. You
can specify up to 8 SYSOUT modes for a single punch. You can also
specify wildcards on this parameter. See Using wildcards for additional information. Multiple entries must be separated
by commas and the list must be enclosed in parentheses. If all processing
modes are selectable by this punch, specify a null parameter of PRMODE=().
You must specify the empty parentheses. Note: For a list of valid process-mode values, see your system programmer.
- Class|Queue=c1[...c15]
- The output class(es) (A-Z, 0-9) this punch is to process. You can specify up to 15 output classes.
- R|Routecde=routecde
- Specifies up to four internal route
codes to be assigned to this card punch. A route code indicates that
this card punch is to be eligible for punch routing. The value for
all routing numbers can range from 1 to 9999. You can also specify wildcards
on this parameter. See Using wildcards for additional
information. Note:If destid is specified alone, it refers to both the node and the remote.
- JES2 does not allow remote punches to change Routecde= to another destination or to delete Routecde from the work selection list. For specification requirements, see Route codes.
- NODENAME=REQUIRED on the DESTDEF initialization statement will cause JES2 to require that a userid be prefixed with a node name.
- Ummmm
- Indicates that output for special local routing is selected. Wildcards are not supported.
Routing to a remote device can be specified in any of the following ways:- LOCAL|ANYLOCAL
- Rnnnn
- destid
- userid
- LOCAL|ANYLOCAL
- Indicates routing to a local device.
- Rnn
- Indicates routing to the specified remote device. Rnn can also be specified as RMnn or RMTnn.
- destid
- Indicates routing to a destination at the local node.
- userid
- Indicates routing to a valid TSO user ID. Generic user IDs are also valid. A generic user ID is a user ID that ends in an asterisk (*), and refers to all user IDs that begin with the characters preceding the *. Note that the * can only be specified in the last position of the userid.
Note: Route codes for local devices should be used cautiously. Once a card punch has been assigned a route code or route codes, it is considered available only for a job that requests punched output through the DEST keyword on the /*OUTPUT control statement or JCL OUTPUT statement, or through the /*ROUTE control statement or through operator command.Default: LOCAL
- RANGE={Jnnnnn|Snnnnn|Tnnnnn} [-nnnnn]
- Specifies the range (1-65534) of batch jobs (J), started tasks (S),
or time sharing users (T) whose output is to be selected by this punch.
If you code this parameter, you can specify one or two values:
- If you specify one value, that value becomes both the low and the high end of the range.
- If you specify two values, the first value is the low end of the range and the second value the high end. The two values can be equal. If they are not equal, the second value must be larger than the first value.
- SELECT={PUNCHnn|EXCHnn|BASICnn}
- Specifies the
device type (PUNCH, EXCH, or BASIC) and the device subaddress (0 -
14) to which JES2 sends output for this remote device. The SELECT= options:
- PUNCHnn
- Sends output to the remote punch (card format).
- EXCHnn
- Sends output to an exchange diskette device.
- BASICnn
- Sends output to a basic exchange diskette device.
The value nn specifies the device number (1-15; subaddress 0-14). If you do not specify the nn value, JES2 provides a default of any available device of the type specified (subaddress=15).
If this is the only punch defined and you do not specify SELECT=PUNCH, JES2 changes the media byte presentation service portion of the RJE BIN to reflect a non-card format.
Note that the SELECT= parameter:- Applies to remote punches only
- Can be changed only when the punch is inactive
- Is ignored for BSC devices
- Should specify a BASIC type only if CCTL=NO and the LRECL= value does not exceed 128.
- Sep=[No|Yes]
- Specifies whether (Y) or not (N) separator cards are to be placed between output groups.
- SEPDS=[No|Yes]
- Specifies whether (Y) or not (N) a header separator card is to be produced for each copy of each data set within an output group. Although JES2 does not actually generate separator cards, it does invoke EXIT 15 (Output Data Set/Copy Separators), if enabled, to generate separator cards.
- SETUP={HALT|NOHALT}
- Specifies whether JES2 is to halt the punch and issue the $HASP190 message requesting the operator to verify the output control specifications when the output requirements for a particular job differ from the output characteristics specified for the punch. (If halted, the punch must be restarted using the $S command.)
- SUSPEND={Yes|No}
- Specifies whether
a remote punch can (No) or cannot (Yes) use the punch-interrupt feature
which allows the remote operator to interrupt punching for the transmitting
of jobs or JES2 commands to this JES2 system. Note:
- Applies only to punches connected to BSC hardware terminals.
- This parameter can only be changed when the punch is inactive.
- TRace={No|P|Yes}
- Specifies whether
tracing is to be activated or deactivated for this punch processor.
This operand requires system authority.
- No
- Tracing is disabled.
- P|Yes
- Tracing is activated if trace IDs 11 and 12 are currently enabled.
Note: Trace IDs 11 and 12 may be enabled either at initialization on the TRACE(n) statement or using the $S TRACE(n) command.
- UNIT={devnum|/devnum}
- Specifies a 3-digit
or 4-digit hexadecimal device number. Device numbers can be specified
by any of the following formats:
where ddd and dddd represent the device numbers.UNIT=ddd UNIT=dddd UNIT=/ddd UNIT=/dddd
A slash (/) can optionally precede the device number (for compatibility with other commands that require a slash to denote a 4-digit device number).
- VOLUME=volume
- The volume serial (5-6 characters) of a volume containing a spool data set. Only the output of jobs which reside on one or more of the specified volume(s) are to be selected by this punch. You can specify up to 4 volumes. Multiple entries must be separated by commas and the list must be enclosed in parentheses. A null parameter of VOLUME=() specifies that volume is not a criterion for output selection. You must specify the empty parentheses.
- Writer=xxxxxxxx
- The 1 to 8 alphanumeric
or special ($ # @) character writer name assigned to this punch. You
can also specify wildcards on this parameter. See Using wildcards for additional information. A null parameter
of (W=) specifies that no writer name is assigned to this punch. Note: If you do not assign a writer name to the punch, and Writer is specified as an exact match criteria in the work selection (WS) list, the punch selects only output groups without a writer name.
- WS=ws
- Specifies the
work selection criteria for this punch. Using any combination of user
and JES2- defined criteria, you may specify a maximum of 19 criteria
in the WS= list. Criteria which are not specified are not considered
during output selection although JES2 does use them to determine setup
requirements. Multiple entries must be separated by commas and the
list must always be enclosed in parentheses (even if only one criterion
is specified). The general rules for specifying a punch work
selection list are:
- One slash (/) can precede or follow one of the selection criterion. Criteria
placed before the slash must be matched exactly if the work is to
be selected. Criteria placed after the slash do not have to matched
exactly except in the following cases:
- Queue
- Routecde
- PRMode
- Volume
Table 1 defines each criterion when placed either before or after the slash.
- Queue, Routecde, PRMode, and Volume can be specified as multiple values on the output device statements. Placing these criteria before the slash in the WS= list, indicates a left to right priority order of multiple values, if multiple values have been specified. Placing these criteria after the slash indicates no priority order of multiple values, but a match is still required.
- The order of those criteria specified after the slash indicates the priority (highest to lowest, in left to right order) in which JES2 attempts to match them.
- Specifying a minus sign (-) before a criterion causes that criterion
to be removed from the list. Note: An invalid operand message ($HASP650) is issued if an error is found in the WS operand, that is, if you try to remove a criterion that is not there. For example, if you enter $tpun1,ws=(-f), you get the $HASP650 message because ‘f' (forms) is not in the current work selection list for punch1.
- Specifying a criterion that is not currently specified in the list adds it to the end of the list either before or after the slash, depending on the placement of the slash in the command. If the slash is omitted from the command, JES2 assumes that the slash is at the end of the command.
- For all exact match criteria, if the output matches the device
for a specific criterion, but the output specifies demand (DMND) setup,
the match is not considered an exact match and the output is not selected
because demand setup indicates that the characteristics do not remain
the same throughout the output group.
To print demand (DMND) setup output, the work selection criteria specified for the punch that is referenced by DMND must be removed from the list.
- If the device is a remote punch, route code (R=) must be in the work selection list.
- In general, the smaller the work selection list the less the placement of certain criteria within the list affects the work selection. Job output elements are queued to the class queues by route code, then priority. This information should be used to tune the work selection list to optimize performance.
- One slash (/) can precede or follow one of the selection criterion. Criteria
placed before the slash must be matched exactly if the work is to
be selected. Criteria placed after the slash do not have to matched
exactly except in the following cases:
Authority Required
This command requires device and system 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
- This command is valid only when the specified punch is inactive. If the punch is active, enter a $P PUNnnnnn command and wait for it to become inactive before entering the $T command.
- If you are uncertain of the controls in effect, enter the $D U command for the punch in question.
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 $HASP603 message displays the status of the specified punch and its current characteristics. In particular,
The $HASP003 rc=65 message indicates that the device type specified through the UNIT= parameter does not match the defined JES2 device information.
The $HASP003 rc=66 message indicates that the device type specified through the UNIT= parameter does not exist.
Examples
1 $t pun1,f=12345678,prmode=line,lim=2000-3000,ws=(f,pmd,lim)
$HASP603 PUN1 UNIT=000D,STATUS=DRAINED,CKPTLINE=1,
$HASP603 CKPTPAGE=100,CREATOR=,FORMS=12345678,
$HASP603 JOBNAME=,LIMIT=(2000,3000),PAUSE=NO,
$HASP603 PRMODE=(LINE),QUEUE=BK,RANGE=(J1,32767),
$HASP603 ROUTECDE=(LOCAL),SEP=YES,SEPDS=NO,SETUP=HALT,
$HASP603 TRACE=NO,VOLUME=(,,,),WRITER=,
$HASP603 WS=(W,Q,R,F,PRM,LIM/)
JES2 loads the forms numbered 12345678 into punch 1. Punch 1 now selects only those data sets that require forms numbered 12345678, specify a PRMODE of LINES, and have at least 2000 records (but no more than 3000 records).
WS=(w,q,r,pmd,lim/f,p)
WS=(q,r,pmd,lim/f,p)
To move pmd after the slash and switch the positions of q and r, enter:
WS=(w,r,q,lim/f,p,pmd)
3 $t pun4,q=akz,r=(u1,r4),ws=(q,r/)
4 $t pun4,ckptline=80,ckptpage=100,setup=nohalt
5 $t pun3,sepds=y,p=y,writer=write3
6 $t r8.pu2,tr=y
7 $t r3.pu1,comp=y
JES2 provides compression and expansion capabilities for data transmitted to remote punch 1 at RJE workstation 3.
CRITERION | BEFORE SLASH (/) | AFTER SLASH (/) |
---|---|---|
CReator | The output group's CReator specification must match the CReator specification of the printer. Otherwise, this output group is not considered selectable. | It is not required that the CReator= specification of the output group match the CReator= specification of the printer. However, JES2 issues the $HASP190 setup message if a difference exists. |
Forms | The output group's FORMS specification must match the current FORMS (F=) specification for the output device. Otherwise the output group is not selected. | It is not required that the output group match the FORMS (F=) specification for the output device. However, JES2 issues the $HASP setup message if a difference exists. |
JOBname | The output group's jobname must match the jobname specified (JOBNAME=) for this device. | It is not required that the job name of the output group match the job name specified (JOBNAME=) for this device. JES2 attempts to consecutively select all eligible output for a particular job. |
LIMit | The amount of output generated by an output group must fall within the limits (LIM=) set for this device. Otherwise, the output is not selected. | It is not required that the amount of output generated by the output group fall within the limits (LIM=). |
{PMD|PRMode} (process mode) | The output group's process mode must match one of the process modes (PRMODE=) specified for the output device. Otherwise the output group is not selected. If there are multiple PRMODEs, the list is considered to be in priority sequence with the highest priority given to the first PRMODE in the list. | The process mode of the output group must match the process mode (PRMODE=) specified for the output device, but if there are multiple PRMODEs, the list is not in priority sequence. |
Priority | The priority of the output group is considered.
Whether specified before or after the slash, higher priority output
groups are preferred. Placement of ‘P' in the WS list
gives priority importance in the work selection process. There is
no ‘matching' done for priority. Note: Output groups
are added to the class queues in priority order, and the class queues
are scanned in the device's class list order. The output groups are
not scanned by priority order across class queues. Thus, if all other
work selection criteria for the output groups are equal, all of the
output groups for the first class in the device's class list are selected
in priority order before the output groups for the second class in
the list. This is the selection order even if higher priority output
groups exist on the class queue for the second class in the device's
list.
|
Same as before slash. |
Queue | When Queue is specified in the WS list, only those output classes specified for this device are searched for work. Otherwise all classes (A-Z and 0-9) are searched. It is therefore suggested that ‘Q' always be included in the WS list. The sequence of the list is the order of search. | The output classes specified for this device are not in priority sequence. All classes are equally preferred. Output groups in the first class in the list are selected first if they meet all other requirements. |
Routecde | The output group's destination must match the route code (R=) specified for this device. Otherwise the output group is not selected. If there are multiple route codes specified for the device, the list is considered to be in priority sequence and a match with the first route code is preferred. | The destination of the output group must match the route code (R=) specified for this device, but if there are multiple route codes, the list is not considered to be in priority sequence. |
RANGE | The job number of the job associated with the output group must be within the range (RANGE=) specified for this device. | It is not required that the job number of the job associated with the output group be within the specified range (RANGE=). |
Volume | The volume of the job associated with this output group must match the volume (VOLUME=) specified for this device. If there are multiple volumes specified, the list is considered to be in priority sequence with the leftmost volume having the highest priority. | The volume of the job associated with this output group must match the volume (VOLUME=) specified for this device but if there are multiple volumes specified, the list is not considered to be in priority sequence. |
Writer | The writer name specified for the output group must match the writer name specified (W=) for this device, otherwise the output group is not selected. | It is not required that the writer name of the output group match the writer name (W=) specified for the device. |