Specific Control Options › CPF—Activate Command Propagation Facility at Startup

CPF—Activate Command Propagation Facility at Startup

Valid on z/OS and z/VM.

Use the CPF control option to specify whether the Command Propagation Facility (CPF) of CA Top Secret is activated at startup.

At least one of the CPF‑related control options must be entered at CA Top Secret startup to use the CPF. If not, CPF might not be activated until the next CA Top Secret startup and no CPF control options are honored by CA Top Secret until that time.

All entry methods are accepted.

This control option has the following format:

CPF(ON|OFF|KILL|REFRESH|INACTIVE)

ON

Specifies that CPF modules are to be loaded into memory, and that the CPF subtask is initiated. NDT CPFNODE definitions override the CPFNODES control option definitions. Prior to encountering CPF(ON), STATUS(CPF) displays CPF(INACTIVE), indicating that CPF modules have not been loaded.

If CPF(ON) is specified, but CCI is not available or not fully initialized, CPF status is displayed as CPF(INIT). While CPF is in this status, commands are not propagated through CPF and are not logged to the CPF recovery file. Once CCI completes its initialization, CPF status displays as CPF(ON) and command propagation logging takes place.

OFF

Specifies that no TSS commands are transmitted by this node or received from other nodes until the operator sets CPF(ON) with the TSS MODIFY command (if any CPF‑related control option was entered), or at the next startup of CA Top Secret.

KILL

Terminates the CPF subtask and produces a dump. Once the subtask has been killed, it can later be reactivated using TSS MODIFY(CPF(ON)). CPF(KILL) produces an SVC dump via abend S33E. If a dump is desired, be certain to disable any active SLIP commands set to suppress S33E abend dumps.

REFRESH

Internally issues CPF(OFF) followed by CPF(ON). During the internal shutdown, the STATUS(CPF) will show CPF(OFF). When CPF is restarted, any changes to the NDT CPFNODE definitions override previous control option settings. Any commands queued in storage are released during shutdown and are rebuilt from the recovery file at startup. Commands and password changes already on the recovery file prior to shutdown are executed verbatim, regardless of NDT changes implemented at startup.

INACTIVE

(Default) Although this value cannot be used in a command, it may be displayed in STATUS(CPF) to indicate that CPF has not been activated.