Keywords › DEFNODES Keyword—Default Remote Nodes

DEFNODES Keyword—Default Remote Nodes

Valid on z/OS, z/VSE, and z/VM.

Use the DEFNODES keyword to maintain a list of default routing nodes for an individual ACID. The list is consulted when:

• The CPFTARGET control option is set to AUTO and no TARGET is specified when the command is issued
• The CPFTARGET control option is set to * and TARGET(SELECT) is specified when the command is issued

The DEFNODES keyword is only used when the list itself is being designated (through the initial TSS CREATE for the ACID or through a subsequent TSS ADDTO) or updated. Otherwise, the list is consulted by default when both of the above conditions apply.

If CPFTARGET is set to AUTO and no TARGET is specified but the ACID has no DEFNODES, the command propagates to those nodes identified by the CPFNODES control option.

The DEFNODES list can be assigned to an ACID from the initial CREATE statement or it can be added later.

To display a user's DEFNODES, specify TSS LIST DATA(DEFNODES).

This keyword has the following format:

TSS ADDTO(acid) DEFNODES(oper,oper,...)

You can specify up to five nodes per command.

This keyword is used with:

• The commands ADDTO, CREATE, REMOVE, LIST, and REPLACE
• The ACID types User, Profile, Department, Division, Zone, DCA, VCA, ZCA, LSCA, SCA, and MSCA
• ACID(DEFNODES) authority

Examples: DEFNODES keyword

This example defines the default routing nodes of NYC, CHI and DET for the USER01 ACID:

TSS ADDTO(USER01) DEFNODES(NYC,CHI,DET)

If a command is issued against USER01 and:

• CPFTARGET is set to AUTO and TARGET is specified on the command, the command is propagated to the NYC, CHI, and DET nodes
• CPFTARGET is set to * and TARGET(SELECT) is specified on the command and the CPFNODES control option is CPFNODES(ATL,NYC(NB),CHI(NB),DET(NB)), the command is sent to the NYC, CHI and DET nodes

This example completely removes the list:

TSS REMOVE(USER01) DEFNODES(NYC,CHI,DET)

This example defines a new user for the Accounting Department. The new user requires an initial DEFNODES list that includes New York, Chicago, and Detroit:

TSS CREATE(ACCT01) NAME('ACCT USER')
                   FACILITY(VM,TSO)
                   PASSWORD(xxxx)
                   TYPE(USER)
                   DEFNODES(NYC,CHI,DET)

The administrator has the option of using a Model ACID, which contains all the default access rights and restrictions—including DEFNODES—for all users in the Accounting Department. In this case, specify the USING keyword with the TSS CREATE.

This example adds DEFNODES Baltimore and Atlanta to the user:

TSS ADDTO(USER01) DEFNODES(BAL,ATL)

The list for USER01 now consists of NYC, CHI, DET, BAL, ATL.

This example removes Houston from the list:

TSS REMOVE(USER01) DEFNODES(HOU)

This example completely replaces the current list with a new list consisting of Houston and Boston:

TSS REPLACE(USER01) DEFNODES(HOU,BOS)