Displaying system requests (R)
- The immediate action messages (descriptor codes 1 or 2), eventual action messages (descriptor code 3), and critical eventual action messages (descriptor code 11)
- The device numbers of devices waiting for mount requests to be fulfilled
- The device numbers of devices waiting for operator intervention
- The status of the action message retention facility
- An alphabetical list of key names of outstanding action messages
- The messages issued by a specified system
- The messages that await operator response at a specified console
- The messages that have specific routing codes
- The U operand displays information about devices and units.
- The I, E, CE, R, and M operands display outstanding action messages.
- The LIST, L, ALL, and A operands display combinations of information.
- The KEY operand displays an alphabetical list of key names of outstanding action messages.
The resulting display is described in messages IEE112I (successful result) or IEE312I (unsuccessful result).
Syntax
D R |
---|
|
Because TSO consoles in OPERATOR mode do not route messages by console IDs or routing codes, do not use the ROUT or CN operands on DISPLAY R commands issued from these consoles.
Parameters
- R
- The system is to display information about outstanding action
messages (that is, messages with descriptor codes 1, 2, 3, or 11),
WTORs, and devices awaiting mount requests to be fulfilled, and units
requiring intervention. Information includes either the text of all
outstanding action messages and WTORs, a summary of key names associated
with the outstanding action messages, or device numbers. The system
also displays a number that represents the total of all outstanding
WTORs or action messages.
If the issuing console has master authority, the system displays, on the issuing console, all outstanding WTORs. Otherwise, unless you specify the CN parameter on the command, the system displays information about only those messages that appeared on the console that issues the DISPLAY R command.
Consoles of some subsystems, such as NetView®, must specify the CN=(ALL) parameter to ensure displaying all outstanding requests.
Optional subparameters are:
- I
- Display the texts and message identification numbers of all outstanding immediate action messages (descriptor codes 1 or 2).
- E
- Display the texts and message identification numbers of all outstanding eventual action messages (descriptor code 3).
- CE
- Display the texts and identification numbers of all outstanding critical eventual action messages (descriptor code 11).
- R
- Display the texts and message identification numbers of all messages awaiting replies (WTORs).
- M
- Display the texts and message identification numbers of all immediate action, eventual action, and critical eventual action messages, and messages awaiting replies.
- LIST or L or ALL or A or blank
- Display the texts and message identification numbers of all immediate action, eventual action, and critical eventual action messages and messages awaiting replies. Also display the device numbers of devices with unfulfilled mount requests and any units requiring operator intervention.
- U
- Display the device numbers of devices with unfulfilled mount requests and any units requiring operator intervention.
- msgformat
- Specifies the information that is to accompany messages when they are displayed on a console.
The possible values of msgformat are:
- J
- Display the message text with the job name or job ID of the message issuer. If JES3 is the primary subsystem and is running in XCF-local mode, this option displays the job name, but not the job ID.
- JN
- Display the message text with only the job name of the message issuer. If JES3 is the primary subsystem and is running in XCF-local mode, JN has the same effect as J.
- M
- Display only the text of each message.
- S
- Display the message text, the name of the system that sent the message, and the job name or job ID of the message issuer. If JES3 is the primary subsystem and is running in XCF-local mode, this option displays the jobname, but not the job ID.
- SN
- Display the system name and the job name of the message issuer. If JES3 is the primary subsystem and is running in XCF-local mode, SN has the same effect as S.
- T
- Display the message text with the time stamp, the name of the system that sent the message, and the jobname or job ID of the message issuer. If JES3 is the primary subsystem and is running in XCF-local mode, this option displays the jobname, but not the job ID.
- TN
- Display the message text with the time stamp, the name of the system that sent the message, and the jobname of the message issuer. If JES3 is the primary subsystem and is running in XCF-local mode, TN has the same effect as T.
The format of a message that includes all message format options is:Time stamp System name Jobname/id Message text
Default: For MCS, HMCS, SMCS and extended MCS consoles, the default message format differs depending on the primary subsystem. If it is JES2, the default format is defined by the MFORM setting for the console. (You can use the CONTROL S command (K S,MFORM) to change the MFORM setting.) If it is JES3, the default message format option is S. You can use the CONTROL command to change the default for MCS, HMCS and SMCS consoles.
M is the default message format option for extended MCS consoles. To change the default value for extended MCS consoles, use the RACF® command, ALTUSER userid OPERPARM(MFORM(T,S,J,M,X)). See z/OS Security Server RACF Command Language Reference for more information.
- MSG=msgid
- The text of any action message awaiting a reply is to be displayed if the message identifier begins with the one to ten characters specified by msgid. Specify a trailing asterisk (*) wildcard to request messages for all message identifiers that match a leading character string.
- JOB=jobname
- The system requests the messages that are identified by a one
to eight-character job name (jobname). Specify
a trailing asterisk (*) wildcard to request messages for all job names
that match a leading character string. For example, enter the following
command to display outstanding messages requiring operator action
for all job names that begin with the characters TSO1:
D R,JOB=TSO1*
- SYS=sysname
- The system is to display messages that have appeared at the system
named sysname or, if you also specify KEY, the
key names of messages issued at the system with this name.
If you issue DISPLAY R,M,SYS=sysname from a console on the JES3 global, you get all messages for the system named sysname. (Note that the system retrieves the same information if you issue the DISPLAY R,L,SYS=sysname command. You cannot retrieve unit information from another system.)
If you issue DISPLAY R,M without the SYS=sysname operand, at an MCS, HMCS or SMCS console that also controls the JES3 global, the system displays all outstanding messages for that system and for the local systems attached to it. If you issue the same command at an MCS, HMCS or SMCS console that also controls a JES3 local or JES2 system, the system displays the messages only for that system.
- KEY
- The system displays an alphabetical list of key names associated with outstanding messages. The system also displays the total number of messages for each key name.
- KEY=keyname
- The system requests those messages that are identified by a one to eight-character key name (keyname), such as those messages issued by the specified dynamic support program (DSP) of JES3.
- KEY=MOUNT
- The system displays outstanding tape mount requests.
- CN
- The system displays a set of messages and device numbers of devices
awaiting mount requests to be fulfilled, and units requiring intervention,
or, if you also specify KEY, a list of outstanding key names of messages
that appear at a specified console or all consoles. These messages
include those directed by routing code and those directed by console
ID.
If you omit the CN operand, the default is the current console on which you enter the D R command.
- name
- Requests those outstanding action messages that the system directed to the console with the name name.
- (ALL)
- Requests the outstanding action messages that the system directed to all consoles. The parentheses are required.
- ROUT
- The system displays only the outstanding action messages that
have the specified routing codes. The system rejects the ROUT operand
if you also request a summary of key names.
- ALL
- Requests messages with any routing code.
- (rrr[,sss]…)
- Requests messages with one or more routing codes.
- (rrr-sss)[,(rrr-sss)]…
- Requests messages within a range of routing codes. When you specify a range of routing codes, the first rrr in the range must be less than or equal to the second sss.
- NONE
- Requests only those messages that the system directs to the console by console ID.
- L=a, name, or name-a
- Specifies the display area (a), console name
(name), or both (name-a) where
the display is to appear.
If you omit this operand, the display is presented in the first available display area or the message area of the console through which you enter the command.
Examples
D R,L,L=CON2-A or D R,A,L=CON2-A
D R,MSG=IEF
D R
DISPLAY R,M,ROUT=(1-12)
If the console is defined to receive, for example, only routing codes 1 and 2, the display includes only messages with those routing codes.
DISPLAY R,KEY
DISPLAY R,KEY=TAPE
DISPLAY R,A,S
DISPLAY R,M,SYS=SY2
The system also displays numbers of devices that await mount requests and units requiring intervention.
DISPLAY R,L,CN=CON02
The system also displays numbers of devices that await mount requests and units requiring intervention.
DISPLAY R,ROUT=ALL issued from console CON04
or
DISPLAY R,ROUT=ALL,CN=CON04 issued from another console
DISPLAY R,L,JN
DISPLAY R,L,JOB=CICS*
or
DISPLAY R,L,JN,JOB=CICS*