$D PRT(nnnnn) and $D R(nnnnn).PR(m) - Display printers
Function
To display printer 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.
Syntax
Parameters
- nnnnn
- For PRT, the identifier of the local printer (1-32767) to display. For R, the identifier of the remote workstation (1-32767) that is attached to printer m (1-7).
- m
- The identifier of the printer (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 printer. 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 printer and SNA devices only. - Burst
- Displays whether the printed output from this 3800 printer is burst into separate sheets (Yes) or continuous fanfold form (No).
- CHAR(1-4)|X1-4
- Displays the 1 to 4 character identifier for the first through fourth character arrangement tables to be used in the specified 3800 printer.
- 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.
- CKPTMODE
- Displays whether the functional subsystem is to take checkpoints based upon page count (PAGE) or elapsed time (SEC).
- CKPTPAGE
- Displays the number (1-32767) of logical pages to be printed before each output checkpoint is taken by JES2. This parameter and CKPTLINE control the amount of checkpoint activity to spool.
- CKPTSEC
- Displays the number of seconds (0-32767) to elapse before each output checkpoint is taken. This parameter is valid only for a printer under the control of a functional subsystem.
- CLass|Queue
- Displays, in priority sequence, the output class(es) (A-Z, 0-9) this printer is to process.
- COPYMARK
- Displays whether indicators of SYSOUT separation markings are incremented on a data set level (DATASET), on a job output element level (JOB), or not at all (CONSTANT).
- CReator
- Displays the 1 through 8 character userid that creates the SYSOUT data sets to be processed.
- DEVFCB
- Displays the forms control buffer (FCB) this printer uses if the printer selects output that does not have an FCB associated with it.
- DEVFLASH
- Displays the 1 to 4 character device default forms FLASH ID.
- EJECT={YES | NO}
- Displays whether JES2 sends a page
eject to a remote printer on the printer's first use following the
start of an RJE session, depending upon the assumed position of the
printer. JES2 assumes that the remote printer is not positioned at
the top of a page on the first use after JES2 is started, restarted,
or after an RJE session fails and the remote printer is not at the
top of a page.
EJECT=Yes causes JES2 to send a page eject when the remote printer is not assumed to currently be at the top of a page. Use this parameter value when the output is destined for a physical printer.
EJECT=No ensures that a print stream never begins with a page eject. Workstations that write SYSOUT to media other than paper can use this parameter to create files that do not contain page ejects in the first line.
- FCB|C
- Displays the forms control buffer (FCB) image or the carriage control tape initially mounted on this remote printer.
- FLASH|O
- Displays the 1 to 4 character identifier of the forms overlay frame for the specified 3800 printer.
- Forms
- Displays the 1 through 8 character name of the forms loaded into this printer.
- FSAROLTR={YES|NO}
- Specifies whether the internal rolling trace for an FSS printer is activated or deactivated.
- FSS
- Displays a 1 to 8 character functional subsystem name that supports a page-mode printer.
- FSSINFO
- Displays information about the FSS
associated with this MODE=FSS printer. This data is only displayed
when LONG is specified on the display command.
- ASID
- Displays the address space identifier (ASID) for this printer.
- FSSMADDR
- Displays the virtual address of the HASPFSSM module used by this printer (in the address space indicated by ASID=).
- FSSMAPAR
- Displays the APAR number of the latest maintenance applied to the HASPFSSM module used by this printer.
- FSSMLENG
- Displays the length of the HASPFSSM module used by this printer.
- FSSMPTF
- Displays the last maintenance applied to the HASPFSSM module used by this printer.
- HASPFSSM
- Displays the name of the load module that is loaded into the functional subsystem address space (ASID).
- NAME
- Displays the name of the FSS used by this printer.
- PROC
- Displays the name of the procedure that contains the JCL to start the FSS.
- JOBname
- Displays the 1 through 8 character name of jobs whose output is selected by this remote printer. 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 printer.
For further information about this parameter, refer to the $T PRTnnnn command.
- LONG
- Displays additional information. Note: Because LONG automatically triggers a "long" display, you cannot add additional display-limiting parameters on this command; however, you can add selection-limiting parameters.
- Mark
- Displays whether (Yes) or not (No) the edge of the separator page is marked.
- MODE
- Displays whether the printer is under the control of a functional subsystem or JES2.
- MODIFY|Y
- Displays the 1 to 4 character identifier of the copy modification module for the specified 3800 printer.
- NEWPAGE
- Displays whether JES2 will treat a ‘skip to channel' or ‘skip to any channel' as a new page.
- NPRO
- Displays the non-process runout time in seconds (0-3600).
- Pause
- Displays whether (Yes) or not (No) the local printer pauses between data sets.
- PLIM
- Displays the lower and upper page limits for the size of output selected by this printer.
- PRESELCT
- Displays whether (Y) or not (N) JES2 preselects data sets for this printer. If PRESELCT=N, data sets are selectable by any device.
- PRMode
- Displays the SYSOUT mode(s) (1 to
8 alphanumeric characters) processed by this remote printer.
For more information about this parameter, refer to the $T PRT(nnnn) command. For a list of valid process-mode values, see your system programmer.
- PRTnnnnn
- The identifier of the printer (1-32767).
- RANGE
- Displays the range of batch jobs (J), started tasks (S), or time sharing users (T) whose output is selected by this remote printer.
- Routecde
- Displays as many as four internal route codes assigned to this remote printer. A route code indicates that this printer is eligible for print routing. The value for all routing numbers can range from 1 to 32767. For specification requirements, refer to Route codes.
- Sep
- Displays whether (YES) or not (NO) separator cards are provided initially between data set groups.
- SEPCHARS
- Displays the character arrangement table to use for separator pages printed on the 3800 printer.
- SEPDS
- Displays whether (Y) or not (N) a header separator page 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 pages.
- SETUP
- Displays whether (HALT) or not (NOHALT) JES2 is to halt the printer 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 printer. (If halted, the punch must be restarted using the $S command.)
- SPACE|K
- Displays the spacing for printed output: 1=single; 2=double; 3=triple.
- SUSPEND
- Displays whether a remote printer can (No) or cannot (Yes) use the printer-interrupt feature which allows the remote operator to interrupt printing for the transmitting of jobs or JES2 commands to this JES2 system. This parameter applies only to printers that are connected to BSC hardware terminals.
- STATUS
- Displays the current status of the
printer, the job active on the printer, and the number of pages or
lines 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.
- BUSY - A device in FSS mode is unable to respond with the current status because a previous command is being processed for this 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.
- INTERVENTION - An FSS-controlled printer requires operator intervention.
- NOT RESPONDING - The FSA informed JES2 that the device is no longer responding to the FSA.
- NOT RESPONDING,INTERVENTION - The FSA informed JES2 that the device is no longer responding to the FSA. Device intervention is required. To determine why the device is not responding, check the device and/or the communication components (for example, VTAM®).
- 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.
- STARTING - The device is in the process of being started. This status is only possible for FSS-owned devices and initiators.
- TRANS
- Displays whether data translation is affected.
- TRKCELL
- Displays whether (YES) or not (NO) data sets that belong to a SYSOUT class with the track-cell characteristic are read from the spool in one operation. The TRKCELL= parameter on the SPOOLDEF initialization statement specifies the number of records in the track cell.
- TRace
- Displays whether (Yes) or not (No) tracing is activated for this print processor.
- UCS|T
- Displays the 1– to 4–character identifier of the print train, print chain, or print band that is mounted on this impact printer. This identifier resides in SYS1.IMAGELIB.
- UCSVerfy
- Displays whether (YES) or not (NO) UCS verification processing is performed when a UCS image is loaded for 4245 and 4248 printers. UCS images are loaded on these printers only when required for print processing; they are not loaded in response to a $T PRT command that specifies a change in UCS setup.
- UNIT
- Displays a 4–digit 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 remote printer.
- WS
- Displays the work selection criteria for this remote printer.
- L=a|name|name-a
- The area (a), console name (name), or console name and output area (name-a) of the active MCS console at which the requested display appears.
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.
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 for more information on using the ROUTE *ALL command.
Messages
The $HASP603 message displays the status of the printers.
Examples
1 $dprt1
$HASP603 PRT1 UNIT=0017,STATUS=HALTED,(STC00008 DIP),
$HASP603 BURST=NO,CHAR(1)=GT10,CKPTLINE=0,
$HASP603 CKPTMODE=PAGE,CKPTPAGE=100,CKPTSEC=0,
$HASP603 CREATOR=,DEVFCB=,DEVFLASH=****,FCB=STD3,
$HASP603 FORMS=(STD,,,,,,,),FSS=BLUEBERY,HONORTRC=YES,
$HASP603 JOBNAME=,LASTFORM=STD,LIMIT=(0,*),
$HASP603 COPYMARK=DATASET,MARK=NO,MODE=JES,
$HASP603 NEWPAGE=DEFAULT,NPRO=300,PAUSE=NO,PLIM=(0,*),
$HASP603 PRESELCT=YES,PRMODE=(LINE),QUEUE=A,RANGE=(J1,
$HASP603 999999),ROUTECDE=(LOCAL),SEP=YES,
$HASP603 SEPCHARS=DEFAULT,SEPDS=NO,SETUP=HALT,SPACE=,
$HASP603 TRACE=NO,TRANS=DEFAULT,TRKCELL=NO,UCS=GT10,
$HASP603 UCSVERFY=NO,VOLUME=(,,,),WRITER=,
$HASP603 WS=(W,Q,R,PRM,LIM/F,UCS,FCB),FSAROLTR=NO
2 $dprt6,class
$HASP603 PRT16 QUEUE=X
3 $dr1.pr1,eject,suspend
$HASP603 R1.PR1 EJECT=YES,SUSPEND=YES
4 $dr(*).pr(*),eject,suspend
$HASP603 R1.PR1 EJECT=YES,SUSPEND=YES
$HASP603 R2.PR1 EJECT=YES,SUSPEND=YES
$HASP603 R3.PR1 EJECT=YES,SUSPEND=YES
$HASP603 R4.PR1 EJECT=YES,SUSPEND=YES
$HASP603 R5.PR1 EJECT=YES,SUSPEND=YES
$HASP603 R5.PR2 EJECT=YES,SUSPEND=YES
$HASP603 R24.PR1 EJECT=YES,SUSPEND=YES
$HASP603 R24.PR2 EJECT=YES,SUSPEND=YES
5 $dr1.pr1,suspend
$HASP603 R1.PR1 SUSPEND=YES
JES2 displays only the status of the SUSPEND parameter for remote printer 1.