cdrmname

Read syntax diagramSkip visual syntax diagram
>>-cdrmname----------------------------------------------------><

The name of an adjacent SSCP as known to VTAM®. It must be the same as the name on the CDRM definition statement that defines the SSCP to VTAM.

Each ADJCDRM definition statement should have a unique cdrmname. Otherwise, an error message is issued. Furthermore, in an SNA interconnected network, the CDRM names must be unique among SSCPs that participate in cross-network sessions.

The following rules apply to the placement of the ADJCDRM definition statement within the adjacent SSCP table definition:
  • The ADJCDRM definition statement can be followed by an ADJCDRM, ADJLIST, CDRM, or NETWORK definition statement (or nothing, if it is the end of the table).
  • If an ADJCDRM definition statement immediately follows a NETWORK definition statement, it is the default adjacent SSCP table for the specified network.
  • If an ADJCDRM definition statement immediately follows the VBUILD definition statement or a NETWORK definition statement without NETID specified, it is the default adjacent SSCP table for all networks.

You can specify ISTAPNCP, instead of an SSCP name, for cdrmname. ISTAPNCP is a generic representation for an APPN CDRM. It can provide you with additional control over the order in which the network is searched.

If you code the SORDER=ADJSSCP start option and code ISTAPNCP in any or all of the user-defined adjacent SSCP tables, VTAM does not search the APPN network until it encounters ISTAPNCP in the adjacent SSCP table.

That is, if you code ISTAPNCP as the fourth CDRM in the user-defined adjacent SSCP table, VTAM does not search the APPN network until after it has searched unsuccessfully in the first three CDRMs in the table. If you code ISTAPNCP first in the adjacent SSCP table, VTAM searches the APPN network immediately.
Note:
  1. If SSCPORD=PRIORITY and SORDER=ADJSSCP, and you do not code ISTAPNCP in the user-defined adjacent SSCP table, VTAM does not add ISTAPNCP to the adjacent SSCP routing table, and VTAM does not search the APPN network unless a previous request for this DLU has searched the APPN network. (That is, there is an ISTAPNCP entry in the ISTADSST table queued to the DLU RDTE.)
  2. If you code the SORDER=APPN, SORDER=SUBAREA, or SORDER=APPNFRST start options (or let it default to APPN), VTAM ignores the ISTAPNCP entry in the user-defined adjacent SSCP table, because VTAM places ISTAPNCP in the appropriate place in the adjacent SSCP routing table.
  3. If you code the SSCPORD=PRIORITY start option (or let it default to PRIORITY), and either SORDER=APPNFRST, SORDER=APPN, or SORDER=SUBAREA, VTAM searches the adjacent SSCP table in the following order. ISTAPNCP is added in one of the following places:
    • Before step 3.a, if SORDER=APPNFRST
    • After step 3.b, if SORDER=APPN
    • After step 3.d, if SORDER=SUBAREA
    1. The CDRM that owns the resource (if known)
    2. The SSCPs for which the most recent session-initiation attempt succeeded
    3. The SSCPs for which no session-initiation attempt has been made
    4. The SSCPs for which the last session-initiation attempt failed.
  4. If you code the SSCPORD=DEFINED start option, VTAM searches the adjacent SSCP table in the same order that SSCPs are listed, with the exception that the CDRM that owns the resource (if known) is searched first.