DISPLAY ADJCLUST command

Read syntax diagramSkip visual syntax diagram
>>-DISPLAY-- --NET--,--ADJCLUST--+--------------------+--------->
                                 '-,--NETID--=--netid-'   

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

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 ADJCLUST (adjacent cluster table) command displays the adjacent cluster (routing) tables and their entries in the order to be used for APPN searches. The entries in the tables include all user-defined entries, along with any dynamic entries that have been added, based on the current value of the BNDYN start option.

Note: The order of the entries for a search can be affected by APPN directory entries and the directory services management exit.

Operands

NETID=netid
Specifies the destination network for the adjacent cluster table to be displayed.
SCOPE
Determines the range of adjacent cluster tables to be displayed.
SCOPE=ALL
Specifies that all adjacent cluster tables are to be displayed. This option is ignored if the NETID operand is specified.
SCOPE=ONLY
  • If the NETID operand is specified, VTAM® displays adjacent cluster definitions that match the destination network.
  • If the NETID operand is not specified, VTAM displays adjacent cluster definitions for the default destination network.

Resulting display

The resulting display shows whether the table is a user-defined, default, or dynamically built table, the level of dynamics used for the table, and the status of each entry. Defined entries are displayed regardless of their status. If a defined entry is displayed as inactive, it will not be included in a search. Dynamic entries are displayed only if they are active.
  • A user-defined table indicates that adjacent cluster definition statements exist for the specified NETID.
  • A default routing table is used when no defined entries exist for the specified NETID, but a default table has been coded. A default table indicates how to route requests when the specified NETID is not defined.
  • A dynamically-built routing table is created when no defined or default routing table exists. This table is created completely from active dynamic routing information.

Examples

Displaying the user-defined adjacent cluster table for a specific network:
d net,adjclust,netid=neta
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT CLUSTER TABLE
IST2207I DEFINED TABLE FOR NETA 
IST2208I BNDYN = LIMITED FROM START OPTION
IST2208I BNORD = PRIORITY FROM START OPTION
IST1326I CP NAME           TYPE    STATE      STATUS       SNVC
IST1327I NETA.BN3          DEFINED ACTIVE     FOUND        003
IST1327I NETA.BN2          DEFINED NOT ACTIVE NOT SEARCHED 003
IST1327I NETA.BN1          DYNAMIC ACTIVE     NOT SEARCHED N/A
IST314I END
Displaying a default adjacent cluster table for a specific network:
d net,adjclust,netid=netb
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT CLUSTER TABLE
IST2207I DEFAULT TABLE FOR NETB           
IST2209I BNDYN = LIMITED FROM ADJCLUST TABLE
IST2208I BNORD = PRIORITY FROM START OPTION
IST1326I CP NAME           TYPE    STATE      STATUS       SNVC
IST1327I NETB.BN4          DEFINED ACTIVE     NOT SEARCHED 004
IST1327I NETB.BN5          DYNAMIC ACTIVE     NOT SEARCHED 003
IST314I END
Displaying a dynamically built adjacent cluster table:
d net,adjclust,netid=netc
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = ADJACENT CLUSTER TABLE
IST2207I DYNAMIC TABLE FOR NETC 
IST2208I BNDYN = LIMITED FROM START OPTION
IST2208I BNORD = PRIORITY FROM START OPTION
IST1326I CP NAME           TYPE    STATE      STATUS       SNVC
IST1327I NETC.BN6          DYNAMIC ACTIVE     FOUND        003
IST314I END