OPERATOR-DISPLAY subcommand

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-4 alphanumeric characters (a specific trap)
1-3 alphanumeric characters and 1-3 occurrences of an asterisk (*) (a set of traps)
**** (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-7 alphanumeric characters (If you specify a TSO/E user ID as LIST, L, ALL, or A, enclose the user ID in parentheses.)
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-8 alphanumeric characters (If you specify a jobname/started task as LIST, L, ALL, or A, enclose the name in parentheses.)
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-7 alphanumeric characters (If you specify a TSO/E user ID as LIST, L, ALL, or A, enclose the user ID in parentheses.)
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-8 alphanumeric characters (If you specify a jobname or started task as LIST, L, ALL, or A, enclose the name in parentheses.)
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

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-8 alphanumeric characters or 1-7 alphanumeric characters and a period (a specific major name)
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-8 characters, excluding the single quotation mark (a specific major name)
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:

2-16 hexadecimal digits (a specific major name)
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-52 alphanumeric characters and periods (a specific minor name)
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-52 characters, excluding the single quotation mark (a specific minor name)
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:

2-104 hexadecimal digits (a specific minor name)
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:

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.
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.
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.)