DISPLAY ADJSSCPS command


Display user-defined and dynamic adjacent SSCP tables:

>>-DISPLAY-- --NET--,--ADJSSCPS--+-----------------------+------>
                                 '-,--CDRM--=--sscp_name-'   

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

                           .-,--SCOPE--=--ONLY---------.   
>--+--------------------+--+---------------------------+-------><
   '-,--NETID--=--netid-'  |              .-ALL------. |   
                           '-,--SCOPE--=--+----------+-'   
                                          '-+------+-'     
                                            +-ALL--+       
                                            '-ONLY-'


Display the adjacent SSCP table for a specific cross-domain resource:

>>-DISPLAY-- --NET--,--ADJSSCPS--,--CDRSC--=--cdrsc_name-------->

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


Display a specific list of adjacent CDRMs used for session requests:

>>-DISPLAY-- --NET--,--ADJSSCPS--,--ADJLIST--=--list_name------->

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


Display all lists of adjacent CDRMs:

>>-DISPLAY-- --NET--,--ADJSSCPS--,--ADJLIST--=--*--------------->

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

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 ADJSSCPS (adjacent system services control points) command displays user-defined and dynamically built adjacent SSCP tables and user-defined adjacent CDRM lists. If a user-defined adjacent SSCP table or CDRM list exists, VTAM® displays information from that table or list. If no user-defined table exists, or if there is a table, but it does not contain any applicable entries, VTAM displays information from the dynamic adjacent SSCP table.

If you specify a CDRSC on this command, VTAM displays the dynamic adjacent SSCP table for the cross-domain resource, along with status information for the resource.

Operands

ADJLIST

Specifies that one or more lists of adjacent CDRMs are to be displayed. If you specify ADJLIST, do not specify any other operands on the command.

ADJLIST=list_name: Displays the list of adjacent CDRMs identified by list_name.
ADJLIST=*: Displays all lists of adjacent CDRMs.

CDRM=sscp_name

Specifies that information is to be displayed about the adjacent SSCP table or tables for the specified CDRM. The sscp_name may not be a network-qualified name; however, you can use the NETID operand to specify the network. If you specify CDRM, do not specify CDRSC on the same command.

CDRSC=cdrsc_name

Specifies that information is to be displayed about the adjacent SSCP table that is used to establish a session with the specified CDRSC. You can specify CDRSC as a network-qualified name. If you specify CDRSC, do not specify CDRM, NETID, or SCOPE on the same command.

The setting of the NQNMODE start option might affect how VTAM processes this operand. See the z/OS Communications Server: SNA Resource Definition Reference for an explanation of NQNMODE.

You can specify the name of a conventionally defined CDRSC, a model CDRSC, a clone CDRSC built from a model CDRSC, or a dynamic CDRSC. You can use wildcard characters in the name you specify. The use of the wildcard characters does not depend on the value of the DSPLYWLD start option. However, unlike wildcard characters in other commands, the wildcard characters you specify here do not represent unspecified characters. They are interpreted as actual characters, an asterisk (*) and a question mark (?). Therefore, if you specify D NET,ADJSSCPS,CDRSC=APPL*, VTAM will display information related to the model CDRSC named APPL* , but it will not display information about any other CDRSCs whose names begin with APPL.

MAX

Specifies the maximum number of adjacent SSCP tables or adjacent CDRM lists 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 adjacent SSCP tables or adjacent CDRM lists 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 adjacent SSCP tables or adjacent CDRM lists are found than you have specified on MAX, VTAM displays only the adjacent SSCP tables or adjacent CDRM lists that are found.

NETID=netid

Specifies the destination network for the adjacent SSCP table or tables to be displayed. If you specify NETID, do not specify CDRSC on the same command.

SCOPE

Determines the domain of the search for an adjacent SSCP table or tables.

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

If you specify SCOPE, do not specify CDRSC on the same command.

SCOPE=ALL

If neither NETID nor CDRM is specified:
1. VTAM displays all user-defined ADJSSCP tables.
2. If no user-defined tables exist, VTAM displays the dynamic table if it exists.
If you specify NETID (and not CDRM):
1. VTAM displays all ADJSSCP tables for all CDRMs for the specified network.
2. If there are no tables for individual CDRMS in the specified network, VTAM displays the default table for the specified network.
3. If there is no default table for the specified network, VTAM displays the dynamic table if it exists.
If you specify CDRM (and not NETID):
1. VTAM displays all ADJSSCP tables for the specified CDRM in all networks.
2. If there are no tables for the specified CDRM, VTAM displays the default table for all networks.
3. If there is no default table for all networks, VTAM displays the dynamic table if it exists.
If you specify both NETID and CDRM:
1. VTAM displays the ADJSSCP for the specified CDRM in the specified network.
2. If there is no table for the specified CDRM in the specified network, VTAM displays the default table for the specified network.
3. If there is no default table for the specified network, VTAM displays the ADJSSCP table for the specified CDRM in the default network.
4. If there is no table for the specified CDRM, VTAM displays the default table for all networks.
5. If there is no default table for all networks, VTAM displays the dynamic table if it exists.

SCOPE=ONLY

If you specify neither NETID nor CDRM:
1. VTAM displays the default table for all networks.
2. If there is no default table for all networks, VTAM displays the dynamic table if it exists.
If you specify NETID (and not CDRM):
1. VTAM displays the default table for the specified network.
2. If there is no default table for the specified network, VTAM displays the default table for all networks.
3. If there is no default table for all networks, VTAM displays the dynamic table if it exists.
If you specify CDRM (and not NETID):
1. VTAM displays the ADJSSCP table for the specified CDRM in the default network.
2. If there is no table for the specified CDRM in the default network, VTAM displays the default table for all networks.
3. If there is no default table for all networks, VTAM displays the dynamic table if it exists.
If you specify both NETID and CDRM:
1. VTAM displays the ADJSSCP for the specified CDRM in the specified network.
2. If there is no table for the specified CDRM in the specified network, VTAM displays the default table for the specified network.
3. If there is no default table for the specified network, VTAM displays the ADJSSCP table for the specified CDRM in the default network.
4. If there is no table for the specified CDRM, VTAM displays the default table for all networks.
5. If there is no default table for all networks, VTAM displays the dynamic table if it exists.

Resulting display

The resulting display differs depending on the operands specified and the value of VTAM start options. (For example, messages IST1704I and IST1705I are issued only if VTAM is enabled for APPN.)

If you specify the ADJLIST operand, the resulting display shows the appropriate adjacent CDRM list.

If you specify the CDRM or CDRSC operands, the resulting display shows the appropriate adjacent SSCP table. VTAM first searches for a user-defined table that satisfies the command. If a user-defined table is not found and the DYNASSCP start option has been set to YES, the dynamic adjacent SSCP table is displayed.

When DISPLAY ADJSSCPS is issued with the CDRSC operand, VTAM builds an adjacent SSCP table as if the resource were the target of a session initiation request. The table displayed is a combination of learned adjacent SSCPs which have been saved for the CDRSC and the appropriate user-defined or dynamic adjacent SSCP table. VTAM displays this table without invoking the session management exit routine for adjacent SSCP selection.

See the z/OS Communications Server: SNA Network Implementation Guide for more information about dynamically defined adjacent SSCP tables.

Examples

Examples of the DISPLAY ADJSSCPS command are presented in a scenario because the output of the command depends on the situation. All of these examples assume that the SORDER start option is currently set to SORDER=ADJSSCP and that the SSCPORD start option is currently set to SSCPORD=PRIORITY.

Suppose that no adjacent SSCP tables are defined and no LU-LU sessions exist, but a dynamic table was created when an SSCP-SSCP session was established with SSCP2A. To display the dynamically created table, issue:

d net,adjsscps (with any other operands except CDRSC or ADJLIST)
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE
IST623I DYNAMIC ADJACENT SSCP TABLE
IST1705I SORDER = ADJSSCP FROM START OPTION
IST1705I SSCPORD = PRIORITY FROM START OPTION
IST624I   SSCP2A
IST1454I 1 RESOURCE(S) DISPLAYED
IST314I END

Later you establish an LU-LU session with APPL2 in SSCP2A. To display the dynamically created, session-specific adjacent SSCP table, issue:

d net,adjsscps,cdrsc=appl2
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE
IST611I ADJACENT SSCP TABLE FOR APPL2 IN NETA
IST1705I SORDER = ADJSSCP FROM START OPTION
IST1705I SSCPORD = PRIORITY FROM START OPTION
IST1220I  SSCPNAME NETID    CURRENT STATE ROUTING STATUS
IST624I   SSCP2A   NETA     ACTIV         SUCCESS
IST1454I 1 RESOURCE(S) DISPLAYED
IST314I END

Next you activate the following user-defined ADJSSCP table:

************************************************************
*                                                          *
*  ADJSSCP Tables - Assumes SORDER=ADJSSCP Start Option    *
*                   and SSCPORD=PRIORITY Start Option      *
************************************************************
ADJSSCP  VBUILD  TYPE=ADJSSCP              
* Default table for all networks           
DEFAULT  NETWORK SORDER=APPNFRST           
SSCP1A   ADJCDRM                           
SSCP2A   ADJCDRM                           
SSCP7B   ADJCDRM                           
SSCP9C   ADJCDRM                           
* CDRM SSCP2A table for all networks       
SSCP2A   CDRM    SSCPORD=PRIORITY          
SSCP2A   ADJCDRM                           
SSCP1A   ADJCDRM                           
* Default table for network NETA           
NETA     NETWORK NETID=NETA,SORDER=APPNFRST,SSCPORD=DEFINED
SSCP1A   ADJCDRM                           
SSCP2A   ADJCDRM                           
* CDRM SSCP2A table for network NETA       
SSCP2A   CDRM    SSCPORD=STARTOPT          
SSCP2A   ADJCDRM                           
SSCP1A   ADJCDRM                           
* Default table for network NETB           
NETB     NETWORK NETID=NETB                
SSCP7B   ADJCDRM                               
* Default table for network NETC               
NETC     NETWORK NETID=NETC                    
SSCP9C   ADJCDRM                               
* Define adjacent lists for NETA, NETB and NETC
LISTA    ADJLIST                               
SSCP1A   ADJCDRM                               
SSCP2A   ADJCDRM                               
LISTB    ADJLIST                               
SSCP7B   ADJCDRM                               
LISTC    ADJLIST                               
SSCP9C   ADJCDRM

To display the new, dynamically created, session-specific adjacent SSCP table for the same resource as above, issue:

d net,adjsscps,cdrsc=appl2
IST097I DISPLAY ACCEPTED                                 
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE               
IST611I ADJACENT SSCP TABLE FOR APPL2 IN NETA            
IST1704I SORDER = APPNFRST FROM ADJACENT SSCP TABLE      
IST1705I SSCPORD = PRIORITY FROM START OPTION
IST1220I  SSCPNAME NETID    CURRENT STATE  ROUTING STATUS
IST624I   ISTAPNCP NETA     ACTIV          ***NA**       
IST624I   SSCP2A   NETA     ACTIV          SUCCESS       
IST624I   SSCP1A   NETA     ACTIV          ***NA**       
IST1454I 3 RESOURCE(S) DISPLAYED                         
IST314I END

To display the user-defined, default ADJSSCP table for all networks, issue:

d net,adjsscps
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE
IST623I DEFAULT ADJACENT SSCP TABLE
IST1704I SORDER = APPNFRST FROM ADJACENT SSCP TABLE
IST1705I SSCPORD = PRIORITY FROM START OPTION
IST624I   SSCP1A                                   
IST624I   SSCP2A                                   
IST624I   SSCP7B                                   
IST624I   SSCP9C                                   
IST1454I 4 RESOURCE(S) DISPLAYED                   
IST314I END

To display the dynamic ADJSSCP table for a model CDRSC, issue:

d net,adjsscps,cdrsc=applb*
IST097I DISPLAY ACCEPTED                         
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE       
IST611I ADJACENT SSCP TABLE FOR APPLB* IN NETB           
IST1705I SORDER = APPN FROM START OPTION                  
IST1705I SSCPORD = PRIORITY FROM START OPTION             
IST1220I  SSCPNAME NETID    CURRENT STATE  ROUTING STATUS 
IST624I   SSCP7B   NETB     NEVAC          ***NA**        
IST624I   ISTAPNCP NETA     ACTIV          ***NA**        
IST1454I 2 RESOURCE(S) DISPLAYED                          
IST314I END

To display the user-defined table for a specific CDRM in the default ADJSSCP table for all networks, issue:

d net,adjsscps,cdrm=sscp2a
IST097I DISPLAY ACCEPTED                           
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE         
IST611I ADJACENT SSCP TABLE FOR SSCP2A             
IST1704I SORDER = APPNFRST FROM ADJACENT SSCP TABLE
IST1704I SSCPORD = PRIORITY FROM ADJACENT SSCP TABLE
IST624I   SSCP2A                                   
IST624I   SSCP1A                                   
IST1454I 2 RESOURCE(S) DISPLAYED                   
IST314I END

To display the user-defined table for a specific CDRM in a specific network, issue:

d net,adjsscps,cdrm=sscp2a,netid=neta
IST097I DISPLAY ACCEPTED                           
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE         
IST611I ADJACENT SSCP TABLE FOR SSCP2A IN NETA     
IST1704I SORDER = APPNFRST FROM ADJACENT SSCP TABLE
IST1705I SSCPORD = PRIORITY FROM START OPTION      
IST624I   SSCP2A                                   
IST624I   SSCP1A                                   
IST1454I 2 RESOURCE(S) DISPLAYED                   
IST314I END

To display all user-defined ADJSSCP tables for a specific CDRM in all networks, issue:

d net,adjsscps,cdrm=sscp2a,scope=all
IST097I DISPLAY ACCEPTED                           
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE         
IST611I ADJACENT SSCP TABLE FOR SSCP2A IN NETA     
IST1704I SORDER = APPNFRST FROM ADJACENT SSCP TABLE
IST1705I SSCPORD = PRIORITY FROM START OPTION
IST624I   SSCP2A                                   
IST624I   SSCP1A                                   
IST611I ADJACENT SSCP TABLE FOR SSCP2A             
IST1704I SORDER = APPNFRST FROM ADJACENT SSCP TABLE
IST1705I SSCPORD = PRIORITY FROM ADJACENT SSCP TABLE
IST624I   SSCP2A                                   
IST624I   SSCP1A                                   
IST1454I 4 RESOURCE(S) DISPLAYED                   
IST314I END

Displaying a user-defined adjacent CDRM list (ADJLIST) by name:

d net,adjsscps,adjlist=lista
IST097I DISPLAY ACCEPTED                  
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE
IST1333I ADJLIST = LISTA                  
IST624I   SSCP1A                          
IST624I   SSCP2A                          
IST1454I 2 RESOURCE(S) DISPLAYED          
IST314I END

Displaying the session-specific adjacent SSCP table for a resource that specifies an adjacent CDRM list (ADJLIST):

d net,adjsscps,cdrsc=appl22
IST097I DISPLAY ACCEPTED                                 
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE               
IST611I ADJACENT SSCP TABLE FOR APPL22 IN NETA           
IST1704I SORDER = ADJLIST FROM ADJACENT SSCP TABLE
IST1704I SSCPORD = ADJLIST FROM ADJACENT SSCP TABLE      
IST1220I  SSCPNAME NETID    CURRENT STATE  ROUTING STATUS
IST624I   SSCP1A   NETA     ACTIV          ***NA**       
IST624I   SSCP2A   NETA     ACTIV          ***NA**       
IST1454I 2 RESOURCE(S) DISPLAYED                         
IST314I END

Displaying all user-defined adjacent CDRM lists (ADJLISTs):

d net,adjsscps,adjlist=*
IST097I DISPLAY ACCEPTED                  
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE
IST1333I ADJLIST = LISTC                  
IST624I   SSCP9C                          
IST1333I ADJLIST = LISTB                  
IST624I   SSCP7B                          
IST1333I ADJLIST = LISTA                  
IST624I   SSCP1A                          
IST624I   SSCP2A                          
IST1454I 4 RESOURCE(S) DISPLAYED          
IST314I END

Displaying all user-defined ADJSSCP tables:

d net,adjsscps,scope=all
IST097I DISPLAY ACCEPTED                           
IST350I DISPLAY TYPE = ADJACENT SSCP TABLE         
IST623I DEFAULT ADJACENT SSCP TABLE FOR NETC       
IST1705I SORDER = ADJSSCP FROM START OPTION        
IST1705I SSCPORD = PRIORITY FROM START OPTION
IST624I   SSCP9C                                   
IST623I DEFAULT ADJACENT SSCP TABLE FOR NETB       
IST1705I SORDER = ADJSSCP FROM START OPTION        
IST1705I SSCPORD = PRIORITY FROM START OPTION
IST624I   SSCP7B                                   
IST611I ADJACENT SSCP TABLE FOR SSCP2A IN NETA     
IST1704I SORDER = APPNFRST FROM ADJACENT SSCP TABLE
IST1705I SSCPORD = PRIORITY FROM START OPTION
IST624I   SSCP2A                                   
IST624I   SSCP1A                                   
IST623I DEFAULT ADJACENT SSCP TABLE FOR NETA       
IST1704I SORDER = APPNFRST FROM ADJACENT SSCP TABLE
IST1704I SSCPORD = DEFINED FROM ADJACENT SSCP TABLE
IST624I   SSCP1A                                   
IST624I   SSCP2A                                   
IST611I ADJACENT SSCP TABLE FOR SSCP2A             
IST1704I SORDER = APPNFRST FROM ADJACENT SSCP TABLE
IST1704I SSCPORD = PRIORITY FROM ADJACENT SSCP TABLE
IST624I   SSCP2A                                   
IST624I   SSCP1A                                   
IST623I DEFAULT ADJACENT SSCP TABLE                
IST1704I SORDER = APPNFRST FROM ADJACENT SSCP TABLE
IST1705I SSCPORD = PRIORITY FROM START OPTION
IST624I   SSCP1A                                   
IST624I   SSCP2A                                   
IST624I   SSCP7B                                   
IST624I   SSCP9C                                   
IST1454I 11 RESOURCE(S) DISPLAYED                  
IST314I END