Explanation: ABEND, LOG, OFF, and SNAP are mutually exclusive, optional parameters specifying what DFSMShsm should do and how many times it should do it when the specified error occurs in the specified module.

ABEND specifies that DFSMShsm abnormally ends the task when the specified error condition occurs in the specified module. DFSMShsm abnormally ends the task by issuing an ABEND macro. DFSMShsm almost always tries to restart the task that abnormally ended. During the abnormal end, DFSMShsm produces an abnormal end dump.

LOG specifies that you want DFSMShsm to write an entry in the DFSMShsm log when the specified error condition occurs in the specified module. TRAP LOG avoids DFSMShsm shutdown because the errors do not increment the counter for the maximum number of occurrences. That is, TRAP LOG logs the errors but does not count them.

OFF specifies that you want DFSMShsm to remove a trap that you specified with a previous TRAP command. For example, you specified TRAP ARCGODS 13 SNAP(ONCE), causing DFSMShsm to produce a snap dump the first time error condition 13 occurs in module ARCGODS. To prevent DFSMShsm from further checking for that error condition, you specify TRAP ARCGODS 13 OFF. This command returns DFSMShsm to the process level that IBM® previously specified for just SNAP. See ARCGODS in Diagnosing from return codes and reason codes.

SNAP specifies that you want DFSMShsm to produce a snap dump when the specified error condition occurs in the specified module. DFSMShsm produces a snap dump by issuing a SNAP macro. If you specify the SYS1DUMP parameter of the SETSYS command, the dump is written to a system dump data set. When a TRAP occurs, DFSMShsm produces a snap dump directed to the SYSOUT class specified in the SETSYS SYSOUT command. DFSMShsm continues processing after producing a snap dump.

Abbreviations: None.

Defaults: If you do not specify ABEND, LOG, OFF, or SNAP, the default is SNAP. If you do not specify ALWAYS, NEVER, or ONCE, the default is ONCE.