ABEND

Terminate a task abnormally.

ABEND

Read syntax diagramSkip visual syntax diagramABENDABCODE( name)CANCELNODUMP

This command is threadsafe.

Description

The ABEND command terminates a task abnormally.

CICS® releases the main storage associated with the terminated task; optionally, you can obtain a transaction dump of this storage.

Invoking the ABEND command causes the current transaction to abend. The Language Environment® is informed that an abend has occurred and the following message is written out to CEEMSG followed by a dump report:
CEE3250C The system or user abend XXXX was issued
XXXX is the transaction dump code specified on the ABCODE option. The Language Environment attempts to access register addresses to dump out the referenced storage as part of the dump report written to CEEMSG. If the Language Environment does not have access to the storage addressed by these registers, an 0C4 abend can occur. You can eliminate 0C4 abends by setting the Language Environment runtime option TERMTHDACT to QUIET, MSG, or UAONLY. For more information, see TERMTHDACT.

Options

ABCODE(name)
Specifies that main storage related to the terminating task is dumped. The ABCODE is used as a transaction dump code to identify the dump. ABCODE follows the format rules for DUMPCODE. The DUMP TRANSACTION command gives the format rules that apply to DUMPCODE, if these rules are not followed, ABEND does not produce a dump.

Do not start the name with the letter A, because this is reserved for CICS itself.

Note: If ABCODE is not used, the effect is the same as NODUMP.
CANCEL
Specifies that exits established by HANDLE ABEND commands are ignored. An ABEND CANCEL command cancels all exits at any level in the task and terminates the task abnormally. If the PL/I STAE execution-time option is specified, an abnormal termination exit is established by PL/I. This exit is revoked by the CANCEL option.
NODUMP
Specifies that an abend occurs without causing a dump to be taken. For programs link-edited using the Language Environment SCEELKED library, when NODUMP is specified, a dump is never taken, regardless of any setting in the transaction dump table. For programs not link-edited with Language Environment, if the transaction dump table already has an entry for the abend code, or if the abend is in Language Environment run-unit initialization or termination, the NODUMP option is ignored.

Examples

The following example shows how to terminate a task abnormally: 
EXEC CICS ABEND ABCODE('BCDE')