Command Propagation Facility › CA Top Secret Command Keywords Used With CPF › What Happens When a Command is Issued

What Happens When a Command is Issued

To get a better understanding of how the CPF control options and CPF command keywords work together, consider the consequences of the following sample commands:

TSS ADDTO(USER01) DSNAME(ABC123)

Since no TARGET was specified, CA Top Secret looks to the CPFTARGET control option setting to determine the designated default routing procedure:

• If CPFTARGET is set to AUTO, the command will propagate to those nodes identified by the ACID's DEFNODES.
• If CPFTARGET is set to LOCAL, the command will only execute on the local node.
• If CPFTARGET is set to *, the command will propagate to all nodes identified by the CPFNODES control option, except for nodes identified as no‑broadcast nodes.
• If CPFTARGET hasn't been activated, the command will only execute on the local node.

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

In this case, USER01 is being granted ownership of the ABC123 data set. Since a TARGET of * was specified, this command is propagated to all nodes identified by the CPFNODES control option.

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

In this case, the same command will only be executed on the local node (as specified by the =).

TSS ADDTO(USER01) DSNAME(ABC123) TARGET(NODEA,NODEB)

Here the command is propagated to NODEA and NODEB regardless of the values specified by the CFPNODES or CPFTARGET control options and any DEFNODES USER01 may have. An explicit TARGET will override the defaults.

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

This command is propagated to all broadcast nodes and any no‑broadcast nodes that are identified as DEFNODES for USER01.