DISPLAY CPCP command


>>-DISPLAY-- --NET--,--CPCP------------------------------------->

   .-,--ID--=--*.*------------------.   
>--+--------------------------------+--------------------------->
   |                            (1) |   
   '-,--ID--=--adjacent_cp_name-----'   

   .-,--LIST--=--ALL--------.   
>--+------------------------+----------------------------------->
   |                  (2)   |   
   '-,--LIST--=--+-NN-----+-'   
                 '-EN-----'     

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

   .-,--SCOPE--=--ALL---------.   
>--+--------------------------+--------------------------------><
   '-,--SCOPE--=--+-ACT-----+-'   
                  +-ALL-----+     
                  +-PENDING-+     
                  '-INACT---'

Notes:

Depending on the value of the DSPLYWLD start option, wildcard values can be used for this operand.
Because an end node will never have CP-CP sessions with another end node, LIST=EN is not valid if this command is issued from an end node. In this case, the LIST operand is not necessary because the output for LIST=ALL and LIST=NN will be identical.

Abbreviations

Operand	Abbreviation
DISPLAY	D

Purpose

Use the DISPLAY CPCP command from a network node or end node to display the status of CP-CP sessions with adjacent APPN nodes. If the ID operand is not specified, then the CP-CP session status for all adjacent APPN nodes capable of having CP-CP sessions with the local node is displayed.

The ID operand can be used to filter this display so that fewer adjacent nodes are shown. If a network qualified adjacent CP name is specified, then the CP-CP session status for only that node is displayed. If the CP name specified is not network qualified, then the CP-CP session status for all adjacent nodes with that CP name (and any network ID) is displayed. If the adjacent CP name specified is a wildcard name, then the CP-CP session status for all adjacent nodes with matching CP names is displayed.

Operands

ID

Specifies the name of the adjacent node to display.

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.

ID=cp_name: Specifies the name of an adjacent control point to display.
ID=*.*: Specifies that all adjacent nodes are to be displayed.

LIST

Specifies the type of adjacent nodes to be displayed.

LIST=ALL: Displays information about all adjacent nodes specified on the ID operand. If you omit the ID operand, information about all adjacent nodes is displayed.
LIST=NN: Displays information about the network nodes specified on the ID operand. If you omit the ID operand, information about all network nodes is displayed.
LIST=EN: Displays information about the end nodes specified on the ID operand, including migration data hosts (MDH). If you omit the ID operand, information about all end nodes is displayed.

SCOPE

Specifies the status of the CP-CP sessions to display.

SCOPE=ACT: Displays only active CP-CP sessions.
SCOPE=ALL: Displays all CP-CP sessions, whether active, pending, or inactive.
SCOPE=INACT: Displays only inactive CP-CP sessions. The output shows adjacent nodes that have at least one active CP-CP session-capable connection but no CP-CP sessions with the local node.
SCOPE=PENDING: Displays only pending CP-CP sessions.

MAX

Specifies the maximum number of CP-CP sessions 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_cpcp_sessions: Specifies the number of CP-CP sessions 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 sessions are found than you have specified on MAX, VTAM displays only the sessions that are found.

Resulting display

The resulting display shows the status of CP-CP sessions between the local node and adjacent nodes.

Examples

Displaying CP-CP session status for all adjacent nodes when no CP-CP sessions exist:

d net,cpcp
IST097I DISPLAY ACCEPTED                       
IST350I DISPLAY TYPE = CP-CP SESSION STATUS    
IST1763I NO ACTIVE CP-CP SESSION-CAPABLE TGS EXIST      
IST1454I 0 ADJCP(S) DISPLAYED                           
IST314I END

Displaying CP-CP session status for all adjacent nodes:

d net,cpcp
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = CP-CP SESSION STATUS
IST1765I ADJACENT CP   WINNER   LOSER   STATE   NODE   ANDCB
IST1766I NETA.SSCPCA   ACT      ACT     UP      NN     004AA240
IST1766I NETA.SSCPAA   ACT      ACT     UP      EN     004AA128
IST1766I NETA.SSCP2A   ACT      ACT     UP      NN     004AA010
IST1454I 3 ADJCP(S) DISPLAYED
IST314I END

Displaying CP-CP status for all adjacent network nodes:

d net,cpcp,list=nn
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = CP-CP SESSION STATUS
IST1765I ADJACENT CP    WINNER   LOSER   STATE   NODE   ANDCB
IST1766I NETA.SSCPCA    ACT      ACT     UP      NN     004AA240
IST1766I NETA.SSCP2A    PACT     INACT   UP      NN     004AA010
IST1454I 2 ADJCP(S) DISPLAYED
IST314I END

Displaying pending CP-CP session status for all adjacent network nodes:

d net,cpcp,list=nn,scope=pending
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = CP-CP SESSION STATUS
IST1765I ADJACENT CP   WINNER   LOSER   STATE   NODE   ANDCB
IST1766I NETA.SSCP2A   PACT     INACT   UP      NN     004AA010
IST1454I 1 ADJCP(S) DISPLAYED
IST314I END

Displaying active CP-CP session status for all adjacent end nodes:

d net,cpcp,list=nn,scope=act
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = CP-CP SESSION STATUS
IST1765I ADJACENT CP   WINNER   LOSER   STATE   NODE   ANDCB
IST1766I NETA.SSCPAA   ACT      ACT     UP      EN     004AA128
IST1766I NETA.SSCPBA   ACT      ACT     UP      EN     004AA028
IST1454I 2 ADJCP(S) DISPLAYED
IST314I END