Protecting Facilities › Facility Matrix Table Administration › Change a Facility’s Definition

Change a Facility’s Definition

Overridden defaults revert to the ones listed in the Parameter File when CA Top Secret is restarted after a shutdown.

To temporarily change the values in the Facility Matrix Table, enter the command:

TSS MODIFY(FACILITY(suboption=operand=value))

Suboption

The name of the facility whose defaults are being changed.

Operand

An operand of the FACILITY control option (like MODE).

value

A value for the operand, if it has one (like WARN for MODE).

Examples: temporary facility changes

This example temporarily changes the mode value for the BATCH facility from FAIL to WARN:

TSS MODIFY(FACILITY(BATCH=MODE=WARN))

This example temporarily prevents users from signing on to the CICSTEST facility:

TSS MODIFY(FACILITY(CICSTEST=INACTIVE))

To change the values in the Facility Matrix Table permanently, enter the command:

FACILITY(facility‑name=suboption=value,suboption=value,...)

If the string of sub-options and values will not fit on one line, use multiple lines:

FACILITY(TSO=MODE=IMPL,LOG=(ALL))

FACILITY(TSO=LOCKTIME=5)

FACILITY(TSO=NOLUMSG,RNDPW)

Facility sub-options override global control options of the same name.

Examples: permanent facility changes

This example permanently changes the mode value for the BATCH facility from FAIL to WARN. Enter the following command in the CA Top Secret Parameter file:

FACILITY(BATCH=MODE=WARN)

This example permanently prevents user type ACIDs from receiving last used messages at sign on. Enter the following command in the CA Top Secret Parameter file:

FACILITY(CICSTEST=NOLUMSG)

Change a Facility’s Name

To change a facility’s name permanently, use the FACILITY control option and the NAME sub-option.

Examples: change a facility's name

This example changes the name of the USER4 facility to CICSA:

FACILITY(USER4=NAME=CICSA)

If the name of a facility is changed, all subsequent control option entries that impact the newly named facility must contain the new facility name.

This example changes the name of USER4 to CICSA and force CICSA to process in WARN mode:

FACILITY(USER4=NAME=CICSA)

FACILITY(CICSA=MODE=WARN)

This example will not affect the mode of the newly named facility. It produces an error message because the referenced facility no longer exists:

FACILITY(USER4=NAME=CICSUSER)

Control option changes made before a facility is renamed remain in effect for the newly named facility.

In this example the newly named CICSA facility processes security in WARN mode and has the NOABEND attribute. Additional changes must be made to CICSA, not USER4:

FACILITY(USER4=MODE=WARN)

FACILITY(USER4=NOABEND)

FACILITY(USER4=NAME=CICSA)