DISPLAY ADJCP command


>>-DISPLAY-- --NET--,--ADJCP--,--ID--=--adjacent_cp_name-------->

   .-,--SCOPE--=--ONLY-----.   
>--+-----------------------+-----------------------------------><
   '-,--SCOPE--=--+-ALL--+-'   
                  '-ONLY-'

Abbreviations

Operand	Abbreviation
DISPLAY	D
SCOPE=ALL	EVERY or E
SCOPE=ONLY	NONE or N

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 ADJCP (adjacent control point) command displays the attributes of a specific adjacent node and the connections in which it is currently involved.

Note: With high performance routing (HPR), a control point does not have to be physically adjacent to be displayed by this command. Each endpoint of an RTP connection considers the other endpoint an adjacent control point, even though there may be intermediate ANR-capable nodes between the two endpoints.

This command is valid only when it is issued at an APPN node (network node, end node, interchange node, or migration data host).

Operands

ID=adjacent_cp_name

Specifies the network-qualified name of the adjacent control point. If the network identifier is not provided, it is assumed to be the issuing network's network identifier. You can specify * (or *NETWORK) as the network ID portion of a network-qualified adjacent CP name in order to display adjacent CPs that do not currently have a network identifier assigned to them. For example, the following command is valid if A01N currently does not have a network ID associated with it:

D NET,ADJCP,ID=*.a01n

SCOPE

Specifies the required scope of the display.

SCOPE=ONLY: Displays the status and the major node name for the adjacent control point.
SCOPE=ALL: Displays the status, the major node name, the node type, and detailed connection information for the adjacent control point.

Resulting display

The resulting VTAM® display shows:

For SCOPE=ONLY, the status and the major node name for the adjacent control point.
For SCOPE=ALL:
- Status of the adjacent CP
- Major node name
- Node type
- Number of connections
- Number of CP-CP capable connections
- An indication of whether the node being displayed is in the same subnetwork as the node where you are issuing the display
- Resource name and status
- TG number
- An indication of CP-CP session capability
- TG characteristics
- Rapid transport protocol (RTP) summary

For a byte-by-byte explanation of the TG characteristics, see the DISPLAY TGPS command.

Examples

Displaying an adjacent CP:

d net,adjcp,id=a01n,scope=only
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT CONTROL POINT
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST1197I ADJCP MAJOR NODE = ISTADJCP
IST314I END

Displaying detailed information for a physically adjacent CP with no RTP connection:

d net,adjcp,id=sscpaa,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT CONTROL POINT
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV - TRACE= OFF
IST1197I ADJCP MAJOR NODE = ISTADJCP
IST1101I ADJCP DISPLAY SUMMARY FOR NETA.SSCPAA
IST1102I NODENAME          NODETYPE CONNECTIONS CP CONNECTIONS NATIVE
IST1103I NETA.SSCPAA        NN        1           1            YES
IST2157I ALIASRCH = *NA
IST1104I CONNECTION SUMMARY FOR NETA.SSCPAA
IST1105I RESOURCE STATUS TGN CP-CP TG CHARACTERISTICS
IST1106I PU1A7B4  AC/R    21 YES   988D0000000000000000017100808
IST1493I RTP SUMMARY FOR NETA.SSCPAA COUNT = 1 RTPONLY = NA
IST172I NO RTPS FOUND
IST314I END

Displaying detailed information for a physically adjacent CP with an RTP connection:

d net,adjcp,id=sscp2a,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT CONTROL POINT
IST486I STATUS= ACT/S, DESIRED STATE= ACTIV
IST1197I ADJCP MAJOR NODE = ISTADJCP
IST1101I ADJCP DISPLAY SUMMARY FOR NETA.SSCP2A
IST1102I NODENAME          NODETYPE CONNECTIONS CP CONNECTIONS NATIVE
IST1103I NETA.SSCP2A        NN        1           1             YES
IST2157I ALIASRCH = *NA
IST1104I CONNECTION SUMMARY FOR NETA.SSCP2A 
IST1105I RESOURCE STATUS TGN CP-CP TG CHARACTERISTICS
IST1106I AHHCPU1  AC/R    21 YES   988D0000000000000000014C00808080
IST1500I STATE TRACE = OFF
IST1493I RTP SUMMARY FOR NETA.SSCP2A COUNT = 1 RTPONLY = NA
IST1486I   RTP NAME   STATE             DESTINATION CP     MNPS  TYPE
IST1487I   CNR00001   CONNECTED         NETA.SSCP2A        NO    CPCP
IST314I END

Displaying detailed information for a CP that is not physically adjacent, but has an RTP connection:

d net,adjcp,id=sscpaa,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT CONTROL POINT
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV - TRACE= OFF
IST1197I ADJCP MAJOR NODE = ISTADJCP
IST1101I ADJCP DISPLAY SUMMARY FOR NETA.SSCPAA
IST1102I NODENAME          NODETYPE CONNECTIONS CP CONNECTIONS NATIVE
IST1103I NETA.SSCPAA        NN        0           0             *NA*
IST2157I ALIASRCH = *NA
IST1104I CONNECTION SUMMARY FOR NETA.SSCPAA
IST172I NO CONNECTIONS FOUND
IST1493I RTP SUMMARY FOR NETA.SSCPAA COUNT = 1  RTPONLY = NA
IST1486I   RTP NAME   STATE             DESTINATION CP     MNPS  TYPE
IST1487I   CNR00001   CONNECTED         NETA.SSCPAA        NO    CPCP
IST314I END

From a border node, displaying detailed information for a CP that is not physically adjacent, but has an RTP connection:

d net,adjcp,id=sscpaa,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT CONTROL POINT
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV - TRACE= OFF
IST1197I ADJCP MAJOR NODE = ISTADJCP
IST1101I ADJCP DISPLAY SUMMARY FOR NETA.SSCPAA
IST1102I NODENAME          NODETYPE CONNECTIONS CP CONNECTIONS NATIVE
IST1103I NETA.SSCPAA        NN        0           0            *NA*
IST2157I ALIASRCH = *NA
IST1104I CONNECTION SUMMARY FOR NETA.SSCPAA
IST172I NO CONNECTIONS FOUND
IST1493I RTP SUMMARY FOR NETA.SSCPAA COUNT = 1 RTPONLY = NA
IST1486I   RTP NAME   STATE             DESTINATION CP     MNPS  TYPE
IST1487I   CNR00001   CONNECTED         NETA.SSCPAA        NO    CPCP
IST314I END

From a border node, displaying detailed information for a physically adjacent non-native CP with RTP connections:

d net,adjcp,id=netb.sscpba,scope=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT CONTROL POINT
IST486I STATUS= ACTIV, DESIRED STATE= ACTIV
IST1197I ADJCP MAJOR NODE = ADJCP1A
IST1101I ADJCP DISPLAY SUMMARY FOR NETB.SSCPBA
IST1102I NODENAME          NODETYPE CONNECTIONS CP CONNECTIONS NATIVE
IST1103I NETB.SSCPBA        NN        1           1            NO
IST2157I ALIASRCH = NO
IST2251I AUTHORIZED NETID LIST FOR BORDER NODE SEARCHING:
IST2252I   NETA      NETC      NETZ
IST1104I CONNECTION SUMMARY FOR NETB.SSCPBA
IST1105I RESOURCE STATUS TGN CP-CP TG CHARACTERISTICS
IST1106I AHHCPU1  AC/R    21 YES   988D0000000000000100014C00808080
IST1500I STATE TRACE = OFF
IST1493I RTP SUMMARY FOR NETB.SSCPBA COUNT = 2 RTPONLY = NO
IST1486I   RTP NAME   STATE             DESTINATION CP     MNPS  TYPE
IST1487I   CNR00002   CONNECTED         NETB.SSCPBA        NO    CPCP
IST1487I   CNR00001   CONNECTED         NETB.SSCPBA        NO    CPCP
IST314I END