 |
Function To perform the following functions: - 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 
.-.------------------------------.
V |
>>-$D--U----+----------------------------+-+--+----------+-----><
+-,ALL-----------------------+ +-,ACTIVE--+
+-,LINE--n-------------------+ +-,ACT-----+
+-,LNE--n--------------------+ +-,LONG----+
+-,LNES----------------------+ +-,SHORT---+
+-,LOGON--n------------------+ +-,SH------+
+-,LGN--n--------------------+ +-,STARTED-+
+-,LGNS----------------------+ '-,STAR----'
+-,NSV--n--------------------+
+-,NETSRV--n-----------------+
+-,NSVS----------------------+
+-,OFFS----------------------+
+-,PRTS----------------------+
+-,PUNS----------------------+
+-,RMT-----------------------+
+-,RMTS----------------------+
+-,RMT--n--(-- -n--|-- -*--)-+
+-,RDRS----------------------+
+-,TP------------------------+
'-,device--------------------'
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.
Although
it is not invalid to specify all four modifiers, SHORT overrides LONG
and ACTIVE overrides STARTED when specified together. In addition,
the SHORT or LONG modifier may produce the same display as the default,
depending on the device operand specified. The individual descriptions
below explain the modifier's effects when used with specific device
operands. - 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, 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 Table 1. $D U 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/)
JES2 displays detailed information about line 15, including
information about job receivers (JRx), job transmitters (JTx), SYSOUT
receivers (SRx) and SYSOUT transmitters (STx). The SYSOUT transmitter
information includes their work selection criterion (line and page
limits). In this case, SYSOUT transmitter 1 (ST1) has no work selection
limits specified for SYSOUT data sets that it selects. ST2 has work
selection limits specified and selects SYSOUT data sets with up to
100 lines and up to 2 pages. 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
JES2 displays the status of all local readers on console
"pok". 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)
JES2 displays detailed information about all local printers
that have been started. 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
JES2 displays the status of offload devices 1, 2, and
3 and their associated transmitters and receivers, if the offload
devices are currently active. In this case, offload device 2 is the
only specified offload device that is currently performing work.
Its associated offload job transmitter is in the process of transmitting
job 2 (named MYJOB) to the offload data set. 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.
|
z/OS JES2 Commands
Copyright IBM Corporation 1990, 2014