Function

One or more parameters on this command accepts wild cards. Parameter descriptions will note that.

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 neither compresses (COMPRESS=NO) nor compacts (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 userid that creates the SYSOUT data sets to be processed. You can also specify wild cards 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 wild cards 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:

1. Applies only to remote punches.
2. 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 wild cards 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 wild cards 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 wild cards on this parameter. See Using wildcards for additional information.

Note:

1. 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.
2. NODENAME=REQUIRED on the DESTDEF initialization statement will cause JES2 to require that a userid be prefixed with a node name.

If destid is specified alone, it refers to both the node and the remote.

Ummmm

Indicates that output for special local routing is selected. Wild cards 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 userid. Generic userids are also valid. A generic userid is a userid that ends in an asterisk (*), and refers to all userids that begin with the characters preceding the *. Note that the * can only be specified in the last position of the userid.

To specify a null route code, use Routecde=() to cause this punch to select no work if Routecde is also specified in the WS list. Use the Unnnn form to specify this punch as a special local punch.

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:

1. Applies only to punches connected to BSC hardware terminals.
2. 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:

UNIT=ddd
UNIT=dddd
UNIT=/ddd
UNIT=/dddd

where ddd and dddd represent the device numbers.

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 wild cards 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:

1. 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.

2. 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.
3. 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.
4. 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.
5. 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.
6. 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.

7. If the device is a remote punch, route code (R=) must be in the work selection list.
8. 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.

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

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).

To move pmd after the slash and switch the positions of q and r, enter:

JES2 provides compression and expansion capabilities for data transmitted to remote punch 1 at RJE workstation 3.