Function

To display remote punch work selection and processing characteristics.

This command has parameters you can use as a filtering technique to limit the type of information to search, or the amount of information to display. See Using filtering to control and display information for additional information.

Parameters

nn

The identifier of the local punch (1-99) to display.

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

CCTL={YES|NO}

Displays 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: The CCTL= parameter applies to remote punch and SNA devices only.

CKPTLINE

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

CKPTPAGE

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

CLass|Queue=queue

Displays, in priority sequence, the output class(es) (A-Z, 0-9) this punch processes.

CReator=creator

Displays the 1 through 8 character userid that creates the SYSOUT data sets to be processed.

FLUSH

Displays whether (YES) or not (NO) JES2 punches a blank card following each data set or data set copy processed by this device.

Forms=form

Displays the 1 through 8 character name of the forms loaded into this punch.

JOBname=jobname

Displays the 1 through 8 character name of jobs whose output is selected by this punch. A null parameter of (JOBNAME=) specifies that jobname is not a criterion for output selection.

LIMit

Displays the lower and upper limits (in records) for the size of output that is selected by this punch.

LRECL

Displays the logical record length (1-255) of data transmitted to this SNA remote punch. This parameter is ignored for BSC devices.

LRECL= can be modified through a warm start.

Pause={Yes|No}

Displays whether (Yes) or not (No) a punch is to pause between data sets.

PRMode

Displays the SYSOUT mode(s) (1- 8) processed by this remote punch. For a list of valid process-mode values, see your system programmer.

RANGE

Displays the range of batch jobs (J), started tasks (S), or time sharing users (T) whose output is selected by this punch.

Routecde

Displays as many as four internal route codes assigned to this card punch. A route code indicates that this card punch is eligible for punch routing. The value for all routing numbers can range from 1 to 32767. For specification requirements, refer to Route codes.

SEPDS={Yes|No}

Displays whether (Y) or not (N) a header separator card is to be produced for each copy of each data set within an output group. JES2 invokes EXIT 15 (Output Data Set/Copy Separators) -- if enabled -- to generate separator cards.

Sep

Displays whether (YES) or not (NO) separator cards are provided initially between data set groups.

SETUP={HALT|NOHALT}

Displays whether (YES) or not (NO) 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.)

STATUS

Displays the current status of the printer, the job active on the printer, and the number of cards printed. Valid printer status values are:

• ACTIVE - JES2 is using the device for job processing and will continue to do so as long as there are jobs available and eligible for that device.
• DRAINED - JES2 is not using the device and will not do so until the device is started using a $S command.
• DRAINING - JES2 is currently using the device for the processing of jobs, but will discontinue its use upon completion of the current function.
• ENDED - A non-recoverable ABEND occurred during processing for this device. JES2 has suspended all processing for this device. At the time the device was suspended, work might still have been assigned to the device. All processing on that work has also been suspended. You need to perform a JES2 hot start to recover the device and any work assigned to it.
• HALTED - JES2 has either requested operator assistance or the operator has halted the device ($Z) and is waiting for the device to be started using a $S command.
• INACTIVE - JES2 is not using the device but would do so if jobs were available and eligible for that device.
• PAUSED - JES2 has paused between jobs during printing or punching. The specified device will not be used until it is started ($S command) or it has been reset from a not-ready to a ready state.

TRace

Displays whether (Yes) or not (No) tracing is activated for this punch processor.

UNIT

Displays a 4-digit hexadecimal device number.

Volume

Displays the 5- to 6-character volume serial number of a volume containing a spool data set.

Writer

Displays the 1 through 8 character writer name assigned to this punch.

WS

Displays the work selection criteria for this remote punch.

Authority Required

This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned. The $T INTRDR command sets the command authority for internal readers.

This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single member. The response to this command will be a display of information about this member only. You might want to use this command to get information about all members in the MAS. To do so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP603 message displays the status of the punches.

JES2 displays the forms name and the lower and upper limits for the record size of output selected by punch 1 on remote 1.