Keywords › TARGET Keyword—Node Assignment

TARGET Keyword—Node Assignment

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

Use the TARGET keyword to:

• Specify which CA Top Secret nodes receive commands and how the local node processes it
• Assign nodes associated with ACIDs

TARGET overrides the CPFTARGET control option which sets up default routing instructions for the entire installation. In the event CPF is active and a command is issued without specifying a TARGET, CA Top Secret propagates the command according to the instructions set by CPFTARGET. If CPFTARGET is set to AUTO, the command is routed based on the DEFNODE keyword.

Note: When administering commands against a user‑defined resource class, the resource class must be defined on the sending node or the node where the resource class was defined.

This keyword has the following format:

TSS ADDTO(acid) keyword(s)
                TARGET(node,node,...)

TSS LIST(ACID) TARGET(*|LOCAL|nodename)

TARGET(node1,node2...)

Identifies each node to which a command can be propagated.

TARGET(*)

Transmits the command to the local node and to all nodes defined in the CPFNODES control option.

TARGET(=)

Restricts command execution to the local node only. The TARGET(=) keyword overrides the CPFTARGET(*) control option.

TARGET(n...n*)

Transmits all commands to nodes whose names begin with the indicated string. The string can range from one to seven characters.

Note: If a command is issued against USER01 and CPFTARGET is set to AUTO and TARGET was not specified on the command, the command will automatically be propagated to the NYC, CHI and DET nodes. If 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 keyword is used with:

• The commands CREATE, ADDTO, REMOVE, PERMIT, REVOKE, REPLACE, RENAME, ADMIN, DEADMIN, WHOOWNS, WHOHAS, MOVE, LIST, and DELETE
• The ACID types User, DCA, VCA, ZCA, LSCA, SCA, and MSCA
• MISC2(TARGET) authority

Examples: TARGET keyword

This example adds data sets beginning with SYS1. to the Accounting Department and transmit them to all nodes whose names start with R:

TSS ADDTO(ACCDPT) DSNAME(SYS1.)
                  TARGET(R*)
                  WAIT(Y)

This example removes the data sets the administrator enters:

TSS REMOVE(ACCDPT) DSNAME(SYS1.)
                   TARGET(R*)
                   WAIT(Y)

This example grants USER01 ownership of the ABC123 data set, propagates to the local node and all nodes defined in the CPFNODES control option, because a TARGET of * is specified.

TSS ADDTO(USER01) DSNAME(ABC123)
                  TARGET(*)

This example only executes on the local node (as specified by the =).

TSS ADDTO(USER01) DSNAME(ABC123)
                  TARGET(=)

The example displays the users on CPU1, CPU2, and the local node that have access to payroll data:

TSS WHOHAS DSNAME(PAYROLL.)
           TARGET(CPU1,CPU2)
           WAIT(Y)

This example grants ownership of the SYS1 data set prefix to DEPT01 on all remote R‑prefixed nodes identified by the CPFNODES control option:

TSS ADDTO(DEPT01) DSNAME(SYS1.)
                  TARGET(R*)
                  WAIT(Y)

This example displays the users on CPU1, CPU2 and the local node that have access to the PAYROLL data set prefix:

TSS WHOHAS DSNAME(PAYROLL.)TARGET(CPU1,CPU2)
           WAIT(Y)