Adjacent cluster routing definitions

The adjacent cluster (ADJCLUST) routing list allows you to define which adjacent APPN subnetworks VTAM® should search. For each destination network, you can define a table that specifies the control point (CP) name of the adjacent nodes to which the search is sent.

Each routing list contains one or more network identifiers, followed by the CPNAMEs of the nodes that should be searched when VTAM receives a request to search for a resource with that network identifier. Coding a NETWORK statement without a NETID value creates a default routing list. The operands coded on the default list are used for all NETIDs that do not have an explicitly coded NETID list.

Figure 1 contains the following three routing lists:

A default routing list to be used when one of the following conditions is met.
- A non-network qualified request is received.
- A network qualified request is received and the NETID specified is not defined in any NETWORK statement.
A list (NETAC) to be used when NETA or NETC is the network identifier specified on a request.
A list (NETZ) to be used when NETZ is the network identifier and nodes are to be omitted.

Figure 1. Adjacent cluster routing definitions

ADJCLUST VBUILD    TYPE=ADJCLUST
*********************************************************************
* Default network ID                                                *
*********************************************************************
DEFAULT  NETWORK   SNVC=4,                allow depth of 4 networks   x
                   BNDYN=LIMITED          allow limited dynamics
NODE2A   NEXTCP    CPNAME=NETA.NODE2A     route to NODE2A
NODE2B   NEXTCP    CPNAME=NETB.NODE2B     route to NODE2B
*********************************************************************
* Routing for NETID=NETA and NETID=NETC                             *
*********************************************************************
NETAC    NETWORK   NETID=(NETA,NETC),                                 x
                   BNDYN=NONE,            do not allow dynamics       x
                   BNORD=DEFINED          use defined routing         x
                   SNVC=4                 allow depth of 4 subnets    x
NODE2A   NEXTCP    CPNAME=NETA.NODE2A     route to NODE2A
NODE2C   NEXTCP    CPNAME=NETC.NODE2C     route to NODE2C
*********************************************************************
* Routing for NETID=NETZ with OMITTED nodes                         *
*********************************************************************
NETZ     NETWORK    NETID=(NETZ),                                     x
                    BNDYN=FULL,           allow full dynamics         x
                    BNORD=PRIORITY,       use priority routing        x
                    SNVC=4                allow depth of 4 subnets     
NODE2A   NEXTCP     CPNAME=NETA.NODE2A,                               x
                    OMITCP=YES            do not route to NODE2A       
NODE2C   NEXTCP     CPNAME=NETC.NODE2C,   route to NODE2C             x
                    OMITCP=YES            do not route to NODE2C

Table 1. Definition statements for ADJCLUST table
Name	Definition statement	Operands	Page	Req	Sift effect	Default	Restrictions, dependencies
name	VBUILD	TYPE=ADJCLUST	TYPE	R			BN=YES

name	NETWORK	BNDYN	BNDYN			BNDYN start option value
		NETID	NETID
		BNORD	BNORD			BNORD start option value

name	NEXTCP	CPNAME	CPNAME			This node's cpname
		SNVC	SNVC		N	SNVC start option
		OMITCP	OMITCP			NO
Legend: R Required operand. N Code this operand on the higher-level NETWORK definition statement to take advantage of the sift effect, or code it on this definition statement.