$D U - Display the status of JES2-controlled devices
Function
- Display the status of the specified devices.
- Display detailed information about the specified devices, including the identification of any jobs currently active on the device.
- Determine the tracing status of the processors associated with individual devices (such as, RDRnn, PRTnnnn, PUNnn, etc.) that allow TR=Y to be set.
- Determine how devices are notified of printer intervention conditions.
Syntax
Parameters
- U
- If you do not specify any device operands, JES2 displays the status of all local JES2-controlled devices.
- ALL
- JES2 displays the status of all local JES2-controlled devices and active remote devices. To display the status of internal readers, use the $D RDI command.
- LINEn|LNEn
- JES2 displays detailed information about the line and any remote devices or NJE nodes connected to the specified line.
- LNES
- JES2 displays the status of all lines and any connected remote devices or NJE nodes.
- LOGONn|LGNn
- JES2 displays detailed information about the specified JES2/VTAM interface. If an SNA session is established, JES2 also displays detailed information about the SNA remote terminal.
- LGNS
- JES2 displays the status of all JES2/VTAM interfaces.
- NSVS
- JES2 displays the status of all network servers.
- NSVn|NETSRVn
- JES2 displays the status of a particular network server.
- OFFS
- JES2 displays the status of all defined offload devices and their associated transmitters and receivers.
- PRTS
- JES2 displays the status of all local printers.
- PUNS
- JES2 displays the status of all local punches.
- RMT
- JES2 displays the information for the remote from which the command is entered. For example, if the operator at the remote workstation, RMT34, enters $D U,RMT, JES2 responds with the information for remote 34 at the console attached to RMT34. This parameter can only be used from a console attached to a remote workstation.
- RMTS
- JES2 displays the status of all remote terminals, associated remote devices, and any lines to which a remote terminal is connected.
- RMTn[-n|-*]
- JES2 displays detailed information about
the specified remote terminal or range of terminals, associated remote
devices, and any lines to which they are connected.
Note that n-* can be used to specify a range up to the highest-numbered RJE workstation attached to a JES2 member.
- RDRS
- JES2 displays the status of all local readers.
- TP
- JES2 displays the status of all lines and the JES2/VTAM interface.
- device
- JES2 displays detailed information about the specified devices.
You can specify any of the following devices:
- Device
- Definition
- OFFLOADn
- A spool offload device
- OFFn.JT
- A job transmitter associated with offload device n
- OFFn.JR
- A job receiver associated with offload device n
- OFFn.ST
- A SYSOUT transmitter associated with offload device n
- OFFn.SR
- A SYSOUT receiver associated with offload device n
- PUNnn
- A local punch
- PRTnnnn
- A local printer
- RDRnn
- A local reader
- Rnnnn.PRm
- A printer connected to remote terminal n
- Rnnnn.PUm
- A punch connected to remote terminal n
- Rnnnn.RDm
- A reader connected to remote terminal n
- Ln.STn
- A SYSOUT transmitter logically connected to NJE line n
- Ln.SRn
- A SYSOUT receiver logically connected to NJE line n
- Ln.JTn
- A job transmitter logically connected to NJE line n
- Ln.JRn
- A job receiver logically connected to NJE line n
Note:- When you specify PRn, PUn, and RDn from a remote console, JES2 displays detailed information for the specified devices connected to that remote system.
- If you specify OFFLOADn, JES2 also displays detailed information for the associated transmitters and receivers.
- The NPRO parameter displayed for cut sheet page printers (for example, the 3820) has no effect on these printers.
- The number of lines displayed for a job on an active printer are only as accurate as the last valid checkpoint.
- For the 3800 printer, the job name that is displayed is the name of the job that is currently visible at the transfer station.
The following operands modify the default amount of information displayed. For example, if you want to display detailed information for all readers (a limited status display is the default), specify $DU,RDRS,LONG. If you want to limit this display for only those readers that are active, specify $DU,RDRS,LONG,ACTIVE.
- ACTIVE|ACT
- JES2 displays the requested information only for devices that are connected to the function subsystem application level control block (FSA), and that are currently performing work or have lines currently dedicated for remote device configuration.
- LONG
- If you specify LONG for a group of devices (for example, RMTS),
JES2 displays detailed information for all the major devices and any
associated sub-devices (for example, Rnnnn.PRn). The exceptions to
this rule are:
- $DU,LONG, $DU,ALL,LONG and $DU,TP,LONG do not produce displays for any associated sub-devices (for example, OFFn.JT or Rnnnn.RDm).
- $DU,LGNS,LONG does not produce a display for any SNA remote terminals connected to the interfaces.
If you specify LONG for a single device (for example, LINE2), JES produces the default display of detailed information for the major device and any associated sub-devices (for example, Rnnnn.RDm).
- SHORT|SH
- If you specify SHORT for a group of devices (for example, RMTS),
JES2 displays the status of only the major devices. No sub-devices
(for example, Rnnnn.PRm) are displayed. Note: Specifying SHORT for $DU, $DU,ALL, $DU,TP, or $DU,LGNS produces the same display as the default.
If you specify SHORT for a single device (for example, LINE4), JES2 displays only the status of the major device and any associated sub-devices (for example, Rnnnn.PRm).
- STARTED|STAR
- JES2 displays information only for started devices or lines (as
specified by the device operands). Note: This modifier operand is not valid for started offload transmitters and receivers unless the offload device is also started. JES2 issues the $HASP003 message indicating that the specified device could not be found.
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.
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
Device | Resulting Message |
---|---|
LINEn | $HASP880 |
LOGONn | $HASP881 |
RMTnnnn | $HASP879 |
OFFLOADn | $HASP882 |
OFFn.JR | $HASP883 |
OFFn.JT | $HASP884 |
OFFn.SR | $HASP885 |
OFFn.ST | $HASP886 |
other devices | $HASP603 |
Examples
1 $d u,line15
$HASP880 LINE15 UNIT=SNA,STATUS=DRAINED,COMPRESS=YES,LOG=NO,
PASSWORD=(NOTSET),REST=0,SESSIONS=,
TRACEIO=NO,JRNUM=3,JTNUM=3,SRNUM=4,STNUM=2
L15.JR1 UNIT=SNA,STATUS=DRAINED,HOLD=NO
L15.JR2 UNIT=SNA,STATUS=DRAINED,HOLD=NO
L15.JR3 UNIT=SNA,STATUS=DRAINED,HOLD=NO
L15.JT1 UNIT=SNA,STATUS=DRAINED
L15.JT2 UNIT=SNA,STATUS=DRAINED
L15.JT3 UNIT=SNA,STATUS=DRAINED
L15.SR1 UNIT=SNA,STATUS=DRAINED
L15.SR2 UNIT=SNA,STATUS=DRAINED
L15.SR3 UNIT=SNA,STATUS=DRAINED
L15.SR4 UNIT=SNA,STATUS=DRAINED
L15.ST1 UNIT=SNA,STATUS=DRAINED,LIMIT=(0,*),PLIM=(0,*),
WS=(/)
L15.ST2 UNIT=SNA,STATUS=DRAINED,LIMIT=(0,100),
PLIM=(0,2),WS=(LIM/)
2 $d u,rdrs,l=pok
$HASP603 RDR1 UNIT=000C,STATUS=DRAINED
$HASP603 RDR2 UNIT=0011,STATUS=DRAINED
$HASP603 RDR3 UNIT=0012,STATUS=DRAINED
$HASP603 RDR4 UNIT=001A,STATUS=DRAINED
3 $du,prts,long,started
$HASP603 PRT1 UNIT=0017,STATUS=HALTED,(STC00003 IRRDPTAB),
$HASP603 BURST=NO,CHAR(1)=GT10,CKPTLINE=0,
$HASP603 CKPTMODE=PAGE,CKPTPAGE=100,CKPTSEC=0,
$HASP603 CREATOR=,DEVFCB=,FCB=STD3,FORMS=(STD,,,,,,,),
$HASP603 FSS=BLUEBERY,JOBNAME=IRRDPTAB,LASTFORM=STD,
$HASP603 LIMIT=(0,*),COPYMARK=DATASET,MARK=NO,
$HASP603 MODE=JES,NEWPAGE=DEFAULT,NPRO=300,PAUSE=NO,
$HASP603 PLIM=(0,*),PRESELCT=YES,PRMODE=(LINE),
$HASP603 QUEUE=A,RANGE=(J1,32767),ROUTECDE=(LOCAL),
$HASP603 SEP=YES,SEPCHARS=DEFAULT,SEPDS=NO,SETUP=HALT,
$HASP603 SPACE=,TRACE=NO,TRANS=DEFAULT,TRKCELL=NO,
$HASP603 UCS=GT10,UCSVERFY=NO,VOLUME=(,,,),WRITER=,
$HASP603 WS=(W,Q,R,PRM,LIM/F,UCS,FCB)
4 $d u,offload1,offload2,offload3,short,active
$HASP882 OFFLOAD2 DSN=SY1.DMP1.WORK,STATUS=ACTIVE
$HASP884 OFF2.JT STATUS=ACTIVE,(JOB00002 MYJOB)
$HASP886 OFF2.ST STATUS=INACTIVE
$HASP883 OFF2.JR STATUS=DRAINED
$HASP886 OFF2.SR STATUS=DRAINED
5 $du,prt2
$HASP603 PRT2 UNIT=0002,STATUS=DRAINED,CKPTLINE=0,
$HASP603 CKPTMODE=PAGE,CKPTPAGE=100,CREATOR=,DEVFCB=,
$HASP603 FCB=6,FORMS=(HFAMFORM,,,,,,,),FSS=BLUEBERY,
$HASP603 JOBNAME=,LASTFORM=HFAMFORM,LIMIT=(0,*),
$HASP603 MODE=JES,NEWPAGE=DEFAULT,NPRO=300,PAUSE=NO,
$HASP603 PLIM=(0,*),PRMODE=(LINE),
$HASP603 QUEUE=1A2B3C4D5E6F7G8,RANGE=(J1,32767),
$HASP603 ROUTECDE=(LOCAL),SEP=YES,SEPCHARS=DEFAULT,
$HASP603 SEPDS=NO,SETUP=HALT,SPACE=,TRACE=NO,
$HASP603 TRANS=DEFAULT,TRKCELL=NO,UCS=0,UCSVERFY=NO,
$HASP603 VOLUME=(,,,),WRITER=,
$HASP603 WS=(W,Q,R,PRM,LIM/F,UCS,FCB)
JES2 displays detailed information about local printer 2, which has been started.