Specific Control Options › DIAGTRAP—Produce Diagnostic Dump

DIAGTRAP—Produce Diagnostic Dump

Valid on z/OS.

Use the DIAGTRAP control option to produce a diagnostic dump, based on limitations of ACID, JOBNAME, RESCLASS, and Detailed Reason Code. This is the CA Top Secret equivalent to O/S SLIP.

Use this control option only under the direction of CA Top Secret Support.

All entry methods are accepted.

This control option has the following format:

DIAGTRAP(id,enable_swtich[,trap_type,acid,drc,resclass,job,matchlim])
DIATRAP(id,OFF)
DIAGTRAP(id,DEL)
DIAGTRAP(ALL,DEL)

id

Specify an ID. “All” is also a valid id as long as it is followed by “,Del” to indicate deleting all of the Diagtraps in the table. If no ID is specified while adding an entry, an error message is issued.

Range: 1 to 10

enable_switch

Enable or disable the given id. Valid values are:

• On—Enable the diagtrapid entry.
• Off—Disable the diagtrapid entry while keeping its information.
• Del—Delete the entry.

Note: The enable and the id are the only entries required for turning an ID off.

trap_type

Activates the trap in a particular location. This field must be entered and there is no default. A “)” can be entered any time after the trap to indicate defaults are to be taken for remaining fields. Valid traps are:

• KER—Trap within security kernel (TSSKERNL)
• SFS—CA Top Secret Security File services debugging
• SF1—CA Top Secret Security File services debugging for GETAR.
• SF2—CA Top Secret Security File services debugging for UPDATE

IF SF1 or SF2 is set, SFS is also set.

• DBG—Interactive TSO or console debugging (online)
• DB1—Diagnostic location‑1
• DB2—Diagnostic location‑2

Important! Initially, when an entry is created, the trap_type is a required parameter in the DIAGTRAP syntax.

acid

The ACID entered as a parameter to be matched for producing a dump.

Default: Any User id (*).

drc

The Detailed Reason Code that must be produced to trigger the dump.

Default: Any violation (255).

resclass

Tests the resource class name.

Default: Any (*).

job

Specifies the job name of the job or started task to be monitored. The restrictions on acid, drc, resclass, and job are combined to trigger the DIAGTRAP: all conditions listed must be simultaneously present for the dump to be triggered.

Default: Any (*).

matchlim

Sets the maximum number of dumps to be taken.

Range: 1 to 255

Default: 1