Terminate a task abnormally.
ABEND
>>-ABEND--+--------------+--+--------+--+--------+-------------><
'-ABCODE(name)-' '-CANCEL-' '-NODUMP-'
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')