DISPLAY APPLS command


>>-DISPLAY-- --NET--,--APPLS------------------------------------>

>--+----------------------------------+------------------------->
   |                              (1) |   
   '-,--ID--=--+-name-----------+-----'   
               |    .-,----.    |         
               |    V      |    |         
               '-(----name-+--)-'         

   .-,--MAX--=--DSPLYDEF_start_option_value-.   
>--+----------------------------------------+------------------->
   '-,--MAX--=--+-*-------------------+-----'   
                '-number_of_resources-'         

   .-,--SCOPE--=--ALL---------------.   
>--+--------------------------------+--------------------------><
   |              .-ALL-----------. |   
   '-,--SCOPE--=--+---------------+-'   
                  '-+-----------+-'     
                    +-ACT-------+       
                    +-ACTONLY---+       
                    +-ACTSESS---+       
                    +-ALL-------+       
                    +-CONCT-----+       
                    +-INACT-----+       
                    +-INACTONLY-+       
                    +-PENDING---+       
                    '-RESET-----'

Notes:

Depending on the value of the DSPLYWLD start option, wildcard values can be used for this operand.

Abbreviations

Operand	Abbreviation
DISPLAY	D
SCOPE=ACT	ACT or A
SCOPE=ACTONLY	ACTONLY
SCOPE=ACTSESS	ACTSESS
SCOPE=ALL	EVERY or E
SCOPE=CONCT	CONCT
SCOPE=INACT	INACT or I
SCOPE=INACTONLY	INACTONL
SCOPE=PENDING	PEND
SCOPE=RESET	RESET

When using an abbreviation in place of an operand, code the abbreviation exactly as shown in the table. For example, when coding the abbreviation for SCOPE=ALL, code only EVERY or E. Do not code SCOPE=E.

Purpose

The DISPLAY APPLS (applications) command displays the status of active application program major nodes in the domain along with their subordinate application program minor nodes.

Note: To display application program minor nodes independently of the major nodes that contain them, use the DISPLAY RSCLIST command with IDTYPE=APPLS.

Operands

ID=name

Specifies the name of one or more active application program major nodes whose subordinate resources are to be displayed.

Depending on the value of the DSPLYWLD start option, wildcard values can be used for this operand. For more information about using wildcards, see Using wildcard names.

Attention: Specifying a wildcard name might degrade performance because VTAM® checks every application major node in the network.

MAX

Specifies the maximum number of application program minor nodes 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 application program minor nodes to display 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 application program minor nodes are found than you have specified on MAX, VTAM displays only the application program minor nodes that are found.

SCOPE

Specifies the required scope of the display.

Note: If you specify the SCOPE operand without specifying a value SCOPE=ALL is assumed.

SCOPE=ACT

Specifies that information is to be displayed about all active, pending, and connectable application program minor nodes within the specified major nodes (or within all major nodes if the ID operand is omitted). If this display is undesirably large, you can use SCOPE=ACTONLY or SCOPE=CONCT to further limit the display.

SCOPE=ACTONLY

Specifies that information is to be displayed about all application program minor nodes in an active state within the specified major nodes (or within all major nodes if the ID operand is omitted). The display does not include application programs in pending or connectable states. If no applications are found in an active state, you can use SCOPE=ACT to broaden the scope of the display to active, connectable, and pending applications.

SCOPE=ACTSESS

Specifies that information is to be displayed about all application program minor nodes that are active with sessions within the specified major nodes (or within all major nodes if the ID operand is omitted).

SCOPE=ALL

Specifies that information is to be displayed about all application program minor nodes (regardless of their status) within the specified major nodes (or within all major nodes if the ID operand is omitted).

SCOPE=CONCT

Specifies that information is to be displayed about all application program minor nodes in a CONCT (connectable) state within the specified major nodes (or within all major nodes if the ID operand is omitted). If no applications are found in a connectable state, you can use SCOPE=ACT to broaden the scope of the display to active, connectable, and pending applications.

SCOPE=INACT

Specifies that information is to be displayed about all inactive application program minor nodes within the specified major nodes (or within all major nodes if the ID operand is omitted). If this display is undesirably large, you can use SCOPE=INACTONLY or SCOPE=RESET to further limit the display.

SCOPE=INACTONLY

Specifies that information is to be displayed about all inactive application program minor nodes within the specified major nodes (or within all major nodes if the ID operand is omitted). Resources in a RESET state are not included in the SCOPE=INACTONLY display.

SCOPE=PENDING

Specifies that information is to be displayed about all pending application program minor nodes within the specified major nodes (or within all major nodes if the ID operand is omitted). A pending state is:

A transient state to or from the 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

SCOPE=RESET

Specifies that information is to be displayed about all application program minor nodes in a RESET state within the specified major nodes (or within all major nodes if the ID operand is omitted).

Resulting display

The resulting VTAM display shows:

The name and status of the specified active application program major nodes (or all active application program major nodes if the ID operand is omitted). Inactive application program major nodes are not known to VTAM and are therefore not displayed.
For each active application program major node, the name and status of each subordinate application program minor node (limited to active, connectable, inactive, or pending minor nodes if specified on the SCOPE operand).
If a model application program has been defined in the major node being displayed, the model application program will be included in the display. In addition, any dynamic application programs that have been built from the model application program definition will also be included in the display.

Note: Dynamic application programs that have been deactivated are not displayed. This is because dynamic application programs cannot exist in an inactive state. When a dynamic application program is deactivated and CLOSE macro processing is complete for the dynamic application program, the definition of the dynamic application program is deleted. The dynamic application program is no longer known by VTAM and will not appear in the output of any DISPLAY commands.

If a channel-attached host is used as an intermediate routing node for either a primary or backup extended recovery facility (XRF) session, the session through the channel-attached host might fail without notifying the XRF host. In that case, a DISPLAY APPLS command issued from either the primary or alternate host shows the failed session across the channel attachment as active.

Examples

Displaying all application program major nodes and their minor nodes:

d net,appls
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = APPL MAJ NODES/NAMES
IST089I VTAMSEG  TYPE = APPL SEGMENT     , ACTIV
IST360I APPLICATIONS:
IST080I ISTATA00 CONCT      ISTNOP   ACTIV      ISTPDCLU ACT/S
IST080I A01N     ACT/S
IST089I VTAMSG2  TYPE = SEGMENT          , ACTIV
IST360I APPLICATIONS:
IST080I *?-?*    CONCT
IST089I A01APPLS TYPE = APPL SEGMENT     , ACTIV
IST360I APPLICATIONS:
IST080I A01NV    ACTIV      A01NVPPT ACTIV      A01NV000 CONCT
IST080I A01NV001 ACTIV      A01NV002 ACTIV      A01NV003 ACTIV
IST080I A01NV004 ACTIV      A01NV005 ACTIV      A01NV006 ACTIV
IST080I A01NV007 CONCT      A01NV008 CONCT      A01NV009 CONCT
IST080I A01TFOPT CONCT      A01TFO0  CONCT      A01TFO1  CONCT
IST080I A01TFO2  CONCT      A01TFO3  CONCT      A01TFO4  CONCT
IST080I A01TF00  CONCT      A01TF01  CONCT      A01TF02  CONCT
IST080I A01TF03  CONCT      A01TF04  CONCT      A01TF05  CONCT
IST080I A01TF06  CONCT      A01TF07  CONCT      A01TF08  CONCT
IST080I A01TF09  CONCT      AAUTSKLP CONCT      AAUTCNMI ACTIV
IST080I DSICRTR  ACTIV      DSIAMLUT ACT/S      A01NVLUC ACT/S
IST080I A01NVSPT ACTIV      BNJHWMON ACTIV      ALIASAPL CONCT
IST080I DSIGDS   ACTIV      APPLR02  CONCT      APPLA01  CONCT
IST080I APPL01   CONCT      APPL0102 CONCT      A01MVSNO CONCT
IST080I A01MVSOP CONCT      A01MVSRE CONCT      WORM     CONCT
IST080I DIAL01   CONCT      CAPPL01O CONCT      CAPPL01C CONCT
IST080I CAPPL01N CONCT      ECHO01   CONCT      ECHOX01  CONCT
IST080I ECHOA01  CONCT      APPCA01  CONCT      A01AP08  CONCT
IST080I A01SPAP8 CONCT      A01SPAP9 CONCT      NPMA01M  CONCT
IST080I NPMA01MA CONCT      TPNS02   CONCT      TPNSA01  CONCT
IST080I IMS02    CONCT      MHCICS02 CONCT      CICS02A  CONCT
IST080I TCAM02   CONCT      TSO02    ACTIV      TSO0201  ACT/S
IST080I TSO0202  CONCT      TSO0203  CONCT      TSO0204  CONCT
IST080I TSO0205  CONCT      TSO0206  CONCT      TSO0207  CONCT
IST080I TSO0208  CONCT      TSO0209  CONCT      TSO0210  CONCT
IST080I VMA01    CONCT      VMA011   CONCT      VMA012   CONCT
IST080I VMA013   CONCT      VMA014   CONCT      VMA015   CONCT
IST080I VMA016   CONCT      VMA017   CONCT      VMA018   CONCT
IST080I VMA019   CONCT
IST089I A01ECHOC TYPE = APPL SEGMENT     , ACTIV
IST360I APPLICATIONS:
IST080I ECHO01A  ACT/S      ECHO01B  ACTIV      ECHO01C  ACT/S
IST080I ECHO01D  CONCT      ECHO01E  CONCT
IST1454I 93 RESOURCE(S) DISPLAYED
IST314I END

Displaying a specific application program major node and its minor nodes, including model application programs and dynamic application programs built from those models:

d net,appls,id=a01appls
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = APPL MAJ NODES/NAMES
IST089I A01APPLS TYPE = APPL SEGMENT     , ACTIV
IST360I APPLICATIONS:
IST080I APPL1    CONCT      APPLA*   CONCT      APPL2    CONCT
IST080I APPLQ?   CONCT      APPLQ1   ACTIV      APPL3    CONCT
IST080I APPL01   CONCT      APPL0102 CONCT      A01MVSNO CONCT
IST1454I 9 RESOURCE(S) DISPLAYED FOR ID=A01APPLS
IST314I END

Displaying application program major nodes and their minor nodes, limiting output to 5 resources:

d net,appls,max=5
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = APPL MAJ NODES/NAMES
IST089I VTAMSEG  TYPE = APPL SEGMENT     , ACTIV
IST360I APPLICATIONS:
IST080I ISTATA00 CONCT      ISTNOP   ACTIV      ISTPDCLU ACTIV
IST080I SSCP1A   ACTIV
IST089I VTAMSG2  TYPE = APPL SEGMENT     ,ACTIV
IST360I APPLICATIONS:
IST080I *?-?*    CONCT
IST1315I DISPLAY TRUNCATED AT MAX = 5
IST1454I 5 RESOURCE(S) DISPLAYED
IST314I END