DISPLAY PENDING command

Abbreviations

Operand	Abbreviation
DISPLAY	D

Purpose

The DISPLAY PENDING command displays information about resources in the domain that are in a pending state. A resource can be a major node, a minor node, an application program, a PU, or an LU.

You can limit the amount of display output (and the amount of time to process this command) by specifying one or more resources on the ID operand whose pending subordinate resources are to be displayed.

Attention: If you leave out the ID operand, this command causes VTAM® to check every resource and could have an adverse effect on VTAM performance.

A pending state is:

A transient state to or from a fully active state
A state of recovery pending or recovery in progress for application programs that have been retained because of the failure or takeover of an application program enabled for persistence. To observe these recovery states, enter the DISPLAY command on the system that contains the application program.

Operands

ID=name

Specifies the name of one or more active major nodes, groups, lines, or PUs whose pending resources are to be displayed.

MAX

Specifies the maximum number of resources that VTAM displays for this command.

MAX=*: Specifies that the value of the DSPLYMAX start option is used to limit the display output.
MAX=number_of_resources: Specifies the number of resources that VTAM displays for this command. The valid range is 1–value of DSPLYMAX. The default is the value specified for the DSPLYDEF start option.
Specifying MAX limits the display output. VTAM searches only for the number of instances that you have specified. When that number is found, VTAM does not search any further. This saves processing time for the command and gives you control over the amount of display output generated by the command. If fewer resources are found than you have specified on MAX, VTAM displays only the resources that are found.

Resulting display

The resulting display shows the name and status of each node in a pending state.

Examples

Displaying all nodes in a pending state:

d net,pending
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = PENDING
IST159I THE FOLLOWING NODES ARE IN A PENDING STATE
IST080I C04T0011 PACTL      C04T0012 PACTL      C04T0013 PACTL
IST080I C04T0014 PACTL      C04T0015 PACTL      C04T0021 PACTL
IST080I C04T0025 PACTL
IST1454I 7 RESOURCE(S) DISPLAYED
IST314I END

Displaying all nodes under a specific resource that are in a pending state:

d net,pending,id=a0362zc
IST097I DISPLAY  ACCEPTED
IST350I DISPLAY TYPE = PENDING
IST089I A0362ZC  TYPE = PU T4/5          , ACTIV
IST159I THE FOLLOWING NODES ARE IN A PENDING STATE
IST080I A03P161  PREQC      A03P162  PREQC      A03P163  PREQC
IST080I A03P164  PREQC      A03P165  PREQC      A03P166  PREQC
IST080I A03P167  PREQC      A03P168  PREQC      A03P169  PREQC
IST080I A03P16A  PREQC      A03P16B  PREQC      A03P16C  PREQC
IST080I A03P201  PREQC      A03P202  PREQC      A03P203  PREQC
IST080I A03P204  PREQC      A03P205  PREQC      A03P206  PREQC
IST080I A03P207  PREQC      A03P208  PREQC      A03P209  PREQC
IST080I A03P20A  PREQC      A03P20B  PREQC      A03P20C  PREQC
IST1454I 24 RESOURCE(S) DISPLAYED FOR ID=A0362ZC
IST314I END