Batch Utility › Command Syntax › Option Arguments for the OPT Command Keyword

Option Arguments for the OPT Command Keyword

The valid arguments for the OPT command are as follows:

ALL

Displays the current settings of all options from SymDump for CICS.

For example:

OPT ALL

SUPPRESSA

Suppresses AP0001 dumps. Specify whether full AP0001 SVC dumps should be suppressed for the ASRA and ASRB abends. If you specify N, dumps conform to the specifications defined for your CICS system.

For example:

OPT SUPPRESSA Y
OPT SUPPRESSA N

SUPPRESSC

Suppresses CICS transaction dumps. Specify if a transaction dump should be written to the CICS dump data set.

For example:

OPT SUPPRESSC Y
OPT SUPPRESSC N

PURGE

Purges dumps automatically. Specify if automatic purging of dumps should occur during startup of CA SymDump for CICS. Qualification for purging is determined by age (number of days to hold dumps), or the HOLD indicator set on the Selection List menu.

For example:

OPT PURGE Y
OPT PURGE N

MESSAGES

Messages to the operator. Specify if informational messages should be written to the console when CA SymDump for CICS intercepts dump or trace requests.

For example:

OPT MESSAGES Y
OPT MESSAGES N

CAPTUREX

Captures EXEC CICS dumps. Specify if transaction dumps produced by EXEC CICS DUMP commands should be captured by CA SymDump.

For example:

OPT CAPTUREX Y
OPT CAPTUREX N

DUMPCURR

Dumps only the current program. Specify if the dump should include just the active program or all linked and loaded programs.

For example:

OPT DUMPCURR Y
OPT DUMPCURR N

DYNAPURGE

Dynamic purge of dumps. Specify if dynamic purging of dumps should occur during dump capture for non-held dumps on a FIFO basis. Dynamic purging occurs only when space to hold the dump being captured is inadequate; dynamic purging deletes only enough dumps to make space for the new dump. HOLD days are ignored for dynamic purge.

For example:

OPT DYNAPURGE Y
OPT DYNAPURGE N

PREVABEND

Use Prev Abend code. Specify if the original abend code is presented when a Handle Abend command is issued. The Handle Abend routine usually issues an EXEC CICS Abend or Dump command which masks the original problem. A 'Y' in this option causes the original dump to be formatted. In order to set PREVABEND to 'Y', the CAPTUREX parameter must also be set to 'Y'.

For example:

OPT PREVABEND Y
OPT PREVABEND N

HOLD

Number of days to hold dumps. Specify the number of days non-held dumps are retained.

For example:

OPT HOLD 20

SELECT

Dumps select start date. Specify the date that dump selection starts.

For example:

OPT SELECT CURRDATE
OPT SELECT 01/01/2007

SUPPRESSD

Suppresses duplicate transaction dumps. Specify if duplicate dump suppression is in effect. A dump is considered a duplicate when an abend has a matching program/offset with a previously captured dump.

For example:

OPT SUPPRESSD Y
OPT SUPPRESSD N

SUPPRESSL

Duplicates dump suppression limit. Specify the maximum number of duplicate dumps captured for a given occurrence of program/offset. This parameter is recognized only when SUPPRESSD=Y is also specified.

For example:

OPT SUPPRESSL 158

EXCLUDE ADD

Causes the specified abend code to be added to the exclusion list to prevent dumps from being created for this type of abend.

For example:

EXCLUDE ADD ASRA

EXCLUDE DEL

Causes the specified abend code to be removed from the exclusion list to allow dumps to be created for this type of abend.

For example:

EXCLUDE DEL ASRA