ABEND

Terminate a task abnormally.

Syntax

ABEND

Read syntax diagramSkip visual syntax diagramABENDABCODE( name)CANCELNODUMP

This command is threadsafe.

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations.

Description

The ABEND command terminates a task abnormally.

CICS® releases the main storage that is 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 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 that is 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 that is 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 in z/OS Language Environment Customization.

Options

ABCODE(name)
This option specifies that main storage that is 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
This option 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
This option 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')