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-----+ '-3270CAND--'
- 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.
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).
- SCOPE=3270CAND
- Specifies that information is to be displayed about all active application program minor nodes, within the specified major nodes (or within all major nodes if the ID operand is omitted), that have had at least one session (since the application opened its ACB) that would have been a candidate for 3270 IDS monitoring if monitoring had been enabled.
Resulting display
- 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). For SCOPE=3270CAND, the status displayed is the
number of sessions that have been started (since the application opened its ACB) that would have
been a candidate for 3270 IDS monitoring if monitoring had been enabled.
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
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
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
d net,appls,scope=3270cand
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = APPL MAJ NODES/NAMES
IST089I VTAMSEG TYPE = APPL SEGMENT , ACTIV
IST1358I NO QUALIFYING MATCHES
IST089I VTAMSG2 TYPE = APPL SEGMENT , ACTIV
IST1358I NO QUALIFYING MATCHES
IST089I APPL1A TYPE = APPL SEGMENT , ACTIV
IST360I APPLICATIONS:
IST080I APPL1 0000000673 APPL2 0000251801 APPL3 0000000023
IST080I TSO10001 0000000001
IST089I TCPAPPLS TYPE = APPL SEGMENT , ACTIV
IST1358I NO QUALIFYING MATCHES
IST1454I 4 RESOURCE(S) DISPLAYED
IST314I END
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