z/OS TSO/E System Programming Command Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


OPERATOR-DISPLAY subcommand

z/OS TSO/E System Programming Command Reference
SA32-0974-00

Use the DISPLAY subcommand to display:
  • The time of day and the date
  • Summary or detailed information about SLIP traps
  • Summary or detailed information about users, jobs, and address spaces
  • Summary or detailed information about outstanding requests requiring operator action
  • The status of the message processing facility (MPF)
  • Information about the status of the global resource serialization complex
  • Information about the status of devices
  • Summary or detailed information about page and/or swap data sets
  • Summary or detailed information about the system-managed storage configuration

The syntax of the DISPLAY subcommand of OPERATOR is:

  • The specification of a d ts, d j, or d a subcommand displays exactly the same information.
  • The first two parameters on a d r subcommand are positional; the remainder are keyword parameters. If you do not specify a positional parameter, indicate its absence by a comma. The following specifications illustrate the rule:
    • d r,,t,msg=iea804e
    • d r,,,msg=iea804e
  • All parameters on a d u subcommand are positional. Therefore, if you do not specify a parameter, indicate its absence by a comma. The following specifications illustrate the rule:
    • d u,,alloc
    • d u,tp,,,nmbr
    • d u,,,,nmbr

If you do not specify either nmbr or ALLOC, nmbr defaults to 16.

If you specify ALLOC but not nmbr, nmbr defaults to 8.

  • To use the DISPLAY SMS subcommand, the Storage Management Subsystem (SMS) must be installed and active.
T
Display the local time of day and the date; and the Greenwich Mean Time (GMT) of day and the date.
SLIP
Display summary information about all the SLIP traps in the system. (The information consists of the trap ids and the state of the traps - enabled or disabled.)
xxxx
Display detailed information about the SLIP trap or traps identified by xxxx. (See the SLIP subcommand for details about xxxx.)

value:

  1. 1-4 alphanumeric characters (a specific trap)
  2. 1-3 alphanumeric characters and 1-3 occurrences of an asterisk (*) (a set of traps)
  3. **** (all traps)
TS
Display the number of
  • active batch jobs
  • started tasks (MOUNT commands in execution are treated as started tasks)
  • TSO/E users currently logged on
  • active system address spaces (e.g., master, global resource serialization, auxiliary, and so on)
  • active initiators
If TSO/VTAM is running, display
  • the number of users logged on
  • the maximum number allowed to be logged on
LIST | L
Include in the display a list of TSO/E user IDs currently logged on and the status of each address space.
ALL | A
Include in the display a list of TSO/E user IDs currently logged on, and, for each address space, also include:
  • status
  • ASID
  • program event recording (PER) active indicator
  • number of step-must-complete requests
  • performance group number
  • domain number
  • CPU affinity
  • accumulated CPU time
  • elapsed time since logon
name
Include in the display only those specified TSO/E user ID(s) currently logged on, and, for each address space, also include:
  • status
  • ASID
  • program event recording (PER) active indicator
  • number of step-must-complete requests
  • performance group numbers
  • domain number
  • CPU affinity
  • accumulated CPU time
  • elapsed time since logon
  • names of the data spaces owned by each address space
  • real address of the address space number second table (ASTE) for each data space
  • real address of the ASTE for each address space
value:
TSO/E user IDs
  1. 1-7 alphanumeric characters (If you specify a TSO/E user ID as LIST, L, ALL, or A, enclose the user ID in parentheses.)
  2. 1-6 alphanumeric characters followed by an asterisk (The display includes all TSO/E user IDs beginning with the specified alphanumeric character(s).)
JOBS | J
Display the number of
  • active batch jobs
  • started tasks (the system treats MOUNT commands in execution as started tasks)
  • TSO/E users currently logged on
  • active system address spaces (e.g., master, global resource serialization, auxiliary, and so on)
  • active initiators
If TSO/VTAM is running, display
  • the number of users logged on
  • the maximum number allowed to be logged on
LIST | L
Include in the display, for each active batch job and started task
  • jobname
  • stepname
  • procedure stepname
  • V=R region boundaries
  • status of each address space
ALL | A
Include in the display, for each active batch job and started task
  • jobname
  • stepname
  • procedure stepname
  • V=R region boundaries
  • status of each address space
For each address space, also include:
  • status
  • ASID
  • program event recording (PER) active indicator
  • number of step-must-complete requests
  • performance group number
  • domain number
  • CPU affinity
  • accumulated CPU time
  • elapsed time since initiation
name
For each specified batch job or started task, or a specified system address space, include in the display
  • for each specified active batch job and started task
    • jobname
    • stepname
    • procedure stepname
    • V=R region boundaries
  • for the specified active system address space
    • jobname
    • stepname
    • procedure stepname
  • for each of the specified active address spaces
    • status
    • ASID
    • program event recording (PER) active indicator
    • number of step-must-complete requests
    • performance group number
    • domain number
    • CPU affinity
    • accumulated CPU time
    • elapsed time since initiation
    • names of the data spaces owned by each address space
    • real address of the ASTE for each data space
    • real address of the ASTE for each address space
value:
Jobnames/started tasks
  1. 1-8 alphanumeric characters (If you specify a jobname/started task as LIST, L, ALL, or A, enclose the name in parentheses.)
  2. 1-7 alphanumeric characters followed by an asterisk (The display includes all jobnames/started tasks beginning with the specified alphanumeric character(s).)
Specific name of a system address space, e.g.,
  • ***
  • GRS
  • ALLOCAS
A
Display the number of
  • active batch jobs
  • started tasks (the system treats MOUNT commands in execution as started tasks)
  • TSO/E users currently logged on
  • active system address spaces (e.g., master, global resource serialization, auxiliary, and so on)
  • active initiators
If TSO/VTAM is running, display
  • the number of users logged on
  • the maximum number allowed to be logged on
LIST | L
Include in the display a list of TSO/E user IDs currently logged on and, for each active batch job and started task
  • jobname
  • stepname
  • procedure stepname
  • V=R region boundaries
  • status of each address space
ALL | A
Include in the display
  • a list of TSO/E user IDs currently logged on
  • for each active batch job and started task
    • jobname
    • stepname
    • procedure stepname
    • V=R region boundaries
  • for each active system address space
    • name (e.g., ***, GRS, and so on)
    • stepname
    • procedure stepname
  • for every active address space
    • status
    • ASID
    • program event recording (PER) active indicator
    • number of step-must-complete requests
    • performance group number
    • domain number
    • CPU affinity
    • accumulated CPU time
    • elapsed time since logon or initiation
name
For each specified TSO/E user ID, batch job, or started task, or a specified system address space, include in the display
  • a list of specified TSO/E user IDs currently logged on
  • for each specified active batch job and started task
    • jobname
    • stepname
    • procedure stepname
    • V=R region boundaries
  • for the specified active system address space
    • name
    • stepname
    • procedure stepname
  • for each of the specified active address spaces
    • status
    • ASID
    • program event recording (PER) active indicator
    • number of step-must-complete requests
    • performance group number
    • domain number
    • CPU affinity
    • accumulated CPU time
    • elapsed time since logon or initiation
    • names of the data spaces owned by each address space
    • real address of the ASTE for each data space
    • real address of the ASTE for each address space
value:
TSO/E user IDs
  1. 1-7 alphanumeric characters (If you specify a TSO/E user ID as LIST, L, ALL, or A, enclose the user ID in parentheses.)
  2. 1-6 alphanumeric characters followed by an asterisk (The display includes all TSO/E user IDs beginning with the specified alphanumeric character(s).)

Jobnames/started tasks

  1. 1-8 alphanumeric characters (If you specify a jobname or started task as LIST, L, ALL, or A, enclose the name in parentheses.)
  2. 1-7 alphanumeric characters followed by an asterisk (The display includes all jobnames and started tasks beginning with the specified alphanumeric character(s).)
Specific name of a system address space, e.g.,
  • **MASTER*
  • GRS
  • ALLOCAS
R
Display
  • the message id and message text of all
    • outstanding immediate action messages
    • outstanding eventual action messages
    • messages awaiting replies
  • the device numbers of all devices
    • with outstanding mount requests
    • awaiting operator intervention
  • and the status (active or not active) of the action message retention facility.
I
Only include in the display the message id and the message text of all outstanding immediate action messages (descriptor codes 1 and 2).
CE
Only include in the display the message id and the message text of all outstanding critical eventual action messages (descriptor code 11).
E
Only include in the display the message id and the message text of all outstanding eventual action messages (descriptor code 3).
R
Only include in the display the message id and the message text of all messages awaiting replies.
LIST | L
The same display you receive by issuing DISPLAY R
ALL | A
The same display you receive by issuing DISPLAY R
T
Include in the display:
  • the time a message was issued
  • the job id of the issuer
  • the name of the system from which the message was issued
S
Include in the display:
  • the job id of the issuer of a message
  • the name of the system from which the message was issued
J
Include in the display the job id of the issuer of a message.
M
Do not include in the display:
  • the time a message was issued
  • the job id of the issuer
  • the name of the system from which the message was issued
Use the following three keyword parameters
  • KEY
  • MSG
  • SYS
to limit the scope of the message display that you requested through the specification of the first positional parameter. Each of the keyword parameters interact with one another to allow you to tailor the display to include only that information you wish to view.
KEY
Only include in the display the messages associated with keyname
keyname
A retrieval key
value:
as specified on a WTO/WTOR macro in the KEY parameter

If you do not specify keyname, the display includes a summary of keynames, in alphabetical order, associated with the outstanding action messages/WTORs and the number of occurrences for each keyname.

MSG
Only include in the display the id and the text of the outstanding
  • immediate action message(s)
  • critical eventual action message(s)
  • eventual action message(s)
  • message awaiting a reply or messages awaiting replies
identified by msgid
msgid
A specific message id (for example, IEE427A) or a set of message ids (for example, IEA1)
value:
1-10 alphanumeric characters
SYS
Only include in the display the id and the text of the outstanding
  • immediate action message(s)
  • critical eventual action message(s)
  • eventual action message(s)
  • message awaiting a reply or messages awaiting replies
that were issued from the system sysname
sysname
The name of a specific system in a complex
value:
as specified by your installation

If you do not specify SYS, the display is limited to the system on which TSO/E is running.

KEY
Display a summary of keynames and the number of occurrences of each keyname for outstanding action messages/ WTORs
SYS
Limit the scope of the display to the system sysname
sysname
The name of a specific system in a complex
value:
as specified by your installation

If you do not specify SYS, the display is limited to the system on which TSO/E is running.

U
Only include in the display the device numbers of all devices with outstanding mount requests and of all devices awaiting operator intervention.
MPF
Display the status of
  • MPF
  • message suppression
  • the action message retention facility
  • the general WTO user exit
Also include in the display
  • the name(s) of the WTO user exit(s)
  • color, highlighting, and intensity options in effect
  • if MPF is active
    • include the two-character identifier (xx) and the contents of the MPFLSTxx member of SYS1.PARMLIB currently in effect; and the status of the general WTO user exit
    • if installation-defined color, highlighting, and intensity options are in effect, include the two-character identifier (xx) and the contents of the MPFLSTxx member of SYS1.PARMLIB that defines the options
    • if default color, highlighting, and intensity options are in effect, include the identifier DF and the default options
  • if MPF is inactive, include the reason
    • ‘…NOT INITIALIZED’ }MPF processing not requested
    • ‘…HARD COPY LOG NOT ESTABLISHED’

      MPF processing requested, but no hard copy log available

    • ‘…HARD COPY SUSPENDED’
      MPF processing requested, but no hard copy log available
      • for the second and third reasons, include the two-character identifier (xx) and the contents of the MPFLSTxx member of SYS1.PARMLIB currently in effect
      • always include the status of the general WTO user exit
MSG | M
Only display information about the messages that are defined in the current MPFLSTxx member of SYS1.PARMLIB:
  • which messages MPF is suppressing
  • which action messages the action message retention facility is not retaining
  • which user exits receive control for selected messages
  • the status of the general WTO user exit
COLOR | C
Only display information about the color, highlighting, and intensity options in effect
GRS
Display both system and CTC information for the current global resource serialization complex
SYSTEM
Display system information (For each system in the complex, the display includes system name, state, and communication status.)
LINK
Display CTC information (For each CTC assigned to global resource serialization on this system, the display includes the device number, status, and target system name.)
ALL | A
Display the contents of all RNLs; and resource contention, system, and CTC information for the current global resource serialization complex
HEX
Include in the display the hexadecimal format of the resource name(s) of those resources involved in the resource contention
Note: The system displays all information in EBCDIC format. However, if you specify HEX, the display includes information in both EBCDIC and hexadecimal formats.
CONTENTION | C
Display resource contention information for the current global resource serialization complex
HEX
Include in the display the hexadecimal format of the resource name(s) of those resources involved in the resource contention
RNL
Display the contents of one or more, or all of the RNLs in the current global resource serialization complex
CONVERSION | CON | C
Display the contents of the RESERVE Conversion RNL
EXCLUSION | EXCL | C
Display the contents of the SYSTEMS Exclusion RNL
INCLUSION | INCL | I
Display the contents of the SYSTEM Inclusion RNL
ALL | A
Display the contents of all three RNLs
HEX
Include in the display the hexadecimal format of the resource names contained in the specified RNL(s)
RES
Display a list of major names or resource information for the specified resource(s). For the system to display a list of major names or resource information, the specified resource must have a requestor. Otherwise, the system displays ‘NO REQUESTORS FOR RESOURCE _ _ _ _ ’.

In the following discussion concerning resource names, appending an asterisk (*) to qname/rname indicates a set of resources whose major/minor names begin with the specified characters. For example, the specification of SYSV* for qname indicates that set of resources whose major names begin with SYSV.

qname
The major name of a resource or the major names of a set of resources
value:
 
  1. 1-8 alphanumeric characters or 1-7 alphanumeric characters and a period (a specific major name)
  2. 1-7 alphanumeric characters appended with an asterisk or 1-6 alphanumeric characters and a period appended with an asterisk (a set of major names). For this form of qname, if you do not specify rname, the system displays just a list of the specified major names of those resources that have requestors.
qname
The major name of a resource or the major names of a set of resources. qname contains a character or characters, other than alphanumeric and the period, from the character set defined in the English (U.S.) I/O Interface Code for 3277, excluding the single quotation mark. (Refer to IBM® 3270 Information Display System Character Set Reference for more explicit information.) The single quotation marks enclosing qname are required; however, they do not count as part of the length specification for qname.
value:
 
  1. 1-8 characters, excluding the single quotation mark (a specific major name)
  2. 1-7 characters, excluding the single quotation mark, appended with an asterisk following the closing single quotation mark (a set of major names). For this form of ‘qname’, if you do not specify rname, the system displays just a list of the specified major names of those resources that have requestors.
X'qname'
The major name of a resource or the major names of a set of resources. qname contains a single quotation mark or multiple single quotation marks and/or characters not included in the character set defined in the English (U.S.) I/O Interface Code for 3277. In this case, specify qname in hexadecimal format. The prefix X and the single quotation marks enclosing qname are required; however, they do not count as part of the length specification for qname.
value:
 
  1. 2-16 hexadecimal digits (a specific major name)
  2. 2-14 hexadecimal digits appended with an asterisk following the closing single quotation mark (a set of major names). For this form of X'qname', if you do not specify rname, the system displays just a list of the specified major names of those resources that have requestors.
*
A generic major name

If you do not specify rname, the system displays just a list of the major names of all resources that have requestors.

When you specify rname in conjunction with qname, the display includes resource information for each unique combination of major-minor name.

rname
The minor name of a resource or the minor names of a set of resources
value:
 
  1. 1-52 alphanumeric characters and periods (a specific minor name)
  2. 1-51 alphanumeric characters and periods appended with an asterisk (a set of minor names)
rname
The minor name of a resource or the minor names of a set of resources. rname contains a character or characters, other than alphanumeric and the period, from the character set defined in the English (U.S.) I/O Interface Code for 3277, excluding the single quotation mark. The single quotation marks enclosing rname are required; however, they do not count as part of the length specification for rname.
value:
 
  1. 1-52 characters, excluding the single quotation mark (a specific minor name)
  2. 1-51 characters, excluding the single quotation mark, appended with an asterisk following the closing single quotation mark (a set of minor names)
X'rname'
The minor name of a resource or the minor names of a set of resources. rname contains a single quotation mark or multiple single quotation marks and/or characters not included in the character set defined in the English (U.S.) I/O Interface Code for 3277. In this case, specify rname in hexadecimal format. The prefix X and the single quotation marks enclosing rname are required; however, they do not count as part of the length specification for rname.
value:
 
  1. 2-104 hexadecimal digits (a specific minor name)
  2. 2-102 hexadecimal digits appended with an asterisk following the closing single quotation mark (a set of minor names)
*
A generic minor name
HEX
Include in the display the hexadecimal format of the specified resource name(s)
U
Display status information about all device types, including non-supported devices.
devicetype
Only display status information about particular device types
value:
as indicated in the following list
  • CTC - channel-to-channel adapters
  • TP - communications equipment
  • GRAPHIC - graphic devices
    Note: In a display that includes graphic devices, the system identifies
    1. a 3290 information panel as a 3279
    2. an MCS console configured as a 3270 model X as a 3270
  • TAPE - magnetic tape units
  • DASD - direct access storage devices
  • UR - unit record devices
ALL
The same display you receive by issuing DISPLAY U
ONLINE
Include in the display only on-line devices
OFFLINE
Include in the display only off-line devices
ALLOC
Include in the display the jobname and ASID of each job to which a device is presently allocated
dev_num
Include in the display only devices whose numbers are equal to or greater than dev_num.
value:
Three hexadecimal digits
Note:
  1. If you specify a device number that you did not specify on the MVSCP IODEVICE statement, the resultant display starts with the next higher device number that you did specify.
  2. For multi-exposure devices, the value you specify for dev_num must be the same as the value you specified in the ADDRESS parameter of the MVSCP IODEVICE statement.
  3. The system displays status information for primary paths only.
nmbr
Include in the display only a specific number of devices
value:
1-4 decimal digits
ASM
For all page and swap data sets, display for each data set
  • type of data set
  • percent full
  • status (that is, bad, full, or OK)
  • device number
  • data set name
PLPA
Only display information about the PLPA page data set
  • type of data set
  • percent full
  • status (that is, bad, full, or OK)
  • device number
  • data set name
  • volume serial number
  • device type
  • data set size in slots
  • number of slots currently in use
  • number of slots currently available
  • number of permanent I/O errors that have occurred on the data set
COMMON
Only display information about the common page data set
  • type of data set
  • percent full
  • status (that is, bad, full, or OK)
  • device number
  • data set name
  • volume serial number
  • device type
  • data set size in slots
  • number of slots currently in use
  • number of slots currently available
  • number of permanent I/O errors that have occurred on the data set
DUPLEX
Only display information about the duplex page data set
  • type of data set
  • percent full
  • status (that is, bad, full, or OK)
  • device number
  • data set name
  • volume serial number
  • device type
  • data set size in slots
  • number of slots currently in use
  • number of slots currently available
  • number of permanent I/O errors that have occurred on the data set
LOCAL
Only display information about a local page data set
  • type of data set
  • percent full
  • status (that is, bad, full, or OK)
  • device number
  • data set name
ALL
The same display you receive by issuing DISPLAY ASM
PAGE
Only display information about page data sets
ALL
For all page data sets, display for each data set
  • type of data set
  • percent full
  • status (that is, bad, full, or OK)
  • device number
  • data set name
dsname
For the specific page data set identified by dsname, display
  • type of data set
  • percent full
  • status (that is, bad, full, or OK)
  • device number
  • data set name
  • volume serial number
  • device type
  • data set size in slots
  • number of slots currently in use
  • number of slots currently available
  • number of permanent I/O errors that have occurred on the data set
value:
the name of a specific page data set
SWAP
Only display information about swap data sets
ALL
For all swap data sets, display for each data set
  • type of data set
  • percent full
  • status (that is, bad, full, or OK)
  • device number
  • data set name
dsname
For the specific swap data set identified by dsname, display
  • type of data set
  • percent full
  • status (that is, bad, full, or OK)
  • device number
  • data set name
  • volume serial number
  • device type
  • data set size in swap sets
  • number of swap sets currently in use
  • number of swap sets currently available
  • number of permanent I/O errors that have occurred on the data set
value:
the name of a specific swap data set
SMS
Display the active system-managed storage configuration
  • the name of the last used source control data set (SCDS)
  • the name of the active control data set (ACDS)
  • the name of the communications data set (COMMDS)
  • the value of the DINTERVAL parameter (See the IGDSMSxx member of SYS1.PARMLIB in z/OS MVS Initialization and Tuning Guide for information concerning the DINTERVAL parameter.)
  • when the Storage Management Subsystem (SMS) verifies a user's authority to allocate a new data set, use a storage class, or use a management class (See IGDSMSxx in z/OS MVS Initialization and Tuning Guide for information concerning the REVERIFY parameter.)
  • if SMS will retrieve certain Automatic Class Selection (ACS) defaults from RACF® (See IGDSMSxx in z/OS MVS Initialization and Tuning Guide for information concerning the ACSDEFAULTS parameter.)
  • the value of the INTERVAL parameter for each configuration in the complex (See IGDSMSxx in z/OS MVS Initialization and Tuning Guide for information concerning the INTERVAL parameter.)
  • a list of the systems in the complex along with the current level of their system-managed storage configuration
ACTIVE | A
The same display as you receive by specifying DISPLAY SMS
STORGRP | SG
Only display storage group information
stor_grp
The name of a specific storage group
value:
1. 1-8 alphanumeric characters, beginning with an alphabetic character
 
2. if the name of the storage group is ALL, specify it as (ALL)
LISTVOL
Include in the display
  • a list of the volumes in the storage group
  • the status of each volume on every system in the complex that has connectivity to the storage group
  • the device number of the volume in the storage group on the system where you issued the DISPLAY subcommand
ALL
Only display a list of all storage groups in the system-managed storage configuration
VOLUME | VOL
Only display the status of a specific volume on all systems. Include in the display the device number of vol_id on the system where you issued the DISPLAY subcommand.
vol_id
The name of the volume
value:
1-6 characters. Valid characters are:
  • alphanumeric
  • - (hyphen)
CACHE | C
Only display information about each 3990-3 control unit that has at least one system-managed storage volume attached. The display includes:
SSID
Four-character identifier of the subsystem
SMSCT
Number of system-managed storage volumes attached to the cache (3990-3 control unit)
READ CONTROL
Percentage of reads and non-retentive writes that used the cache
FAST WRITE CONTROL
Percentage of writes that used the fast write feature
READ HIT RATIO
Percentage of I/O requests that made a hit in the cache
FAST WRITE RATE
Number of fast write waits per minute
TRACE | T
Only display the tracing options in effect (See IGDSMSxx in z/OS MVS Initialization and Tuning Guide for an explanation of the tracing options.)

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014