Download as pdf or txt
Download as pdf or txt
You are on page 1of 334

CICS Transaction Server for z/OS

Version 5 Release 4

CICS Codes

IBM
Note
Before using this information and the product it supports, read the information in “Notices” on page
321.

This edition applies to the IBM CICS® Transaction Server for z/OS® Version 5 Release 4 (product number 5655-Y04) and
to all subsequent releases and modifications until otherwise indicated in new editions.
© Copyright International Business Machines Corporation 1974, 2020.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with
IBM Corp.
Contents

About this PDF.......................................................................................................v

Chapter 1. Transaction abend codes...................................................................... 1


AAxx abend codes........................................................................................................................................2
ABxx abend codes..................................................................................................................................... 19
ACxx abend codes......................................................................................................................................40
ADxx abend codes..................................................................................................................................... 76
AExx abend codes......................................................................................................................................98
AFxx abend codes....................................................................................................................................129
AGxx abend code.....................................................................................................................................139
AIxx abend codes.................................................................................................................................... 140
AJxx abend codes....................................................................................................................................163
AKxx abend codes................................................................................................................................... 167
ALxx abend codes....................................................................................................................................174
AMxx abend codes...................................................................................................................................179
ANxx abend codes................................................................................................................................... 183
AOxx abend codes................................................................................................................................... 185
APxx abend codes................................................................................................................................... 185
ARxx abend codes................................................................................................................................... 205
ASxx abend codes................................................................................................................................... 215
ATxx abend codes....................................................................................................................................231
AUxx abend codes................................................................................................................................... 250
AWxx abend codes.................................................................................................................................. 250
AXxx abend codes................................................................................................................................... 260
AZxx abend codes................................................................................................................................... 274

Chapter 2. System abend and dump codes......................................................... 303


CICS system dump codes........................................................................................................................303
DHxx (IMS) abend codes......................................................................................................................... 304
01xx (translator) abend codes................................................................................................................ 304
02xx (DFHPD710) abend codes..............................................................................................................305
03xx (DFHCSDUP) abend codes..............................................................................................................305
04xx (external CICS interface) abend codes.......................................................................................... 309
4xxx LE/370 abend codes....................................................................................................................... 314
CICSPlex SM Abend and dump codes.....................................................................................................314
CICS abend and dump codes.............................................................................................................314
Uxxxx abend codes............................................................................................................................ 316
System dump codes...........................................................................................................................317
CICSPlex SM Abend and dump codes.....................................................................................................317
CICS abend and dump codes.............................................................................................................317
Uxxxx abend codes............................................................................................................................ 319
System dump codes...........................................................................................................................320

Notices..............................................................................................................321

iii
iv
About this PDF
This PDF is a reference of CICS transaction abend codes, and system abend codes. Before CICS TS V5.4,
this information was in the PDF called CICS Messages and Codes, Volume 1.
For details of the terms and notation used in this book, see Conventions and terminology used in the CICS
documentation in IBM Knowledge Center.

Date of this PDF


This PDF was created on April 13th 2020.

© Copyright IBM Corp. 1974, 2020 v


vi CICS TS for z/OS: CICS Codes
Chapter 1. Transaction abend codes
When abnormal conditions occur, CICS can send a message to the CSMT transient data destination that
contains the transaction ID, the program name, and the abend code.
Here is an example:
DFHAC2236: date time applid Transaction tranid abend primary abcode
in program program name term termid backout successful
{ batchid = }batchid. message

Alternatively, the application can intercept abends by including an active EXEC CICS HANDLE ABEND
command. The actual abend code can be determined by issuing the EXEC CICS ASSIGN command with
the ABCODE option.
The transaction identification code tranid usually consists of the 4 characters defined to CICS. However,
when a transaction is initiated by using a light pen, an operator identification (OPID) card reader, or 3270
PA or PF keys (specified in the TASKREQ= operand), CICS creates an internal transaction identification in
the form of a 1-byte 3270 attention identification (AID) code followed by 3 bytes of X'FF'.
The code that may actually appear in the message in place of the internally-created transaction
identification will be *xx*, where xx is the character translation of the 3270 AID code. To prevent
ambiguity, the user should avoid using these codes as transaction identifiers.
The keys, the light pen (LPA), and OPID, and their corresponding printed AID codes are given in the
following list:

PF1 *F1* PF13 *C1* LPA *7E*


PF2 *F2* PF14 *C2* OPID *E6*
PF3 *F3* PF15 *C3* PA1 *6C*
PF4 *F4* PF16 *C4* PA2 *6E*
PF5 *F5* PF17 *C5* PA3 *6B*
PF6 *F6* PF18 *C6*
PF7 *F7* PF19 *C7*
PF8 *F8* PF20 *C8*
PF9 *F9* PF21 *C9*
PF10 *7A* PF22 *4A*
PF11 *7B* PF23 *4B*
PF12 *7C* PF24 *4C*

An abend code indicates the cause of an error that may have been originated by CICS or by a user
program. For most of the abend codes described, a CICS transaction dump is provided at abnormal
termination.
All CICS transaction abend codes abcode are 4-character alphanumeric codes of the form Axxy, where:
A
is the IBM-assigned designation of a CICS transaction abend.
xx
is the 2-character code assigned by CICS to identify the module that detected an error.
y
is the 1-character alphanumeric code assigned by CICS.

© Copyright IBM Corp. 1974, 2020 1


Format of information
For each transaction abend code, the following information is given:
• An explanation of events leading to or following the message.
• The action that has been or will be taken by CICS (system action).
• The action recommended for the user (console or terminal operator).
• The module or modules that can determine that the message should be sent (not necessarily the
module or modules that can issue the macro to write the message.)

AAxx abend codes


AACA DFHALP
AAL2
Explanation
An invalid error code has been passed to the DFHTFP Explanation
or DFHACP programs. Either an incorrect response (other than PURGED) was
returned from the suspend of the allocated task, or an
System action incorrect response was returned from the resume.
CICS terminates the task abnormally with a dump.
System action
User response The transaction is abnormally terminated with a dump.
Notify the system programmer.
User response
Module:
DFHTFP,DFHACP Check the return code from the resume or the suspend
to determine the cause of the error.
AAL1
Module:
Explanation DFHALP

DFHALP was processing a request that deadlocked. AAL3


The most likely reason for the abend is that an
ALLOCATE QUEUE request has been suspended Explanation
because there are no contention-winning links
The task has been purged before a GETMAIN request
available.
to the storage manager (SM) domain was able to
AAL1 is issued for non time-out related deadlocks, for complete successfully. The task that first detected the
instance the task may have been cancelled. purged condition provides an exception trace.
AAL8 is issued for stall purges and deadlock time-
outs. System action
The task is abnormally terminated with a CICS
System action transaction dump.
CICS terminates the task abnormally. A dump is taken.
User response
User response Investigate the reason why the task was purged. It
was purged either by the master terminal operator or
Ensure that there are enough contention-winning
as a result of a deadlock timeout.
sessions available to satisfy the ALLOCATE QUEUE
request. Module:
DFHALP
If you are running with modegroups, ensure that there
are contention-winning sessions available to satisfy AAL4
the ALLOCATE request in that modegroup.
Module:

2 CICS TS for z/OS: CICS Codes


Explanation System action
An error (INVALID, DISASTER or unexpected The task is abnormally terminated with a CICS
EXCEPTION response) has occurred on a call to the transaction dump.
storage manager (SM) domain. The domain that
detected the original error provides an exception User response
trace, a console message, and possibly a system dump
(depending on the options specified in the dump See the related message produced by the domain that
table). detected the original error.
Module:
System action DFHALP
The task is abnormally terminated with a CICS AAL8
transaction dump.
Explanation
User response
DFHALP was processing a request that deadlocked.
See the related message produced by the domain that The most likely reason for the abend is that an
detected the original error. ALLOCATE QUEUE request has been suspended
because there are no contention-winning links
Module:
available.
DFHALP
AAL1 is issued for non time-out related deadlocks.
AAL6
AAL8 is issued for stall purges and deadlock time-
Explanation outs.

An error (INVALID, DISASTER or EXCEPTION


System action
response) has occurred on a call to
SIGNOFF_TERMINAL_USER by DFHALP during sign-off CICS terminates the task abnormally. A transaction or
for a surrogate terminal session running CRTE. The system dump is not taken unless the transaction dump
domain that detected the original error provides an table has been modified for AAL8.
exception trace, a console message and, possibly, a
system dump (depending on the options specified in User response
the dump table).
Ensure that there are enough contention-winning
sessions available to satisfy the ALLOCATE QUEUE
System action
request.
The task is abnormally terminated with a CICS
If you are running with modegroups, ensure that there
transaction dump.
are contention-winning sessions available to satisfy
the ALLOCATE request in that modegroup.
User response
It might be necessary to increase the deadlock
See the related message produced by the domain that timeout (DTIMEOUT) value for the transaction to
detected the original error. prevent this abend from recurring.
Module: If you require a transaction or system dump for this
DFHALP abend then add AAL8 to the transaction dump table.
AAL7 Module:
DFHALP
Explanation
AALA
An error (INVALID, DISASTER or EXCEPTION
response) has occurred on a call to schedule a remote Explanation
terminal delete by DFHALP during sign-off for a
surrogate terminal session running CRTE. The domain An error (INVALID, DISASTER or unexpected
that detected the original error provides an exception EXCEPTION response) has occurred on a call to the
trace, a console message and, possibly, a system Atomservice Manager. The domain that detected the
dump (depending on the options specified in the dump original error provides a trace entry and possibly a
table). system dump (depending on the options specified in
the dump table).

Chapter 1. Transaction abend codes 3


System action Explanation
The task is abnormally terminated with a CICS An error (INVALID, DISASTER or unexpected
transaction dump. EXCEPTION response) has occurred on a call to the log
manager (LM) domain. The domain that detected the
User response original error provides an exception trace, a console
message, and possibly a system dump (depending on
Inform the system programmer. Examine the trace the options specified in the dump table).
and the dump to identify the point of error.
Module: System action
DFHAMW2
The task is abnormally terminated with a CICS
AALB transaction dump.

Explanation User response


An error (INVALID, DISASTER or unexpected See the related message produced by the domain that
EXCEPTION response) has occurred on a call to the detected the original error.
CICS/MQ Connection Manager. The domain that
Module:
detected the original error provides a trace entry and
DFHAMLM
possibly a system dump (depending on the options
specified in the dump table). AALN

System action Explanation


The task is abnormally terminated with a CICS An error (INVALID, DISASTER or unexpected
transaction dump. EXCEPTION response) has occurred on a call to the TD
manager. The domain that detected the original error
User response provides a trace entry and possibly a system dump
(depending on the options specified in the dump
Inform the system programmer. Examine the trace table).
and the dump to identify the point of error.
Module: System action
DFHAMMQ
The task is abnormally terminated with a CICS
AALC transaction dump.

Explanation User response


An error (INVALID, DISASTER or unexpected Inform the system programmer. Examine the trace
EXCEPTION response) has occurred on a call to the and the dump to identify the point of error.
JVMSERVER Resource Manager. The domain that
Module:
detected the original error provides a trace entry and
DFHAMTD
possibly a system dump (depending on the options
specified in the dump table). AALO

System action Explanation


The task is abnormally terminated with a CICS An error (INVALID, DISASTER or unexpected
transaction dump. EXCEPTION response) has occurred on a call to the
CICS/DB2 table manager DFHD2TM. The domain that
User response detected the original error provides a trace entry and
possibly a system dump (depending on the options
Inform the system programmer. Examine the trace specified in the dump table).
and the dump to identify the point of error.
Module: System action
DFHAMSJ
The task is abnormally terminated with a CICS
AALM transaction dump.

4 CICS TS for z/OS: CICS Codes


User response detected the original error provides a trace entry and
possibly a system dump (depending on the options
Inform the system programmer. Examine the trace
specified in the dump table).
and the dump to identify the point of error.
Module: System action
DFHAMD2
The task is abnormally terminated with a CICS
AALP transaction dump.

Explanation User response


An error (INVALID, DISASTER or unexpected Inform the system programmer. Examine the trace
EXCEPTION response) has occurred on a call to the and the dump to identify the point of error.
Program Manager. The domain that detected the
original error provides a trace entry and possibly a Module:
system dump (depending on the options specified in DFHAMBA
the dump table). AALS

System action Explanation


The task is abnormally terminated with a CICS An error (INVALID, DISASTER or unexpected
transaction dump. EXCEPTION response) has occurred on a call to the
Global Enqueue Manager. The domain that detected
User response the original error provides a trace entry and possibly a
system dump (depending on the options specified in
Inform the system programmer. Examine the trace
the dump table).
and the dump to identify the point of error.
Module: System action
DFHAMPG
The task is abnormally terminated with a CICS
AALQ transaction dump.

Explanation User response


An error (INVALID, DISASTER or unexpected Inform the system programmer. Examine the trace
EXCEPTION response) has occurred on a call to the and the dump to identify the point of error.
Business Application Manager. The domain that
detected the original error provides a trace entry and Module:
possibly a system dump (depending on the options DFHAMBA
specified in the dump table). AALT

System action Explanation


The task is abnormally terminated with a CICS An error (INVALID, DISASTER or unexpected
transaction dump. EXCEPTION response) has occurred on a call to the
Internet Inter-Orb Protocol Manager. The domain that
User response detected the original error provides a trace entry and
possibly a system dump (depending on the options
Inform the system programmer. Examine the trace
specified in the dump table).
and the dump to identify the point of error.
Module: System action
DFHAMBA
The task is abnormally terminated with a CICS
AALR transaction dump.

Explanation User response


An error (INVALID, DISASTER or unexpected Inform the system programmer. Examine the trace
EXCEPTION response) has occurred on a call to the and the dump to identify the point of error.
Temporary Storage Manager. The domain that

Chapter 1. Transaction abend codes 5


Module: System action
DFHAMOP
The task is abnormally terminated with a CICS
AALU transaction dump.

Explanation User response


An error (INVALID, DISASTER or unexpected Inform the system programmer. Examine the trace
EXCEPTION response) has occurred on a call to the and the dump to identify the point of error.
Sockets Domain Manager. The domain that detected
Module:
the original error provides a trace entry and possibly a
DFHAMWB
system dump (depending on the options specified in
the dump table). AALX

System action Explanation


The task is abnormally terminated with a CICS An error (INVALID, DISASTER or unexpected
transaction dump. EXCEPTION response) has occurred on a call to the
Pipeline Manager. The domain that detected the
User response original error provides a trace entry and possibly a
system dump (depending on the options specified in
Inform the system programmer. Examine the trace the dump table).
and the dump to identify the point of error.
Module: System action
DFHAMSO
The task is abnormally terminated with a CICS
AALV transaction dump.

Explanation User response


An error (INVALID, DISASTER or unexpected Inform the system programmer. Examine the trace
EXCEPTION response) has occurred on a call to the and the dump to identify the point of error.
Enterprise Java Domain. The domain that detected the
Module:
original error provides a trace entry and possibly a
DFHAMPI
system dump (depending on the options specified in
the dump table). AALY

System action Explanation


The task is abnormally terminated with a CICS An error (INVALID, DISASTER or unexpected
transaction dump. EXCEPTION response) has occurred on a call to the
ISC/IP Domain. The domain that detected the original
User response error provides a trace entry and possibly a system
dump (depending on the options specified in the dump
Inform the system programmer. Examine the trace table).
and the dump to identify the point of error.
Module: System action
DFHAMEJ
The task is abnormally terminated with a CICS
AALW transaction dump.

Explanation User response


An error (INVALID, DISASTER or unexpected Inform the system programmer. Examine the trace
EXCEPTION response) has occurred on a call to the and the dump to identify the point of error.
Web Domain. The domain that detected the original
Module:
error provides a trace entry and possibly a system
DFHAMIS
dump (depending on the options specified in the dump
table). AALZ

6 CICS TS for z/OS: CICS Codes


Explanation System action
An error (INVALID, DISASTER or unexpected The transaction is abnormally terminated with a CICS
EXCEPTION response) has occurred on a call to the transaction dump.
Document Handler. The domain that detected the
If an error has occurred, at the time the error is
original error provides a trace entry and possibly a
detected, CICS issues a DFHXMnnnn console
system dump (depending on the options specified in
message, records an exception trace entry and takes a
the dump table).
system dump.

System action
User response
The task is abnormally terminated with a CICS
Determine why the task has failed. If there is a system
transaction dump.
dump, use it together with the trace entry and the
console message to resolve the problem. If there is no
User response system dump, the task has been purged either by the
Inform the system programmer. Examine the trace master terminal operator or as a result of deadlock
and the dump to identify the point of error. timeout.

Module: Module:
DFHAMDH DFHAMP

AAM1 AAM3

Explanation Explanation

DFHXMCL has returned an unexpected response An error (INVALID, DISASTER or unexpected


during the install of a transaction class. This can be EXCEPTION response) has occurred on a call to the
caused by the task being purged during the install. Loader Domain. The domain that detected the original
error provides a trace entry and possibly a system
dump (depending on the options specified in the dump
System action
table).
The transaction is abnormally terminated with a CICS
transaction dump. System action
If an error has occurred, at the time the error is The task is abnormally terminated with a CICS
detected, CICS issues a DFHXMnnnn console transaction dump.
message, records an exception trace entry and takes a
system dump.
User response

User response Inform the system programmer. Examine the trace


and the dump to identify the point of error.
Determine why the task has failed. If there is a system
dump, use it together with the trace entry and the Module:
console message to resolve the problem. If there is no DFHAMLD
system dump, the task has been purged either by the AAM4
master terminal operator or as a result of deadlock
timeout.
Explanation
Module:
An error (INVALID, DISASTER or unexpected
DFHAMP
EXCEPTION response) has occurred on a call to the
AAM2 Resource Lifecycle Manager. The domain that
detected the original error provides a trace entry and
Explanation possibly a system dump (depending on the options
specified in the dump table).
DFHXMXD has returned an unexpected response
during the install of a transaction definition. This can
System action
be caused by the task being purged during the install.
The task is abnormally terminated with a CICS
transaction dump.

Chapter 1. Transaction abend codes 7


User response User response
Inform the system programmer. Examine the trace If you need further assistance from IBM to resolve this
and the dump to identify the point of error. problem, see IBM problem support for guidance on
how to proceed.
Module:
DFHAMRL Module:
DFHAMP
AAMA
AAMF
Explanation
Explanation
There is an internal logic error in DFHAMP.
An unexpected return code has been received
System action following a call to the kernel (KE) domain. This might
be due to an internal logic error.
The task is abnormally terminated with a CICS
transaction dump.
System action

User response CICS terminates the task abnormally with a dump.

If you need further assistance from IBM to resolve this


User response
problem, see IBM problem support for guidance on
how to proceed. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
Module:
how to proceed.
DFHAMP
Module:
AAMC
DFHAMP

Explanation AAMH

The task was purged before a GETMAIN request to the


Explanation
storage manager domain was able to complete
successfully. An unexpected return code has been received
following a call to DFHFCMT. This might be due to an
System action internal logic error.

The task is abnormally terminated with a CICS


System action
transaction dump.
CICS terminates the task abnormally with a dump.
User response
User response
Investigate the reason the task was purged. It was
purged either by the master terminal operator or as a If you need further assistance from IBM to resolve this
result of deadlock timeout. problem, see IBM problem support for guidance on
how to proceed.
Module:
DFHAMP Module:
DFHAMP
AAMD
AAMI
Explanation
Explanation
An unexpected return code has been received from
DFHDMP. This is due to an internal logic error. An unexpected return code has been received
following a call to DFHFCRL. This might be due to an
System action internal logic error.

The task is abnormally terminated with a CICS


System action
transaction dump.
CICS terminates the task abnormally with a dump. If
you need further assistance from IBM to resolve this

8 CICS TS for z/OS: CICS Codes


problem, see IBM problem support for guidance on System action
how to proceed.
The task is abnormally terminated with a CICS
User response: transaction dump.
Module:
DFHAMP User response

AAMJ If you need further assistance from IBM to resolve this


problem, see IBM problem support for guidance on
how to proceed.
Explanation
Module:
While installing a file, using RDO, a call was made to
DFHAMP
DFHFCFS to enable the file. An irrecoverable error was
returned from DFHFCFS. AAMO

System action Explanation


The task is abnormally terminated with a CICS An invalid return code was returned from DFHTOR, the
transaction dump. CICS terminal object resolution program.
At the time the error is detected, CICS writes a
message to the console, records an exception trace System action
entry and takes a system dump. The task is abnormally terminated with a CICS
transaction dump.
User response
Inform the system programmer. Examine the trace User response
and the dump to identify the point of error. If you need further assistance from IBM to resolve this
Module: problem, see IBM problem support for guidance on
DFHAMP how to proceed.

AAMK Module:
DFHAMP
Explanation AAMP
While installing a file, using RDO, a call was made to
DFHFCDN. An irrecoverable error was returned from Explanation
DFHFCDN. An unexpected return code has been received from
DFHPUP. This might be due to an internal logic error.
System action
The task is abnormally terminated with a CICS System action
transaction dump. At the time the error is detected, The task is abnormally terminated with a CICS
CICS writes a message to the console, records an transaction dump.
exception trace entry, and takes a system dump.
User response
User response
If you need further assistance from IBM to resolve this
Inform the system programmer, Examine the trace problem, see IBM problem support for guidance on
and dump to identify the point of error. how to proceed.
Module: Module:
DFHAMP DFHAMP
AAMN AAMQ

Explanation Explanation
There has been an unexpected return code from a call An attempt has been made to install a partner using
to DFHPRPT. This might be due to an internal logic RDO. However, the partner resource manager (PRM) is
error.

Chapter 1. Transaction abend codes 9


unavailable having failed to initialize during CICS Explanation
initialization.
An unexpected return code has been received from
DFHZCP. This is due to an internal logic error.
System action
The task is abnormally terminated with a CICS System action
transaction dump.
The task is abnormally terminated with a CICS
transaction dump.
User response
If you need to use the PRM, correct the problem which User response
prevented the PRM from initializing, and restart CICS.
If you need further assistance from IBM to resolve this
Module: problem, see IBM problem support for guidance on
DFHAMP how to proceed.
AAMS Module:
DFHAMP
Explanation AAO2
There has been an unexpected return code following a
GETMAIN request to the storage manager. This is due Explanation
to an internal logic error.
CPI Communications has detected an unexpected
response from DFHLUC.
System action
The task is abnormally terminated with a CICS System action
transaction dump.
The transaction is abnormally terminated with a CICS
transaction dump.
User response
If you need further assistance from IBM to resolve this User response
problem, see IBM problem support for guidance on
This is a CICS internal logic error.
how to proceed.
A level 2 CICS trace for 'CP' of the transaction
Module:
documents the course of events prior to this error
DFHAMP
(such as the modules called and their parameters).
AAMT The level 2 trace also provides details of the error
itself.
Explanation If you need further assistance from IBM to resolve this
There is an internal logic error in DFHAMP due to an problem, see IBM problem support for guidance on
unexpected return code from DFHTMP. how to proceed.
Module:
System action DFHCPCBA
The task is abnormally terminated with a CICS AAO3
transaction dump.
Explanation
User response
The CPI interface detected that a call was made to a
If you need further assistance from IBM to resolve this CPI Communications function without CPI
problem, see IBM problem support for guidance on Communications being initialized. This implies that
how to proceed. CPI Communications initialization failed while CICS
was initializing.
Module:
DFHAMP
System action
AAMZ
The transaction is abnormally terminated with a CICS
transaction dump. An exception trace entry is also
written when this event occurs.

10 CICS TS for z/OS: CICS Codes


User response User response
Check the console listing to determine the reason why Investigate the reason why the task was purged. It
CPI Communications failed to initialize during CICS was purged either by the master terminal operator or
initialization. Correct the problem and restart CICS. as a result of deadlock timeout.
If the console listing indicates that CPI Module:
Communications initialized successfully, you need DFHCPCBA, DFHCPCBI, DFHCPCBS
further assistance to resolve the problem. Collect the
AAO7
console listing, the traces and the transaction dump.
See IBM problem support for guidance on how to
proceed. Explanation

Module: The CPI Communications syncpoint request handler


DFHCPI has been passed an invalid DFHLUC parameter list.
This is a CICS internal logic error.
AAO4
System action
Explanation
The transaction is abnormally terminated with a CICS
DFHZARL, or a module called by DFHZARL, has transaction dump.
detected a logic error. This error is almost certainly
caused by the module receiving invalid data or
User response
indicators from VTAM.
A level 2 trace for 'CP' of the transaction shows the
System action course of events before this error occurred (such as
the modules called and their parameters) plus details
Before returning to the CPI Communications layer, of the error itself. If you need further assistance from
DFHZARL calls DFHZNAC to clean up the session and IBM to resolve this problem, see IBM problem support
put out messages on the CSNE log. CPI for guidance on how to proceed.
Communications abnormally terminates the
transaction with a CICS transaction dump, and Module:
produces an exception trace entry. DFHCPSRH
AAO8
User response
Check the CSNE log to determine the type of error. You Explanation
may need further assistance from IBM to fully resolve The CPI Communications syncpoint request handler
this problem. See IBM problem support for guidance has been passed an invalid conversation control block
on how to proceed. (CPC). This is a CICS internal logic error.
Module:
DFHCPCLR System action
AAO5 The transaction is abnormally terminated with a CICS
transaction dump.
Explanation
User response
The task was purged before a GETMAIN request to the
storage manager (SM) domain was able to complete A level 2 trace for 'CP' of the transaction shows the
successfully. The domain that first detected the course of events before this error occurred (such as
purged condition provides an exception trace. the modules called and their parameters) plus details
of the error itself. If you need further assistance from
System action IBM to resolve this problem, see IBM problem support
for guidance on how to proceed.
The task is abnormally terminated with a CICS
transaction dump. Module:
DFHCPSRH
AAO9

Chapter 1. Transaction abend codes 11


Explanation of the issued CPI call. Use the trace or the dump to
verify that this character string is the name of a CPI
A task has been purged either as a result of a purge
function which is supported.
from the master terminal operator via the CEMT
transaction, or by the task being timed out after If the character string is not an intelligible character
waiting for longer than the DTIMOUT (deadlock string, the stub has probably been corrupted.
timeout) value specified for the transaction.
Module:
DFHCPI
System action
AAOB
The task is abnormally terminated with a CICS
transaction dump.
Explanation

User response An application has issued a CPI verb which specifies


more than eight parameters.
Investigate why the task was purged.
If the task was purged by the master terminal System action
operator, this may have been in an attempt to clear the
The transaction is abnormally terminated with a CICS
system which appeared to be deadlocked for some
transaction dump and an exception trace entry is also
reason.
written.
If the task was timed out automatically as a result of
the DTIMOUT value being exceeded, this may be due User response
to insufficient main storage being available for the
number of tasks in the system. If the amount of main Change your application program so that the correct
storage cannot be increased, the number of tasks in number of parameters is specified on the CPI call.
the system should be reduced to avoid short-on- Module:
storage situations. Another possibility would be to DFHCPI
increase the value of the DTIMOUT option for the
transaction. AAOC

Module:
Explanation
DFHCPCLR
CPI Communications is invoked with an invalid number
AAOA
of parameters for call

Explanation
System action
An application has issued a CPI verb which CICS does
The transaction is abnormally terminated with a CICS
not support. The entry point referenced in the
transaction dump.
application program was resolved in the link edit stub,
but the function requested could not be resolved when
control passed to CICS. User response

There are two possible reasons for this: The exception trace point produced with this abend
contains the incorrectly issued CPI Communications
• You have linkedited your application program with a verb name. Use this to determine where the
CPI stub which supports more function than this application program was in error and amend it
release of CICS. accordingly.
• The linkedit stub has been corrupted. The Common Programming Interface Communications
(CPI-C) Reference manual, SC26-4399, provides a
System action detailed description of all the CPI Communications
The transaction is abnormally terminated with a CICS verbs and how they should be called.
transaction dump. An exception trace entry is also Module:
written. DFHCPARH
AAOD
User response
At the time of the error, general register 0 points to an
8-byte character string which should match the name

12 CICS TS for z/OS: CICS Codes


Explanation User response
The task was purged before a GETMAIN request to the Investigate the reason the task was purged. It was
storage manager (SM) domain was able to complete purged either by the master terminal operator or as a
successfully. The domain that first detected the result of deadlock timeout.
purged condition provides an exception trace.
Module:
DFHCPCBS
System action
AAOG
The task is abnormally terminated with a CICS
transaction dump.
Explanation

User response During the processing of CMACCP (accept


conversation), CPI Communications detected that the
Investigate the reason the task was purged. It was application was attached with an unsupported sync
purged either by the master terminal operator or as a level.
result of deadlock timeout.
Module: System action
DFHCPCBI
The transaction is abnormally terminated with a CICS
AAOE transaction dump.

Explanation User response


The task was purged before a GETMAIN request to the This condition is caused by a back-end CPI
storage manager (SM) domain was able to complete Communications transaction being attached with a
successfully. The domain that first detected the sync level that is not CM_NONE (0) or CM_CONFIRM
purged condition provides an exception trace. (1).
Change the front-end transaction, (that is, the initiator
System action of the conversation in the other system) so that it
The task is abnormally terminated with a CICS defines the sync level correctly.
transaction dump. Module:
DFHCPCBA
User response
AAOH
Investigate the reason the task was purged. It was
purged either by the master terminal operator or as a Explanation
result of deadlock timeout.
Journaling of data sent on a CPI communications
Module: mapped conversation has failed. This condition is
DFHCPCBA caused by a nonzero response from the CICS log
AAOF manager.

Explanation System action

The task was purged before a GETMAIN request to the The transaction is abnormally terminated with a CICS
storage manager (SM) domain was able to complete transaction dump.
successfully. The domain that first detected the
purged condition provides an exception trace. User response
Use the dump to ascertain why the journal or log
System action record could not be written correctly. If a journal
The task is abnormally terminated with a CICS record length error is indicated, TIOATDL may have
transaction dump. been corrupted.

Problem determination
Register 12 addresses the current TCA and field
TCAJCAAD and register 4 address the JCA. The log

Chapter 1. Transaction abend codes 13


manager request is contained in JCATR2 and the Possible response codes are:
response code is in JCAJCRC.
Possible request codes are: X'01' - IDERROR - Journal identification error
X'02' - INVREQ - Invalid request
X'03' - STATERR - Status error
X'05' - NOTOPEN - Journal not open
X'8001' - WRITE X'06' - LERROR - Journal record length error
X'8003' - PUT X'07' - IOERROR - I/O error

Possible response codes are: The address of the TIOA is contained in register 8 and
its data length is in TIOATDL.
X'01' - IDERROR - Journal identification error Analysis:
X'02' - INVREQ - Invalid request
X'03' - STATERR - Status error
X'05' - NOTOPEN - Journal not open
X'06' - LERROR - Journal record length error
X'07' - IOERROR - I/O error. Register Label Description

The address of the TIOA is contained in register 8 and R4=@JCA TCZARQPJ JCAJCRC is nonzero.
its data length is in TIOATDL.
Analysis: Module:
DFHCPCRI, DFHCPCRW
AAOJ
Register Label Description
Explanation
R4=@JCA TCZARQPJ JCAJCRC is nonzero.
CPI Communications has detected an unexpected
Module: response from one of its internal routines.
DFHCPCOJ
System action
AAOI
The transaction is abnormally terminated with a CICS
Explanation transaction dump.

The journaling of data received on a CPI User response


Communications mapped conversation has failed.
This is a CICS internal logic error.
System action A level 2 trace for 'CP' of the transaction shows the
The transaction is abnormally terminated with a CICS course of events prior to this error. For example, the
transaction dump. modules called and their parameters. The level 2 trace
also provides details of the error itself.
User response If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
This condition is caused by an invalid response from how to proceed.
the log manager. Use the dump to ascertain why the
journal or log record could not be written correctly. If a Module:
journal record length error is indicated, TIOATDL may DFHCPIC
have been corrupted. AAOK

Problem determination Explanation


Register 12 addresses the current TCA and field CPI Communications has detected an unexpected call
TCAJCAAD and register 4 address the JCA. The CICS to one of its internal routines.
log manager request is contained in JCATR2 and the
response code is in JCAJCRC.
System action
Possible request codes are:
The transaction is abnormally terminated with a CICS
transaction dump.
X'8001' - WRITE
X'8003' - PUT

14 CICS TS for z/OS: CICS Codes


User response If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
This is a CICS internal logic error.
how to proceed.
A level 2 trace for 'CP' of the transaction shows the
Module:
course of events prior to this error, for example, the
DFHCPCLR, DFHCPSRH
modules called and their parameters. The level 2 trace
also provides details of the error itself. AAON
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Explanation
how to proceed. CPI Communications has detected an unexpected
Module: response from DFHLUC.
DFHCPIC
System action
AAOL
The transaction is abnormally terminated with a CICS
Explanation transaction dump.

CPI Communications has made an invalid call to


User response
DFHLUC.
This is a CICS internal logic error.
System action A level 2 trace for 'CP' of the transaction shows the
The transaction is abnormally terminated with a CICS course of events prior to this error. For example, the
transaction dump. modules called and their parameters. The level 2 trace
also provides details of the error itself.
User response If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
This is a CICS internal logic error.
how to proceed.
A level 2 trace for 'CP' of the transaction shows the
Module:
course of events prior to this error, for example, the
DFHCPCLR, DFHCPCLC
modules called and their parameters. The level 2 trace
also provides details of the error itself. AAOO
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Explanation
how to proceed. CPI Communications has been invoked with an invalid
Module: first parameter. The first parameter should be the
DFHCPCLR code of the function to be performed. This is a CICS
internal logic error.
AAOM
System action
Explanation
The transaction is abnormally terminated with a CICS
The CPI Communications and the DFHZUSR state transaction dump.
machines are out of synchronization.
User response
System action
A level 2 trace for 'CP' of the transaction shows the
The transaction is abnormally terminated with a CICS course of events before this error occurred (such as
transaction dump. the modules called and their parameters) plus details
of the error itself.
User response
If you need further assistance from IBM to resolve this
This is a CICS internal logic error. problem, see IBM problem support for guidance on
how to proceed.
A level 2 trace for 'CP' of the transaction shows the
course of events prior to this error. For example, the Module:
modules called and their parameters. The level 2 trace DFHCPARH
also provides details of the error itself.
AAOP

Chapter 1. Transaction abend codes 15


Explanation If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
The CPI Communications state machine has been
how to proceed.
requested to perform a state transition request that is
considered to be an 'impossible' situation. (The Module:
Common Programming Interface Communications DFHCPCFS
(CPI-C) Reference manual, (SC26-4399) documents
AAOR
all these situations.)
There are two possible causes of this error: Explanation
• The CPC (conversation control block) has been CPI Communications has detected an invalid value in
overwritten in such a way that the conversation state the CPC (conversation control block).
has been altered, or
There are 2 possible causes of this error:
• There is an error in the CPI Communications state
machine. • The CPC (conversation control block) has been
overwritten, or
System action • There is an error in CPI Communications which
causes it to reject valid values.
The transaction is abnormally terminated with a CICS
transaction dump.
System action
User response The transaction is abnormally terminated with a CICS
transaction dump.
A level 2 trace for 'CP' of the transaction shows the
course of events prior to this error, for example, the
modules called and their parameters. The level 2 trace User response
also provides details of the error itself. A level 2 trace for 'CP' of the transaction shows the
The transaction dump shows the CPC. You may need course of events prior to this error, for example, the
further assistance from IBM to fully resolve this modules called and their parameters. The level 2 trace
problem. See IBM problem support for guidance on also provides details of the error itself.
how to proceed. Module:
Module: DFHCPIC
DFHCPCFS AAOS
AAOQ
Explanation
Explanation CPI Communications has detected that the
The return code generated by CPI Communications conversation state is RESET for a situation where this
does not have an entry in the state table against the should not occur. That is, the conversation control
current CPI Communications verb. This error is block (CPC) is about to be deleted.
detected by the CPI Communications state machine. There are two possible causes of this error:
• The CPC has been overwritten, or
System action
• There is an error in CPI communications.
The transaction is abnormally terminated with a CICS
transaction dump.
System action

User response The transaction is abnormally terminated with a CICS


transaction dump.
This is a CICS internal logic error.
A level 2 trace for 'CP' of the transaction shows the User response
course of events prior to this error, for example, the
A level 2 trace for 'CP' of the transaction shows the
modules called and their parameters. The level 2 trace
course of events prior to this error, for example, the
also provides details of the error itself.
modules called and their parameters. The level 2 trace
also provides details of the error itself. You may need
further assistance from IBM to fully resolve this

16 CICS TS for z/OS: CICS Codes


problem. See IBM problem support for guidance on User response
how to proceed.
A level 2 trace for 'CP' of the transaction shows the
Module: course of events prior to this error, for example, the
DFHCPIC modules called and their parameters. The level 2 trace
also provides details of the error itself.
AAOT
If you need further assistance from IBM to resolve this
Explanation problem, see IBM problem support for guidance on
how to proceed.
While chaining through the CPCs (conversation control
blocks) for a given conversation, CPI Communications Module:
detected that the chain was broken. DFHCPCBI

There are two possible causes of this error. AAOV

1. The CPC chain has been overwritten, or


Explanation
2. There is an error in the CPI Communications
chaining mechanism. CPI Communications has detected that its internal
state table is corrupted.
System action This error is detected by the CPI Communications
state machine.
The transaction is abnormally terminated with a CICS
transaction dump.
System action
User response The transaction is abnormally terminated with a CICS
transaction dump.
Determine which of the above caused the error.
A level 2 trace for 'CP' of the transaction shows the User response
course of events prior to this error, for example, the
modules called and their parameters. The level 2 trace This is a CICS internal logic error.
also provides details of the error itself. A level 2 trace for 'CP' of the transaction shows the
You may need further assistance from IBM to fully course of events prior to this error, for example, the
resolve this problem. See IBM problem support for modules called and their parameters. The level 2 trace
guidance on how to proceed. also provides details of the error itself.

Module: If you need further assistance from IBM to resolve this


DFHCPCBI problem, see IBM problem support for guidance on
how to proceed.
AAOU
Module:
DFHCPCFS
Explanation
AAOW
CPI Communications has detected an error in the
TP_name or partner_LU_name while processing an
initialize conversation request. The TP_name or Explanation
partner_LU_name is obtained by lookup of the CPI Communications has detected an internal logic
sym_dest_name in the partner resource table (PRT). error in DFHCPCLC.
There are two possible causes of this error.
System action
1. The entry in the PRT contains invalid data, or
2. There is an error in the mechanism that returns the The transaction is abnormally terminated with a CICS
data from the PRT and interprets it. transaction dump.

System action User response

The transaction is abnormally terminated with a CICS This is a CICS internal logic error.
transaction dump. A level 2 trace for 'CP' of the transaction shows the
course of events prior to this error, for example, the

Chapter 1. Transaction abend codes 17


modules called and their parameters. The level 2 trace User response
also provides details of the error itself.
Use CICS traces and, possibly a VTAM trace, to
If you need further assistance from IBM to resolve this determine the data that was sent between both
problem, see IBM problem support for guidance on systems.
how to proceed.
A level 2 CICS trace for 'CP' of the transaction
Module: documents the course of events prior to this error
DFHCPCLC (such as the modules called and their parameters).
The level 2 trace also provides details of the error
AAOX
itself.

Explanation You may need further assistance from IBM to fully


resolve this problem. See IBM problem support for
CPI Communications has detected a bad syncpoint guidance on how to proceed.
return code which has been set on a synclevel 0 or 1
conversation. The bad return code is only expected on Module:
a synclevel 2 conversation. DFHCPCRB
AAOZ
System action
The transaction is abnormally terminated with a CICS Explanation
transaction dump. CPI Communications has detected an invalid ID field in
the GDS records it was receiving on a mapped
User response conversation. The exception trace point that
accompanies this abend gives the ID field in data 3.
This is a CICS internal logic error.
The valid IDs are '12FF'X for application data and
A level 2 trace for 'CP' of the transaction shows the '12F1'X for null data.
course of events prior to this error, for example, the
modules called and their parameters. The level 2 trace System action
also provides details of the error itself.
The transaction is abnormally terminated with a CICS
If you need further assistance from IBM to resolve this transaction dump.
problem, see IBM problem support for guidance on
how to proceed.
User response
Module:
Use CICS traces and, possibly, a VTAM trace to
DFHCPIC
determine the data that was sent between both
AAOY systems.
A level 2 CICS trace for 'CP' of the transaction
Explanation documents the course of events prior to this error
CPI Communications detected an invalid LL field in the (such as the modules called and their parameters).
GDS records from which it was receiving on a mapped The level 2 trace also provides details of the error
conversation. itself.

Although it is possible that the remote system is You may need further assistance from IBM to fully
sending invalid records, it is more likely to be an error resolve this problem. See IBM problem support for
in the receive logic because DFHZARRC (a lower level guidance on how to proceed.
receive module) also checks the LLs before passing Module:
them to CPI Communications. DFHCPCRB
AASA
System action
The transaction is abnormally terminated with a CICS Explanation
transaction dump.
An unexpected EXCEPTION response was received
from a call to the user (US) domain during initialization
of a child task.
The call was issued during initialization of a
transaction that was started without a terminal. The

18 CICS TS for z/OS: CICS Codes


call was made as part of processing to associate the It may be necessary to examine the transaction dump
transaction with its intended user. to determine why the external security manager has
informed CICS that the user is not correctly defined.
System action Module:
The transaction is abnormally terminated with a CICS DFHASXM
transaction dump.

User response
Examine the messages produced for the CICS job by
the external security manager (ESM). This may require
the assistance of a security administrator.

ABxx abend codes


ABAC ABAE

Explanation Explanation
An activity issued EXEC CICS RETURN (without the An activity issued EXEC CICS RETURN (without the
ENDACTIVITY option) but no events were processed ENDACTIVITY option) but no events were processed
during the activation. The activity was executed with a during the activation. The activity was executed with a
RUN command. LINK command.

System action System action


The task is abnormally terminated with a CICS The task which issued the LINK is abnormally
transaction dump. The EXEC CICS HANDLE ABEND terminated with a CICS transaction dump. The EXEC
command cannot handle this abend. CICS HANDLE ABEND command cannot handle this
abend.
User response
User response
Investigate why the activity did not process any
events. Investigate why the activity did not process any
events.
Module:
DFHBASP Module:
DFHEIBAM
ABAD
ABAF
Explanation
Explanation
An activity issued EXEC CICS RETURN ENDACTIVITY
while there were activity completion events pending. An activity issued EXEC CICS RETURN ENDACTIVITY
The activity was executed with a RUN command. while there were activity completion events pending.
The activity was executed with a LINK command.
System action
System action
The task is abnormally terminated with a CICS
transaction dump. The EXEC CICS HANDLE ABEND The task which issued the LINK is abnormally
command cannot handle this abend. terminated with a CICS transaction dump. The EXEC
CICS HANDLE ABEND command cannot handle this
User response abend.

Investigate why the activity had pending activity


User response
completion events.
Investigate why the activity had pending activity
Module:
completion events.
DFHBASP

Chapter 1. Transaction abend codes 19


Module: Module:
DFHEIBAM DFHMCP, DFHMCPE, DFHM32, DFHPBP, DFHRLR
ABLA ABM0

Explanation Explanation
The task was purged before a GETMAIN request to the The map specified for a basic mapping support (BMS)
storage manager (SM) domain was able to complete request could not be located.
successfully. The domain that first detected the
purged condition provides an exception trace. System action
The transaction is abnormally terminated with a CICS
System action
transaction dump.
The task is abnormally terminated with a CICS
transaction dump. User response
Check if the map has been defined. If it has, check that
User response
it has been specified correctly.
Investigate why the task was purged. It was purged
Module:
either by the master terminal operator or as a result of
DFHMCP, DFHMCX, DFHMCY
deadlock timeout.
ABM1
If the task was purged by the master terminal
operator, this may have been in an attempt to clear the
system which appeared to be deadlocked for some Explanation
reason. A basic mapping support (BMS) service is requested by
If the task was timed out automatically as a result of a task associated with a terminal that is not supported
the DTIMOUT value being exceeded, this may be due by BMS. The request is not a routing request.
to insufficient main storage being available for the
number of tasks in the system. If the amount of main System action
storage cannot be increased, the number of tasks in
The transaction is abnormally terminated with a CICS
the system should be reduced to avoid short-on-
transaction dump.
storage situations. Another possibility would be to
increase the value of the DTIMOUT option for the
transaction. User response

Module: Do not use terminals not supported by BMS for


DFHMCP, DFHMCPE, DFHM32, DFHPBP, DFHRLR applications using BMS services.

ABLB Check the terminal type and model number. Confirm


that it is a terminal that is not supported by BMS. A list
of terminals supported by BMS is given in the
Explanation
Developing CICS Applications. Check that the resource
An error (INVALID, DISASTER, or unexpected definition for the terminal accurately describes the
EXCEPTION response) has occurred on a call to the physical terminal.
storage manager (SM) domain. The domain that
detected the original error provides an exception Problem determination
trace, a console message and, possibly, a system
dump (depending on the options in the dump table). At the time of the abend, register 11 addresses the
TCTTE, and TCTTETEA and register 6 address the
TCTTE extension, TCTETTE.
System action
Relevant fields are:
The task is abnormally terminated with a CICS
transaction dump.
TCTTEDDS the device dependent suffix.
TCTTEMSS the map set suffix.
User response
Please see the related message produced by the Analysis: DFHRLR tests the device dependent suffix
domain that originally detected the error. and the map set suffix in the TCTTE extension. If both
of these are zero, the terminal is not supported by

20 CICS TS for z/OS: CICS Codes


BMS and DFHRLR abends the task with the abend checking the application listing and the contents of
code ABM1. TCTTEDA and/or TCAMSIOA.
Next, check that the BMS request has been correctly
decoded by CICS by referring to the OSPWA request
Register Label Description bytes (OSPTR1-8) or decoding the last BMS entry in
the trace table. See OSPIND01 to check correct
R4= RLRSFXCK TCTEDDS=X'00' and decoding of PAGEBLD or TEXTBLD, and TCAFCI bit 7 to
TCTEMSS=X'00'.
@TCTTETE The device dependent suffix identify whether the task is terminal-oriented or not.
and the map set suffix have
loaded into the lower two At the abend point, register 1 contains the user data
bytes of register 3 by the address last loaded, and register 4 the address of
subroutine RLRSUFXS.
OSPTIOA as an address of null data.
Module: If a CICS error is suspected, concentrate initially on
DFHRLR subroutine MCPFTIOA, because this is a simple piece
of code that shows the data-fetch logic. ABM2
ABM2
condition is trapped early in the CICS decoding of the
DFHBMS request and involves module DFHMCP only.
Explanation
No user data was supplied for this BMS request. That Case/Register Label Description
is, the address of a user data area was not found in
either TCTTEDA or TCAMSIOA. R9=@OSPWA MCPMAP OSPTR4 has OSPTRM
(X'04') bit set for
TYPE=MAP.
When a BMS macro level output request is issued, the
user must have placed the address of the data to be R9=@OSPWA MCPPGBLD OSPTR5 has OSPTRB
passed to BMS in TCTTEDA or TCAMSIOA before (X'80') bit set and
BMS sets bit
issuing the macro. The choice is made on the following OSPLMPB (X'08') in
criteria: OSPIND01 for
TYPE=PAGEBLD.
• If the data is to be passed in a TIOA by a terminal- OSPTR4 has X'40',
X'80', or X'C0' set
oriented task, the address of this TIOA may be for DATA=NO, ONLY,
placed either at TCTTEDA, or in TCAMSIOA together or YES respectively,
so should be X'80'
with the setting of binary zeros into TCTTEDA. or X'C0'.
• If the data is being passed by a terminal-oriented R9=@OSPWA MCPTXBLD OSPTR7 has OSPTRX
task but not in a TIOA, the address of the TIOA-like (X'80') bit set and
area of this data must be placed in TCAMSIOA and BMS sets bit
OSPLMTB (X'04') in
binary zeros set into TCTTEDA. OSPIND01 for
TYPE=PAGEBLD.
• If the data is being passed by a non-terminal- OSPTR4 has X'40',
oriented task, the address of the TIOA-like area of X'80', or X'C0' set
this data must be placed in TCAMSIOA. TCTTEDA for DATA=NO, ONLY,
or YES respectively,
cannot be referenced, because there is no TCTTE so should be X'80'
associated with this task. or X'C0'.

If a task attempts to pass addresses from both R9=@OSPWA MCPMAPNG OSPTR3 has OSPTSN
(X'01'), OSPTSA
TCTTEDA and TCAMSIOA, the address in TCTTEDA is (X'02'), or OSPTMN
the one selected. (X'04') bits set, or
OSPTR4 has OSPTMA
(X'10') bit set for
System action mapping.
OSPTR4 has X'04' or
X'80' or X'C0' set for
The transaction is abnormally terminated with a CICS DATA=NO, ONLY, or YES
transaction dump. respectively, so should
be X'80' or X'C0'.

User response All R12=@TCA MCPFTIOA TCAFCI has


TCAFCTRM (X'01') bit
The programmer must place the address of the data set if the task is
terminal-oriented.
into TCTTEDA or TCAMSIOA, whichever is appropriate.
All R11=@TCTTE MCPFTIOA TCTTEDA could point
Firstly, check that the user has loaded TCTTEDA or to a use TIOA but does
TCAMSIOA with the address of the user data, by not, thus causing the
abend.

Chapter 1. Transaction abend codes 21


All R12=@TCA MCPFTIOA TCAMSIOA could point • The title record specified in the TITLE option on a
to a user data area
(TIOA or otherwise), BMS ROUTE request has an invalid format, that is, it
but does thus causing does not begin with a halfword length field or is
the abend.
more than 64 characters.
All R9=@OSPWA MCPNTOTM OSPTIOA contains the • The message is being routed to more terminals than
address of the user
area found, so is intended. OSPTTCNT is very large, for example, if
zero. LIST=ALL is specified on a ROUTE request and there
OSPSIOA points
to OSPIOA (which is are a large number of terminals in the TCT.
copied from TCAMSIOA)
as being the second-dry If the page buffer length is too large, this may be
data area sought by because more data than intended is being built into
BMS for data .
OSPIA (TCAMSIOA) was the page. If the page buffer length is greater than the
also zero so causing length of the storage area indicated in the preceding
the abend. storage accounting area, an error has occurred in page
or text building, and the page buffer extends beyond
Module: the area allocated to it (that is, storage violation).
DFHMCP
ABM3 Problem determination
Abend in DFHMCP (see Analysis)
Explanation
The OSPWA (output services work area) is in user
A BMS input or output request has been issued from a storage and is printed in a transaction dump. It is
task that is not terminal-oriented. addressed by register 9 at the time of the abend.
Relevant fields are:
System action
The task is abnormally terminated with a CICS dump. OSPTITLE
OSPTTCNT
OSPPLTI
User response OSPTOTPG

The task issuing a BMS input or output request must


The message control record (MCR) is an area of user
be attached to a terminal.
storage obtained by BMS. It is addressed by register 8
Module: at the time of the abend. The first 8 bytes contain
DFHMCP storage accounting information. MCRLLBB contains
the length of the MCR (halfword) abend in DFHTPP.
ABM4
The page buffer is addressed by register 7 at the time
Explanation of the abend. It contains storage accounting fields in
the first 8 bytes and a halfword length at offset 8
An invalid request response has been received to a (TSIOAVRL).
temporary storage PUT or PUTQ request issued by
BMS. The data passed to the temporary storage In both cases, the temporary storage use map
program has an invalid length. (DFHTSMAP) is addressed from CSATSATA.
TSMAPCOM contains the number of available bytes in
a control interval on the temporary storage data set.
System action
Analysis: If the temporary storage request preceding
The transaction is abnormally terminated with a CICS
the abend is a DFHTS PUT, the abend occurred in
transaction dump.
DFHMCP. If the temporary storage request preceding
the abend is a DFHTS PUTQ, the abend occurred in
User response DFHTPP. If the abend occurred in DFHMCP, DFHMCP is
If you need further assistance from IBM to resolve this attempting to put the message control record to
problem, see IBM problem support for guidance on temporary storage. Check the length of the MCR
how to proceed. (MCRLLBB). It may be negative.

Determine from the trace table whether the abend The length of the MCR is calculated by code following
occurred in DFHMCP or DFHTPP. label MCPNODDS and is:

Check the length of the appropriate area.


28 + 21 * OSPTTCNT + (length of title record)
If the MCR length is invalid, possible reasons are:

22 CICS TS for z/OS: CICS Codes


+ (space for page/LDC table, System action
if needed)
The transaction is abnormally terminated with a CICS
The address of the title record is at OSPTITLE and the transaction dump.
length is contained in the first halfword. Space for the
page/LDC table is required if OSPPLT1 is nonzero, User response
which should occur only for messages routed to LDC
devices (3600, 3650, 3767, 3770, 3790). The number Check the trace table and find the preceding PUT/
of entries is in OSPTOTPG. 2 bytes are required per PUTQ TS requests. Check whether the identifier for the
entry. PUT/PUTQ is the same as that for the PURGE. If it is
not, find out how they differ. Check to see if the
If the abend occurred in DFHTPP, BMS is attempting to OSPWA has been corrupted.
add a page to the temporary storage queue, and the
page buffer will not fit in the control interval. This error is very unlikely, as the label indicates
TSIOAVRL contains the length of the page buffer. (TPRSNH - "Should Not Happen"). DFHTPS has
scanned the MCR to identify the terminals to which
For messages directed to 3270 devices, the page this message is directed, and has created an AID to
buffer consists of a 3270 data stream with a 4-byte initiate CSPG (DFHTPR) at each of them. However,
page control area following it (a 3270 data stream may when DFHTPR retrieves the MCR, it cannot find the
be larger than the number of characters available on current terminal identifier in the list of terminals.
the screen, particularly if extended 3270 attributes are Presumably the MCR has been corrupted between
used). For messages directed to other devices, the creation of the AID and dispatching of CSPG at the
page buffer consists of a message formatted with NL terminal. Check back through the trace table to find
characters, a 4-byte page control area following it. The the instance of DFHTPS that built the AID for this
length in TSIOAVRL should be less than the length in terminal (transaction CSPS); it will have issued a TC
the preceding storage accounting area, otherwise an LOCATE request to verify that the terminal identifier is
error has occurred in constructing the page, possibly in valid, and this identifier can be seen in the trace entry.
prior BMS requests.
In either of the above cases, if the length of the area Problem determination
being output appears valid, it is necessary to increase
the control interval size for the temporary storage data The TS identifier is built in TCATSDI before the TS
set. purge is issued, although this has probably been
overwritten before the dump is taken. The trace table
entry for the DFHTS TYPE=PURGE contains the TS
identifier in the last 8 bytes.
Register Label Description
The OSPWA is addressed by register 9.
DFHMCP OPSTSID temporary storage identifier (8 bytes).
R8=@MCR MCPMCRTS The MCR is too long or
has invalid length ($4).
Register 8 points to the MCR.
DFHTPP
R7=@pgbuf TPNOPGL The page buffer is Register 5 points to the current entry.
or too large.
TPNODDS Register 0 points to the end of table.
Register 9 points to the TCTTE.
Module:
DFHMCP, DFHTPP The terminal list starts at MCRIDLST and the terminal
identifier is at the start of the terminal entry. Each
ABM5 terminal entry is X'15' bytes long.

Explanation Analysis: DFHMCP uses the temporary storage


identifier in OSPTSID.
A DFHTS TYPE=PURGE request has been issued with
an invalid REQID. This incorrect request was issued by Cannot find the terminal identifier for this terminal in
basic mapping support (BMS). the terminal list in the MCR.

DFHTPR cannot find the terminal identifier for the


current terminal in the terminal list in the message Register Label Description
control record (MCR).
R9=@(OSPWA) MCPCKPGS Code builds the temporary
storage code in TCATSDI
and issues DFHTS

Chapter 1. Transaction abend codes 23


TYPE=PURGE macro, System action
specifying IDERROR exit
of MCPTSIDE, where the The transaction is abnormally terminated with a CICS
abend is raised.
transaction dump.
R8=@(MCR) TPRCKID Code scans terminal list
for a terminal entry that
has the id of the current User response
terminal, and if it
cannot be found, links to Correct the application program that specified too
TPRSNH to raise the abend.
large or zero value for the JUSTIFY option.
Module: Module:
DFHMCP, DFHTPR DFHPBP
ABM6 ABM9

Explanation Explanation
Transaction CSPS, scheduled internally by BMS, has The text data overflow routines have been reentered
not been installed. while text overflow was in process. This condition
occurs when the line requirements for the text header
System action and/or trailer exceed the line capacity of the page for
which data is being formatted.
The transaction is abnormally terminated with a CICS
transaction dump.
System action

User response The transaction is abnormally terminated with a CICS


transaction dump.
Install the transaction CSPS (Group DFHBMS).
Module: User response
DFHMCP
Reduce the number of lines required for the header
ABM7 and/or trailer or increase the page size of the terminal.
Module:
Explanation DFHPBP
The trailer specified to be used while building pages of ABMA
text data is longer than the page.
Explanation
System action
The user has supplied a terminal I/O area (TIOA) with
The transaction is abnormally terminated with a CICS an invalid data length that was either equal to zero or
transaction dump. greater than the storage accounting length minus 12.
Alternatively, the length field of a header or trailer area
User response
provided by the application program is invalid (that is,
Correct the application program that issues the not positive).
request with too long a trailer.
Module: System action
DFHPBP The transaction is abnormally terminated with a CICS
ABM8 transaction dump.

Explanation User response

A BMS text request specified a value for the JUSTIFY Correct the program that supplied the erroneous data
option which is zero or too large for the page being length.
built. Check the TIOA. If either of the conditions described is
present, check the application program. For programs
using command-level interface, the TIOA is obtained
by CICS using the length of the data item passed in the
FROM option on an EXEC CICS SEND MAP or EXEC

24 CICS TS for z/OS: CICS Codes


CICS SEND TEXT command, or in the TRAILER or User response
HEADER option on an EXEC CICS SEND TEXT or an
Correct the program that specified the incorrect cursor
EXEC CICS SEND PAGE command. Check the data item
location.
for zero length.
Use trace to identify the statement issuing the request.
Header and trailer records have a special format
Check that the cursor position is being correctly set.
described in the Reference: application development.
The program may have been designed to run in
An ABMA abend occurs if the first halfword (the
alternate screen size mode but is being run in default
length) is not positive. Check the remainder of the
screen size mode, or it may have been designed to run
header/trailer record for validity when the length is
on a 3270 model different from the one in use. If the
checked.
program is routing a message, the route list should be
checked. If the program is to run with various 3270
Problem determination models, the cursor position should be within the size
The output services work area (OSPWA) is in user of the smallest screen.
storage and will be printed in a transaction dump. It is
addressed by register 2 at the time of the abend. Problem determination
Relevant fields are:
If the abend occurs in DFHPBP:
• OSPTR7
At the time of the abend, register 2 points to the
• OSPHDRA OSPWA and register 1 to the TTP. Relevant fields are:
• OSPTRLA • OSPTR3 has X'10' bit set to indicate a user-specified
Register 4 or OSPTIOA points to the TIOA. In the cursor position
TIOA, the following fields are relevant: • OSPCP contains a halfword cursor position specified
• TIOATDL by user

• TIOASAL • TTPSCSZ contains the halfword value of the screen


size to compare against.
Analysis:
If the abend occurs in DFHMCP or DFHMCX:
• Register 6 points to the OSPWA (in LIFO storage)
Register Label Description • OSPCP contains a halfword cursor position specified
by user
R4=@TIOA PBCKTDL TIOATDL is zero or
greater • OSPTR3 has X'10' bit set to indicate a user-specified
than TIOASAL-12. cursor position
R2=@OSPWA PBD20080 R0 (= first halfword of • OSPSCSZ contains the halfword value of the screen
R0=length trailer) is zero. size to compare against.
of trailer R8=OSPTRLA.
R8=@trailer OSPTR7 has X'20' bit set.
Analysis:
R2=@OSPWA PBDTXHDR R0 (= first halfword of
R8=@header header) is zero.
R0=length R8=OSPHDRA.
of header. OSPTR7 has X'40' bit set. Register Label Description

Module: In DFHPBP:
DFHPBP, DFHMCP R2=@OSPWA PBDBADC OSPTR3 X'10' bit set
indicates the user-
ABMB R1=@TTP specified cursor
position.
TTPSCSZ halfword screen
Explanation size.
OSPCP halfword cursor
The user has specified a cursor position in the BMS position.
output request. It is larger than the current screen size In DFHKCP or DFHMCX:
for the 3270 for which output is being built. R6=@OSPWA MCENEAU2 OSPTR3 X'10' bit set
indicates the user-
specified cursor
System action position.
OSPSCSZ halfword screen
size.
The transaction is abnormally terminated with a CICS OSPCP halfword cursor
transaction dump. position.

Chapter 1. Transaction abend codes 25


Module: User response
DFHPBP, DFHMCP (for minimum-function BMS),
If DFHTPR or DFHTPP issued the ABEND then examine
DFHMCX
the transaction dump for bad data in the TIOA. If the
ABMC origin of the bad data is an application program,
correct the program. If DFHWBBMS issued the ABEND
Explanation then check the validity of the incoming forms data in
the CICS trace.
The CMSG transaction is attempting to send a
message to a greater number of terminals than is Module:
possible. There is no fixed maximum because the DFHTPP, DFHTPR, DFHWBBMS
value depends on the other operands specified on the ABMF
routing command.
Explanation
System action
The value specified for the length option of the basic
The transaction is abnormally terminated with a CICS mapping support (BMS) send map is greater than the
transaction dump. length of the 'from' area.

User response System action


Redefine the route list. The transaction is abnormally terminated with a CICS
Module: transaction dump.
DFHMCP
User response
ABMD
Redefine the value for the length option.
Explanation Module:
DFHTPR or DFHTPP has issued a DFHDI TYPE=SEND DFHPBP
and has received a return code other than "FUNCERR- ABMG
REQUEST FOR CHANGE DIRECTION SIGNALED" or
"NORESP"
Explanation

System action The user has requested a basic mapping support


(BMS) service that was not specified at system
The transaction is abnormally terminated with a CICS generation, or at initialization.
transaction dump.
System action
User response
The transaction is abnormally terminated with a CICS
Inform your system programmer. transaction dump.
Module:
DFHTPP, DFHTPR User response
ABME Correlate services requested against options specified
in the system generation of BMS.
Explanation Follow this procedure:
DFHTPR or DFHTPP has detected an invalid 1. Scan the trace table for the transaction ID that
datastream or DFHWBBMS detected invalid forms data issued the abend. If this is CSPQ (page cleanup),
while processing a basic mapping support (BMS) module DFHTPQ abnormally terminated because a
request. message purge delay of zero has been specified
and CSPQ has been entered via a terminal. The
System action message purge delay is specified in the PRGDLAY
of the DFHSIT macro, and its value can be found in
The transaction is abnormally terminated with a CICS
SITPRGD.
transaction dump. If the ABEND was issued from
DFHTPR or DFHTPP then register 7 indicates the 2. Scan the trace table for the last BMS request (code
location at which the ABEND was detected. 'FA'). Use the option bytes at the start of the failing

26 CICS TS for z/OS: CICS Codes


module to see if the requested functions have been User response
generated. For example, paging may have been
Either define another input map or redefine the
requested, but standard or minimum BMS was
existing map.
specified in the SIT.
3. If the BMS request is compatible with the BMS Module:
options in the CICS system generation, some DFHMCP, DFHMCX, DFHMCY
incompatible suffixing amongst BMS modules must ABML
have occurred. This can happen if the DFHSIT
macro specified individual suffixes for the BMS Explanation
modules.
The terminal control locate routine received invalid
The following modules differ between standard and data from DFHRLR and returns with an error return
full-function BMS: code. DFHRLR is attempting to scan the TCT for a BMS
DFHMCP ROUTE request with LIST=ALL or operator class or
DFHRLR operator ID specified in the route list. The terminal
DFHPBP control table may have been corrupted.
DFHTPP
System action
Module:
DFHMCP, DFHTPQ The transaction is abnormally terminated with a CICS
transaction dump.
ABMH
User response
Explanation
If you need further assistance from IBM to resolve this
The BMS mapping program DFHMCX or DFHMCY failed problem, see IBM problem support for guidance on
in an attempt to update the output TIOA because it how to proceed.
detected that storage outside the TIOA would have
been corrupted. The terminal control table has probably been
corrupted during execution. Attempt to scan through
the TCT in a dump. (Because the system dump uses
System action
the same technique for printing all TCTTEs, the system
The transaction is abnormally terminated with a CICS dump fails at the same point.)
transaction dump.
Determine which entry is incorrect. It may be that the
TCTTE has been overwritten by user data that is
User response recognizable in the dump.
Identify and inspect the BMS map being used with the Check the application program for references to the
BMS SEND command. Check the map for errors in the TCTTE pointer. Check for user data that may be
map definition such as inconsistencies between the addressed from the same pointer.
length specified on the DFHMDF macro and the actual
length of data included in the field. If no errors can be In an assembler program, there may be multiple
identified contact IBM support for further assistance. equates for the TCTTE base register.

Module: It may be that the TCT is being overwritten by some


DFHMCX, DFHMCY earlier transaction. If this is so, it is probably one
associated with the terminal whose TCTTE is
ABMI overwritten.

Explanation Problem determination


The map specified for a BMS input mapping request Register 11 points to the current TCTTE in the search.
was not an input map.
The TCT prefix (DFHTCTFX) can be located from
CSATCTBA.
System action
The first terminal entry (TCTTE) in the TCT is
The transaction is abnormally terminated with a CICS
addressed by TCTVTEBA.
transaction dump.
TCTTETEL is the halfword offset from current TCTTE to
the next.

Chapter 1. Transaction abend codes 27


Analysis: The current TCTTE address is either not on a device, since the console has the appearance to CICS
full-word boundary or is not within the limits of the of a keyboard/printer device. The CQRY transaction
TCT, or the address of the next TCTTE, obtained by does not have an operator interface, and under normal
adding TCTTETEL to the current address, is invalid. conditions there is no need for an operator to invoke
This check is made by locate code (DFHZLOC) in CQRY or for a user transaction to START the CQRY
DFHZCX. transaction. CQRY is run automatically by CICS when a
3270 or SCSPRINT device connects. In the transaction
dump, register 8 contains the address of the TCTTE for
Register Label Description
R11=@TCTTE RLRLOCN Issue DFHTC CTYPE=LOCATE the associated terminal. If register 8 contains zero,
this indicates that the task is not terminal-oriented.
Module:
DFHRLR for full-function BMS System action
ABMM The task is abnormally terminated with a CICS dump.

Explanation User response


An invalid map was specified. Ensure that the terminal associated with CQRY is of
the 3270 or SCSPRINT family of devices.
System action Module:
The transaction is abnormally terminated with a CICS DFHQRY
transaction dump. ABMR

User response Explanation


Use the supplied dump to diagnose the problem. The Page Retrieval transaction (CSPG) has been
Register 6 contains the address of the BMS instruction initiated but the task is not terminal-oriented.
being executed when the error was recognized.
Module: System action
DFHPBP
The task is abnormally terminated with a CICS dump.
ABMO
User response
Explanation
Ensure that a terminal is associated with the CSPG
The map specified for a BMS output mapping request transaction.
was not an output map.
Module:
DFHTPR
System action
ABMT
The transaction is abnormally terminated with a CICS
transaction dump.
Explanation
User response A BMS request has been issued for a terminal type
which does not support the level of BMS required by
Either define another output map or redefine the the request. This might be a non-3270 type terminal
existing map. for an input or output request, or a non-bridge facility
Module: for a locate map request. Locate map requests are
DFHMCP, DFHMCX, DFHMCY only issued internally by CICS 3270 bridge related
code.
ABMQ
This abend might also be issued if the level of BMS
Explanation required by the request is not supported by the CICS
region.
The query transaction (CQRY) has been initiated and
either the task is not terminal-oriented, or the System action
associated terminal is not defined to CICS as a 3270 or
SCSPRINT device. This abend will occur if CQRY is The task is abnormally ended with a CICS transaction
entered at a console, even when the console is a 3270 dump.

28 CICS TS for z/OS: CICS Codes


User response Explanation
Ensure that the terminal and the CICS region supports A text string passed to BMS contained a set attribute
the BMS request. order that was invalid for one of the following reasons:
Module: 1. The set attribute sequence was less than three
DFHMCP, DFHMCX characters.
ABMU 2. The attribute type was invalid.

Explanation System action

The application program supplied an address that is The task is abnormally terminated with a CICS
not within region boundaries. The low-order 3 bytes of transaction dump.
general register 1 in the transaction dump contain the
erroneous address. The high-order byte of register 1 User response
indicates the address type as follows:
Correct the application program.
Module:
X'01' - Title address (TCAMSTA)
X'02' - Alternate I/O area address (TCAMSIOA) DFHPBP
X'03' - Map address (TCABMSMA)
X'04' - Header address (TCAMSHDR) ABMY
X'05' - Route list address (TCAMSRLA)
X'06' - Trailer address (TCAMSTRL)
X'07' - Map set address (TCAMSMSA) Explanation
X'08' - TIOA address (TCTTEDA)
BMS is building a TTP (Terminal Type Parameter)
control block but the pagesize selected for a terminal
System action by BMS is zero because either the default or alternate
The transaction is abnormally terminated with a CICS screensize has been defined as zero.
transaction dump. In the transaction dump, significant general purpose
register contents are as follows:
User response
1. Register 6 points to the BMS extension of the
Correct the application program that is supplying the TCTTE
erroneous address. 2. Register 10 points to the TTP (Terminal Type
Module: Parameter) control block
DFHMCP, DFHEMS 3. Register 11 points to the TCTTE
ABMV
System action
Explanation The task is abnormally terminated with a CICS
DFHRLR has detected an invalid route list entry. transaction dump.

System action User response

The transaction is abnormally terminated with a CICS Check the TERMINAL and TERMTYPE definitions which
transaction dump. determined the attributes of the offending TCTTE.
Module:
User response DFHRLR
Check that the route list is correctly built with reserved ABMZ
field in the entry containing blank and a stopper of
halfword X'FFFF' to terminate the list. Explanation
Module: The address of the terminal I/O area (TIOA) in
DFHRLR TCTTEDA was found to be zero.
ABMX When using BMS fast path as a result of an EXEC CICS
RECEIVE MAP, DFHEMS always initializes TCTTEDA
with the address of the TIOA. If TCTTEDA is

Chapter 1. Transaction abend codes 29


subsequently found to be zero by DFHMCX, an ABNC
overwrite must have occurred.
Explanation
System action
An attempt to access a temporary storage queue
The transaction is abnormally terminated with a CICS failed.
transaction dump.
System action
User response
The task is abnormally terminated with a CICS
Investigate why TCTTEDA is zero. transaction dump.
Scan the trace table for the last BMS request (code FA)
for the failing task and try to determine which user User response
programs have been given control since that BMS Ensure that temporary storage is correctly generated.
request.
Module:
Module: DFHTPS
DFHMCP, DFHMCX, DFHMCY
ABNE
ABNA
Explanation
Explanation
An error response was received from an invocation of a
No route list was supplied with a route request BMS TYPE=ROUTE or TYPE=STORE request.
received from the :i1.DFHTPS abend codes remote
system.
System action

System action The task is abnormally terminated with a CICS


transaction dump.
The task is abnormally terminated with a CICS
transaction dump.
User response

User response Check that BMS was correctly generated.

If you need further assistance from IBM to resolve this Module:


problem, see IBM problem support for guidance on DFHTPS
how to proceed. ABNF
Module:
DFHTPS Explanation
ABNB The transaction was not in send mode when it sent
data to the remote system.
Explanation
System action
Either the principal facility of the task is not a TCTTE of
the correct type, or the task has no principal facility. The task is abnormally terminated with a CICS
transaction dump.
System action
User response
The task is abnormally terminated with a CICS
transaction dump. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
User response how to proceed.
Ensure that DFHTPS has not been specified as the Module:
initial program of a transaction other than CSPS. Check DFHTPS
that the operator did not enter CSPS from the terminal. ABNG
Module:
DFHTPS

30 CICS TS for z/OS: CICS Codes


Explanation Explanation
An attach request was received from the remote The task was purged before a call to another domain
system without any data indicating the reason for the was able to complete successfully. The task that first
request. detected the purged condition provides an exception
trace.
System action
System action
The task is abnormally terminated with a CICS
transaction dump. The task is abnormally terminated with a CICS
transaction dump.
User response
User response
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Investigate the reason why the task was purged. It
how to proceed. was purged either by the master terminal operator or
as a result of a deadlock timeout.
Module:
DFHTPS Module:
DFHTPS
ABNH
ABNK
Explanation
Explanation
An attempt to ship data to the remote system failed.
An error (INVALID, DISASTER or unexpected
System action EXCEPTION response) has occurred on a call another
domain. The domain that detected the original error
The task is abnormally terminated with a CICS provides an exception trace, a console message and,
transaction dump. possibly, a system dump (depending on the options
specified in the dump table).
User response
If you need further assistance from IBM to resolve this System action
problem, see IBM problem support for guidance on The task is abnormally terminated with a CICS
how to proceed. transaction dump.
Module:
DFHTPS User response
ABNI See the related message produced by the domain that
detected the original error.
Explanation Module:
CICS could not find a profile for an LU6.2 transaction DFHTPS
routing request. ABR3

System action Explanation


CICS terminates the task abnormally. An unsupported BMS request was received by the
bridge exit.
User response
Either you have specified an incorrect name in the System action
PROFILE parameter of an EXEC CICS ALLOCATE The task is abnormally terminated with a CICS
command, or you have not installed the profile. transaction dump.
Correct the error before resubmitting the transaction.
Module: User response
DFHTPS
The bridge only supports minimum function BMS and
ABNJ SEND TEXT. This transaction cannot be used in a
bridge environment.

Chapter 1. Transaction abend codes 31


Module: DFHBRMR
DFHEMS
ABRC
ABR4
Explanation
Explanation
The bridge exit is not defined and could not be
The link DFHL3270 command did not specify a autoinstalled.
commarea.
System action
System action
The task is abnormally terminated with a CICS
The task is abnormally terminated with a CICS transaction dump. The user transaction will not be
transaction dump. started.

User response User response


The link DFHL3270 command must specify a Either define the program using RDO or change the
commarea to contain the BRIH and any message program autoinstall exit to allow it to be autoinstalled.
vectors.
Module:
Module: DFHBRMS, DFHBRTC
DFHBRMR
ABRD
ABR5
Explanation
Explanation
The bridge exit is disabled.
The commarea specified in the link DFHL3270
command is shorter than the BRIH. System action
The task is abnormally terminated with a CICS
System action
transaction dump. The user transaction will not be
The task is abnormally terminated with a CICS started.
transaction dump.
User response
User response
Identify why the bridge exit is disabled. Enable the
The link DFHL3270 command must specify a bridge exit and retry the action.
commarea to contain the BRIH and any message
Module:
vectors.
DFHBRMS, DFHBRTC
Module:
ABRE
DFHBRMR
ABR6 Explanation
The bridge exit could not be loaded.
Explanation
The commarea specified in the link DFHL3270 System action
command does not contain a valid BRIH.
The task is abnormally terminated with a CICS
transaction dump. The user transaction will not be
System action
started.
The task is abnormally terminated with a CICS
transaction dump. User response
Investigate why it cannot be loaded. It may not have
User response
been defined in the DFHRPL library.
The link DFHL3270 command must specify a
Module:
commarea which must contain a valid BRIH.
DFHBRMS, DFHBRTC
Module:

32 CICS TS for z/OS: CICS Codes


ABRF Before the client reused the bridge facility token, CICS
had already discarded it. Check the bridge facility keep
Explanation time in the outbound messages. CICS will use the keep
time value specified in the last message used by a
The bridge exit is defined as remote. transaction. Alternatively use the trace or CEDX to look
at the keep time in the BRXA passed back on the
System action terminate call to the bridge exit.
The task is abnormally terminated with a CICS Another possible error is that the client application
transaction dump. The user transaction will not be passed a request to a CICS system other than that on
started. which the original request was sent. Bridge facilities
are only valid on a single CICS system.
User response Module:
Define the bridge exit as a local program. DFHBRXM

Module: ABRI
DFHBRMS, DFHBRTC
Explanation
ABRG
There are no free bridge facility tokens available. This
Explanation is probably due to excessive keep time values being
specified on the bridge exit termination call.
An invalid bridge facility token was specified
System action
System action
The task is abnormally terminated with a CICS
The task is abnormally terminated with a CICS transaction dump. The user transaction will not be
transaction dump. The user transaction will not be started.
started.
User response
User response
Review the keep time values used by the client
This error was probably caused by the incorrect data applications. If some client applications are returning
being sent to the bridge exit from the client excessive values, modify the bridge exit to specify a
application. limit to the values.
Check the data set by tracing the data sent from the Module:
client application. DFHBRXM
Ensure that the bridge facility token in the data ABRJ
transmitted by the application is correct.
Module: Explanation
DFHBRXM
An invalid FACILITYLIKE value was specified.
ABRH The FACILITYLIKE value can be specified on the bridge
exit initialization call. If the default value (blanks) is
Explanation returned, the value in the user transaction profile
The bridge facility token specified is not known to definition is used. If no FACILITYLIKE value is
CICS. specified in the profile definition, a value of CBRF is
used.
System action The name must be that of an installed VTAM 3270
terminal.
The task is abnormally terminated with a CICS
transaction dump. The user transaction will not be
started. System action
The task is abnormally terminated with a CICS
User response transaction dump. The user transaction will not be
started.
The most likely error is that the client application
specified too small a keep time for the bridge facility.

Chapter 1. Transaction abend codes 33


User response System action
Define the terminal specified by FACILITYLIKE, change The task is abnormally terminated with a CICS
the value on the profile definition, change the value transaction dump.
supplied by the client application, or install a terminal
definition for CBRF User response
Module: Determine why the bridge client is no longer available.
DFHBRXM It might have been purged.
ABRK Module:
DFHBRME
Explanation
ABRQ
The user ID check failed following the call to run the
Link3270 bridge request, because it does not match Explanation
the user ID that created the bridge facility that is being
used to service the request. The bridge exit issued an abend.

System action System action

The task is abnormally terminated with a CICS The transaction is backed out.
transaction dump. The user transaction will not be
started. User response
Identify why the bridge exit abended.
User response
Module:
A Link3270 bridge facility must run under the control DFHBRMS, DFHBRTC
of a single userid for the lifetime of its use. Ensure that
all of the programs that use Link3270 sessions run ABRR
uder the same user ID.
Explanation
Module:
DFHBRXM The user transaction's profile could not be found.
ABRN
System action
Explanation The task is abnormally terminated with a CICS
transaction dump. The user transaction is not started.
The bridge exit returned a value in BRXA_RESP that is
not valid for the command for which it was invoked.
User response
System action Check that the profile name in the user transaction
definition is correct, and that this profile has been
The transaction is backed out.
defined.

User response Module:


DFHBRXM
Change the bridge exit to only return valid response
settings. ABRX

Module:
Explanation
DFHBRIC, DFHBRMS, DFHBRSP, DFHBRTC
The bridge facility was invalid when a transaction
ABRP
started. This can occur when MAXTASK is reset to a
low value on a busy system. The bridge facility can
Explanation time out and be deleted before the user transaction is
The bridge client is no longer available. started.

System action
The user transaction will abend during initialisation.

34 CICS TS for z/OS: CICS Codes


User response User response
None. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
Module:
how to proceed.
DFHBRXM
Module:
ABRY
DFHTBS

Explanation ABSX

CICS returned an unexpected error running the bridge


Explanation
exit. This is a CICS internal error.
CICS has detected that a BMS protected field has been
System action updated by the client.

The task is abnormally terminated with a CICS


System action
transaction dump.
The task is abnormally terminated with a CICS
User response transaction dump.

If you need further assistance from IBM to resolve this


User response
problem, see IBM problem support for guidance on
how to proceed. The message DFHTF0200 will give details of the client
and the field updated.
Module:
DFHBRMS, DFHBRTC Refer to this message for further actions.
ABRZ Module:
DFHMCPE
Explanation ABX1
The bridge exit returned invalid data in the BRXA.
Explanation
System action The bridge exit or formatter was called with an invalid
The task is abnormally terminated with a CICS BRXA-HEADER. This indicates a storage overwrite.
transaction dump.
System action
User response An exception trace is made of the data in error. The
If a user supplied bridge exit was used, review the task is abnormally terminated with a CICS transaction
format of the data returned by the exit. dump.

If a CICS supplied exit was used, this is a CICS error. If As CICS also does a check of the BRXA on return from
you need further assistance from IBM to resolve this the call to the exit, there will probably be a subsequent
problem, see IBM problem support for guidance on ABRZ abend.
how to proceed.
User response
Module:
DFHBRIC, DFHBRMS, DFHBRSP, DFHBRTC, DFHXMBR Investigate the cause of the storage error, and retry.
ABSA Module:
DFH0CBAE,DFH0CBRE,DFH0CBRF
Explanation ABX2
A message passed to DFHBSMSG is too long. This is a
CICS internal error. Explanation
The bridge exit or formatter was called with an invalid
System action BRXA-TRANSACTION-AREA. This indicates a storage
CICS terminates the task abnormally with a dump. overwrite.

Chapter 1. Transaction abend codes 35


System action Explanation
An exception trace is made of the data in error. The The bridge exit or formatter was called with an invalid
task is abnormally terminated with a CICS transaction user-area. This indicates a storage overwrite or an
dump. error in the bridge exit.
As CICS also does a check of the BRXA on return from
the call to the exit, there will probably be a subsequent System action
ABRZ abend. An exception trace is made of the data in error. The
task is abnormally terminated with a CICS transaction
User response dump.
Investigate the cause of the storage error, and retry.
User response
Module:
DFH0CBAE,DFH0CBRE,DFH0CBRF Investigate the cause of the storage error, and retry.

ABX3 Module:
DFH0CBAE,DFH0CBRE,DFH0CBRF
Explanation ABX7
The bridge exit or formatter was called with an invalid
BRXA-COMMAND-AREA. This indicates a storage Explanation
overwrite. A TC command passed to the formatter, exceeded the
maximum message size.
System action
An exception trace is made of the data in error. The System action
task is abnormally terminated with a CICS transaction An exception trace is made of the first 4K of data in
dump. error. The task is abnormally terminated with a CICS
As CICS also does a check of the BRXA on return from transaction dump.
the call to the exit, there will probably be a subsequent
ABRZ abend. User response
Check that the user transaction is passing the correct
User response data. If it is, it will be necessary to change the size of
Investigate the cause of the storage error, and retry. the buffer. This is in field block-length in the sample
exit. Recompile and reload the exit and retry.
Module:
DFH0CBAE,DFH0CBRE,DFH0CBRF Module:
DFH0CBRF
ABX5
ABX8
Explanation
Explanation
The bridge exit or formatter was called without a user-
area. This probably indicates an error in the bridge A next BMS BRMQ vector in the input message passed
exit. to the formatter does not contain the mapset
requested to answer a RECEIVE MAP request.
System action
System action
An exception trace is made of the data in error. The
task is abnormally terminated with a CICS transaction The task is abnormally terminated with a CICS
dump. transaction dump.

User response User response

Investigate the cause of the storage error, and retry. This may just indicate that the transaction has gone
down an error path which should result in a
Module: transaction backout. If not, the input message should
DFH0CBAE,DFH0CBRE,DFH0CBRF have a BRMQ vector for this mapset. Change the client
ABX6 application, recompile and retry.

36 CICS TS for z/OS: CICS Codes


Module: System action
DFH0CBRF
The task is abnormally terminated with a CICS
ABXA transaction dump.

Explanation User response


A next BRMQ vector in the input message passed to Check for other CICS messages and exception trace
the formatter is the wrong type of a RECEIVE vector. entries to investigate the cause of the SYNCPOINT
RECEIVE and RECEIVE MAP have separate vectors. error.
Module:
System action DFH0CBRE
The task is abnormally terminated with a CICS ABXD
transaction dump.
Explanation
User response
An error occurred when a SYNCPOINT ROLLBACK
This may just indicate that the transaction has gone request was issued by the bridge exit.
down an error path which should result in a
transaction backout. If not, the input message should
System action
have a BRMQ vector for this command. Change the
client application, recompile and retry. The task is abnormally terminated with a CICS
transaction dump.
Module:
DFH0CBRF
User response
ABXB
Check for other CICS messages and exception trace
entries to investigate the cause of the SYNCPOINT
Explanation
ROLLBACK error.
The BRIH requested that outbound BMS vector must
Module:
include the ADS descriptor. The map did not contain
DFH0CBRE
an ADS descriptor. This means that the mapset was
not assembled with CICS TS 1.2 or later. ABXE

System action Explanation


The task is abnormally terminated with a CICS The bridge exit was expecting data to be passed on the
transaction dump. BRDATA parameter of the START command. No data
was found.
User response
System action
Either reassemble the mapset using the current level
of BMS macros, or set BRIH-ADSDESCRIPTOR to The task is abnormally terminated with a CICS
BRIHADSD-NO (the default value is BRIHADSD-YES). transaction dump.
Note that BRIHADSD-YES is required when codepage
conversion of the Link3270 message is required (e.g. User response
using ECI). If you need to reassemble the mapset and
don't have the mapset source, the utility DFHBMSUP Correct the transaction which issued the START.
can be used to recreate it. Recompile, reload and retry.

Module: Module:
DFHBRMF DFH0CBAE,DFH0CBRE

ABXC ABXF

Explanation Explanation

An error occurred when a SYNCPOINT request was An error was detected by the bridge exit when it tried
issued by the bridge exit. to input the next message.

Chapter 1. Transaction abend codes 37


System action Explanation
An exception trace is made of any error information. A message received by the bridge exit, exceeded the
The task is abnormally terminated with a CICS maximum message size.
transaction dump.
System action
User response
An exception trace is made of the first 4K of data in
Check for other CICS messages and exception trace error. The task is abnormally terminated with a CICS
entries to investigate the cause of the input error. transaction dump.
Module:
DFH0CBAE,DFH0CBRE,DFH0CBAI User response

ABXG Check that the client application is passing the correct


data. If it is, it will be necessary to change the size of
the buffer. This is in field block-length in the sample
Explanation
exit. Recompile and reload the exit and retry.
An error was detected by the bridge exit when it tried
Module:
to output the next message.
DFH0CBAE,DFH0CBRE

System action ABXJ

An exception trace is made of any error information.


Explanation
The task is abnormally terminated with a CICS
transaction dump. The bridge exit detected an error in the MQCIH header
passed by the client application.
User response
System action
Check for other CICS messages and exception trace
entries to investigate the cause of the output error. An exception trace is written containing the MQCIH
header. The task is abnormally terminated with a CICS
Module:
transaction dump.
DFH0CBAE,DFH0CBRE
ABXH User response
The client application has either not set the MQCIH
Explanation
header, or is using a version of the header which is
The user transaction issued a request which requires incompatible with the bridge exit. Correct the client
more data (such as a RECEIVE request). No data was application. Recompile, reload and retry.
available in the message, and mqcih-
Module:
conversationaltask was set to mqcct-no which
DFH0CBAE,DFH0CBRE
specifies that the transaction is non conversational.
ABXK
System action
Explanation
The task is abnormally terminated with a CICS
transaction dump. The bridge exit detected an error in the data passed on
the BRDATA parameter of the START command.
User response
System action
This may be correct behaviour as defined by the client
application. If it is not, the client application should An exception trace is made of the data in error. The
either supply additional data, or be redesigned to task is abnormally terminated with a CICS transaction
allow the transaction to be conversational. dump.
Module:
DFH0CBRF User response

ABXI Correct the transaction which issued the START.


Recompile, reload and retry.
Module:

38 CICS TS for z/OS: CICS Codes


DFH0CBAE,DFH0CBRE is made of the MQCIH and BRMQ vector. The task is
abnormally terminated with a CICS transaction dump.
ABXM

User response
Explanation
Correct the client application. Recompile, reload and
The bridge exit or formatter was called with a function
retry.
or command which it doesn't support. This either
indicates a storage overwrite, or that the bridge exit is Module:
not designed for this command. DFH0CBRF
ABXP
System action
An exception trace is made of the data in error. The Explanation
task is abnormally terminated with a CICS transaction
The formatter detected an error in a BRMQ vector
dump.
header passed by the client application.

User response
System action
Check the BRXA data in the trace to see if there has
The field MQCIH-ERROROFFSET is set to indicate the
been a storage overwrite, or whether the exit supports
position of the error in the message An exception trace
this command.
is made of the MQCIH and BRMQ vector. The task is
Module: abnormally terminated with a CICS transaction dump.
DFH0CBAE,DFH0CBRE,DFH0CBRF
ABXN User response
Correct the client application. Recompile, reload and
Explanation retry.
The formatter detected that the input message was Module:
truncated. DFH0CBRF
ABXQ
System action
An exception trace is made of the first 4K of the Explanation
message. The task is abnormally terminated with a
The formatter could not find an ADSD vector as part of
CICS transaction dump.
the BRMQ-RM vector when MQCIH-ADSDESCRIPTOR
specified MQCADSD-MSGFORMAT.
User response
Check that the transport mechanism allows for System action
messages of this length. If this is correct, it indicates
An exception trace is made of the request. The task is
that the client application is issuing an incorrect
abnormally terminated with a CICS transaction dump.
message. Trace the outbound message on the client
application. Recompile, reload and retry.
User response
Module:
DFH0CBRF Correct the client application. Recompile, reload and
retry.
ABXO
Module:
DFH0CBRF
Explanation
ABXS
The formatter detected an error in a BRMQ vector
passed by the client application.
Explanation
System action An error was detected by the bridge exit when it tried
to open the queue for the input or output message.
The field MQCIH-ERROROFFSET is set to indicate the
position of the error in the message An exception trace

Chapter 1. Transaction abend codes 39


System action codepage. for example client code page 852 from
Latin-2 group, is only supported to server code page
An exception trace is made of any error information.
870.
The task is abnormally terminated with a CICS
transaction dump. Module:
DFHBRMF
User response ABXV
Check for other CICS messages and exception trace
entries to investigate the cause of the open error. Explanation
Module: The client code page which has been requested by the
DFH0CBRE client is not one which CICS can support.
ABXU
System action
Explanation The transaction is abnormally terminated with a
transaction dump.
The conversion between client code page and server
code page is not supported by CICS/390; for example
conversion has been requested between Japanese User response
code page 932 and Latin-1 code page 500. Ensure that the Client codepage is valid.
Module:
System action
DFHBRMF
The transaction is abnormally terminated with a
transaction dump.

User response
Ensure that the Client codepage, both default and
overrides are in the same group as the Server

ACxx abend codes


ACAA • A CICS logic error has occurred.

Explanation System action


This explanation applies to the two transaction abend • In a CICS environment, the CEDA transaction is
codes, ACAA and ACAD. CICS cannot find a match for a abnormally terminated with a CICS transaction
function code in the language definition table because dump.
the parameterized resource definition contains an • In a batch environment, processing is abnormally
unrecognized resource type code. The abend code terminated with an operating system dump.
issued depends on the DFHCAP operation that was
invoked before the error occurred:
User response
Abend
Ensure that the DFHEITCU module is in the library and
DFHCAP operation
is valid for this release of CICS.
ACAA
If a valid version of DFHEITCU is already in the library,
ANALYZE a CICS logic error has occurred. See IBM problem
ACAD support for guidance on how to proceed.

DEFAULTS Module:
DFHCAP
The cause of the abend is either:
ACAD
• The language definition table, DFHEITCU, in the
library is invalid for the release of CICS you are
running, or

40 CICS TS for z/OS: CICS Codes


Explanation Explanation
See ACAA. An internal error has occurred when module
DFHECBAM was invoked while processing a CBAM
System action:
transaction.
User response:
Module: System action
DFHCAP CBAM is abnormally terminated with a CICS
ACAI transaction dump.

Explanation User response

An internal error has occurred when module DFHCAP If you need further assistance from IBM to resolve this
was invoked. There was an invalid function code for a problem, see IBM problem support for guidance on
domain call to DFHCAP. how to proceed.
Module:
System action DFHECBAM
• In a CICS environment, the CEDA transaction is ACC1
abnormally terminated with a CICS transaction
dump. Explanation
• In a batch environment, processing is abnormally Abend codes with 'ACC' as the first three characters
terminated with an operating system dump. are issued by the C/370 compiler running under CICS.
These are documented in the IBM C/370 General
User response Information.
If you need further assistance from IBM to resolve this System action:
problem, see IBM problem support for guidance on
how to proceed. User response:

Module: Module:
DFHCAP ACC2
ACAJ
Explanation
Explanation Abend codes with 'ACC' as the first three characters
An internal error has occurred when module DFHCAP are issued by the C/370 compiler running under CICS.
was invoked while processing an EXEC CICS CREATE These are documented in the IBM C/370 General
command. The preallocated dynamic storage area was Information.
too small. System action:
User response:
System action
Module:
The transaction executing the EXEC CICS CREATE
command is abnormally terminated with a CICS ACC3
transaction dump.
Explanation
User response
Abend codes with 'ACC' as the first three characters
If you need further assistance from IBM to resolve this are issued by the C/370 compiler running under CICS.
problem, see IBM problem support for guidance on These are documented in the IBM C/370 General
how to proceed. Information.
Module: System action:
DFHCAP User response:
ACAM
Module:
ACC4

Chapter 1. Transaction abend codes 41


Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACC9
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACC5
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCA
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACC6
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCB
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACC7
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCC
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACC8
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCD
These are documented in the IBM C/370 General
Information.
System action:

42 CICS TS for z/OS: CICS Codes


Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCI
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACCE
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCJ
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACCF
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCK
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACCG
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCL
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACCH
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCM
These are documented in the IBM C/370 General
Information.
System action:

Chapter 1. Transaction abend codes 43


Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCR
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACCN
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCS
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACCO
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCT
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACCP
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCU
These are documented in the IBM C/370 General
Information.
Explanation
System action:
Abend codes with 'ACC' as the first three characters
User response: are issued by the C/370 compiler running under CICS.
Module: These are documented in the IBM C/370 General
Information.
ACCQ
System action:
Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACCV
These are documented in the IBM C/370 General
Information.
System action:

44 CICS TS for z/OS: CICS Codes


Explanation User response:
Abend codes with 'ACC' as the first three characters Module:
are issued by the C/370 compiler running under CICS.
ACFA
These are documented in the IBM C/370 General
Information.
Explanation
System action:
During the loading of a Coupling Facility Data Table by
User response: the CFCL transaction, an abend was detected or a
Module: domain call returned a response (such as DISASTER)
after which normal processing could not continue.
ACCW
System action
Explanation
A message is issued (one of DFHFC7100, DFHFC7101,
Abend codes with 'ACC' as the first three characters DFHFC7103 or DFHFC7104). Loading of the data table
are issued by the C/370 compiler running under CICS. is terminated and CFCL abends.
These are documented in the IBM C/370 General
Information.
User response
System action:
If this abend is produced as a result of an abend
User response: during loading, message DFHFC7103 is issued. If it is a
result of a domain call failure, depending on which
Module:
domain the failure was returned by, one of the
ACCY messages DFHFC7100, DFHFC7101 or DFHFC7104 is
issued. Refer to the description of the message for
Explanation further information and guidance.

Abend codes with 'ACC' as the first three characters Module:


are issued by the C/370 compiler running under CICS. DFHFCDL
These are documented in the IBM C/370 General ACFB
Information.
System action: Explanation
User response: A transaction has issued a request to a coupling facility
data table for which it holds an active lock, but after
Module:
the lock was acquired, the coupling facility data table
ACCZ server for the pool in which this coupling facility data
table resides failed and was restarted. This request is
Explanation of a type which cannot continue against a new
instance of the server, because it is reliant on the lock
Abend codes with 'ACC' as the first three characters which was acquired before the server failed.
are issued by the C/370 compiler running under CICS.
These are documented in the IBM C/370 General
System action
Information.
The requesting transaction abends with a transaction
System action:
dump.
User response:
CICS continues normally.
Module:
ACCX User response
Retry the failed transaction.
Explanation
Module:
Abend codes with 'ACC' as the first three characters DFHEIFC
are issued by the C/370 compiler running under CICS.
ACFC
These are documented in the IBM C/370 General
Information.
System action:

Chapter 1. Transaction abend codes 45


Explanation System action
A transaction has issued a request to a coupling facility The transaction is abnormally terminated. CICS
data table which was last accessed using a previous processing continues.
instance of the coupling facility data table server (that
is, the server for the pool in which this coupling facility User response
data table resides has failed and been restarted one or
more times since the last access). We therefore need Establish why an attempt was made to attach CFCL
to reopen the access between this CICS file and the illegally, or why a transaction definition specified
coupling facility data table, but the attempt to reopen DFHFCDL as the program to be given control.
access has failed. Module:
DFHFCDL
System action
ACHA
The requesting transaction abends with a transaction
dump. Explanation
CICS continues normally. The remote server transaction, CEHS, is not at a
compatible level to operate with the CICS/CMS
User response system. This usually indicates that the service levels of
CICS/CMS and the remote server are different.
Retry the failed transaction. If the error continues to
occur, issue an explicit close request for the file,
followed by an explicit open request. System action

Module: CICS terminates the remote server transaction


DFHEIFC abnormally with a dump.

ACFD
User response

Explanation If you need further assistance from IBM to resolve this


problem, see IBM problem support for guidance on
During the loading of a Coupling Facility Data Table by how to proceed.
the CFCL transaction, a call to the CICS Transaction
Manager has returned a response (such as DISASTER)
Problem determination
after which normal processing could not continue.
To diagnose a problem with the remote server, it is
System action generally helpful to obtain a trace of the remote
server's activity up to the point of failure.
Message DFHFC7121 is issued. Loading of the data
table is terminated and CFCL abends. A remote server trace is obtained by invoking the
remote server with the TRACE option, (type CEHS
TRACE). The remote server operates as normal but
User response
causes entries to be written to a trace log in temporary
Refer to the description of the message for further storage. Note that main storage, not auxiliary, is used
information and guidance. for this queue hence large amounts of memory can be
used up if this trace is left on for long.
Module:
DFHFCDL The trace is found in a queue whose name is
'CEHSxxxx', where 'xxxx' is the four-character terminal
ACFE
identifier. The queue can be browsed in text form or in
hexadecimal form using CEBR. To find the terminal
Explanation identifier, invoke CEBR on the terminal that has run
An attempt was made to attach a transaction CEHS, without giving a queue name. The queue name
specifying DFHFCDL as the program to be given will default to 'CEBRxxxx', where 'xxxx' is the terminal
control, but the transaction was not internally identifier.
attached by CICS. Note: CEBR requires the queue name to be in UPPER
DFHFCDL is for use by CICS system transaction CFCL. CASE.
This loads a Coupling Facility Data Table. For a description of the remote server and its trace
entries and abend codes, see the (LC33-0438).

46 CICS TS for z/OS: CICS Codes


Module: System action
DFHCHS
CICS terminates the remote server abnormally with a
ACHB dump.

Explanation User response


The remote server has received a data frame from Reestablish the connection between CICS/CMS and
CICS/CMS that is out of sequence. A frame may have the remote CICS system and try to use the remote
been lost in transmission. server again. For further information, see the 'Problem
Determination' section for abend code ACHA.
System action If the problem persists, you will need assistance from
CICS terminates the remote server abnormally with a IBM to resolve the problem. See IBM problem support
dump. for guidance on how to proceed.
Module:
User response DFHCHS
Reestablish the connection between CICS/CMS and ACHE
the remote CICS system and try to use the remote
server again. For further information, see the 'Problem Explanation
Determination' section for abend code ACHA.
The remote server received an unexpected data frame
If the problem persists, you will need assistance from from CICS/CMS. This indicates a logic error in the
IBM to resolve the problem. See IBM problem support remote server.
for guidance on how to proceed.
Module: System action
DFHCHS
CICS terminates the remote server abnormally with a
ACHC dump.

Explanation User response


The remote server did not receive the expected Reestablish the connection between CICS/CMS and
acknowledgement type data frame from CICS/CMS. the remote CICS system and try to use the remote
server again. For further information, see the 'Problem
System action Determination' section for abend code ACHA.

CICS terminates the remote server abnormally with a If the problem persists, you will need assistance from
dump. IBM to resolve the problem. See IBM problem support
for guidance on how to proceed.
User response Module:
DFHCHS
Reestablish the connection between CICS/CMS and
the remote CICS system and try to use the remote ACHF
server again. For further information, see the 'Problem
Determination' section for abend code ACHA. Explanation
If the problem persists, you will need assistance from The remote server attempted to send one of a series of
IBM to resolve the problem. See IBM problem support data frames to CICS/CMS when, at this time, only a
for guidance on how to proceed. single frame is allowed. This indicates a logic error in
Module: the remote server.
DFHCHS
System action
ACHD
CICS terminates the remote server abnormally with a
Explanation dump.

The remote server did not receive the expected


response type data frame from CICS/CMS.

Chapter 1. Transaction abend codes 47


User response Module:
DFHCHS
Reestablish the connection between CICS/CMS and
the remote CICS system and try to use the remote ACHI
server again. For further information, see the 'Problem
Determination' section for abend code ACHA. Explanation
If the problem persists, you will need assistance from The remote server has received an unexpected return
IBM to resolve the problem. See IBM problem support code from the Transformer 2 program.
for guidance on how to proceed.
Module: System action
DFHCHS
CICS terminates the remote server abnormally with a
ACHG dump.

Explanation User response


The remote server attempted to send data to CICS/ For further information, see the 'Problem
CMS. However, it was not set to the correct mode to do Determination' section for abend code ACHA.
so. This indicates a logic error in the remote server.
Module:
DFHCHS
System action
ACHJ
CICS terminates the remote server abnormally with a
dump.
Explanation

User response An error has occurred processing a request from


CICS/CMS which had the 'No-Reply' option. The
Reestablish the connection between CICS/CMS and remote server cannot, therefore, return the error
the remote CICS system and try to use the remote condition to CICS/CMS.
server again. For further information, see the 'Problem
Determination' section for abend code ACHA.
System action
If the problem persists, you will need assistance from
CICS terminates the remote server abnormally with a
IBM to resolve the problem. See IBM problem support
dump.
for guidance on how to proceed.
Module: User response
DFHCHS
Reestablish the remote server and diagnose the
ACHH problem by executing the same command from CECI
under CICS/CMS without the NOCHECK option. For
Explanation further information, see the 'Problem Determination'
section for abend code ACHA.
A TIOA has not been created from the data received by
the remote server from CICS/CMS. Module:
DFHCHS
System action ACHK
CICS terminates the remote server abnormally with a
dump. Explanation
The transformer program has requested neither EIP
User response nor DLI to execute the request received from CICS/
Reestablish the connection between CICS/CMS and CMS. This indicates a logic error because the request
the remote CICS system and try to use the remote has to be destined for either EIP or DLI.
server again. For further information, see the 'Problem
Determination' section for abend code ACHA. System action
If the problem persists, you will need assistance from CICS terminates the remote server abnormally with a
IBM to resolve the problem. See IBM problem support dump.
for guidance on how to proceed.

48 CICS TS for z/OS: CICS Codes


User response Explanation
For further information, see the 'Problem The remote server has tried to receive a request from
Determination' section for abend code ACHA. CICS/CMS which failed repeatedly until the retry limit
was exceeded.
Module:
DFHCHS
System action
ACHL
CICS terminates the remote server abnormally with a
dump.
Explanation
CICS/CMS has supplied a buffer to the remote server User response
which is not large enough to hold the reply that the
remote server has to return. Reestablish the connection between CICS/CMS and
the remote CICS system and try to use the remote
server again. For further information, see the 'Problem
System action
Determination' section for abend code ACHA.
CICS terminates the remote server abnormally with a
If the problem persists, you will need assistance from
dump.
IBM to resolve the problem. See IBM problem support
for guidance on how to proceed.
User response
Module:
Reestablish the connection between CICS/CMS and DFHCHS
the remote CICS system and try to use the remote
server again. For further information, see the 'Problem ACHO
Determination' section for abend code ACHA.
Explanation
If the problem persists, you will need assistance from
IBM to resolve the problem. See IBM problem support The remote server has tried to receive a reply from
for guidance on how to proceed. CICS/CMS which failed repeatedly until the retry limit
was exceeded.
Module:
DFHCHS
System action
ACHM
CICS terminates the remote server abnormally with a
dump.
Explanation
The remote server has tried to receive a response from User response
CICS/CMS which failed repeatedly until the retry limit
was exceeded. Reestablish the connection between CICS/CMS and
the remote CICS system and try to use the remote
server again. For further information, see the 'Problem
System action
Determination' section for abend code ACHA.
CICS terminates the remote server abnormally with a
If the problem persists, you will need assistance from
dump.
IBM to resolve the problem. See IBM problem support
for guidance on how to proceed.
User response
Module:
Reestablish the connection between CICS/CMS and DFHCHS
the remote CICS system and try to use the remote
server again. For further information, see the 'Problem ACHP
Determination' section for abend code ACHA.
Explanation
If the problem persists, you will need assistance from
IBM to resolve the problem. See IBM problem support CICS/CMS has made a request to the remote server for
for guidance on how to proceed. which the reply would need more than the maximum
storage allowed (32660 bytes). This indicates that a
Module:
logic error has occurred.
DFHCHS
ACHN

Chapter 1. Transaction abend codes 49


System action Explanation
CICS terminates the remote server abnormally with a The new operator failed to allocate storage whilst
dump. creating an object. This problem will occur if there is
insufficient storage available to the CICS region to
User response satisfy the request.

For further information, see the 'Problem


System action
Determination' section for abend code ACHA.
CICS abnormally terminates the transaction.
Module:
DFHCHS
User response
ACHR
This abend may occur if you are in a loop creating
objects and not deleting them. Alternatively CICS
Explanation
might be short on storage and you should try
The CICS/CMS remote server transaction (CEHS) has resubmitting the transaction.
been initiated and either the task is not terminal-
Module:
oriented, or the associated terminal is a console.
ICCGLBIC

System action ACL1

CICS abnormally terminates the remote server with a


Explanation
dump.
The CICS Foundation Classes have thrown an
User response exception which the application programmer failed to
catch.
Ensure the transaction is initiated with an associated
terminal and that the terminal is not defined as a
System action
console. For further information, see the 'Problem
Determination' section for abend code ACHA. CICS abnormally terminates the transaction.
Module:
DFHCHS User response

ACHS Check that you have coded your application to catch


exceptions. Interrogate the message object contained
within the exception object to establish the cause of
Explanation
the exception being thrown.
The CICS/OS2 remote server transaction (CEHP) has
Another possible cause of this abend is that you are
been initiated and either the task is not terminal-
running a Foundation Classes program on a machine
oriented, or the associated terminal is a console.
that does not have the C++ runtime installed. Check
that your machine has the C++ runtime installed.
System action
Module:
CICS abnormally terminates the remote server with a ICCGLBIC
dump.
ACL2
User response
Explanation
Ensure the transaction is initiated with an associated
terminal and that the terminal is not defined as a The CICS Foundation Classes invoked the default
console. For further information, see the 'Problem handleEvent method (defined in class IccResource) in
Determination' section for abend code ACHA. order to handle a CICS condition because the
application programmer did not implement his own
Module: handleEvent method.
DFHCHS
ACL0 System action
CICS abnormally terminates the transaction.

50 CICS TS for z/OS: CICS Codes


User response System action
Implement your own handleEvent method or CICS abnormally terminates the transaction.
customize your resource objects so they do not call
the handleEvent method for any of the possible CICS User response
conditions.
This abend may occur if you are in a loop creating
Module: objects and not deleting them. Alternatively CICS
ICCRESEC might be short on storage and you should try
ACL3 resubmitting the transaction.
Module:
Explanation ICCBASEC
The CICS Foundation Classes responded to an ACL6
application programmer's request to abend a CICS
task. Explanation
The CICS Foundation Classes detected an error while
System action
processing a storage release request.
CICS abnormally terminates the transaction.
System action
User response
CICS abnormally terminates the transaction.
The application programmer requested that the CICS
Foundation Classes abend the transaction using the User response
appropriate return enumeration from the handleEvent
method (see IccResource class). This abend can occur if you try to delete an object that
does not exist (that is, it has already been deleted). It
Module: may also indicate a CICS memory management
ICCRESIC problem, or a storage corruption problem. If the error
ACL4 persists, please contact your support organization.
Module:
Explanation ICCBASEC
The CICS Foundation Classes detected an internal ACL7
error.
Explanation
System action
The CICS Foundation Classes have thrown an
CICS abnormally terminates the transaction. exception which the application programmer failed to
catch.
User response
System action
This abend indicates a CICS Foundation Classes
internal problem. Please contact your support CICS abnormally terminates the transaction.
organization.
Module: User response
ICCGLIBC Check that you have coded your application to catch
ACL5 exceptions. Interrogate the message object contained
within the exception object to establish the cause of
the exception being thrown.
Explanation
Another possible cause of this abend is that you are
The CICS Foundation Classes received an error from a
running a Foundation Classes program on a machine
CICS storage request (GETMAIN). In response to a
that does not have the C++ runtime installed. Check
new operator request the CICS Foundation Classes
that your machine has the C++ runtime installed.
issued a CICS GETMAIN request to allocate storage
which CICS was unable to satisfy. Module:
ICCGLBIC

Chapter 1. Transaction abend codes 51


ACL8 User response
This abend indicates a CICS Foundation Classes
Explanation internal problem. Please contact your support
The CICS Foundation Classes have thrown an organization.
exception which the application programmer failed to Module:
catch. ICCGLIBC
ACLB
System action
CICS abnormally terminates the transaction. Explanation
The CICS Foundation Classes detected an internal
User response error.
Check that you have coded your application to catch
exceptions. Interrogate the message object contained System action
within the exception object to establish the cause of
the exception being thrown. CICS abnormally terminates the transaction.

Another possible cause of this abend is that you are User response
running a Foundation Classes program on a machine
that does not have the C++ runtime installed. Check This abend indicates a CICS Foundation Classes
that your machine has the C++ runtime installed. internal problem. Please contact your support
organization.
Module:
ICCGLBIC Module:
ICCGLIBC
ACL9
ACLC
Explanation
Explanation
The CICS Foundation Classes responded to an
application programmer's request to abend a CICS The CICS Foundation Classes detected an internal
task. error.

System action System action


CICS abnormally terminates the transaction. CICS abnormally terminates the transaction.

User response User response


A resource object was customized to cause a This abend indicates a CICS Foundation Classes
transaction abend if a particular CICS condition was internal problem. Please contact your support
raised, and this condition was subsequently raised by organization.
CICS. Module:
Module: ICCGLIBC
ICCRESIC ACLD
ACLA
Explanation
Explanation The CICS Foundation Classes detected an internal
The CICS Foundation Classes detected an internal error.
error.
System action
System action CICS abnormally terminates the transaction.
CICS abnormally terminates the transaction.

52 CICS TS for z/OS: CICS Codes


User response User response
This abend indicates a CICS Foundation Classes This abend indicates a CICS Foundation Classes
internal problem. Please contact your support internal problem. Please contact your support
organization. organization.
Module: Module:
ICCGLIBC ICCGLIBC
ACLE ACLH

Explanation Explanation
The CICS Foundation Classes detected an internal The CICS Foundation Classes detected an error while
error. processing a storage release request.

System action System action


CICS abnormally terminates the transaction. CICS abnormally terminates the transaction.

User response User response


This abend indicates a CICS Foundation Classes This abend can occur if you try to delete an object that
internal problem. Please contact your support does not exist (that is, it has already been deleted). It
organization. may also indicate a CICS memory management
problem, or a storage corruption problem. If the error
Module:
persists, please contact your support organization.
ICCGLIBC
Module:
ACLF
ICCBASEC

Explanation ACN1

The CICS Foundation Classes detected an internal


Explanation
error.
The table DFHCNV cannot be loaded. This is probably
System action because a table has not been pregenerated. It could
also occur if the table DFHCNV has been linked above
CICS abnormally terminates the transaction. 16MB but DFHCCNV has been linked below 16MB.

User response System action


This abend indicates a CICS Foundation Classes The transaction is abnormally terminated with a
internal problem. Please contact your support transaction dump.
organization.
Module: User response
ICCGLIBC
Check that the DFHCNV module is in the library and is
ACLG valid for this release of CICS. Check the linkage of
DFHCNV and relink it with the correct AMODE if
Explanation necessary.

The CICS Foundation Classes detected an internal Module:


error. DFHCCNV
ACN2
System action
CICS abnormally terminates the transaction. Explanation
The table DFHCNV has been loaded but the first record
is in the wrong format. This is probably due to an error
during assembly or linkedit, but could also be the
result of a storage overwrite.

Chapter 1. Transaction abend codes 53


System action System action
The transaction is abnormally terminated with a The transaction is abnormally terminated with a
transaction dump. transaction dump.

User response User response


The table should be reassembled and linked. Check Check that the client system is using one of the client
the assemble and linkedit output. Check for any code pages supported by CICS/390.
messages issued from CICS indicating that storage
Module:
overwrites have occurred.
DFHCCNV
Module:
ACN6
DFHCCNV
ACN3 Explanation
The client sent data in unicode but the client and
Explanation
server code pages are not the same. Unicode data is
The program DFHUCNV cannot be linked. A user only tolerated provided that conversion is not
conversion program must be available (even if it only required.
returns).
System action
System action
The transaction is abnormally terminated with a
The transaction is abnormally terminated with a transaction dump.
transaction dump.
User response
User response
Ensure that the Client codepage and the Server
Check that the DFHUCNV module is in the library and codepage are the same.
is valid for this release of CICS. Check the linkage of
Module:
DFHUCNV and relink it with the correct AMODE if
DFHCCNV
necessary.
ACN7
Module:
DFHCCNV
Explanation
ACN4
An override for the default binary format has been
received; however the value is not recognized.
Explanation
An unrecognized format of a DFHCNV table has been System action
encountered.
The transaction is abnormally terminated with a
transaction dump.
System action
The transaction is abnormally terminated with a User response
transaction dump.
Data formats should be either S/370 or INTEL,
anything else is unsupported by CICS/390.
User response
Module:
Re-assemble and re-link edit the DFHCNV macro.
DFHCCNV
Module:
ACN8
DFHCCNV
ACN5 Explanation
CICS data conversion is processing a FIELD defined as
Explanation
containing GRAPHIC characters (which are only
An override for the default client code page has been DBCS): that is DFHCNV
received; however the value is not recognized. TYPE=FIELD,DATATYP=GRAPHIC,... However the

54 CICS TS for z/OS: CICS Codes


client code page (defined in the CLINTCP operand), Explanation
and the server code page (defined in the SRVERCP
The program DFHUCNV cannot be linked This is a
operand) imply that the FIELD contains only SBCS
general purpose abend code indicating that the LINK
characters, for example DFHCNV
request for the conversion program DFHUCNV, has
TYPE=ENTRY,CLINTCP=437,SRVERCP=037
failed.

System action
System action
The transaction is abnormally terminated with a
The transaction is abnormally terminated with a
transaction dump.
transaction dump.

User response
User response
Correct the FIELD definition.
Examine the transaction dump to determine the exact
Module: condition returned from LINK request.
DFHCCNV
Module:
ACN9 DFHCCNV
ACNC
Explanation
The table DFHCNV cannot be loaded. This abend code Explanation
is issued following a NOTAUTH condition being raised
The client code page which has been requested by the
during loading of the DFHCNV table.
client is not one which CICS can support.

System action
System action
The transaction is abnormally terminated with a
The transaction is abnormally terminated with a
transaction dump.
transaction dump.

User response
User response
Ensure the resource security definitions are correct.
Ensure that the Client codepage is valid.
Module:
Module:
DFHCCNV
DFHCCNV
ACNA
ACND

Explanation
Explanation
The table DFHCNV cannot be loaded. This is a general
The conversion between client code page and server
purpose abend code indicating that the LOAD request
code page is not supported by CICS/390; for example
for the conversion table, DFHCNV, has failed.
conversion has been requested between Japanese
code page 932 and Latin-1 code page 500.
System action
The transaction is abnormally terminated with a System action
transaction dump.
The transaction is abnormally terminated with a
transaction dump.
User response
Examine the transaction dump to determine the exact User response
condition returned from LOAD request.
Ensure that the Client codepage, both default and
Module: overrides are in the same group as the Server
DFHCCNV codepage. for example client code page 852 from
Latin-2 group, is only supported to server code page
ACNB
870.
Module:
DFHCCNV

Chapter 1. Transaction abend codes 55


ACNE User response
Analyze the dump. The response code is in low-order
Explanation byte of register 0.
The conversion between client code page and server Module:
code page is not supported by CICS/390. Although the DFHCPY
code pages are in the same group, CICS does not have
a conversion table to match the requested server code ACQA
page for the client code page specified.
Explanation
System action The Connection Quiesce Protocol transaction has been
The transaction is abnormally terminated with a initiated by user action, such as a START command or
transaction dump. by typing the transaction identifier at a terminal. The
transaction is not intended to be initiated in this way.
User response
System action
Ensure that the Client codepage and the server
codepage are correct. If they are as intended, then 1. If the transaction was not initiated by terminal
CICS can not support the requested conversion. input, message DFHZC4951 is written to
destination CSNE.
Module:
2. An exception trace record is written to all active
DFHCCNV
trace destinations.
ACP1 3. The transaction is abnormally terminated with a
CICS transaction dump.
Explanation
DFHIC TYPE=GET response code is other than the User response
normal response during print key processing. Determine what caused the transaction to be initiated.
The exception trace record contains information which
System action will help you.
The transaction is abnormally terminated with a CICS Module:
transaction dump. The keyboard of the terminal on DFHCLS5
which the print key was depressed remains locked to
ACQB
indicate the failure of the operation.

Explanation
User response
The Connection Quiesce Protocol transaction has
Analyze the dump. The response code is in the low
encountered an error when communicating with
order byte of register 0.
another system on an APPC session.
Module:
DFHCPY System action
ACP2 1. Message DFHZC4951 is written to destination
CSNE.
Explanation 2. An exception trace record is written to all active
DFHIC TYPE=INITIATE response code is other than trace destinations.
the normal response during print key processing. 3. The transaction is abnormally terminated with a
CICS transaction dump.
System action
The transaction is abnormally terminated with a CICS User response
transaction dump. The keyboard of the terminal on Determine what caused the failure. A likely cause is a
which the print key was depressed remains locked to failure of the session with the partner system.
indicate the failure of the operation.
Module:
DFHCLS5

56 CICS TS for z/OS: CICS Codes


ACQC User response
Check that the relay program is defined correctly.
Explanation Determine why DFHAPRT was invoked if the
The Connection Quiesce Protocol transaction has transaction is not a remote transaction.
encountered an unexpected error. Module:
DFHAPRT
System action ACRC
1. Message DFHZC4951 is written to destination
CSNE. Explanation
2. An exception trace record is written to all active The relay program received an invalid response from
trace destinations. DFHZCX or DFHAPRR.
3. The transaction is abnormally terminated with a
CICS transaction dump. System action
The task is abnormally terminated with a CICS
User response
transaction dump.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on User response
how to proceed.
If you need further assistance from IBM to resolve this
Module: problem, see IBM problem support for guidance on
DFHCLS5 how to proceed.
ACRA Module:
DFHAPRT
Explanation
ACRD
The relay program has been invoked without a
terminal as its principal facility. Explanation
The system entry for the system to which routing is to
System action
be performed could not be found or, for CICS TS 4.1
The task is abnormally terminated with a CICS and earlier releases, an attempt has been made to
transaction dump. send a transaction that is defined as routable=yes over
an IPIC connection.
User response
System action
Ensure that DFHAPRT has not been specified as the
initial program of a task that is not terminal-related. The task is abnormally terminated with a CICS
transaction dump.
Module:
DFHAPRT
User response
ACRB
Check the installed transaction definition to confirm
that the system was correctly specified. Check that the
Explanation
system entry is defined to CICS with a CONNECTION
The relay program has been invoked by a transaction or IPCONN resource definition.
that is not defined as remote.
Module:
DFHAPRT
System action
ACRE
The task is abnormally terminated with a CICS
transaction dump.
Explanation
A transaction invoked from an APPC terminal and
specified in the installed transaction definition as
remote has abnormally terminated because the link is
out of service.

Chapter 1. Transaction abend codes 57


System action User response
The task is abnormally terminated. The dump can be used to help ascertain the mismatch.
Check the transactions listed in the TCTTE and PCT
User response fields of the system dump against the AID chain.

Wait until the link is available. The CICS supplied Module:


transaction CEMT INQUIRE CONNECTION can be used DFHAPRT
to check the states of the links. ACRH
Module:
DFHAPRT Explanation
ACRF The profile for the session that will carry intersystem
flows during transaction routing could not be found.
Explanation
System action
The relay program received a nonzero return code
from the dynamic router following its first invocation. The task is abnormally terminated with a CICS
transaction dump.
System action
User response
The task is abnormally terminated with a CICS
transaction dump. Check the installed transaction definition to confirm
that TRPROF is correctly specified.
User response Module:
Use the dump to determine why the dynamic routing DFHAPRT
program has failed by checking the contents of the ACRI
passed COMMAREA DFHDYE for correctness. The
COMMAREA address can be found from field
Explanation
TCACOMM in the system TCA for the task. The
COMMAREA fields are mapped via the DFHDYPDS An error occurred when attempting to link to the
DSECT. dynamic routing program.
Module:
DFHAPRT System action

ACRG The transaction is abnormally terminated with a CICS


transaction dump.
Explanation A message in the range DFHRT4417 to DFHRT4420 is
written to the CSMT log.
An ATI initiated remote transaction defined with
DYNAMIC(YES) has failed because there is no
matching entry in the AID chain. User response

Each AID in the chain has been checked and none has Refer to the message sent to the CSMT log. It
been found where identifies the cause of the link failure and provides
further user guidance.
• The AID terminal ID matches that of the TCTTE
Module:
• The installed transaction definition and the AID DFHAPRT, DFHEPC
transaction IDs match
ACRJ
• The AID is for a remote transaction
• The AID has not been canceled.
Explanation

System action An abend has occurred in the dynamic routing program


after a link has been executed from DFHAPRT or
The task is abnormally terminated with a CICS system DFHEPC.
dump.

58 CICS TS for z/OS: CICS Codes


System action transaction for which the dynamic router has been
invoked. The attempt has failed.
The transaction is abnormally terminated with a CICS
transaction dump. Message DFHRT4416 is written to
the CSMT log. System action
The transaction is abnormally terminated with a CICS
User response transaction dump.
Refer to message DFHRT4416. It identifies the abend
in the dynamic routing program and provides further User response
user guidance. Examine the following possibilities:
Module: • The autoinstall user-replaceable module (URM) was
DFHAPRT, DFHEPC called but is unable to do the autoinstall.
ACRK • The autoinstall URM was called but data supplied by
the autoinstall URM is invalid.
Explanation • The autoinstall URM was called, but there is no
The relay program has been invoked with no address definition for the autoinstall model.
for the principal facility. • There is a problem with the autoinstall URM.
• There is no resource definition for the program and
System action either the autoinstall is not active or the autoinstall
URM indicated that the program should not be
The task is abnormally terminated with a CICS
autoinstalled.
transaction dump.
• The program is disabled.
User response • The program cannot be loaded.
If you need further assistance from IBM to resolve this • The program is defined as remote.
problem, see IBM problem support for guidance on Module:
how to proceed. DFHAPRT
Module: ACRN
DFHAPRT
ACRL Explanation
The dynamic routing program has indicated that the
Explanation transaction should not be routed, but execute in the
The task does not own the facility. local system. Prior to invoking the application
program, a security check is performed. This check
has failed.
System action
The task is abnormally terminated with a CICS System action
transaction dump.
The transaction is abnormally terminated with a CICS
transaction dump.
User response
If you need further assistance from IBM to resolve this User response
problem, see IBM problem support for guidance on
how to proceed. Ensure that the transaction security definition is
correct.
Module:
DFHAPRT Module:
DFHAPRT
ACRM
ACRO
Explanation
In response to a request from the dynamic routing
program, DFHAPRT has attempted an INITIAL_LINK
to a program that is not the initial program of the

Chapter 1. Transaction abend codes 59


Explanation User response
An attempt has been made to invoke the CRSQ Provide an alternative SYSID, or make an MRO or ISC
transaction from a terminal. CRSQ is an internal CICS connection available.
transaction and cannot be invoked in this way.
Module:
DFHAPRT
System action
ACSA
The task is abnormally terminated.
Explanation
User response
The remote scheduler task (CRSR) does not own an
None. You can use CEMT and EXEC CICS commands to intersystem link TCTTE as its principal facility.
cancel AIDs.
Module: System action
DFHCRQ
The task is abnormally terminated with a CICS
ACRP transaction dump.

Explanation User response


The dynamic router has supplied a sysid whose Ensure that DFHCRS is not specified as the initial
supported functions are unknown. This may be due to program of a task other than CRSR. Check that the
either a backlevel release, or APPC is used for terminal operator did not enter CRSR.
communication and no work has flowed across this
Module:
connection.
DFHCRS

System action ACSB

The task is abnormally terminated with a CICS


Explanation
transaction dump.
An unexpected reply was received from a remote
User response system in response to a request to schedule a task on
that system.
Give an alternative sysid, or revert to the old style
START, or flow some routed work across the
System action
connection.
The task is abnormally terminated with a CICS
Module:
transaction dump.
DFHAPRT
ACRQ User response
If you need further assistance from IBM to resolve this
Explanation
problem, see IBM problem support for guidance on
An attempt has been made to route unsupported how to proceed.
function across an IPIC connection. If message
Module:
DFHIS1035 is issued immediately before the ACRQ
DFHCRS
abend, the ACRQ abend is caused by an attempt to
route to a backlevel release. If message DFHIS1035 is ACSC
not issued, the ACRQ abend is caused by an attempt to
route an APPC device. Explanation
An unexpected request was received from a remote
System action
system when expecting a request to schedule a task.
The task is abnormally terminated with a CICS
transaction dump. System action
The task is abnormally terminated with a CICS
transaction dump.

60 CICS TS for z/OS: CICS Codes


User response Explanation
If you need further assistance from IBM to resolve this The task was purged before a GETMAIN request to the
problem, see IBM problem support for guidance on storage manager (SM) domain was able to complete
how to proceed. successfully. The task that first detects the purged
condition provides an exception trace.
Module:
DFHCRS
System action
ACSD
The task is abnormally terminated with a CICS
transaction dump.
Explanation
An internal logic error has been detected. User response
Investigate the reason why the task was purged. It
System action
was purged either by the master terminal operator or
The task is abnormally terminated with a CICS as a result of a deadlock timeout.
transaction dump.
Module:
DFHCRS
User response
ACSG
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
Explanation
how to proceed.
An error (INVALID, DISASTER or unexpected
Module:
EXCEPTION response) has occurred on a call to the
DFHCRS
storage manager (SM) domain. The domain that
ACSE detected the original error will have provided an
exception trace, a console message and, possibly, a
Explanation system dump (depending on the options specified in
the dump table).
Module DFHCRS has been attached in an unsupported
manner.
System action

System action The task is abnormally terminated with a CICS


transaction dump.
CICS abnormally terminates the transaction with a
transaction dump.
User response

User response Please see the related error message produced by the
domain that detected the original error.
Module DFHCRS should be executed only by
transaction CRSR, which executes with an MRO Module:
session, an LU6.1 session or an LU type 6.2 DFHCRS
conversation as its principal facility. Ensure that the ACSH
transaction is being attached by a CRSR transaction in
the connected system, and not by a user transaction.
Explanation
If the transaction is being attached by a CRSR
The processing of APPC mapped data requires the
transaction, you will need assistance from IBM to
generation of an LU6.2 attach FMH with default values.
resolve the problem. See IBM problem support for
In particular, the sync level requested is defaulted to
guidance on how to proceed.
2. However, the session that is to be used has been
Module: bound with a sync level of 1.
DFHCRS
ACSF System action
The task is abnormally terminated with a CICS
transaction dump.

Chapter 1. Transaction abend codes 61


User response Explanation
Check that: The transaction wait was purged while waiting for a
VTAM INQUIRE macro to complete.
• The CONNECTION resource for the remote system
has not been defined as single-session. CICS issued a VTAM INQUIRE OPTCD=NQN or
• The remote system can support a sync level of 2 INQUIRE OPTCD=SESSNAME request then waited for
VTAM to post the ECB, but the wait was terminated
• The correct sync level has been requested. either as a result of an explicit FORCEPURGE request,
Module: or due to a 3 minute time out.
DFHCRS
System action
ACSI
A transaction dump is taken together with CICS issuing
Explanation message DFHZC0001.

An APPC conversation failure occurred when an attach


User response
between CICS systems was issued.
Investigate the reason why the wait was terminated.
System action In the case of a time out, you may need further
The task is abnormally terminated with a CICS assistance from IBM. See IBM problem support for
transaction dump. guidance on how to proceed.
Module:
User response DFHZGIN
Check the connection to the remote CICS system and ACSL
try to reestablish it.
Module: Explanation
DFHCRS CICS has been unable to attach a transaction to
ACSJ perform a mass flag (CFTS) or mass remote delete
(CDTS) request.
Explanation
System action
An error (INVALID, DISASTER or unexpected
EXCEPTION response) has occurred on a call to the The task is abnormally terminated with a CICS
recovery manager (RM) domain. The domain provides transaction dump.
an exit trace, and possibly a console message and a
system dump (depending on the options specified in User response
the dump table). This failure is either the result of a
If you need further assistance from IBM to resolve this
task purge, or a CICS logic error.
problem, see IBM problem support for guidance on
how to proceed.
System action
Module:
The task is abnormally terminated with a CICS DFHCRS
transaction dump.
ACSM
User response
Explanation
See the related diagnostic material produced by the
recovery manager domain and determine the reason Transaction CFTS has abended. The mass flagging of
for the failure. terminals for deletion has failed.
In the case of a CICS logic error, you need further
assistance from IBM. See IBM problem support for System action
guidance on how to proceed. The task is abnormally terminated with a CICS
transaction dump.
Module:
DFHCRS
ACSK

62 CICS TS for z/OS: CICS Codes


User response Explanation
If you need further assistance from IBM to resolve this The relay program running in the terminal-owning
problem, see IBM problem support for guidance on region has received an unexpected request from the
how to proceed. application owning region. The request received is in
violation of CICS transaction routing protocols.
Module:
DFHCRS The request will be in the DFHLUCDS DSECT in
DFHZTSP's LIFO - field LUCOPN0
ACSN

System action
Explanation
The task is abnormally terminated with a CICS
Transaction CFTS has stalled. The mass flagging of
transaction dump.
terminals for deletion has exceeded the expected time
and is therefore assumed to have failed.
User response
System action If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
The task is abnormally terminated with a CICS
how to proceed.
transaction dump. A flag is set in the remote work
element (RWE) to indicate that the mainline Module:
transaction has assumed that CFTS has failed. DFHZTSP
ACTB
User response
If you need further assistance from IBM to resolve this Explanation
problem, see IBM problem support for guidance on
The relay program running in the terminal-owning
how to proceed.
region issued a terminal control WRITE,LAST request
Module: to the application-owning system, and received a
DFHCRS nonzero return code from terminal control.
ACSO This is the usual return code from terminal control in
TCATPAPR.
Explanation
System action
An IPIC conversation failure occurred when an attach
between CICS systems was issued. The task is abnormally terminated with a CICS
transaction dump.
System action
User response
The task is abnormally terminated with a CICS
transaction dump. Use the transaction dump to determine why terminal
control was unable to process the request.
User response Module:
Check the connection to the remote CICS system and DFHZTSP
try to reestablish it. Use the transaction dump to ACTC
determine why the conversation failed. This may be
the result of a security error that occurred when invalid
Explanation
credentials were sent, or if they were missing from the
IPIC message when the connection was configured to The relay program running in the terminal-owning
expect them. region issued a terminal control request to free its
session to the application-owning system, and
Module:
received a nonzero return code from terminal control.
DFHCRS
This is the usual return code from terminal control in
ACTA
TCATPAPR.

Chapter 1. Transaction abend codes 63


System action ACTF
The task is abnormally terminated with a CICS
transaction dump. Explanation
The relay program running in the terminal-owning
User response region issued a terminal control request to free its
session to the application-owning system, and
Use the transaction dump to determine why terminal
received a nonzero return code from terminal control.
control was unable to process the request.
This return code can be found in the TCA field,
Module:
TCATPAPR.
DFHZTSP
ACTD System action
The task is abnormally terminated with a CICS
Explanation
transaction dump.
The relay program running in the terminal-owning
region issued a terminal control WRITE,WAIT,READ User response
request to the application-owning system, and
received a nonzero return code from terminal control. Use the transaction dump to determine why terminal
control was unable to process the request. The
This is the usual return code from terminal control in transaction on the application-owning region may have
TCATPAPR. abnormally terminated or the session may have failed.
Module:
System action
DFHZTSP
The task is abnormally terminated with a CICS
transaction dump. ACTG

User response Explanation

Use the transaction dump to determine why terminal The relay program running in the terminal-owning
control was unable to process the request. region issued a request to attach a transaction in the
application-owning region, but the response received
Module: from that region was invalid.
DFHZTSP
The return code in the TCA (field TCATPAPR) will be
ACTE nonzero, and either there will be no TIOA (field
TCTTEDA in the TCTTE is zero) or there will be no
Explanation FMH7 at the start of the TIOA.

The relay program running in the terminal-owning


System action
region attempted to free its session with the APPC
terminal, and received a nonzero return code from The task is abnormally terminated with a CICS
terminal control. transaction dump.
The return code will be in the DFHLUCDS DSECT in
DFHZTSP's LIFO field, LUCRCODE. User response
Use the transaction dump to determine why terminal
System action control was unable to process the request. The
transaction on the application-owning region may have
The task is abnormally terminated with a CICS
abnormally terminated or the session may have failed.
transaction dump.
Module:
User response DFHZTSP

Use the transaction dump to determine why terminal ACTH


control was unable to process the request. The
terminal session may have failed. Explanation
Module: A privileged allocate was issued against a remote LU
DFHZTSP 6.2 system.

64 CICS TS for z/OS: CICS Codes


System action Explanation
The task is abnormally terminated with a CICS The task was purged before a GETMAIN request to the
transaction dump. storage manager (SM) domain was able to complete
successfully. The task that first detected the purged
User response condition will have provided an exception trace.

If you need further assistance from IBM to resolve this


System action
problem, see IBM problem support for guidance on
how to proceed. The task is abnormally terminated with a CICS
transaction dump.
Module:
DFHZISP
User response
ACTI
Investigate the reason why the task was purged. It
was either purged by the master terminal operator or
Explanation
as a result of a deadlock timeout.
The relay transaction has an ISC or MRO session as its
Module:
principal facility. However the TCTTE for that session is
DFHZISP
not owned by the task.
ACTL
System action
Explanation
The task is abnormally terminated with a CICS
transaction dump. An error (INVALID, DISASTER or unexpected
EXCEPTION response) has occurred on a call to the
User response storage manager (SM) domain. The domain that
detected the original error will have provided an
If you need further assistance from IBM to resolve this exception trace, a console message and, possibly, a
problem, see IBM problem support for guidance on system dump (depending on the options specified in
how to proceed. the dump table).
Module:
DFHCRT System action
ACTJ The task is abnormally terminated with a CICS
transaction dump.
Explanation
User response
The principal facility of the relay transaction is not a
TCTTE. See the related message produced by the domain that
detected the original error.
System action Module:
The task is abnormally terminated with a CICS DFHZISP
transaction dump. ACU0

User response Explanation


Task CXRT should only be started in a terminal-owning The transaction routing program in the application-
region by an ALLOCATE request issued in an owning region issued a terminal control
application-owning region against a remote APPC WRITE,LAST,WAIT request to the terminal-owning
device. The principal facility of the task should be an region, and received a nonzero return code from
ISC or MRO link. Check that your CICS system is terminal control.
defined in such a way that this will always be the case.
Also ensure that program DFHCRT is started only by The return code is located both in TCATPAPR and in
task CXRT. the trace entry on return from DFHZARQ.

Module:
DFHCRT
ACTK

Chapter 1. Transaction abend codes 65


System action Explanation
The task is abnormally terminated with a transaction The transaction routing program in the application-
dump and an exception trace entry. owning region attempted to set the conversation state
machine to a state which violates CICS transaction
User response routing protocols.

Use the transaction dump to determine why terminal The register containing the state can be determined
control was unable to process the request. This abend from the assembler listing.
code may result when:
System action
• The relay program in the terminal-owning region
terminates abnormally. In this case, determine the The task is abnormally terminated with a transaction
reason why the relay program has abnormally dump and an exception trace entry.
terminated.
• The session has failed. User response
Module: If you need further assistance from IBM to resolve this
DFHZXRL problem, see IBM problem support for guidance on
how to proceed.
ACU1
Module:
Explanation DFHZXRL

Refer to the description of abend ACUO. ACU4

System action:
Explanation
User response:
The transaction routing program in the application-
Module: owning region issued a SET request to the
DFHZXRL conversation state machine and received a nonzero
return code. This violates CICS transaction routing
ACU2 protocols.

Explanation The trace entry on return from DFHZUSR will show the
request type and current state.
The transaction routing program in the application-
owning region received a response from the terminal- System action
owning region which violates CICS transaction routing
protocols. The task is abnormally terminated with a transaction
dump and an exception trace entry.
The trace from the terminal-owning region will show
its response to the application-owning region.
User response
System action If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
The task is abnormally terminated with a transaction how to proceed.
dump and an exception trace entry.
Module:
User response DFHZXRL

If you need further assistance from IBM to resolve this ACU5


problem, see IBM problem support for guidance on
how to proceed. Explanation
Module: An program running in an application-owning region
DFHZXRL has issued an ALLOCATE against an APPC device
attached to a terminal owning region, but the
ACU3
connection between the two systems is not installed.

66 CICS TS for z/OS: CICS Codes


System action Explanation
The task is abnormally terminated with a transaction A request to DFHRTSU to get the recovery status of a
dump and an exception trace entry. surrogate TCTTE gave an unexpected response and
reason code. The response and reason code are
User response included in DFHRTSU's parameter list which is printed
in the exception trace.
Install the connection between the two regions.
Module: System action
DFHZXRL
The task is abnormally terminated with a transaction
ACU6 dump and an exception trace entry.

Explanation User response


A request to DFHRTSU to prepare the surrogate TCTTE If you need further assistance from IBM to resolve this
for syncpoint gave an unexpected response and problem, see IBM problem support for guidance on
reason code. The response and reason code are how to proceed.
included in DFHRTSU's parameter list which is printed
Module:
in the exception trace.
DFHZXRL

System action ACU9

The task is abnormally terminated with a transaction


Explanation
dump and an exception trace entry.
A request to recovery manager to set the recovery
User response status of a link gave an unexpected response and
reason code. The response and reason code are
If you need further assistance from IBM to resolve this included in DFHRMLN's parameter list which is printed
problem, see IBM problem support for guidance on in the exception trace.
how to proceed.
Module: System action
DFHZXRL
The task is abnormally terminated with a transaction
ACU7 dump and an exception trace entry.

Explanation User response


A request to allocate a session between the If you need further assistance from IBM to resolve this
application-owning region and the terminal-owning problem, see IBM problem support for guidance on
region was issued, but the connection with the remote how to proceed.
system is not an APPC or MRO connection.
Module:
DFHZXRL
System action
ACUA
The task is abnormally terminated with a CICS
transaction dump.
Explanation

User response DFHZXRL was called with a request which is not


supported for transaction routing.
Redefine the connection as APPC or MRO, or avoid
using transaction routing on this connection. The request is located in the DFHLUC parameter list
which is printed in the exception trace. DFHZXRL is
Module: called from DFHZARL, which will put details of the
DFHZXRL request in its trace entry.
ACU8
System action
The task is abnormally terminated with a transaction
dump and an exception trace entry.

Chapter 1. Transaction abend codes 67


User response Explanation
If you need further assistance from IBM to resolve this The profile DFHCICSR could not be located as an
problem, see IBM problem support for guidance on installed profile definition.
how to proceed.
Module: System action
DFHZXRL The task is abnormally terminated with a transaction
ACUB dump and an exception trace entry.

Explanation User response

The parameter list passed to DFHZXRL for an Check that the IBM-supplied profile DFHCICSR is
ALLOCATE request does not contain the TCTSE correctly defined and installed to CICS.
address of a remote APPC terminal. Module:
The TCTSE address is located in the DFHLUC DFHZXRL
parameter list which is printed in the exception trace. ACUE
DFHZXRL is called from DFHZARL, which will put
details of the request in its trace entry.
Explanation

System action A request to DFHZTSP to build a surrogate TCTTE was


not satisfied.
The task is abnormally terminated with a transaction
dump and an exception trace entry.
System action

User response The task is abnormally terminated with a transaction


dump and an exception trace entry.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
User response
how to proceed.
If you need further assistance from IBM to resolve this
Module:
problem, see IBM problem support for guidance on
DFHZXRL
how to proceed.
ACUC
Module:
DFHZXRL
Explanation
ACUF
The TCTSE address passed to DFHZXRL is not that of a
remote LU 6.2 terminal.
Explanation
The TCTSE address is located in the DFHLUC
A session between the application-owning region and
parameter list which is printed in the exception trace.
the terminal-owning region was not allocated because
DFHZXRL is called from DFHZARL, which will put
the request was incorrectly specified.
details of the request in its trace entry.

System action
System action
The task is abnormally terminated with a transaction
The task is abnormally terminated with a transaction
dump and an exception trace entry.
dump and an exception trace entry.

User response
User response
If you need further assistance from IBM to resolve this
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
problem, see IBM problem support for guidance on
how to proceed.
how to proceed.
Module:
Module:
DFHZXRL
DFHZXRL
ACUG
ACUD

68 CICS TS for z/OS: CICS Codes


Explanation the IBM-supplied profile, but that MODENAME is not
defined in the SESSIONS definition for the terminal-
A request to allocate a session between the
owning region.
application-owning region and the terminal-owning
region failed. The return code from the ALLOCATE
request indicated that the profile could not be located System action
as an installed transaction definition, although an The task is abnormally terminated with a transaction
earlier attempt to locate it was successful. dump and an exception trace entry.
The return code is located both in TCATPAPR and in
the trace entry on return from DFHZARQ. User response
Ensure that the MODENAME specified in profile
System action DFHCICSR was also specified when defining the
The task is abnormally terminated with a transaction SESSIONS to the terminal-owning region.
dump and an exception trace entry. Module:
DFHZXRL
User response
ACUJ
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Explanation
how to proceed.
A session between the application-owning region and
Module: the terminal-owning region was not allocated because
DFHZXRL the maximum session count for the mode group
ACUH specified in profile DFHCICSR is zero.

Explanation System action

A request to allocate a session between the The task is abnormally terminated with a transaction
application-owning region and the terminal-owning dump and an exception trace entry.
region failed. The return code from the ALLOCATE
request indicated that the requested session is already User response
owned by the TCA.
Use the CEMT transaction to set sessions in the
The return code is located both in TCATPAPR and in required mode group available for use.
the trace entry on return from DFHZARQ.
Module:
DFHZXRL
System action
ACUK
The task is abnormally terminated with a transaction
dump and an exception trace entry.
Explanation

User response No TCT entry was found for the terminal-owning region
specified in the TCTSE for the remote terminal.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
System action
how to proceed.
The task is abnormally terminated with a transaction
Module:
dump and an exception trace entry.
DFHZXRL
ACUI User response
Ensure that the terminal-owning region defined in the
Explanation
remote system entry is also defined to CICS.
An ISC session between the application-owning region
Module:
and the terminal-owning region was not allocated
DFHZXRL
because the MODENAME named in the profile could
not be found. The profile DFHCICSR as supplied by ACUL
IBM does not specify a MODENAME. Therefore, this
error will occur when a MODENAME has been added to

Chapter 1. Transaction abend codes 69


Explanation The return code is located both in TCATPAPR and in
the trace entry on return from DFHZARQ.
The transaction routing program in the application-
owning region issued a terminal control
WRITE,WAIT,READ request to the terminal-owning System action
region, and received a nonzero return code from The task is abnormally terminated with a transaction
terminal control. dump and an exception trace entry.
The return code is located both in TCATPAPR and in
the trace entry on return from DFHZARQ. User response
Use the transaction dump to determine why terminal
System action control was unable to process the request. This abend
The task is abnormally terminated with a transaction code may result when:
dump and an exception trace entry. • The relay program in the terminal-owning region
terminates abnormally. In this case, determine the
User response reason why the relay program has abnormally
terminated.
Use the transaction dump to determine why terminal
control was unable to process the request. This abend • The session has failed.
code may result when: Module:
• The relay program in the terminal-owning region DFHZXRL
terminates abnormally. In this case, determine the ACUP
reason why the relay program has abnormally
terminated.
Explanation
• The session has failed.
The transaction routing program in the application-
Module: owning region did not receive a rollback from the
DFHZXRL terminal-owning region. This violates CICS transaction
ACUM routing protocols.
The trace from the terminal-owning region will show
Explanation its response to the application-owning region.
A request to DFHZTSP to free a surrogate TCTTE was
not satisfied. System action
The task is abnormally terminated with a transaction
System action dump and an exception trace entry.
The task is abnormally terminated with a transaction
dump and an exception trace entry. User response
If you need further assistance from IBM to resolve this
User response problem, see IBM problem support for guidance on
how to proceed.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Module:
how to proceed. DFHZXRL
Module: ACUQ
DFHZXRL
ACUO Explanation
Refer to the description of abend ACUO.
Explanation
System action:
A terminal control READ request has failed. The
User response:
transaction routing program in the application-owning
region attempted to receive data from the terminal- Module:
owning region, and received a nonzero return code DFHZXRL
from terminal control.
ACUR

70 CICS TS for z/OS: CICS Codes


Explanation System action
Refer to the description of abend ACUP. The task is abnormally terminated with a transaction
dump and an exception trace entry.
System action:
User response: User response
Module: Use the transaction dump to determine why terminal
DFHZXRL control was unable to process the request. This abend
ACUS code may result when:
• The relay program in the terminal-owning region
Explanation terminates abnormally. In this case, determine the
reason why the relay program has abnormally
Refer to the description of abend ACUO.
terminated.
System action: • The session has failed.
User response: Module:
Module: DFHZXRL
DFHZXRL ACUW
ACUT
Explanation
Explanation The transaction routing program in the application-
The transaction routing program in the application- owning region issued a terminal control ISSUE ERROR
owning region did not receive either a syncpoint or a request on an MRO link to the terminal-owning region,
rollback from the terminal-owning region. This violates and received a nonzero return code from terminal
CICS transaction routing protocols. control.

The trace from the terminal-owning region will show The return code is located both in TCATPAPR and in
its response to the application-owning region. the trace entry on return from DFHZIS1.

System action System action

The task is abnormally terminated with a transaction The task is abnormally terminated with a transaction
dump and an exception trace entry. dump and an exception trace entry.

User response User response

If you need further assistance from IBM to resolve this Use the transaction dump to determine why terminal
problem, see IBM problem support for guidance on control was unable to process the request. This abend
how to proceed. code may result when:

Module: • The relay program in the terminal-owning region


DFHZXRL terminates abnormally. In this case, determine the
reason why the relay program has abnormally
ACUV terminated.
• The session has failed.
Explanation
Module:
The transaction routing program in the application- DFHZXRL
owning region issued a terminal control ISSUE ABEND
request on an MRO link to the terminal-owning region, ACUX
and received a nonzero return code from terminal
control. Explanation
The return code is located both in TCATPAPR and in Refer to the description of abend ACUL.
the trace entry on return from DFHZIS1.
System action:
User response:
Module:

Chapter 1. Transaction abend codes 71


DFHZXRL User response
ACUY Use the transaction dump to determine why terminal
control was unable to process the request. This abend
Explanation code may result when:

The transaction routing program in the application- • The program in the application-owning region
owning region issued a terminal control WRITE,WAIT terminates abnormally. In this case, determine the
request to the terminal-owning region, and received a reason why the program has abnormally terminated.
nonzero return code from terminal control. • The session has failed.
The return code is located both in TCATPAPR and in Module:
the trace entry on return from DFHZARQ. DFHZXRT
ACVB
System action
The task is abnormally terminated with a transaction Explanation
dump and an exception trace entry.
The transaction routing program in the terminal-
owning region attempted to issue an ISSUE SIGNAL
User response request on an MRO link to the application-owning
Use the transaction dump to determine why terminal region. This violates CICS transaction routing
control was unable to process the request. This abend protocols.
code may result when:
System action
• The relay program in the terminal-owning region
terminates abnormally. In this case, determine the The task is abnormally terminated with a transaction
reason why the relay program has abnormally dump and an exception trace entry.
terminated.
• The session has failed. User response
Module: If you need further assistance from IBM to resolve this
DFHZXRL problem, see IBM problem support for guidance on
how to proceed.
ACUZ
Module:
Explanation DFHZXRT

Refer to the description of abend ACUL. ACVC

System action:
Explanation
User response:
The transaction routing program in the terminal-
Module: owning region issued an ISSUE SIGNAL request on an
DFHZXRL LU 6.2 link to the application-owning region, and
received a nonzero return code from terminal control.
ACVA
The return code is located in the DFHLUC parameter
Explanation list which is printed in the exception trace.

The transaction routing program in the terminal-


System action
owning region issued a terminal control
WRITE,WAIT,READ request to the application-owning The task is abnormally terminated with a transaction
region, and received a nonzero return code from dump and an exception trace entry.
terminal control.
The return code is located both in TCATPAPR and in User response
the trace entry on return from DFHZARQ. Use the transaction dump to determine why terminal
control was unable to process the request. This abend
System action code may result when:
The task is abnormally terminated with a transaction
dump and an exception trace entry.

72 CICS TS for z/OS: CICS Codes


• The program in the application-owning region • the program in the application-owning region
terminates abnormally. In this case, determine the terminates abnormally. In this case, determine the
reason why the program has abnormally terminated. reason why the program has abnormally terminated.
• The session has failed. • the session has failed.
Module: Module:
DFHZXRT DFHZXRT
ACVD ACVF

Explanation Explanation
The transaction routing program in the terminal- The transaction routing program in the terminal-
owning region issued a READ,WAIT request to the owning region issued a WRITE,LAST,WAIT request to
application-owning region, and received a nonzero the application-owning region, and received a nonzero
return code from terminal control. return code from terminal control.
The return code is located both in TCATPAPR and in The return code is located both in TCATPAPR and in
the trace entry on return from DFHZARQ. the trace entry on return from DFHZARQ.

System action System action


The task is abnormally terminated with a transaction The task is abnormally terminated with a transaction
dump and an exception trace entry. dump and an exception trace entry.

User response User response


Use the transaction dump to determine why terminal Use the transaction dump to determine why terminal
control was unable to process the request. This abend control was unable to process the request. This abend
code may result when: code may result when:
• The program in the application-owning region • The program in the application-owning region
terminates abnormally. In this case, determine the terminates abnormally. In this case, determine the
reason why the program has abnormally terminated. reason why the program has abnormally terminated.
• The session has failed. • The session has failed.
Module: Module:
DFHZXRT DFHZXRT
ACVE ACVG

Explanation Explanation
The transaction routing program in the terminal- The transaction routing program in the terminal-
owning region issued a WRITE request to the owning region issued a FREE request to free the
application-owning region, and received a nonzero session with the LU 6.2 terminal, and received a
return code from terminal control. nonzero return code from terminal control.
The return code is located both in TCATPAPR and in The return code is located in the DFHLUC parameter
the trace entry on return from DFHZARQ. list which is printed in the exception trace.

System action System action


The task is abnormally terminated with a transaction The task is abnormally terminated with a transaction
dump and an exception trace entry. dump and an exception trace entry.

User response User response


Use the transaction dump to determine why terminal Use the transaction dump to determine why terminal
control was unable to process the request. This abend control was unable to process the request. The
code may result when: terminal session may have failed.

Chapter 1. Transaction abend codes 73


Module: Module:
DFHZXRT DFHZXRT
ACVH ACVL

Explanation Explanation
The transaction routing program in the terminal- The transaction routing program in the terminal-
owning region issued a FREE request to free the owning region issued an ISSUE ABEND request on an
session with the application-owning region, and MRO link to the application-owning region, and
received a nonzero return code from terminal control. received a nonzero return code from terminal control.
The return code is located both in TCATPAPR and in The return code is located both in TCATPAPR and in
the trace entry on return from DFHZARQ. the trace entry on return from DFHZIS1.

System action System action


The task is abnormally terminated with a transaction The task is abnormally terminated with a transaction
dump and an exception trace entry. dump and an exception trace entry.

User response User response


Use the transaction dump to determine why terminal Use the transaction dump to determine why terminal
control was unable to process the request. This abend control was unable to process the request. This abend
code may result when: code may result when:
• The program in the application-owning region • The program in the application-owning region
terminates abnormally. In this case, determine the terminates abnormally. In this case, determine the
reason why the program has abnormally terminated. reason why the program has abnormally terminated.
• The session has failed. • The session has failed.
Module: Module:
DFHZXRT DFHZXRT
ACVK ACVM

Explanation Explanation
The transaction routing program in the terminal- The transaction routing program in the terminal-
owning region issued an ISSUE ABEND request on an owning region issued an ISSUE ERROR request on an
LU 6.2 link, and received a nonzero return code from LU 6.2 link, and received a nonzero return code from
terminal control. terminal control.
The return code is located in the DFHLUC parameter The return code is located in the DFHLUC parameter
list which is printed in the exception trace. list which is printed in the exception trace.

System action System action


The task is abnormally terminated with a transaction The task is abnormally terminated with a transaction
dump and an exception trace entry. dump and an exception trace entry.

User response User response


Use the transaction dump to determine why terminal Use the transaction dump to determine why terminal
control was unable to process the request. This abend control was unable to process the request. This abend
code may result when: code may result when:
• The program in the connected region terminates • The program in the connected region terminates
abnormally. In this case, determine the reason why abnormally. In this case, determine the reason why
the program has abnormally terminated. the program has abnormally terminated.
• The session has failed. • The session has failed.

74 CICS TS for z/OS: CICS Codes


Module: Otherwise the distributed application programs may
DFHZXRT have violated APPC conversation protocols.
ACVN Module:
DFHZXRT
Explanation ACVP
The transaction routing program in the terminal-
owning region issued an ISSUE ERROR request on an Explanation
MRO link to the application-owning region, and
The transaction routing program in the terminal-
received a nonzero return code from terminal control.
owning region did not receive an FMH43 from the
The return code is located both in TCATPAPR and in application-owning region. This violates CICS
the trace entry on return from DFHZIS1. transaction routing protocols.
The trace from the application-owning region will
System action show its response to the terminal-owning region.
The task is abnormally terminated with a transaction
dump and an exception trace entry. System action
The task is abnormally terminated with a transaction
User response dump and an exception trace entry.
Use the transaction dump to determine why terminal
control was unable to process the request. This abend User response
code may result when:
If you need further assistance from IBM to resolve this
• The program in the application-owning region problem, see IBM problem support for guidance on
terminates abnormally. In this case, determine the how to proceed.
reason why the program has abnormally terminated.
Module:
• The session has failed. DFHZXRT
Module: ACVQ
DFHZXRT
ACVO Explanation
The transaction routing program in the terminal-
Explanation owning region issued a request to the APPC terminal,
The transaction routing program in the terminal- and received a nonzero return code from terminal
owning region issued an ISSUE PREPARE request and control.
received either a nonzero return code or a response Both the request and the return code are located in
which violates CICS transaction routing protocols. the DFHLUC parameter list which is printed in the
The return code is located in TCASPRC and the exception trace.
response is located in TCASPSN1.
System action
System action The task is abnormally terminated with a transaction
The task is abnormally terminated with a transaction dump and an exception trace entry.
dump and an exception trace entry.
User response
User response Use the transaction dump to determine why terminal
Use the transaction dump to determine whether the control was unable to process the request. The
problem is caused by the return code or the response. terminal session may have failed or be in the wrong
If terminal control was unable to process the request, state, for example, as the result of both the terminal
the abend may occur when: and application issuing SYNCPOINT ROLLBACK at the
same time.
• The program in the connected region terminates
abnormally. In this case, determine the reason why Module:
the program has abnormally terminated. DFHZXRT

• The session has failed. ACVR

Chapter 1. Transaction abend codes 75


Explanation ACWA
The transaction routing program in the terminal-
owning region issued a SEND,LAST,WAIT request to Explanation
the LU 6.2 terminal, and received a nonzero return CICS CWTO transaction has failed because the task
code from terminal control. does not own a terminal (TCTTE) as its principal
The return code is located in the DFHLUC parameter facility. This has probably happened because CWTO
list which is printed in the exception trace. has been started as an EXEC CICS START transid
without a terminal ID.
System action
System action
The task is abnormally terminated with a transaction
dump and an exception trace entry. The transaction is abnormally terminated without a
transaction dump.
User response
User response
Use the transaction dump to determine why terminal
control was unable to process the request. The Retry with a terminal ID value or enter CWTO from a
terminal session may have failed. terminal.

Module: Module:
DFHZXRT DFHCWTO

ADxx abend codes


AD21 User response
If you need further assistance from IBM to resolve this
Explanation problem, see IBM problem support for guidance on
The CICS-DB2 attachment facility received a request how to proceed.
for a resource manager with the incorrect name. Module:
Message DFHDB2045 is output to transient data DFHD2EDF
detailing the invalid name.
AD23
System action
Explanation
The transaction is abnormally terminated with a
transaction dump. An error (INVALID, DISASTER or unexpected
EXCEPTION response) has occurred on a LOCK call to
the lock manager (LM) domain made by the CICS-DB2
User response attachment facility service transaction CEX2. A
If you need further assistance from IBM to resolve this console message is output, an exception trace written
problem, see IBM problem support for guidance on and, possibly, a system dump taken (depending on the
how to proceed. options specified in the dump table).
Module:
DFHD2EX1 System action

AD22 The CICS-DB2 service task initiates a force shutdown


of the CICS-DB2 interface.
Explanation
User response
The CICS-DB2 attachment facility EDF processor was
unable to interpret the SQL request. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed.
System action
Module:
The command is not interpreted by EDF. A CICS DFHD2EX2
transaction dump is taken with abend code AD22.
AD24

76 CICS TS for z/OS: CICS Codes


Explanation (depending on the options specified in the dump
table).
An error (INVALID, DISASTER or unexpected
EXCEPTION response) has occurred on an UNLOCK
call to the lock manager (LM) domain made by the System action
CICS-DB2 attachment facility service transaction The DSNC command fails and the transaction is
CEX2. A console message is output, an exception trace abnormally terminated with a transaction dump.
written and, possibly, a system dump taken
(depending on the options specified in the dump
User response
table).
If you need further assistance from IBM to resolve this
System action problem, see IBM problem support for guidance on
how to proceed.
The CICS-DB2 Service task initiates a force shutdown
of the CICS-DB2 interface. Module:
DFHD2CC
User response AD27
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Explanation
how to proceed. The CICS-DB2 attachment facility attempted to attach
Module: a TCB on which a DB2 thread was to be created to
DFHD2EX2 service the SQL request from the application. The
attach of the TCB failed due to lack of storage.
AD25
System action
Explanation
The transaction is abnormally terminated with a
An error (INVALID, DISASTER or unexpected transaction dump.
EXCEPTION response) has occurred on a LOCK call to
the lock manager (LM) domain made by the CICS-DB2
User response
attachment facility while processing a DSNC
command. A console message is output, an exception Increase the size of the CICS region or lower the
trace written and, possibly, a system dump taken TCBLIMIT value specified in the DB2CONN.
(depending on the options specified in the dump
Module:
table).
DFHD2EX1

System action AD28

The DSNC command fails and the transaction is


Explanation
abnormally terminated with a transaction dump.
The CICS-DB2 attachment facility attempted to attach
User response a TCB on which a DB2 thread was to be created to
service the SQL request from the application. The
If you need further assistance from IBM to resolve this attach of the TCB failed.
problem, see IBM problem support for guidance on
how to proceed.
System action
Module:
The transaction is abnormally terminated with a
DFHD2CC
transaction dump.
AD26
User response
Explanation
If you need further assistance from IBM to resolve this
An error (INVALID, DISASTER or unexpected problem, see IBM problem support for guidance on
EXCEPTION response) has occurred on an UNLOCK how to proceed.
call to the lock manager (LM) domain made by the
Module:
CICS-DB2 attachment facility while processing a DSNC
DFHD2EX1
command. A console message is output, an exception
trace written and, possibly, a system dump taken AD29

Chapter 1. Transaction abend codes 77


Explanation User response
The CICS-DB2 attachment facility was unable to link to If you need further assistance from IBM to resolve this
its EDF processor DFHD2EDF. problem, see IBM problem support for guidance on
how to proceed.
System action Module:
The command is not interpreted by EDF. Message DFHD2EX1
DFHDB2048 is output to transient data and a AD2C
transaction dump is taken with abend code AD29.
Explanation
User response
An unexpected EXCEPTION response has occurred on
Examine the trace in the CICS transaction dump to a locate call to directory manager (DD) domain to
determine why the link to module DFHD2EDF failed. locate a DB2TRAN control block. A console message is
Module: output, an exception trace written and, possibly, a
DFHD2EDF system dump taken (depending on the options
specified in the dump table).
AD2A
System action
Explanation
The task is abnormally terminated with a CICS
An error (INVALID, DISASTER or unexpected transaction dump.
EXCEPTION response) has occurred on a LOCK call to
the lock manager (LM) domain. A console message is
User response
output, an exception trace written and, possibly, a
system dump taken (depending on the options If you need further assistance from IBM to resolve this
specified in the dump table). problem, see IBM problem support for guidance on
how to proceed.
System action Module:
The task is abnormally terminated with a CICS DFHD2EX1
transaction dump. AD2D

User response Explanation


If you need further assistance from IBM to resolve this An error (INVALID or DISASTER response ) has
problem, see IBM problem support for guidance on occurred on a locate call to directory manager (DD)
how to proceed. domain to locate a DB2TRAN control block. A console
Module: message is output, an exception trace written and,
DFHD2EX1 possibly, a system dump taken (depending on the
options specified in the dump table).
AD2B
System action
Explanation
The task is abnormally terminated with a CICS
An error (INVALID, DISASTER or unexpected transaction dump.
EXCEPTION response) has occurred on an UNLOCK
call to the lock manager (LM) domain. A console
User response
message is output, an exception trace written and,
possibly, a system dump taken (depending on the If you need further assistance from IBM to resolve this
options specified in the dump table). problem, see IBM problem support for guidance on
how to proceed.
System action Module:
The task is abnormally terminated with a CICS DFHD2EX1
transaction dump. AD2E

78 CICS TS for z/OS: CICS Codes


Explanation User response
An unexpected EXCEPTION response has occurred on Use CEMT INQ DB2TRAN TRANSID(tttt) where tttt is
a locate call to directory manager (DD) domain to the transid, to determine the name of the DB2ENTRY
locate a DB2ENTRY control block. A console message involved. Re-enable the DB2ENTRY or discard the
is output, an exception trace written and, possibly, a DB2ENTRY so that the transid will use a pool thread.
system dump taken (depending on the options
Module:
specified in the dump table).
DFHD2EX1

System action AD2H

The task is abnormally terminated with a CICS


Explanation
transaction dump.
The CICS-DB2 attachment facility detected that a
User response dynamic plan exit program abended.

If you need further assistance from IBM to resolve this


System action
problem, see IBM problem support for guidance on
how to proceed. CICS trapped the abend from the dynamic plan exit,
issued message DFHDB2050, and then abnormally
Module:
terminated the task with a CICS transaction dump.
DFHD2EX1
AD2F User response
See the associated DFHDB2050 transient data
Explanation
message to determine the abend code with which the
An error (INVALID or DISASTER response ) has dynamic plan exit program abended. Determine why
occurred on a locate call to directory manager (DD) the exit program abended.
domain to locate a DB2ENTRY control block A console
Module:
message is output, an exception trace written and,
DFHD2EX1
possibly, a system dump taken (depending on the
options specified in the dump table). AD2I

System action Explanation


The task is abnormally terminated with a CICS The CICS-DB2 attachment facility failed to link to a
transaction dump. dynamic plan exit program because it was not link
edited AMODE 31.
User response
System action
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on The task is abnormally terminated with a CICS
how to proceed. transaction dump.
Module:
DFHD2EX1 User response

AD2G See the associated DFHDB2051 transient data


message to determine the name of the dynamic plan
exit program involved. Re-linkedit the dynamic plan
Explanation
exit program AMODE 31.
A transaction attempted to use a DB2ENTRY that is
Module:
DISABLED or is DISABLING. The DISABLEDACT
DFHD2EX1
attribute of the DB2ENTRY specified ABEND meaning
that new transactions that attempt to use the AD2J
DB2ENTRY should be abended.
Explanation
System action
The CICS-DB2 attachment facility failed to link to a
The task is abnormally terminated with a CICS dynamic plan exit program because it is disabled.
transaction dump.

Chapter 1. Transaction abend codes 79


System action Explanation
The task is abnormally terminated with a CICS The CICS-DB2 attachment facility failed to link to a
transaction dump. dynamic plan exit program because the program is
defined as remote.
User response
System action
See the associated DFHDB2053 transient data
message to determine the name of the dynamic plan The task is abnormally terminated with a CICS
exit program involved. Enable the dynamic plan exit transaction dump.
program.
Module: User response
DFHD2EX1 See the associated DFHDB2066 transient data
AD2K message to determine the name of the dynamic plan
exit program involved. Correct the program definition
for the dynamic plan exit program so that it is defined
Explanation
as local.
The CICS-DB2 attachment facility failed to link to a
Module:
dynamic plan exit program because no program
DFHD2EX1
definition was found.
AD2N
System action
Explanation
The task is abnormally terminated with a CICS
transaction dump. The CICS-DB2 attachment facility failed to link to a
dynamic plan exit program.
User response
System action
See the associated DFHDB2057 transient data
message to determine the name of the dynamic plan The task is abnormally terminated with a CICS
exit program involved. Ensure that the dynamic plan transaction dump.
exit program has been correctly defined to CICS.
Module: User response
DFHD2EX1 See the associated DFHDB2054 transient data
AD2L message to determine the name of the dynamic plan
exit program involved. Examine the transaction dump
to determine why the link failed.
Explanation
Module:
The CICS-DB2 attachment facility failed to link to a
DFHD2EX1
dynamic plan exit program because the program could
not be loaded. AD2O

System action Explanation


The task is abnormally terminated with a CICS An error (INVALID, DISASTER or unexpected
transaction dump. EXCEPTION response) has occurred on an WAIT_MVS
call to the dispatcher (DS) domain. A console message
User response is output, an exception trace written and, possibly, a
system dump taken (depending on the options
See the associated DFHDB2058 transient data specified in the dump table).
message to determine the name of the dynamic plan
exit program involved. Ensure that the dynamic plan
System action
exit program has been correctly defined and is in a
load library accessible to CICS. The task is abnormally terminated with a CICS
transaction dump.
Module:
DFHD2EX1
AD2M

80 CICS TS for z/OS: CICS Codes


User response User response
If you need further assistance from IBM to resolve this If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on problem, see IBM problem support for guidance on
how to proceed. how to proceed.
Module: Module:
DFHD2EX1 DFHD2EX1
AD2P AD2R

Explanation Explanation
The transaction was unable to obtain a DB2 thread The CICS-DB2 attached TCB connection that
from a DB2ENTRY or the pool. See the associated processes the DB2 request for this transaction has
transient data message DFHDB2011 to determine abended. An exception trace, AP 319D, is written
which DB2ENTRY was involved or whether it was the containing the MVS abend code; MVS reason code; and
pool. The transaction was abended because the the relevant CICS-DB2 control blocks that are used by
DB2ENTRY or the pool specified threadwait(no) the CICS task and by the CICS-DB2 TCB connection.
meaning do not wait for a thread if all threads are One of the control blocks returned is the CSUB control
currently in use. Note if message DFHDB2011 block. This control block contains data from the MVS
indicates that the pool was being used, it means the SDWA at the time of the abend, for example, the
transaction was using the pool directly rather than CSB_SDWA_REGS (regs 0-15) and the
overflowing to the pool. (An abend AD3T is produced CSB_SDWA_PSW fields. The CSB_SDWA_REGS is the
when a transaction overflows to the pool and no pool 16 words following the SDWA eye catcher. The
threads are available.) CSB_SDWA_PSW field is the two words following the
CSB_SDWA_REGS field.
System action The TCB connection is terminated if a CICS transaction
The task is abnormally terminated with a CICS is forcepurged from CICS when the thread is still active
transaction dump. in DB2.

User response System action

Determine whether more threads should be allocated The task is abnormally terminated with a CICS
to the DB2ENTRY or the pool, or whether the number transaction dump.
of instances of this transaction should be limited using
TRANCLASS. User response
Module: Examine the trace in the CICS transaction dump to
DFHD2EX1 determine why the CICS-DB2 thread TCB abended.
AD2Q Module:
DFHD2EX1
Explanation AD2S
An error (INVALID, DISASTER or unexpected
EXCEPTION response) has occurred on an getmain call Explanation
to the storage manager (SM) domain. A console
The thread TCB servicing the DB2 request for the
message is output, an exception trace written and,
transaction issued a sign-on request to DB2 which
possibly, a system dump taken (depending on the
failed. The installed DB2CONN specifies
options specified in the dump table).
THREADERROR(N906D) or THREADERROR(ABEND).

System action
System action
The task is abnormally terminated with a CICS
If THREADERROR(N906D) is specified in the
transaction dump.
DB2CONN, processing continues. A -906 sqlcode is
returned to the application, and a transaction dump is
taken with abend code AD2S.

Chapter 1. Transaction abend codes 81


If THREADERROR(ABEND) is specified in the If THREADERROR(ABEND) is specified in the
DB2CONN, the task is abnormally terminated with a DB2CONN, the task is abnormally terminated with a
CICS transaction dump. CICS transaction dump.

User response User response


Examine the dump to determine why the signon Examine the dump to determine why the create thread
request to DB2 failed. One such reason could be the failed.
thread has been cancelled. For authorization failures,
Module:
examine the AUTHID or AUTHTYPE parameter of the
DFHD2EX1
DB2ENTRY or pool used for the transaction. Ensure
the id is authorised to access the plan in DB2. AD2V
Module:
DFHD2EX1 Explanation

AD2T The CICS-DB2 attachment facility issued a commit or


abort request to DB2 but received a reason code
00F30805 indicating that connection to DB2 has been
Explanation
lost. This is due to DB2 terminating abnormally or
An attempt to create a DB2 thread by the TCB being in the process of terminating abnormally. If the
servicing the DB2 request for the transaction failed commit or abort request was preceded by a prepare
with DB2 reason code 00F30040. The installed request, DB2 may well still be indoubt. In this case,
DB2CONN specifies THREADERROR(N906D) or the CICS-DB2 attachment facility instructs CICS to
THREADERROR(ABEND). remember the outcome of the UOW pending
resynchronisation, which will happen when CICS and
System action DB2 are reconnected. For an abort request not
preceded by a prepare, i.e. a transaction abend or
If THREADERROR(N906D) is specified in the syncpoint rollback, DB2 will not be indoubt as the
DB2CONN, processing continues. A -906 sqlcode is UOW was still inflight. DB2 will backout updates made
returned to the application and a transaction dump is by the UOW when restarted so there is no need for
taken with abend code AD2T. CICS to remember the outcome of the UOW.
If THREADERROR(ABEND) is specified in the
DB2CONN, the task is abnormally terminated with a System action
CICS transaction dump.
The transaction completes normally but a transaction
dump is taken with abend code AD2V. If DB2 is
User response indoubt about the outcome of the UOW it will be
Either the plan is unavailable or is not known to DB2. resolved when CICS and DB2 are reconnected.

Module:
User response
DFHD2EX1
Contact your system programmer to restart the DB2
AD2U
subsystem.

Explanation Module:
DFHD2EX1
An attempt to create a DB2 thread by the TCB
servicing the DB2 request failed. The installed AD2W
DB2CONN specifies THREADERROR(N906D) or
THREADERROR(ABEND). Explanation
The CICS-DB2 attachment facility issued a single-
System action phase commit call to DB2 but received an unexpected
If THREADERROR(N906D) is specified in the response. Transient data message DFHDB2055 details
DB2CONN, processing continues. A -906 sqlcode is the DB2 reason code received. The commit request
returned to the application and a transaction dump is may have been processed or it may have been ended.
taken with abend code AD2U. There is no resynchronisation needed, as no CICS
recoverable resources were updated.

82 CICS TS for z/OS: CICS Codes


System action threadwait(no), and again there were no TCBs
available.
The CICS-DB2 attachment facility abnormally
terminates the transaction with abend code AD2W. • The transaction was using the pool directly, the pool
The CICS recovery manager will supersede the AD2W specifies threadwait(no) and no TCB was available.
abend code with abend code ASPR. A transaction
dump is taken. System action
The task is abnormally terminated with a CICS
User response transaction dump.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on User response
how to proceed.
Determine whether TCBLIMIT should be increased or
Module: whether the number of transactions using DB2 at any
DFHD2EX1 one instance should be limited using transaction
classes.
AD2X
Module:
Explanation DFHD2EX1

The CICS-DB2 attachment facility detected that the AD2Z


CICS task and the thread TCB were in an invalid state.
A console message is output, an exception trace Explanation
written and, possibly, a system dump taken
(depending on the options specified in the dump DB2 detected a deadlock and the CICS-DB2
table). attachment facility attempted a syncpoint rollback
command for the transaction as DROLLBACK(YES) was
specified for the DB2ENTRY or POOL. The syncpoint
System action rollback command failed. Message DFHDB2070 is
The task is abnormally terminated with a transaction output to transient data detailing the transid involved
dump. and the EIBRESP2 from the failed syncpoint rollback
command.
User response
System action
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on The transaction is abnormally terminated with a
how to proceed. transaction dump.

Module:
User response
DFHD2EX1
Examine the eibresp2 value to determine why the
AD2Y
syncpoint rollback request failed. One possible reason
could be that the transaction running is a DPL server
Explanation transaction which was DPLed to by a client transaction
The transaction was unable to obtain a DB2 thread without specifying the SYNCONRETURN parameter. In
from a DB2ENTRY or the pool because there were no this case syncpoints, or syncpoint rollbacks, cannot be
TCBs available on which to create the thread. The taken by the server transaction, so DROLLBACK(YES)
number of thread TCBs currently running is at the is invalid in this case.
TCBLIMIT defined in the DB2CONN. Message Module:
DFHDB2010 is output to transient data. The DFHD2EX1
transaction was abended because either:
AD31
• The DB2ENTRY specifies threadwait(no), meaning
do not wait for a thread, including having to wait to
create a thread because a TCB is not available - that Explanation
is, do not wait for a TCB either. An unexpected EXCEPTION response has occurred on
• The DB2ENTRY specified threadwait(pool), but the a locate call to directory manager (DD) domain to
pool definition within the DB2CONN specifies locate a PACKAGESET control block. A console
message is output, an exception trace written and,

Chapter 1. Transaction abend codes 83


possibly, a system dump taken (depending on the Module:
options specified in the dump table). DFHD2EX1
AD35
System action
The task is abnormally terminated with a CICS Explanation
transaction dump.
The CICS-DB2 attachment facility failed to link to the
set packagset program DFHD2SPS because it is
User response disabled.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on System action
how to proceed.
The task is abnormally terminated with a CICS
Module: transaction dump.
DFHD2EX1
AD32 User response
Enable the DFHD2SPS program.
Explanation
Module:
An error (INVALID or DISASTER response ) has DFHD2EX1
occurred on a locate call to directory manager (DD)
AD36
domain to locate a PACKAGESET control block. A
console message is output, an exception trace written
and, possibly, a system dump taken (depending on the Explanation
options specified in the dump table). The CICS-DB2 attachment facility failed to link to the
set packagset program DFHD2SPS because no
System action program definition was found.
The task is abnormally terminated with a CICS
transaction dump. System action
The task is abnormally terminated with a CICS
User response transaction dump.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on User response
how to proceed. Ensure that DFHD2SPS has been correctly defined to
Module: CICS. The definition for DFHD2SPS cannot be
DFHD2EX1 autoinstalled.

AD33 The definition for DFHD2SPS is supplied in CICS


defined group DFHDB2. Ensure CSD definitions have
been upgraded.
Explanation
Module:
The CICS-DB2 attachment facility detected that the
DFHD2EX1
set packageset program DFHD2SPS abended.
AD37
System action
Explanation
CICS trapped the abend from DFHD2SPS, issued
message DFHDB2080, and then abnormally The CICS-DB2 attachment facility failed to link to the
terminated the task with a CICS transaction dump. set packageset program DFHD2SPS because the
program could not be loaded.
User response
System action
See the associated DFHDB2080 transient data
message to determine the abend code with which The task is abnormally terminated with a CICS
DFHD2SPS abended. Determine why DFHD2SPS transaction dump.
abended.

84 CICS TS for z/OS: CICS Codes


User response System action
Ensure that DFHD2SPS has been correctly defined and Startup of the CICS-DB2 interface is terminated, and
is in a load library accessible to CICS. the interface is closed. The task is abnormally
terminated with a CICS transaction dump.
Module:
DFHD2EX1
User response
AD38
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
Explanation
how to proceed.
The CICS-DB2 attachment facility failed to link to the
Module:
set packagset program DFHD2SPS because the
DFHD2STR
program is defined as remote.
AD3B
System action
Explanation
The task is abnormally terminated with a CICS
transaction dump. An error (INVALID, DISASTER or unexpected
EXCEPTION response) has occurred on an UNLOCK
User response call to the lock manager (LM) domain made by the
CICS-DB2 Attachment facility startup program. A
Correct the program definition for DFHD2SPS so that it console message is output, an exception trace written
is defined as local. and, possibly, a system dump taken (depending on the
Module: options specified in the dump table).
DFHD2EX1
System action
AD39
Startup of the CICS-DB2 interface is terminated, and
Explanation the interface is closed. The task is abnormally
terminated with a CICS transaction dump.
The CICS-DB2 attachment facility failed to link to the
set packagset program DFHD2SPS.
User response

System action If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
The task is abnormally terminated with a CICS how to proceed.
transaction dump.
Module:
DFHD2STR
User response
AD3C
Examine the transaction dump to determine why the
link failed.
Explanation
Module:
DFHD2EX1 An error (INVALID, DISASTER response) has occurred
on a CONNECT_TO_DB2 function call to the CICS-DB2
AD3A Coordinator program DFHD2CO made by the CICS-
DB2 Attachment facility startup program. A console
Explanation message is output, an exception trace written and,
possibly, a system dump taken (depending on the
An error (INVALID, DISASTER or unexpected
options specified in the dump table).
EXCEPTION response) has occurred on a LOCK call to
the lock manager (LM) domain made by the CICS-DB2
attachment facility startup program. A console System action
message is output, an exception trace written and, Startup of the CICS-DB2 interface is terminated, and
possibly, a system dump taken (depending on the the interface is closed. The task is abnormally
options specified in the dump table). terminated with a CICS transaction dump.

Chapter 1. Transaction abend codes 85


User response DFHD2D2
If you need further assistance from IBM to resolve this AD3F
problem, see IBM problem support for guidance on
how to proceed. Explanation
Module: During processing of a DB2 request for the transaction,
DFHD2STR a terminate thread request was made to DB2 which
AD3D failed. A console message is output, an exception
trace written and, possibly, a system dump taken
(depending on the options specified in the dump
Explanation
table).
An unexpected response was received while
attempting to delete a record from a temporary System action
storage queue during processing of a DSNC STRT
command. A console message is output, an exception The DB2 request fails. The task is abnormally
trace written and, possibly, a system dump taken terminated with a CICS transaction dump.
(depending on the options specified in the dump
table). User response
Examine the exception trace in the dump to determine
System action why the terminate thread request failed. The CSUB
The DSNC STRT command fails. The task is abnormally control block is output as part of the exception trace
terminated with a CICS transaction dump. entry, and it contains a record of all calls to DB2
starting at field CSB_TRACE_ENTRIES_START. The
terminate thread request contains eyecatcher "TERM"
User response
and is followed by the DB2 FRB response and reason
If you need further assistance from IBM to resolve this codes.
problem, see IBM problem support for guidance on
Module:
how to proceed.
DFHD2D2
Module:
AD3G
DFHD2CM1
AD3E Explanation
An unexpected response was received from an EXEC
Explanation
CICS GETMAIN issued during processing of a CICS-
During processing of a DB2 request for the transaction, DB2 DSNC command. A console message is output, an
an identify request was made to identify the calling exception trace written and, possibly, a system dump
TCB to DB2. The identify request failed. A console taken (depending on the options specified in the dump
message is output, an exception trace written and, table).
possibly, a system dump taken (depending on the
options specified in the dump table). System action
The DSNC command fails. The task is abnormally
System action
terminated with a CICS transaction dump.
The DB2 request fails. The task is abnormally
terminated with a CICS transaction dump. User response
If you need further assistance from IBM to resolve this
User response
problem, see IBM problem support for guidance on
Examine the exception trace in the dump to determine how to proceed.
why the identify request failed. The CSUB control
Module:
block is output as part of the exception trace entry,
DFHD2CM1
and it contains a record of all calls to DB2 starting at
field CSB_TRACE_ENTRIES_START. The identify AD3H
request contains eyecatcher "IDEN" and is followed by
the DB2 FRB response and reason codes.
Module:

86 CICS TS for z/OS: CICS Codes


Explanation User response
The issuing of an EXEC SQL command or IFI call from Examine the exception trace in the dump to determine
a Dynamic Plan Exit is not allowed. why the commit request failed. The CSUB control
block is output as part of the exception trace entry,
System action and it contains a record of all calls to DB2 starting at
field CSB_TRACE_ENTRIES_START. The commit
The task is abnormally terminated. request contains eyecatcher "COMM" and is followed
by the DB2 FRB response and reason codes.
User response
Module:
Remove any EXEC SQL commands or IFI calls from the DFHD2D2
Dynamic Plan Exit.
AD3K
Module:
DFHD2EX1 Explanation
AD3I An abort request to DB2, issued during the second
phase of syncpoint, failed. A console message is
Explanation output, an exception trace written and, possibly, a
system dump taken (depending on the options
An unexpected response was received from an EXEC
specified in the dump table).
CICS INQUIRE DB2CONN command issued during
startup of the CICS-DB2 interface. A console message
is output, an exception trace written and, possibly, a System action
system dump taken (depending on the options The task is abnormally terminated with a CICS
specified in the dump table). transaction dump. CICS maintains a record that the
UOW backed out pending a future resynchronization
System action request with DB2.
Startup of the CICS-DB2 interface is terminated, and
the interface is closed. The task is abnormally User response
terminated with a CICS transaction dump. Examine the exception trace in the dump to determine
why the abort request failed. The CSUB control block
User response is output as part of the exception trace entry, and it
contains a record of all calls to DB2 starting at field
If you need further assistance from IBM to resolve this
CSB_TRACE_ENTRIES_START. The abort request
problem, see IBM problem support for guidance on
contains eyecatcher "ABRT" and is followed by the
how to proceed.
DB2 FRB response and reason codes.
Module:
Module:
DFHD2CM1
DFHD2D2
AD3J
AD3L

Explanation
Explanation
A commit request to DB2, issued during the second
During processing of a DB2 request for the transaction,
phase of syncpoint, failed. A console message is
an associate request was made to associate the DB2
output, an exception trace written and, possibly, a
connection with the calling TCB. The associate request
system dump taken (depending on the options
failed. A console message is output, an exception
specified in the dump table).
trace written and, possibly, a system dump taken
(depending on the options specified in the dump
System action table).
The task is abnormally terminated with a CICS
transaction dump. CICS maintains a record that the System action
UOW committed pending a future resynchronization
The DB2 request fails. The task is abnormally
request with DB2.
terminated with a CICS transaction dump.

Chapter 1. Transaction abend codes 87


User response Explanation
Examine the exception trace in the dump to determine An unexpected response was received while
why the associate request failed. The CSUB control attempting to read a record from a temporary storage
block is output as part of the exception trace entry, queue during processing of a DSNC STRT command. A
and it contains a record of all calls to DB2 starting at console message is output, an exception trace written
field CSB_TRACE_ENTRIES_START. The associate and, possibly, a system dump taken (depending on the
request contains eyecatcher "ASSO" and is followed options specified in the dump table).
by the DB2 FRB response and reason codes.
Module: System action
DFHD2D2 The DSNC STRT command fails. The task is abnormally
AD3M terminated with a CICS transaction dump.

Explanation User response

An unexpected error occurred during processing of a If you need further assistance from IBM to resolve this
DSNC MODIFY command. A console message is problem, see IBM problem support for guidance on
output, an exception trace written and, possibly, a how to proceed.
system dump taken (depending on the options Module:
specified in the dump table). DFHD2CM1
AD3R
System action
The DSNC MODIFY command fails. The task is Explanation
abnormally terminated with a CICS transaction dump.
An unexpected response was received while
attempting to read a record from a temporary storage
User response
queue during startup of the CICS-DB2 interface. A
If you need further assistance from IBM to resolve this console message is output, an exception trace written
problem, see IBM problem support for guidance on and, possibly, a system dump taken (depending on the
how to proceed. options specified in the dump table).
Module:
DFHD2CM1 System action

AD3P Startup of the CICS-DB2 interface is terminated, the


interface is closed. The task is abnormally terminated
with a CICS transaction dump.
Explanation
An unexpected error occurred during processing of a User response
DSNC STOP command. A console message is output,
an exception trace written and, possibly, a system If you need further assistance from IBM to resolve this
dump taken (depending on the options specified in the problem, see IBM problem support for guidance on
dump table). how to proceed.
Module:
System action DFHD2STR
The DSNC STOP command fails. The task is AD3S
abnormally terminated with a CICS transaction dump.
Explanation
User response
An unexpected response was received from an EXEC
If you need further assistance from IBM to resolve this CICS SET DB2CONN command issued during startup
problem, see IBM problem support for guidance on of the CICS-DB2 interface. A console message is
how to proceed. output, an exception trace written and, possibly, a
system dump taken (depending on the options
Module:
specified in the dump table).
DFHD2CM1
AD3Q

88 CICS TS for z/OS: CICS Codes


System action User response
Startup of the CICS-DB2 interface is terminated, and If you need further assistance from IBM to resolve this
the interface is closed. The task is abnormally problem, see IBM problem support for guidance on
terminated with a CICS transaction dump. how to proceed.
Module:
User response DFHD2EX1
If you need further assistance from IBM to resolve this AD3W
problem, see IBM problem support for guidance on
how to proceed.
Explanation
Module:
An unexpected response was received while
DFHD2CM1
attempting to write a record to a temporary storage
AD3T queue during startup of the CICS-DB2 interface. A
console message is output, an exception trace written
Explanation and, possibly, a system dump taken (depending on the
options specified in the dump table).
The transaction was unable to obtain a DB2 thread
from the pool. Message DFHDB2011 is output to
System action
transient data. The transaction was abended because
the transaction tried using a DB2ENTRY but all threads Startup of the CICS-DB2 interface is terminated, and
were in use on the DB2ENTRY, and despite the interface is closed. The task is abnormally
threadwait(pool) being specified, all threads in the terminated with a CICS transaction dump.
pool were also in use. The pool definition within the
DB2CONN specifies threadwait(no). User response
If you need further assistance from IBM to resolve this
System action
problem, see IBM problem support for guidance on
The task is abnormally terminated with a CICS how to proceed.
transaction dump.
Module:
DFHD2STR
User response
AD3X
Determine whether more threads should be allocated
to the DB2ENTRY or the pool, or whether the number
Explanation
of instances of this transaction should be limited using
TRANCLASS. An unexpected response was received while
attempting to write a record to a temporary storage
Module:
queue during processing of a DSNC STRT command. A
DFHD2EX1
console message is output, an exception trace written
AD3U and, possibly, a system dump taken (depending on the
options specified in the dump table).
Explanation
System action
An error (INVALID or DISASTER response ) has
occurred on a locate call to transaction manager (XM) The DSNC STRT command fails. The task is abnormally
domain to locate a transaction definition. A console terminated with a CICS transaction dump.
message is output, an exception trace written and,
possibly, a system dump taken (depending on the User response
options specified in the dump table).
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
System action
how to proceed.
The task is abnormally terminated with a CICS
Module:
transaction dump.
DFHD2CM1
AD3Z

Chapter 1. Transaction abend codes 89


Explanation Explanation
The CICS-DB2 thread TCB processing the DB2 request This abend is issued if DBCTL returns a non-zero
for this transaction has abended because the DB2 response code when a DL/I request has been issued
adapter is being shutdown. from an application program.

System action System action


The task is abnormally terminated. The transaction is abnormally terminated with a CICS
transaction dump.
User response
User response
If this abend should occur at CICS or DB2 shutdown
then it can be ignored, because the DB2 adapter is Look up accompanying message DFHDB8109 that
abending the task as part of shutdown processing, appears on the CDBC transient data destination.
otherwise you will need assistance from IBM.
Module:
Module: DFHDLIDP
DFHD2EX1
ADCB
AD4A
Explanation
Explanation
This abend occurs when DBCTL has notified CICS that
The CICS-DB2 set packageset program issued an a task has issued a DL/I request, but it did not have a
EXEC SQL SET CURRENT PACKAGESET command PSB scheduled. If your application does have a PSB
which failed. scheduled then a possible cause for this abend is that
the DBCTL STOP THREAD command may have been
System action used to terminate the DBCTL thread that corresponds
to this task.
The task is abnormally terminated with a CICS
transaction dump.
System action

User response CICS abnormally terminates the transaction with a


transaction dump. CICS processing continues.
Examine the transaction dump to determine why the
command failed.
User response
Module:
Check if the DBCTL operator has issued a STOP
DFHD2EX1
THREAD command for the task that has abnormally
AD4B terminated. Look up DBCTL response code 28 in the
DBCTL return code section of the IMS messages and
Explanation codes.

The CICS-DB2 attachment facility failed to locate a Module:


valid dfhd2pkgset control block. DFHDLIDP
ADCC
System action
The task is abnormally terminated with a CICS Explanation
transaction dump. This abend occurs when DBCTL has notified CICS that
a task has issued program specification block (PSB)
User response request, but it has a PSB already scheduled. CICS
prevents a task from issuing a PSB schedule request to
If you need further assistance from IBM to resolve this
DBCTL when it has already issued a PSB schedule
problem, see IBM problem support for guidance on
request by returning a PSBSCH response in UIBDLTR.
how to proceed.
However, in this case it is DBCTL that has rejected the
Module: subsequent PSB schedule request. A possible cause
DFHD2EX1 for this abend is a storage over-write.
ADCA

90 CICS TS for z/OS: CICS Codes


System action DFHDBAT is a task related user exit and forms part of
the CICS-DBCTL interface. This abend is accompanied
CICS abnormally terminates the transaction with a
by message DFHDB8110.
transaction dump. CICS processing continues.

System action
User response
CICS abnormally terminates the transaction with a
Check for any messages issued from your CICS system
transaction dump. CICS processing continues.
indicating that storage over-writes have taken place.
Look up DBCTL response code 32 in the DBCTL return
code section of the IMS messages and codes. User response

Module: Look up the accompanying message DFHDB8110 that


DFHDLIDP appears on the CDBC transient data destination.

ADCD Module:
DFHDLIDP
Explanation ADCF
This abend is issued when a deadlock has been
detected by IMS and this transaction has been Explanation
selected for abnormal termination. This abend is issued when the module DFHDLIDP
This abend can occur when a transaction is accessing detects that the CICS-DBCTL Interface has been
IMS resources via DBCTL or via a remote DLI request configured using a DRA startup table (DFSPZPxx)
to a remote CICS region. The remote CICS region can which specifies option PCBLOC=31, and the
be accessing IMS via DBCTL, or if it is a CICS 4.1 application is amode 24.
region or earlier, accessing IMS via local DLI. PCBLOC=31 specifies that the PCB address list and
PCBs can be stored above the line. This is
System action incompatible with amode 24 applications.
Access to IMS resources via DBCTL is withdrawn for
this transaction. Further attempts to access IMS will System action
result in an AEY9 abend. CICS abnormally terminates the transaction with a
CICS abnormally terminates the transaction with a transaction dump. CICS processing continues.
transaction dump. CICS processing continues.
User response
User response Linkedit the application amode 31, or change the DRA
If ADCD abends occur infrequently in your system, no startup table option to PCBLOC=24.
action is required although you may like to consider Module:
setting your system up in such a way that, after an DFHDLIDP
ADCD abend is issued, the transaction is automatically
restarted. See the Administering recovery and restart ADCI
for further information.
Explanation
If ADCD abends are occurring frequently in your
system, you may need to review the design of your This abend is issued when IMS returns a user abend
applications. Some general techniques for deadlock 3303 response for a DL/I request issued from an
avoidance are described in the Administering recovery application program.
and restart.
Module: System action
DFHDLIDP Access to IMS resources via DBCTL is withdrawn for
ADCE this transaction. Further attempts to access IMS will
result in an AEY9 abend.
Explanation CICS abnormally terminates the transaction with a
transaction dump. CICS processing continues.
This abend is issued when the module DFHDBAT
returns a nonzero return code in reply to a DL/I
request issued from an application program to DBCTL.

Chapter 1. Transaction abend codes 91


User response • If the transaction is being run as a result of a request
from a connected ISC system, the user is defined in
Check the description in the IMS messages and codes
the SECURITYNAME operand of the installed
for the meaning of IMS user abend 3303.
CONNECTION definition that defines the link
Module: between the remote system and the local system.
DFHDLIDP Ensure that the name in the SECURITYNAME
operand is the same as that supplied by the
ADCJ
connected CICS system. This will depend upon the
type of CONNECTION between the two systems. For
Explanation further information about this, refer to the CICS
This abend is issued when an application has been intercommunication.
using DBCTL, and while the application was still Notes.
scheduled to DBCTL, the CICS-DBCTL interface was
terminated. By the above definitions, a PSB used by a routed
transaction has two users, the terminal user and the
communicating region. Therefore, for routed
System action
transactions, the external security manager makes two
CICS abnormally terminates the transaction with a checks, on the terminal user (as qualified in 1 above),
transaction dump. CICS processing continues. and on the communicating region (2 or 3 above).

User response System action


Check the CDBC transient data destination for CICS abnormally terminates the task attempting to
messages indicating the reason for termination of the schedule the PSB. CICS processing continues.
CICS-DBCTL interface. If you do not know where the
CDBC transient is, then please check with your system User response
programmer. Check for messages issued from the
DBCTL system. Ensure that the PSB is defined to the external security
manager, and that all users have the correct level of
Module: authorization. If the system setup is correct, note the
DFHDLIDP security violation.
ADCP Module:
DFHDLIDP
Explanation
ADCQ
When checking the DBCTL program specification block
(PSB), the external security manager checked the Explanation
usage of the PSB, and found that:
This abend can occur when an application has issued
• The user was unauthorized to access the PSB, or an EXEC DLI SCHD request for a PSB that contains no
• The PSB was unknown to the external security DBPCBs, and the SYSSERVE keyword was not
manager, or specified. Secondly this abend can occur when an
application has issued a PCB request for a PSB that
• The user was set to the capability of the default user.
contains no DBPCBs and the IOPCB option was not
The meaning of the term "user" in the above context specified. Otherwise it may indicate an IMS processing
depends on the way the transaction was invoked. error.
• If the transaction is being run from a local terminal,
or has been routed from a remote terminal, the user System action
is the terminal user. (For a routed transaction, if The transaction is abnormally terminated with a CICS
PSBCHK=NO is specified in the SIT, or RESSEC=NO transaction dump.
is specified in the transaction definition (CEDA
DEFINE TRANSACTION command), the security
User response
manager does not check the terminal user.)
• If the transaction is being run as a result of a request Check that the application program has scheduled the
from another CICS MRO region, the user is the owner appropriate PSB. If the PSB is correct, then contact
of the other CICS system (as defined to the external your IMS administrator.
security manager in the JOB statement of the Module:
initializing JCL).

92 CICS TS for z/OS: CICS Codes


DFHDLIDP System action
ADCR CICS rejects the request.

Explanation User response


This abend occurs when an application has issued a Do not try to invoke CICS internal transactions directly.
DL/I request other than a schedule request, and the
Module:
DBCTL DRA return code of 40 indicates that there was
DFHDBCT
no active communication with DBCTL.
ADCV
System action
Explanation
The transaction is abnormally terminated with a CICS
transaction dump. The connection to DBCTL was terminated and then re-
established. The failing task had issued a schedule
User response request against an earlier run of DBCTL and is
therefore no longer scheduled.
Check the CDBC transient data destination for
messages indicating the reason for termination of the
System action
CICS-DBCTL interface. If you do not know where the
CDBC transient data destination is, check with your CICS abnormally terminates the transaction with a
system programmer. Check for messages issued from transaction dump. CICS processing continues.
the DBCTL system.
Module: User response
DFHDLIDP No action is required, although you may like to
ADCS consider setting your system up in such a way that,
after an abend ADCV is issued, the transaction is
automatically restarted.
Explanation
Module:
CICS issued a single-phase commit request to DBCTL
DFHDLIDP
and an unexpected response was returned from
DBCTL. ADDA

System action Explanation


CICS issues message DFHDB8119 to transient data An error (INVALID or DISASTER response) has
queue CDBC, then terminates the task abnormally with occurred on a call to the storage manager domain. The
a CICS transaction dump. domain that detected the original error provides an
exception trace, a console message, and possibly a
User response system dump (depending on the options in the dump
table).
Message DFHDB8119 shows the unexpected response
from DBCTL, along with the recovery token of the LUW
System action
involved. The explanation of message DFHDB8119
indicates how the outcome of the LUW can be The task is abnormally terminated with a CICS
determined. transaction dump (depending on the options in the
dump table).
Module:
DFHDBAT
User response
ADCT
See related message from the domain that detected
the original error.
Explanation
Module:
A user has attempted to invoke the CICS-DBCTL
DFHDBME, DFHDLI, DFHDLIDP
control transaction from a terminal.
ADDB

Chapter 1. Transaction abend codes 93


Explanation User response
An error (INVALID or DISASTER response) has Refer to message DFHDX8323 for further information.
occurred on a call to the catalog (CC) domain. The It may be necessary to restart DBCTL manually.
domain that detected the original error provides an
Module:
exception trace, a console message, and possibly a
DFHDBCT
system dump (depending on the options in the dump
table). ADDJ

System action Explanation


The task is abnormally terminated with a CICS CICS has failed to connect to DBCTL because program
transaction dump (depending on the options in the DFHDBAT could not be ENABLED.
dump table).
System action
User response
A CICS transaction dump is produced. The state of the
See related message from the domain that detected CICS/DBCTL interface remains not connected.
the original error.
Module: User response
DFHDBCON, DFHDBDSC Refer to the transaction dump to determine why the
ADDC ENABLE failed.
Module:
Explanation DFHDBCON
An error (INVALID or DISASTER response) has ADDK
occurred on a call to the loader (LD) domain. The
domain that detected the original error will have Explanation
provided an exception trace, a console message, and
possibly a system dump (depending on the options in CICS failed to obtain or release a lock on either the
the dump table). adapter's Global Work Area(GWA) or the DBCTL Global
Block (DGB).
System action
System action
The task is abnormally terminated with a CICS
transaction dump (depending on the options in the The task is abnormally terminated with a CICS
dump table). transaction dump (depending on the options in the
dump table).
User response
User response
See related message from the domain that detected
the original error. Refer to the transaction dump to determine why lock
failed.
Module:
DFHDBCON, DFHDBDI Module:
DFHDBAT
ADDI
ADEF
Explanation
Explanation
CICS has been notified of a DBCTL failure. However, it
has been unable to complete the search for a DBCTL A severe error has been encountered when executing
alternate. This is possibly due to an unexpected return transaction CLS3.
code from an IEFSSREQ request.
System action
System action CLS3 is abnormally terminated with a transaction
A CICS transaction dump is produced. CICS continues dump. CICS issues message DFHZC4948.
as if no XRF DBCTL alternate has been found. This
abend is accompanied by message DFHDX8323.

94 CICS TS for z/OS: CICS Codes


User response System action
See message DFHZC4948 for further guidance. The transaction is abnormally terminated with a CICS
transaction dump.
Module:
DFHCLS3
User response
ADIR
Either correct the SYSIDNT parameter in the relevant
DFHDLPSB entry, or define the remote system to CICS
Explanation
with a DFHTCT TYPE=SYSTEM macro or a CEDA
The abend code is issued for either of the following DEFINE CONNECTION command.
reasons:
Module:
• A DFHDI or DFHBMS request was issued when the DFHDLIRP
DFHDIP program was generated as a dummy.
ADLF
• A DFHDI TYPE=RECEIVE or TYPE=NOTE was
attempted but the transaction identification did not Explanation
specify either INBFMH=DIP or INBFMH=ALL.
A DL/I request was made for a remote database, but
System action the link to the system on which the database resides
was down.
A CICS transaction dump is provided to assist in
problem determination. System action

User response The transaction is abnormally terminated with a CICS


transaction dump.
Either generate a DFHDIP program into the system or
specify INBFMH correctly on the profile definition. User response
Module: Notify the system programmer. Once the link to the
DFHDIP remote system has been reestablished, resubmit the
ADIS transaction.
Module:
Explanation DFHDLIRP
EXEC CICS ISSUE SEND request has been issued from ADLG
a task that has a non-terminal principal facility.
Explanation
System action
A DL/I request was made for a remote database, but
A CICS transaction dump is provided to assist in there were errors in the DL/I argument list that was
problem determination. provided by the user.

User response System action


Use a terminal or device that is properly supported. The transaction is abnormally terminated with a CICS
Module: transaction dump.
DFHEDI
User response
ADLE
Ensure that any errors in the DL/I argument are
Explanation corrected.

A DL/I request was made for a remote database, but Module:


the system named in the remote PDIR entry was DFHDLIRP
unknown to CICS, that is, not specified in a DFHTCT ADLP
TYPE=SYSTEM macro or CEDA DEFINE CONNECTION
command.

Chapter 1. Transaction abend codes 95


Explanation DFHDLIRP
When checking the DLI program specification block ADMA
(PSB), the external security manager checked the
usage of the PSB, and found that: Explanation
• The user was unauthorized to access the PSB, or The alternate CICS task responsible for tracking the
• The PSB was unknown to the external security DBCTL connection status of the active CICS has
manager, or received an error from the CICS Availability Manager
(CAVM) message input service.
• The user was set to the capability of the default user.
The meaning of the term "user" in the above context System action
depends on the way the transaction was invoked.
The tracking transaction terminates with a CICS
• If the transaction is being run from a local terminal, transaction dump. No further action is taken in
or has been routed from a remote terminal, the user response to DBCTL status changes. The global exits,
is the terminal user. (For a routed transaction, if XXDFB and XXDTO, are never invoked and no attempt
PSBCHK=NO is specified in the SIT, or RESSEC=NO at a DBCTL restart is made in the event of a takeover.
is specified in the transaction definition (CEDA This abend is accompanied by DFHDX8331.
DEFINE TRANSACTION command), the security
manager does not check the terminal user.)
User response
• If the transaction is being run as a result of a request
from another CICS MRO region, the user is the owner Check for any other messages relating the CAVM
of the other CICS system (as defined to the external dataset problems. In the event of a takeover, it may be
security manager in the JOB statement of the necessary to restart DBCTL manually.
initializing JCL). Module:
• If the transaction is being run as a result of a request DFHDBCR
from a connected ISC system, the user is defined in
ADMB
the SECURITYNAME operand of the installed
CONNECTION definition that defines the link
between the remote system and the local system. Explanation
Ensure that the name in the SECURITYNAME The CICS/XRF DBCTL tracking task has received an
operand is the same as that supplied by the unrecognizable message from the CICS/XRF message
connected CICS system. This will depend upon the manager. This abend is preceded by message
type of CONNECTION between the two systems. For DFHDX8333.
further information about this, refer to the CICS
intercommunication. System action
Note: The CICS/XRF DBCTL tracking task abends.
By the above definitions, a PSB used by a routed
transaction has two users, the terminal user and the User response
communicating region. Therefore, for routed
transactions, the external security manager makes two Refer to the instructions for message DFHDX8333.
checks, on the terminal user (as qualified in 1 above), Module:
and on the communicating region (2 or 3 above). DFHDBCR.
ADMD
System action
The task attempting to schedule the PSB abnormally Explanation
terminates.
The alternate CICS system task responsible for
tracking the DBCTL connection status of the active
User response
CICS has been unable to complete its search for a
Ensure that the PSB is defined to the external security DBCTL alternate, possibly due to an unexpected return
manager, and that all users have the correct level of code from an IEFSSREQ request.
authorization. If the system setup is correct, note the
security violation.
Module:

96 CICS TS for z/OS: CICS Codes


System action Explanation
A CICS transaction dump is produced. The tracking The CICS supplied transaction for managing debugging
transaction continues as if no DBCTL alternate had profiles, CADP, has received a disaster response from
been found. This abend is accompanied by message the file manager, with reason disaster percolation.
DFHDX8335. There is an error in one of the CICS domains called by
the file manager.
User response
System action
Refer to message DFHDX8335 for further information.
It may be necessary to restart DBCTL manually. CICS abends the transaction with a transaction dump.
Module:
DFHDBCR. User response

ADPA Examine the CICS joblog for associated messages.


Contact IBM for assistance with this type of error.
Explanation Module:
DFHDPLU
The CICS supplied transaction for managing debugging
profiles, CADP, has received a exception response ADPD
from the file manager, with reason file error. The file
manager will have issued a message to the CICS joblog Explanation
containing a code which indicates the precise nature of
the error. For example this abend will be issued if the The CICS supplied transaction for managing debugging
underlying file DFHDPFMB used by CADP is disabled or profiles, CADP, has received a purged response from
doesn't exist. the file manager. reason disaster precolation. It is
likely that an underlying request to CICS File Control
has timed out because the record that CADP is trying
System action
to access, is held up by another transaction. For
CICS abends the transaction with a transaction dump. example this would occur if CECI was bing used to
access the underlying file, DFHDPFMB, at the same
User response time as using CADP.

Examine the CICS joblog for associated messages,


System action
correct the problem and retry the CADP transaction.
CICS abends the transaction with a transaction dump.
Module:
DFHDPLU
User response
ADPB
Investigate if there are other tasks running against the
file used by CADP.
Explanation
Module:
The CICS supplied transaction for managing debugging
DFHDPLU
profiles, CADP, has received a disaster response from
the file manager, with reason internal error. There is an ADPI
error in the file manager program.
Explanation
System action
The CICS supplied program for inactivating all
CICS abends the transaction with a transaction dump. debugging profiles, DFHDPIN, has received a
exception response from the file manager, with reason
User response file error. The file manager will have issued a message
to the CICS joblog containing a code which indicates
Examine the CICS joblog for associated messages. the precise nature of the error. For example this abend
Contact IBM for assistance with this type of error. will be issued if the underlying file DFHDPFMB used by
Module: CADP was disabled or deleted whilst DFHDPIN was
DFHDPLU running.

ADPC

Chapter 1. Transaction abend codes 97


System action System action
CICS abends the transaction with a transaction dump. DXCU is abnormally terminated with a CICS
transaction dump. This abend is accompanied by
User response DFHDX8319.

Examine the CICS joblog for associated messages,


User response
correct the problem and retry the CADP transaction.
Diagnose the error from the CICS transaction dump.
Module:
Refer to DFHDX8319 for further information.
DFHDPIN
Module:
ADPL
DFHDXCU

Explanation ADXB

A server program has issued a command which is


Explanation
restricted in the distributed program link (DPL)
environment. Certain API and CPI-RR requests, and The XRF DBCTL state catch-up transaction, DXCU, has
the DL/I terminate request are not allowed in the DPL failed.
environment. See the Developing CICS Applications for
a list of these restricted commands. System action
A server program is a program which has been DXCU is abnormally terminated with a CICS
remotely linked, or a program defined to run with the transaction dump. This abend is accompanied by
DPL subset. DFHDX8318.

System action User response


CICS abends the transaction with a transaction dump. Use the dump to help diagnose the problem. Refer to
DFHDX8318 for further information. Check for any
User response other messages relating to CICS availability manager
(CAVM) data set problems.
Remove the restricted commands from the server
program, or run the server program locally. Module:
DFHDXCU
Module:
DFHEIP, DFHCPIR, DFHDLI
ADXA

Explanation
The XRF DBCTL state catch-up transaction, DXCU, has
failed.

AExx abend codes


AEC1 User response
Use a terminal that is supported by the Command
Explanation Level Interpreter, Enhanced Master Terminal, or RDO
An attempt has been made to use the Command Level transaction.
Interpreter (CECI) or the Enhanced Master Terminal Module:
(CEMT) or an RDO (CEDA, CEDB, CEDC) transaction on DFHECIP, DFHECSP, DFHEMTP, DFHESTP, DFHEOTP,
a terminal that is not supported. DFHEDAP
AEC2
System action
The task is abnormally terminated with a CICS
transaction dump.

98 CICS TS for z/OS: CICS Codes


Explanation User response
An attempt has been made to use the Command Level Refer to the error message or messages issued by
Interpreter (CECI) or the Enhanced Master Terminal Language Environment to determine the cause of the
(CEMT) or an RDO (CEDA, CEDB, CEDC) transaction on problem.
a display terminal of size less than 24 X 80.
Module:
DFHAPLI
System action
AEC9
The task is abnormally terminated with a CICS
transaction dump.
Explanation

User response Language Environment has encountered an


unexpected error during the RUNUNIT BEGIN
Use a display terminal that is supported by the INVOCATION phase while attempting to execute a
Command Level Interpreter or Enhanced Master Language Environment enabled program.
Terminal or RDO transaction.
Module: System action
DFHECIP, DFHECSP, DFHEMTP, DFHESTP, DFHEOTP,
The return code received from Language Environment
DFHEDAP
is placed into the field EIBRESP2. Message
AEC7 DFHAP1200 is issued and the transaction is
abnormally terminated. The program is disabled.
Explanation
User response
Language Environment has encountered an
unexpected error during the THREAD INITIALIZATION Refer to the error message or messages issued by
phase while attempting to execute a Language Language Environment to determine the cause of the
Environment enabled program. The return code problem.
received from Language Environment is placed into the
Module:
field EIBRESP2.
DFHAPLI

System action AECA

Message DFHAP1200 is issued and the transaction is


Explanation
abnormally terminated. The program is disabled.
An attempt has been made to run one of the CICS
User response internal EP Adapter transactions: CEPQ, CEPT, CEPR,
or CEPS as a user transaction.
Refer to the error message or messages issued by
Language Environment to determine the cause of the
System action
problem.
CICS terminates the task.
Module:
DFHAPLI
User response
AEC8
Investigate why the attempt was made to run a CICS
supplied EP Adapter as a user transaction.
Explanation
Module:
Language Environment has encountered an
DFHECEAM, DFHECEAQ, DFHECEAS, DFHECEAT
unexpected error during the RUNUNIT
INITIALIZATION phase while attempting to execute a AECC
Language Environment enabled program.
Explanation
System action
An error occurred while emitting an event. This
The return code received from Language Environment problem is likely to have been caused by an error in
is placed into the field EIBRESP2. Message the specification of the event or in the configuration of
DFHAP1200 is issued and the transaction is the EP adapter.
abnormally terminated. The program is disabled.

Chapter 1. Transaction abend codes 99


System action System action
An exception trace entry is written. The EP adapter An exception trace entry is written. The EP adapter
task is abnormally terminated with a CICS transaction task is abnormally terminated with a CICS transaction
dump. dump.

User response User response


Inspect the CICS trace and message log to determine Inspect the CICS trace and message log to determine
the cause of the failure. the cause of the failure.
Module: Module:
DFHECEAM, DFHECEAQ, DFHECEAS, DFHECEAT DFHECEAM, DFHECEAQ, DFHECEAS, DFHECEAT
AECE AED1

Explanation Explanation
An unexpected error occurred in the event processing This abend is produced as a result of either:
deferred filtering task CEPF.
• An attempt to use the execution diagnostic facility
(EDF) on an unsupported terminal,
System action
• Using the temporary storage browse transaction
An exception trace entry is written. The CEPF task is (CEBR) on an unsupported device, or
abnormally terminated with a CICS transaction dump. • An attempt to initiate the temporary storage browse
transaction (CEBR) with a non-terminal principal
User response facility.
Inspect the CICS trace and message log to determine
the cause of the failure. System action
Module: The task is abnormally terminated with a CICS
DFHECDF transaction dump.
AECM
User response
Explanation Use a terminal or device that is properly supported.
An attempt was made to attach a CICS event Module:
processing deferred filtering task CEPF, but the DFHEDFP, DFHEDFBR
transaction was not attached internally by CICS. AED2

System action Explanation


An exception trace entry is written. The CEPF task is The program EDF has terminated a task and placed
abnormally terminated. this abend code in the terminated task's TCA. This
occurs because execution of EDF is about to be
User response abnormally terminated. A probable reason for EDF
Investigate why an attempt was made to run a CICS being terminated is that a line, control unit, or a
supplied event processing deferred filtering task as a terminal has been put out of service.
user transaction.
System action
Module:
DFHECDF The task is abnormally terminated with a CICS
transaction dump.
AECO

User response
Explanation
Use a terminal that is supported as a display terminal
An unexpected error occurred while emitting an event. by EDF. A CICS transaction dump of the task
terminated with this abend code is available for
review.

100 CICS TS for z/OS: CICS Codes


Module: User response
DFHEDFX
The problem may be avoided by less complex user
AED3 interactions with EDF. If the problem persists, you may
need further assistance. See IBM problem support for
Explanation guidance on how to proceed.

The program EDF has terminated a task and placed Module:


this abend code in the terminated task's TCA. The DFHEDFD
termination occurs because execution of EDF is about AED6
to be abnormally terminated.
One possible cause of an abend in EDF is incorrect Explanation
data being sent to the terminal by the user task.
An internal logic error was detected in EDF.

System action
System action
The task is abnormally terminated with a CICS
EDF is terminated abnormally with dumps having
transaction dump.
dump codes CXSP, RMIN, PAGE, LDIN. The user task
continues.
User response
A CICS transaction dump of the terminated task and User response
also a similar dump for EDF, when its termination was
The problem may be avoided by less complex user
abnormally terminated, are available for review.
interactions with EDF. If the problem persists, you may
Module: need further assistance. See IBM problem support for
DFHEDFX guidance on how to proceed.
AED4 Module:
DFHEDFU
Explanation AED7
An internal logic error has been detected in EDF
module DFHEDFP. Explanation
The installed definition of the transaction CEDF has a
System action TWA size which is too small.
The task is abnormally terminated with a CICS
transaction dump. System action
CICS abnormally terminates the transaction with a
User response CICS transaction dump.
This indicates a CICS logic error. If you need further
assistance from IBM to resolve this problem, see IBM User response
problem support for guidance on how to proceed.
If you have an updated copy of the CEDF transaction
Module: installed, ensure that you have a TWA size at least as
DFHEDFP big as the one defined by the IBM supplied definition.
If you do not have an updated CEDF you may need
AED5
further assistance to resolve this problem. See IBM
problem support for guidance on how to proceed.
Explanation
Module:
An internal logic error was been detected in EDF. DFHEDFP
Insufficient dynamic storage was pre-allocated.
AED8
System action
Explanation
EDF is terminated abnormally with dumps having
dump codes CXSP, RMIN, PAGE, LDIN. The user task A terminal control error has occurred in DFHEDFX.
continues.

Chapter 1. Transaction abend codes 101


System action Explanation
The task is abnormally terminated with a CICS DFHEDFP has been passed an invalid EDFXA. This is
transaction dump. an internal CICS error.

User response System action


If you need further assistance from IBM to resolve this The task is abnormally terminated with a CICS
problem, see IBM problem support for guidance on transaction dump.
how to proceed.
Module: User response
DFHEDFX If you need further assistance from IBM to resolve this
AED9 problem, see IBM problem support for guidance on
how to proceed.
Explanation Module:
DFHEDFX
A temporary storage error has occurred in EDF. This
could be caused by an input/output error on temporary AEDC
storage or because temporary storage data is full.
Explanation
System action
The program EDF has terminated because a GETMAIN
EDF is abnormally terminated with a CICS transaction request to the storage manager failed.
dump.
System action
User response
The task is abnormally terminated with a CICS
Investigate the reason for the temporary storage transaction dump.
request failure. Ensure that the definition of the
temporary storage data set is correct. User response
See the Troubleshooting and support section for Use the transaction dump to determine why the
further guidance in dealing with temporary storage request has failed.
problems.
Module:
Module: DFHEDFX
DFHEDFD
AEDD
AEDA
Explanation
Explanation
CICS has attempted to attach the EDF task to display
The CEDF transaction has been started with an invalid the user request but the attach has failed.
start code. This could be the result of attempting to
start the execution diagnostic facility (EDF) with EXEC
System action
CICS START(CEDF).
The task is abnormally terminated with a CICS
System action transaction dump.

The task is abnormally terminated with a CICS


User response
transaction dump.
Use the transaction dump to determine why the attach
User response has failed.

Use the transaction dump to determine why the start Module:


has failed. DFHEDFX

Module: AEDE
DFHEDFX
AEDB

102 CICS TS for z/OS: CICS Codes


Explanation DFHEDFX
CICS has suspended the user task to allow the EDF AEDH
task to complete but an error has occurred while
performing the suspend. Explanation
An error occurred when CICS called the Program
System action
Manager in order to discover details of the user
The task is abnormally terminated with a CICS program that has invoked EDF.
transaction dump.
System action
User response
The task is abnormally terminated with a CICS
Use the transaction dump to determine why the transaction dump.
suspend has failed.
Module: User response
DFHEDFX Use the transaction dump to determine why the call
AEDF has failed.
Module:
Explanation DFHEDFX
CICS has suspended the user task to allow the EDF AEE0
task to complete. The user task has been purged while
suspended, before control was returned from EDF. Explanation
An application that is executing in AMODE(64) called
System action
CICS using a stub program that does not support
The task is abnormally terminated with a CICS AMODE(64).
transaction dump.
System action
User response
The task is abnormally terminated with a CICS
The task was probably purged by the master terminal transaction dump.
operator.
Investigate the reason why the task was purged. This User response
may have been in an attempt to clear the system Ensure that the application program calls the correct
which appeared to be deadlocked for some reason. stub program in the correct AMODE.
Module: The application must either call the AMODE(64)
DFHEDFX version of the stub program or switch AMODE before
AEDG calling CICS with the stub program that it is currently
using.
Explanation For an application to call the AMODE(64) version of the
stub program, the SYSSTATE macro with the option
CICS has suspended the user task to allow the EDF
AMODE64=YES must be invoked before any CICS-
task to complete. The user task has gone away while
supplied macros are invoked.
suspended, before control was returned from EDF.
Module:
System action DFHCPI,DFHEIP, DFHEIPA, DFHERM

The task is abnormally terminated with a CICS AEE1


transaction dump.
Explanation
User response The application program called an AMODE(64)
Use the transaction dump to determine the reason command stub, but was not executing in AMODE(64).
why the task finished before being resumed.
Module:

Chapter 1. Transaction abend codes 103


System action Module:
DFHEIGA
The task is abnormally terminated with a CICS
transaction dump. AEI0

User response Explanation


Ensure that the application program is in the correct PGMIDERR condition not handled.
AMODE and is calling the correct stub program.
This is one of a number of abends issued by the EXEC
The application must either call the non-AMODE(64) interface program. Because of their similar
version of the stub program, or switch to AMODE(64) characteristics these abends are described as a group.
before calling CICS with the current stub program.
See the description of abend AEIA for further details.
Module:
System action:
DFHEIG, DFHEIGA
User response:
AEE2
Module:
Explanation DFHEIP

The initial AMODE(64) command processor module, AEI1


DFHEIG, detected an application program error. An
exception trace is produced immediately before the Explanation
abend to identify the error.
TRANSIDERR condition not handled.

System action This is one of a number of abends issued by the EXEC


interface program. Because of their similar
The task is abnormally terminated with a CICS characteristics these abends are described as a group.
transaction dump.
See the description of abend AEIA for further details.
User response System action:
Use the exception trace to identify and correct the User response:
error.
Module:
Module: DFHEIP
DFHEIG
AEI2
AEE3
Explanation
Explanation
ENDDATA condition not handled.
An AMODE(64) assembler application used DFHEIRET
This is one of a number of abends issued by the EXEC
to return, but the dynamic storage area (DSA) that is
interface program. Because of their similar
being released by the CICS epilog code is not at the
characteristics these abends are described as a group.
front of the chain. The assembler DSAs are obtained
by the DFHEIENT macro and CICS prolog code, and See the description of abend AEIA for further details.
are chained together, with each one added to the front
System action:
of the chain.
User response:
System action Module:
The task is abnormally terminated with a CICS DFHEIP
transaction dump. AEI3

User response Explanation


Ensure that all assembler application programs that INVTSREQ condition not handled.
are directly called and use DFHEIENT use either
DFHEIRET or the EXEC CICS RETURN command to This is one of a number of abends issued by the EXEC
return to their caller. interface program. Because of their similar
characteristics these abends are described as a group.

104 CICS TS for z/OS: CICS Codes


See the description of abend AEIA for further details. Explanation
System action: The EXEC interface program issues an abend when an
exceptional condition has occurred but the command
User response:
does not have the RESP option (or NOHANDLE option),
Module: or the application program has not executed an EXEC
DFHEIP CICS HANDLE CONDITION command for that
condition. This will cause DFHEIP to take the system
AEI4
action for the condition in question. In most cases, the
system action will be to abend the transaction.
Explanation
Because of their similar characteristics, the above-
EXPIRED condition not handled. named abend codes for the EXEC interface program
This is one of a number of abends issued by the EXEC are described as a group. The codes and their
interface program. Because of their similar corresponding exceptional conditions are as follows:
characteristics these abends are described as a group.
Code Condition
See the description of abend AEIA for further details.
AEIA ERROR
System action:
AEID EOF
User response:
AEIE EODS
Module:
DFHEIP AEIG INBFMH
AEI8 AIEH ENDINPT
AEII NONVAL
Explanation
AEIJ NOSTART
TSIOERR condition not handled.
AEIK TERMIDERR
This is one of a number of abends issued by the EXEC
interface program. Because of their similar AEIL FILENOTFOUND
characteristics these abends are described as a group.
AEIM NOTFND
See the description of abend AEIA for further details.
AEIN DUPREC
System action:
AEIO DUPKEY
User response:
AEIP INVREQ
Module:
DFHEIP AEIQ IOERR
AEI9 AEIR NOSPACE
AEIS NOTOPEN
Explanation
AEIT ENDFILE
MAPFAIL condition not handled.
AEIU ILLOGIC
This is one of a number of abends issued by the EXEC
interface program. Because of their similar AEIV LENGERR
characteristics these abends are described as a group.
AEIW QZERO
See the description of abend AEIA for further details.
AEIZ ITEMERR
System action:
AEI0 PGMIDERR
User response:
AEI1 TRANSIDERR
Module:
DFHEIP AEI2 ENDDATA
AEIA AEI3 INVTSREQ
AEI4 EXPIRED

Chapter 1. Transaction abend codes 105


Code Condition Code Condition
AEI8 TSIOERR AEYR ISCINVREQ
AEI9 MAPFAIL AEYT ENVDEFERR
AEXC RESIDERR AEYU IGREQCD
AEXF ESCERROR AEYV SESSIONERR
AEXG UOWLNOTFOUND AEYX USERIDERR
AEXI TERMERR AEYZ CBIDERR
AEXJ ROLLEDBACK AEY0 INVEXITREQ
AEXK END AEY1 INVPARTNSET
AEXL DISABLED AEY2 INVPARTIN
AEXU NOTPOSS AEY3 PARTNFALL
AEXV VOLIDERR AEY7 NOTAUTH
AEXW TASKIDERR AEZE CHANGED
AEX1 DSNNOTFOUND AEZF PROCESSBUSY
AEX2 LOADING AEZG ACTIVITYBUSY
AEX3 MODELIDERR AEZH PROCESSERR
AEX4 UOWNOTFOUND AEZI ACTIVITYERR
AEX5 PARTNERIDERR AEZJ CONTAINERERR
AEX6 PROFILEIDERR AEZK EVENTERR
AEX7 NETNAMEIDERR AEZL TOKENERR
AEX8 LOCKED AEZM NOTFINISHED
AEX9 RECORDBUSY AEZN POOLERR
AEYA INVERRTERM AEZO TIMERERR
AEYB INVMPSZ AEXP SYMBOLERR
AEYC IGREQID AEZQ TEMPLATERR
AEYE INVLDC AEZR NOTSUPERUSER
AEYG JIDERR AEZS CSDERR
AEYH QIDERR AEZT DUPRES
AEYJ DSSTAT AEZU RESUNAVAIL
AEYK SELNERR AEZV CHANNELERR
AEYL FUNCERR AEZW CCSIDERR
AEYM UNEXPIN AEZX TIMEDOUT
AEYN NOPASSBKRD AEZY CODEPAGEERR
AEYO NOPASSBKWR AEZZ INCOMPLETE
AEYP SEGIDERR AEZ1 APPNOTFOUND
AEYQ SYSIDERR AEZ2 BUSY

106 CICS TS for z/OS: CICS Codes


System action This is one of a number of abends issued by the EXEC
interface program. Because of their similar
The transaction is abnormally terminated with a CICS
characteristics these abends are described as a group.
transaction dump.
See the description of abend AEIA for further details.
User response System action:
Change the application program either to prevent the User response:
condition recurring, to check it by using the RESP
option, or to handle the condition when it does occur Module:
(by using the EXEC CICS HANDLE CONDITION DFHEIP
command). If necessary, use the contents of the AEIE
EIBRESP2 field or the EIBRCODE in the EIB to assist in
determining the cause of the exceptional condition.
Explanation

Problem determination EODS condition not handled.

The function code of the command that produced the This is one of a number of abends issued by the EXEC
exceptional response and the response code can be interface program. Because of their similar
found in the EXEC interface block (EIB). The EIB is part characteristics these abends are described as a group.
of a larger control block, used by DFHEIP, known as See the description of abend AEIA for further details.
the EXEC interface storage block (EIS). The EIS is
addressed by the TCAEISA, which is the system part of System action:
the TCA + X'90' The EIB is pointed to from the EIS + User response:
X'8'.
Module:
The function code may be located at offset X'1B' in the DFHEIP
EIB while the response codes may be one of the
following at the given offsets: AEIG

EIBRCODE
Explanation
X'1D'
INBFMH condition not handled.
EIBRESP
This is one of a number of abends issued by the EXEC
X'4C' interface program. Because of their similar
characteristics these abends are described as a group.
EIBRESP2
See the description of abend AEIA for further details.
X'50'
System action:
The Reference: application development gives
translations of the encoded functions and their User response:
responses.
Module:
Analysis: Because these abend codes are directly DFHEIP
related to exceptional conditions that can be specified
AEIH
in HANDLE CONDITION commands, the application
programmer should decide whether the condition is
one that should be handled by the application (for Explanation
example ENDFILE), or one that requires modifications ENDINPT condition not handled.
to the application or CICS tables. :i1.DFHEIP abend
codes This is one of a number of abends issued by the EXEC
interface program. Because of their similar
Module: characteristics these abends are described as a group.
DFHEIP
See the description of abend AEIA for further details.
AEID
System action:
Explanation User response:
EOF condition not handled. Module:
DFHEIP

Chapter 1. Transaction abend codes 107


AEII System action:
User response:
Explanation
Module:
NONVAL condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEIM
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. NOTFND condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.
AEIJ System action:
User response:
Explanation
Module:
NOSTART condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEIN
interface program. Because of their similar
characteristics these abends are described as a group.
Explanation
See the description of abend AEIA for further details.
DUPREC condition not handled.
System action:
This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.
AEIK System action:
User response:
Explanation
Module:
TERMIDERR condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEIO
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. DUPKEY condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.
AEIL System action:
User response:
Explanation
Module:
FILENOTFOUND condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEIP
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. INVREQ condition not handled.

108 CICS TS for z/OS: CICS Codes


This is one of a number of abends issued by the EXEC AEIT
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. ENDFILE condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

AEIQ System action:


User response:
Explanation
Module:
IOERR condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEIU
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. ILLOGIC condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

AEIR System action:


User response:
Explanation
Module:
NOSPACE condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEIV
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. LENGERR condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

AEIS System action:


User response:
Explanation
Module:
NOTOPEN condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEIW
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. QZERO condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

Chapter 1. Transaction abend codes 109


System action: Explanation
User response: The executing function has been purged before control
could be returned.
Module:
DFHEIP
System action
AEIZ
The transaction is marked to be abnormally
terminated with abend code AELB.
Explanation
ITEMERR condition not handled. User response
This is one of a number of abends issued by the EXEC Investigate the reason the task was purged. It was
interface program. Because of their similar purged either by the master terminal operator, or as a
characteristics these abends are described as a group. result of a deadlock timeout.
See the description of abend AEIA for further details. If the task was purged by the master terminal
System action: operator, this may have been in an attempt to clear the
system which appeared to be deadlocked for some
User response: reason.
Module: If the task was timed out automatically as a result of
DFHEIP the DTIMOUT value being exceeded, this may be due
AELA to insufficient main storage being available for the
number of tasks in the system. If the amount of main
storage cannot be increased then the number of tasks
Explanation
in the system should be reduced to avoid short-on-
The executing function has been purged before control storage situations. Another possibility would be to
could be returned. increase the value of the DTIMOUT option for the
transaction.
System action Module:
The transaction is marked to be abnormally DFHEGL
terminated with abend code AELA. AEMA

User response Explanation


Investigate the reason the task was purged. It was An error (INVALID or DISASTER response) has
purged either by the master terminal operator, or as a occurred on a call to the application (AP) domain when
result of a deadlock timeout. a request for set user exit active could not be serviced.
If the task was purged by the master terminal
operator, this may have been in an attempt to clear the System action
system which appeared to be deadlocked for some
The task is abnormally terminated. The domain that
reason.
detected the original error issues a console message
If the task was timed out automatically as a result of and might provide an exception trace, and depending
the DTIMOUT value being exceeded, this may be due on the options specified in the dump table, a system
to insufficient main storage being available for the dump.
number of tasks in the system. If the amount of main
storage cannot be increased then the number of tasks User response
in the system should be reduced to avoid short-on-
storage situations. Another possibility would be to See the associated console message for further
increase the value of the DTIMOUT option for the guidance.
transaction. Module:
Module: DFHUEM
DFHETL AEMB
AELB

110 CICS TS for z/OS: CICS Codes


Explanation Explanation
An error (INVALID or DISASTER response) has The task was purged before an IDENTIFY_PROGRAM
occurred on a call to the loader (LD) domain. The request to the loader (LD) domain was able to
domain that detected the original error will have complete successfully. The domain that first detected
provided an exception trace, a console message, and the purged condition provides an exception trace.
possibly a system dump (depending on the options in
the dump table). System action
The task is abnormally terminated with a CICS
System action
transaction dump (depending on the options in the
The task is abnormally terminated with a CICS dump table).
transaction dump (depending on the options in the
dump table). User response
Investigate why the task was purged. This is either as
User response
a result of a purge from the master terminal operator
See the related message from the domain that via the CEMT transaction, or by the task being timed
detected the original error. out after waiting for longer than the DTIMOUT
(deadlock timeout) value specified for the transaction.
Module:
DFHUEM If the master terminal operator purged the task, this
may have been in an attempt to clear the system
AEMP
which appeared to be deadlocked for some reason.

Explanation If the task was timed out automatically as a result of


the DTIMOUT value being exceeded, this may be due
The task was purged before a set active request to the to insufficient main storage being available for the
application (AP) domain was able to complete number of tasks in the system. If the amount of main
successfully. The domain that first detected the storage cannot be increased, reduce the number of
purged condition may provide an exception trace. tasks in the system to avoid short-on-storage
situations. Another possibility is to increase the value
System action of the DTIMOUT option for the transaction.
The task is abnormally terminated with a CICS Module:
transaction dump. DFHUEM
AEPD
User response
Investigate why the task was purged. This is either as Explanation
a result of a purge from the master terminal operator
An unexpected error occurred while dispatching
via the CEMT transaction, or by the task being timed
events.
out after waiting for longer than the DTIMOUT
(deadlock timeout) value specified for the transaction.
System action
If the master terminal operator purged the task, this
may have been in an attempt to clear the system An exception trace entry is written. The EP dispatcher
which appeared to be deadlocked for some reason. task is abnormally terminated with a CICS transaction
dump.
If the task was timed out automatically as a result of
the DTIMOUT value being exceeded, this may be due
User response
to insufficient main storage being available for the
number of tasks in the system. If the amount of main Inspect the CICS trace and message log to determine
storage cannot be increased, reduce the number of the cause of the failure.
tasks in the system to avoid short-on-storage
Module:
situations. Another possibility is to increase the value
DFHEPDS
of the DTIMOUT option for the transaction.
AEPM
Module:
DFHUEM
AEMQ

Chapter 1. Transaction abend codes 111


Explanation Explanation
An attempt was made to attach a CICS EP dispatcher A CICS transaction has issued a non-CICS command
task, but the transaction was not attached internally via an application "stub" (an expansion of a
by CICS. DFHRMCAL macro). However, the task-related user
exit (TRUE) is not known to program manager.
System action
System action
An exception trace entry is written. The EP dispatcher
task is abnormally terminated. The task is abnormally terminated with a transaction
dump
User response
User response
Investigate why the attempt was made to run a CICS
supplied EP dispatcher task as a user transaction. Ensure that the TRUE as identified to the DFHRMCAL
macro has been correctly defined to CICS.
Module:
DFHEPDS, DFHEPSY Module:
DFHERM
AEPO
AETF
Explanation
Explanation
An unexpected error occurred in the EP dispatcher
event queue server task. The task was purged before a request to the storage
manager (SM) domain was able to complete
System action successfully. The domain that first detected the
purged condition will have provided an exception
An exception trace entry is written. The EP dispatcher trace.
task is abnormally terminated with a CICS transaction
dump.
System action

User response The task is abnormally terminated with a CICS


transaction dump.
Inspect the CICS trace and message log to determine
the cause of the failure.
User response
Module:
Investigate why the task was purged. This is either as
DFHEPSY
a result of a purge from the master terminal operator
AETA via the CEMT transaction, or by the task being timed
out after waiting for longer than the DTIMOUT
Explanation (deadlock timeout) value specified for the transaction.

A CICS transaction has issued a non-CICS command If the master terminal operator purged the task, this
via an application "stub" (an expansion of a may have been in an attempt to clear the system
DFHRMCAL macro). Program DFHERM has determined which appeared to be deadlocked for some reason.
that the exit has been disabled since the previous If the task was timed out automatically as a result of
DFHRMCAL request was issued from the transaction. the DTIMOUT value being exceeded, this may be due
to insufficient main storage being available for the
System action number of tasks in the system. If the amount of main
storage cannot be increased, reduce the number of
The task is abnormally terminated with a transaction
tasks in the system to avoid short-on-storage
dump
situations. Another possibility is to increase the value
of the DTIMOUT option for the transaction.
User response
Module:
Notify your system programmer. DFHERM
Module: AETG
DFHERM
AETC

112 CICS TS for z/OS: CICS Codes


Explanation AETI
An error (INVALID, DISASTER or unexpected
EXCEPTION response) has occurred on a call to the Explanation
storage manager (SM) domain. The domain that An error (INVALID, DISASTER or unexpected
detected the original error will have provided an EXCEPTION response) has occurred on a call to the
exception trace, a console message and, possibly, a storage manager (SM) domain. The domain that
system dump (depending on the options specified in detected the original error will have provided an
the dump table). exception trace, a console message and, possibly, a
system dump (depending on the options specified in
System action the dump table).
The task is abnormally terminated with a CICS
transaction dump. System action
The task is abnormally terminated with a CICS
User response transaction dump.
See the related message produced by the domain that
detected the original error. User response

Module: See the related message produced by the domain that


DFHERM detected the original error.

AETH Module:
DFHERM
Explanation AETJ
The task was purged before a request to the storage
manager (SM) domain was able to complete Explanation
successfully. The domain that first detected the An error (EXCEPTION, DISASTER, INVALID,
purged condition will have provided an exception KERNERROR or PURGED) has occurred on an
trace. ADD_LINK call to the recovery manager (RM) domain.
For errors other than EXCEPTION, the RM domain
System action provides an exception trace, a console message, and
possibly a system dump (depending on the options in
The task is abnormally terminated with a CICS
the dump table).
transaction dump.
For all errors, DFHERM provides an exception trace,
User response console message DFHAP0002, and possibly a system
dump (depending on the options in the dump table).
Investigate why the task was purged. This is either as
a result of a purge from the master terminal operator
System action
via the CEMT transaction, or by the task being timed
out after waiting for longer than the DTIMOUT The task is abnormally terminated with a CICS
(deadlock timeout) value specified for the transaction. transaction dump.
If the master terminal operator purged the task, this
may have been in an attempt to clear the system User response
which appeared to be deadlocked for some reason. If you need further assistance from IBM to resolve this
If the task was timed out automatically as a result of problem, see IBM problem support for guidance on
the DTIMOUT value being exceeded, this may be due how to proceed.
to insufficient main storage being available for the Module:
number of tasks in the system. If the amount of main DFHERM
storage cannot be increased, reduce the number of
tasks in the system to avoid short-on-storage AETK
situations. Another possibility is to increase the value
of the DTIMOUT option for the transaction. Explanation
Module: An error (EXCEPTION, DISASTER, INVALID,
DFHERM KERNERROR or PURGED) has occurred on an
SET_LINK call to the recovery manager (RM) domain.

Chapter 1. Transaction abend codes 113


For errors other than EXCEPTION, the RM domain trace, a console message, and possibly a system dump
provides an exception trace, a console message, and (depending on the options in the dump table).
possibly a system dump (depending on the options in
For all errors, DFHRMSY provides an exception trace,
the dump table).
console message DFHAP0002, and possibly a system
For all errors, DFHERM provides an exception trace, dump (depending on the options in the dump table).
console message DFHAP0002, and possibly a system
dump (depending on the options in the dump table). System action
The task is abnormally terminated with a CICS
System action
transaction dump.
The task is abnormally terminated with a CICS
transaction dump. User response
If you need further assistance from IBM to resolve this
User response
problem, see IBM problem support for guidance on
If you need further assistance from IBM to resolve this how to proceed.
problem, see IBM problem support for guidance on
Module:
how to proceed.
DFHRMSY
Module:
AETN
DFHERM
AETL Explanation
An EXCEPTION response with an unexpected reason
Explanation
occurred on an INITITIATE_RECOVERY call to
An error (EXCEPTION, DISASTER, INVALID, recovery manager (RM) domain. DFHRMSY provides an
KERNERROR or PURGED) has occurred on an exception trace, console message DFHAP0002, and
SET_UOW call to the recovery manager (RM) domain. possibly a system dump (depending on the options in
For errors other than EXCEPTION, the RM domain the dump table).
provides an exception trace, a console message, and
possibly a system dump (depending on the options in System action
the dump table).
The task is abnormally terminated with a CICS
For all errors, DFHERM provides an exception trace, transaction dump.
console message DFHAP0002, and possibly a system
dump (depending on the options in the dump table).
User response

System action If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
The task is abnormally terminated with a CICS how to proceed.
transaction dump.
Module:
DFHRMSY
User response
AETO
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed. Explanation

Module: An error (DISASTER, INVALID, KERNERROR, or


DFHERM PURGED) has occurred on an INITIATE_RECOVERY
call to the recovery manager (RM) domain. The RM
AETM domain provides an exception trace, a console
message, and possibly a system dump (depending on
Explanation the options in the dump table).
An error (EXCEPTION, DISASTER, INVALID, DFHRMSY also provides an exception trace, console
KERNERROR, or PURGED) has occurred on an message DFHAP0002, and possibly a system dump
INQUIRE_TRANSACTION call to the transaction (depending on the options in the dump table).
manager (XM) domain. For errors other than
EXCEPTION, the XM domain provides an exception

114 CICS TS for z/OS: CICS Codes


System action User response
The task is abnormally terminated with a CICS If you need further assistance from IBM to resolve this
transaction dump. problem, see IBM problem support for guidance on
how to proceed.
User response Module:
If you need further assistance from IBM to resolve this DFHRMSY
problem, see IBM problem support for guidance on AETR
how to proceed.
Module: Explanation
DFHRMSY
An error (DISASTER, INVALID, KERNERROR, or
AETP PURGED) has occurred on an INQUIRE_UOW call to
the recovery manager (RM) domain. The RM domain
Explanation provides an exception trace, a console message, and
possibly a system dump (depending on the options in
An error (EXCEPTION, DISASTER, INVALID, the dump table).
KERNERROR, or PURGED) has occurred on an
TERMINATE_RECOVERY call to recovery manager DFHRMSY also provides an exception trace, console
(RM) domain. For errors other than EXCEPTION, the message DFHAP0002, and possibly a system dump
RM domain provides an exception trace, a console (depending on the options in the dump table).
message, and possibly a system dump (depending on
the options in the dump table). System action
For all errors, DFHRMSY provides an exception trace, The task is abnormally terminated with a CICS
console message DFHAP0002, and possibly a system transaction dump.
dump (depending on the options in the dump table).
User response
System action
If you need further assistance from IBM to resolve this
The task is abnormally terminated with a CICS problem, see IBM problem support for guidance on
transaction dump. how to proceed.
Module:
User response DFHRMSY
If you need further assistance from IBM to resolve this AETS
problem, see IBM problem support for guidance on
how to proceed.
Explanation
Module:
An error (EXCEPTION, DISASTER, INVALID,
DFHRMSY
KERNERROR, or PURGED) has occurred on an
AETQ INQUIRE_STARTUP call to recovery manager (RM)
domain. For errors other than EXCEPTION, the RM
Explanation domain provides an exception trace, a console
message, and possibly a system dump (depending on
An EXCEPTION response with an unexpected reason the options in the dump table).
occurred on an INQUIRE_UOW call to the recovery
manager (RM) domain. DFHRMSY provides an For all errors, DFHRMSY provides an exception trace,
exception trace, console message DFHAP0002, and console message DFHAP0002, and possibly a system
possibly a system dump (depending on the options in dump (depending on the options in the dump table).
the dump table).
System action
System action The task is abnormally terminated with a CICS
The task is abnormally terminated with a CICS transaction dump.
transaction dump.

Chapter 1. Transaction abend codes 115


User response Explanation
If you need further assistance from IBM to resolve this MODELIDERR condition not handled.
problem, see IBM problem support for guidance on
This is one of a number of abends issued by the EXEC
how to proceed.
interface program. Because of their similar
Module: characteristics these abends are described as a group.
DFHRMSY
See the description of abend AEIA for further details.
AEX0
System action:

Explanation User response:

TCIDERR condition not handled. Module:


DFHEIP
This is one of a number of abends issued by the EXEC
interface program. Because of their similar AEX4
characteristics these abends are described as a group.
Explanation
See the description of abend AEIA for further details.
UOWNOTFOUND condition not handled.
System action:
This is one of a number of abends issued by the EXEC
User response:
interface program. Because of their similar
Module: characteristics these abends are described as a group.
DFHEIP
See the description of abend AEIA for further details.
AEX1
System action:

Explanation User response:

DSNNOTFOUND condition not handled. Module:


DFHEIP
This is one of a number of abends issued by the EXEC
interface program. Because of their similar AEX5
characteristics these abends are described as a group.
Explanation
See the description of abend AEIA for further details.
PARTNERIDERR condition not handled.
System action:
This is one of a number of abends issued by the EXEC
User response:
interface program. Because of their similar
Module: characteristics these abends are described as a group.
DFHEIP
See the description of abend AEIA for further details.
AEX2
System action:

Explanation User response:

LOADING condition not handled. Module:


DFHEIP
This is one of a number of abends issued by the EXEC
interface program. Because of their similar AEX6
characteristics these abends are described as a group.
Explanation
See the description of abend AEIA for further details.
PROFILEIDERR condition not handled.
System action:
This is one of a number of abends issued by the EXEC
User response:
interface program. Because of their similar
Module: characteristics these abends are described as a group.
DFHEIP
See the description of abend AEIA for further details.
AEX3
System action:
User response:

116 CICS TS for z/OS: CICS Codes


Module: See the description of abend AEIA for further details.
DFHEIP
System action:
AEX7
User response:

Explanation Module:
DFHEIP
NETNAMEIDERR condition not handled.
AEXF
This is one of a number of abends issued by the EXEC
interface program. Because of their similar
Explanation
characteristics these abends are described as a group.
ESCERROR condition not handled.
See the description of abend AEIA for further details.
This is one of a number of abends issued by the EXEC
System action:
interface program. Because of their similar
User response: characteristics these abends are described as a group.
Module: See the description of abend AEIA for further details.
DFHEIP
System action:
AEX8
User response:

Explanation Module:
DFHEIP
LOCKED condition not handled.
AEXG
This is one of a number of abends issued by the EXEC
interface program. Because of their similar
Explanation
characteristics these abends are described as a group.
UOWLNOTFOUND condition not handled.
See the description of abend AEIA for further details.
This is one of a number of abends issued by the EXEC
System action:
interface program. Because of their similar
User response: characteristics these abends are described as a group.
Module: See the description of abend AEIA for further details.
DFHEIP
System action:
AEX9
User response:

Explanation Module:
DFHEIP
RECORDBUSY condition not handled.
AEXI
This is one of a number of abends issued by the EXEC
interface program. Because of their similar
Explanation
characteristics these abends are described as a group.
TERMERR condition not handled.
See the description of abend AEIA for further details.
This is one of a number of abends issued by the EXEC
System action:
interface program. Because of their similar
User response: characteristics these abends are described as a group.
Module: See the description of abend AEIA for further details.
DFHEIP
System action:
AEXC
User response:

Explanation Module:
DFHEIP
RESIDERR condition not handled.
AEXJ
This is one of a number of abends issued by the EXEC
interface program. Because of their similar
characteristics these abends are described as a group.

Chapter 1. Transaction abend codes 117


Explanation User response
ROLLEDBACK condition not handled. Refer to abend AEIA for an explanation of how to
determine the function code of the CICS command
This is one of a number of abends issued by the EXEC
that caused the abend.
interface program. Because of their similar
characteristics these abends are described as a group. It is not possible to set an EXEC CICS HANDLE
CONDITION for NOTPOSS.
See the description of abend AEIA for further details.
The system programmer should investigate the cause
System action:
of the storage overlay.
User response:
Module:
Module: DFHEIDTI, DFHEIG, DFHEIP, DFHEIQDS, DFHEIQSA,
DFHEIP DFHEIQSC, DFHEIQSM, DFHEIQSP, DFHEIQST,
DFHEIQSX
AEXK
AEXV
Explanation
Explanation
END condition not handled.
VOLIDERR condition not handled.
This is one of a number of abends issued by the EXEC
interface program. Because of their similar This is one of a number of abends issued by the EXEC
characteristics these abends are described as a group. interface program. Because of their similar
characteristics these abends are described as a group.
See the description of abend AEIA for further details.
See the description of abend AEIA for further details.
System action:
System action:
User response:
User response:
Module:
DFHEIP Module:
DFHEIP
AEXL
AEXW
Explanation
Explanation
DISABLED condition not handled.
SUPPRESSED condition not handled.
This is one of a number of abends issued by the EXEC
interface program. Because of their similar This is one of a number of abends issued by the EXEC
characteristics these abends are described as a group. interface program. Because of their similar
characteristics these abends are described as a group.
See the description of abend AEIA for further details.
See the description of abend AEIA for further details.
System action:
System action:
User response:
User response:
Module:
DFHEIP Module:
DFHEIP
AEXU
AEXX
Explanation
Explanation
During execution of an EXEC CICS command, a
NOTPOSS condition has been raised on encountering TASKIDERR condition not handled.
an invalid parameter. This is probably caused by a
This is one of a number of abends issued by the EXEC
previous storage overlay.
interface program. Because of their similar
characteristics these abends are described as a group.
System action
See the description of abend AEIA for further details.
The transaction is abnormally terminated with a CICS
transaction dump. System action:

118 CICS TS for z/OS: CICS Codes


User response: System action
Module: The transaction is abnormally terminated with abend
DFHEIP code AEXZ. CICS takes a transaction dump, unless
module DFHDUIO is not loaded.
AEXY

User response
Explanation
Use the transaction dump to determine the cause of
The executing transaction has been purged before
the failure. For further assistance, or if module
control could be returned.
DFHDUIO is not loaded and no transaction dump is
This can arise when the transaction is purged while available, contact your system programmer.
• A CICS command was being processed For module list, see Diagnostics reference.
• The transaction was waiting to be dispatched Module:
DFHACP, DFHAPRA, DFHAPRR DFHAPRX, DFHBEP,
System action DFHBREX, DFHBRIC, DFHBRMS, DFHBRSP, DFHBRTC,
DFHBSTS, DFHBSTZO, DFHCDKRN, DFHEDCP,
The transaction is abnormally terminated with a CICS DFHEDFP, DFHEDI, DFHEEI, DFHEGL, DFHEIACQ,
transaction dump. DFHEIBAM, DFHEICRE, DFHEIG, DFHEIIC, DFHEIP,
DFHEIPA, DFHEIML, DFHEIPI, DFHEIPRT, DFHEIPSE,
User response DFHEIPSH, DFHEIQBA, DFHEIQBR, DFHEIQCF,
Contact your system programmer to determine why DFHEIQCS, DFHEIQDF, DFHEIQDI, DFHEIQDN,
the transaction has been purged. DFHEIQDS, DFHEIQDU, DFHEIQD2, DFHEIQEJ,
DFHEIQIR, DFHEIQML, DFHEIQMQ, DFHEIQMS,
For module list, see Diagnostics reference. DFHEIQMT, DFHEIQPF, DFHEIQPI, DFHEIQPN,
Module: DFHEIQRL, DFHEIQRQ, DFHEIQSA, DFHEIQSC,
DFHACP, DFHAPRR, DFHAPRX, DFHBEP, DFHBREX, DFHEIQSJ, DFHEIQSK, DFHEIQSL, DFHEIQSM,
DFHBRIC, DFHBRMS, DFHBRSP, DFHBRTC, DFHBSTS, DFHEIQSP, DFHEIQSQ, DFHEIQST, DFHEIQSX,
DFHBSTZO, DFHD2CC, DFHD2EX1, DFHD2EX2, DFHEIQSY, DFHEIQTM, DFHEIQTR, DFHEIQTS,
DFHD2STR, DFHEDCP, DFHEDFP, DFHEDI, DFHEEI, DFHEIQUE, DFHEIQVT, DFHEIQWB, DFHEIQWR,
DFHEGL, DFHEIBAM, DFHEICRE, DFHEIIC, DFHEIG, DFHEIQW2, DFHEIUOW, DFHEIWB, DFHEKC,
DFHEIP, DFHEIPA, DFHEIPI, DFHEIPRT, DFHEIPSE, DFHEMS, DFHEOP, DFHEPC, DFHEPS, DFHESC,
DFHEIPSH, DFHEIQAS, DFHEIQBA, DFHEIQBR, DFHESE, DFHESN, DFHETC, DFHETL, DFHETRX,
DFHEIQCF, DFHEIQCS, DFHEIQDE, DFHEIQDI, DFHFCFL, DFHMQTRU, DFHSJIN, DFHTACP, DFHTFP,
DFHEIQDN, DFHEIQDS, DFHEIQDU, DFHEIQD2, DFHTIEM, DFHUEH, DFHUEM, DFHWBTC, DFHXMBR,
DFHEIQEJ, DFHEIQIR, DFHEIQML, DFHEIQMQ, DFHXTP, DFHZATS, DFHZNCA, DFHZNCE, DFHZTSP,
DFHEIQMS, DFHEIQMT, DFHEIQPF, DFHEIQPI, DFHZXQO, DFHZXST
DFHEIQPN, DFHEIQRL, DFHEIQRQ, DFHEIQSA, AEY0
DFHEIQSC, DFHEIQSJ, DFHEIQSK, DFHEIQSL,
DFHEIQSM, DFHEIQSP, DFHEIQSQ, DFHEIQST, Explanation
DFHEIQSX, DFHEIQSY, DFHEIQTM, DFHEIQTR,
DFHEIQTS, DFHEIQUE, DFHEIQVT, DFHEIQWB, INVEXITREQ condition not handled.
DFHEIQWR, DFHEIQW2, DFHEIUOW, DFHEIWB, This is one of a number of abends issued by the EXEC
DFHEKC, DFHEMS, DFHEOP, DFHEPC, DFHEPS, interface program. Because of their similar
DFHERM, DFHESC, DFHESE, DFHESN, DFHETC, characteristics these abends are described as a group.
DFHETL, DFHETRX, DFHTACP, DFHTFP, DFHTIEM,
DFHUEM, DFHWBTC, DFHXMBR, DFHXTP, DFHZATS, See the description of abend AEIA for further details.
DFHZNCA, DFHZNCE, DFHZTSP, DFHZXQO, DFHZXST System action:
AEXZ User response:

Explanation Module:
DFHEIP
A command has failed due to a serious failure in a
CICS component (resource manager). AEY1

Chapter 1. Transaction abend codes 119


Explanation and EPLs) are out of step and have probably been
corrupted.
INVPARTNSET condition not handled.
This is one of a number of abends issued by the EXEC System action
interface program. Because of their similar
characteristics these abends are described as a group. The task is abnormally terminated with a CICS
transaction dump.
See the description of abend AEIA for further details.
System action: User response
User response: If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
Module:
how to proceed.
DFHEIP
Module:
AEY2
DFHUEM

Explanation AEY7

INVPARTN condition not handled.


Explanation
This is one of a number of abends issued by the EXEC
NOTAUTH condition not handled.
interface program. Because of their similar
characteristics these abends are described as a group. This is one of a number of abends issued by the EXEC
interface program. Because of their similar
See the description of abend AEIA for further details.
characteristics these abends are described as a group.
System action:
See the description of abend AEIA for further details.
User response:
System action:
Module:
User response:
DFHEIP
Module:
AEY3
DFHEIP

Explanation AEY8

PARTNFAIL condition not handled.


Explanation
This is one of a number of abends issued by the EXEC
No DSA was found on the chain while trying to free
interface program. Because of their similar
dynamic storage for an assembler language program
characteristics these abends are described as a group.
using an EXEC CICS command.
See the description of abend AEIA for further details.
System action: System action

User response: The transaction is abnormally terminated with a CICS


transaction dump.
Module:
DFHEIP
User response
AEY6
Ensure that the DFHEIENT, DFHEISTG, and DFHEIEND
macro invocations are correctly positioned and retry. If
Explanation the error persists, you will need further assistance.
Internal logic error in DFHUEM. This arises when using See IBM problem support for guidance on how to
EXITALL to DISABLE an exit program from all exit proceed.
points for which it has been enabled. The entire user Module:
exit table has been scanned and all associations of the DFHEIP
program have been found. But the activation count for
the program in its exit program block indicates there AEY9
should be more associations (for example, the
activation count has not been reduced to zero). The
user exit table and associated control blocks (EPBs

120 CICS TS for z/OS: CICS Codes


Explanation AEYB
One of the following:
Explanation
• An EXEC CICS command has been issued that is not
supported by the EXEC interface program DFHEIP. INVMPSZ condition not handled.
• A transaction has issued an EXEC CICS command This is one of a number of abends issued by the EXEC
which is supported in principle by the EXEC interface interface program. Because of their similar
program DFHEIP, but for which the prerequisite characteristics these abends are described as a group.
function has not been included in the current CICS
See the description of abend AEIA for further details.
start-up.
• A non-CICS command has been issued via an System action:
application stub (expansion of a DFHRMCAL macro), User response:
and the program DFHERM has detected that the
necessary non-CICS support is not available. Module:
DFHEIP
• An attempt has been made to use remote resources,
but the local SYSID has been specified in an EXEC AEYC
CICS command, or vice versa.
• An attempt has been made to use remote resources, Explanation
but ISC is not supported. IGREQID condition not handled.
• An EXEC CICS command contains an invalid AID or This is one of a number of abends issued by the EXEC
CONDITION identifier. This indicates that the EXEC interface program. Because of their similar
CICS command has become corrupted. characteristics these abends are described as a group.

System action See the description of abend AEIA for further details.

The transaction is abnormally terminated with a CICS System action:


transaction dump. User response:
Module:
User response DFHEIP
Check that the sysid specified and the resource names
AEYD
were correct. If not, notify the system programmer.
Either the command (or an application stub) has
become corrupted, or the unavailable function needs Explanation
to be generated (CICS command), ENABLEd (non-CICS A transaction has requested that CICS access a
command), or exceptionally the non-CICS support has storage area that the transaction itself could not
suffered damage and is attempting to withdraw itself access. This occurred when an invalid storage area
from the CICS system. was passed to CICS as an output parameter on an
Module: EXEC CICS command.
DFHEIG, DFHEIP, DFHEEI
System action
AEYA
The transaction is abnormally terminated with a CICS
Explanation transaction dump.

INVERRTERM condition not handled. User response


This is one of a number of abends issued by the EXEC Examine the trace to find the exception trace entry
interface program. Because of their similar created by DFHEISR and then identify the parameter
characteristics these abends are described as a group. in error. If the abend is handled, EXEC CICS ASSIGN
See the description of abend AEIA for further details. ASRASTG, ASRAKEY, and ASRASPC give additional
information about the abend. At the time of the abend,
System action: register 2 points to the storage area at fault.
User response: Change one or more of the following:
Module:
DFHEIP

Chapter 1. Transaction abend codes 121


• Correct the code in error in the transaction issuing System action
the EXEC CICS command in order to supply a valid
The transaction is abnormally terminated with a CICS
storage area.
transaction dump.
• If storage protection is active, change the EXECKEY
on the CEDA definition for the program that issued User response
the EXEC CICS command from USER to CICS.
Examine the trace to find the entry trace entry created
• If storage protection is active, change the
by DFHEISR and then identify the parameter in error.
TASKDATAKEY attributes on the transaction
If the abend is handled, EXEC CICS ASSIGN ASRASTG,
definition from CICS to USER.
ASRAKEY, and ASRASPC give additional information
• If transaction isolation is active, change the ISOLATE about the abend. At the time of the abend, register 2
attribute on the transaction definition from YES to points to the storage area at fault.
NO.
You will most likely need to do the following:
Module:
DFHSRP • Correct the program in error that issued the EXEC
CICS PUT CONTAINER or EXEC CICS GET
AEYE CONTAINER command. Ensure that it supplies the
address of a valid storage area and that it supplies
Explanation an FLENGTH such that no part of the storage area is
inaccessible to the transaction. Ensure that
INVLDC condition not handled.
FLENGTH refers to a fullword length.
This is one of a number of abends issued by the EXEC
You may also need to consider changing one or more
interface program. Because of their similar
of the following:
characteristics these abends are described as a group.
• If storage protection is active, change the EXECKEY
See the description of abend AEIA for further details.
on the CEDA definition for the program that issued
System action: the EXEC CICS command from USER to CICS.
User response: • If storage protection is active, change the
TASKDATAKEY attributes on the transaction
Module: definition from CICS to USER.
DFHEIP
• If transaction isolation is active, change the ISOLATE
AEYF attribute on the transaction definition from YES to
NO.
Explanation Module:
A transaction has requested that CICS access a DFHSRP
storage area that the transaction itself could not AEYG
access. This occurred when an invalid storage area
was passed to CICS on a PUT CONTAINER, PUT 64
CONTAINER, GET CONTAINER or GET64 CONTAINER Explanation
command. The error can occur when: JIDERR condition not handled.
• Either the FROM or INTO address is specified This is one of a number of abends issued by the EXEC
incorrectly. interface program. Because of their similar
• The FLENGTH value specifies a value large enough to characteristics these abends are described as a group.
cause the area to include storage which the See the description of abend AEIA for further details.
transaction can not access.
System action:
A common cause of this error is specifying the address
of a halfword area in the FLENGTH parameter, which User response:
expects a fullword area. This error can arise when a Module:
program which previously used commareas, which DFHEIP
have halfword lengths, has been modified to use
containers which have fullword lengths. AEYH

Explanation
QIDERR condition not handled.

122 CICS TS for z/OS: CICS Codes


This is one of a number of abends issued by the EXEC AEYM
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. UNEXPIN condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

AEYJ System action:


User response:
Explanation
Module:
DSSTAT condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEYN
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. NOPASSBKRD condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

AEYK System action:


User response:
Explanation
Module:
SELNERR condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEYO
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. NOPASSBKWR condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

AEYL System action:


User response:
Explanation
Module:
FUNCERR condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEYP
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. SEGIDERR condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

Chapter 1. Transaction abend codes 123


System action: This is one of a number of abends issued by the EXEC
interface program. Because of their similar
User response:
characteristics these abends are described as a group.
Module:
See the description of abend AEIA for further details.
DFHEIP
System action:
AEYQ
User response:
Explanation Module:
SYSIDERR condition not handled. DFHEIP

This is one of a number of abends issued by the EXEC AEYV


interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. SESSIONERR condition not handled.
System action: This is one of a number of abends issued by the EXEC
interface program. Because of their similar
User response:
characteristics these abends are described as a group.
Module:
See the description of abend AEIA for further details.
DFHEIP
System action:
AEYR
User response:
Explanation Module:
ISCINVREQ condition not handled. DFHEIP

This is one of a number of abends issued by the EXEC AEYX


interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. USERIDERR condition not handled.
System action: This is one of a number of abends issued by the EXEC
interface program. Because of their similar
User response:
characteristics these abends are described as a group.
Module:
See the description of abend AEIA for further details.
DFHEIP
System action:
AEYT
User response:
Explanation Module:
ENVDEFERR condition not handled. DFHEIP

This is one of a number of abends issued by the EXEC AEYY


interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. NOTALLOC condition not handled.
System action: This is one of a number of abends issued by the EXEC
interface program. Because of their similar
User response:
characteristics these abends are described as a group.
Module:
See the description of abend AEIA for further details.
DFHEIP
System action:
AEYU
User response:
Explanation Module:
IGREQCD condition not handled. DFHEIP

124 CICS TS for z/OS: CICS Codes


AEYZ User response
Either redefine and install a new definition for the
Explanation transaction with TASKDATALOC(BELOW), or modify
CBIDERR condition not handled. the task related user exit so that it is invoked in
AMODE 31.
This is one of a number of abends issued by the EXEC
interface program. Because of their similar Module:
characteristics these abends are described as a group. DFHERM

See the description of abend AEIA for further details. AEZC

System action: Explanation


User response: A transaction has been defined with a
Module: TASKDATALOC(ANY), but a program within the
DFHEIP transaction is defined to run AMODE 24. CICS cannot
invoke the AMODE 24 program when the transaction is
AEZA running with TASKDATALOC(ANY), as this would cause
a protection exception, or a storage overwrite.
Explanation
A transaction has been defined with a System action
TASKDATALOC(ANY), but the programs within the The transaction is abnormally terminated.
transaction are running amode 24. The exec interface
program is therefore is unable to access the TCA for
the application. Furthermore, any reference to the EIB User response
would cause the transaction to fail with an OC4 Either redefine and install a new definition for the
protection exception. transaction with TASKDATALOC(BELOW), or relink the
program as AMODE 31.
System action Module:
The transaction is abnormally terminated. DFHAPLI
AEZD
User response
Either redefine and install a new definition for the Explanation
transaction with TASKDATALOC(BELOW), or relink the
An attempt has been made to run a program defined
programs as amode 31.
as EXECKEY(USER) as part of a transaction defined as
Module: TASKDATAKEY(CICS). These attributes are
DFHEIP incompatible and the transaction is abended. This
incompatibility could occur as a result of the program
AEZB definition being autoinstalled. See the Developing
system programs for CICS and the Defining resources
Explanation for more information about program autoinstall.
A transaction has been defined with a
TASKDATALOC(ANY), and the application is System action
attempting to call a task related user exit. However the The transaction is abnormally terminated. Message
task related user exit has been linkedited AMODE 24 DFHAP1226 will show the incompatible program and
and enabled with the LINKEDITMODE option, thereby transaction.
directing CICS to invoke it in AMODE 24. An AMODE 24
task related user exit cannot run when the calling
application is running with TASKDATALOC(ANY), as User response
this would cause a protection exception, or a storage Redefine and install a new definition either for the
overwrite. transaction with TASKDATAKEY(USER), or for the
program with EXECKEY(CICS).
System action If this abend occurs when running a CICS transaction,
The transaction is abnormally terminated. a possible cause is that you are not using the CICS-
supplied definition for the program. If you are using

Chapter 1. Transaction abend codes 125


your own copies of CICS-supplied program definitions, This is one of a number of abends issued by the EXEC
they must be defined as EXECKEY(CICS). interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHAPLI See the description of abend AEIA for further details.
AEZE System action:
User response:
Explanation
Module:
CHANGED condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEZI
interface program. Because of their similar
characteristics these abends are described as a group.
Explanation
See the description of abend AEIA for further details.
ACTIVITYERR condition not handled.
System action:
This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.
AEZF System action:
User response:
Explanation
Module:
PROCESSBUSY condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEZJ
interface program. Because of their similar
characteristics these abends are described as a group.
Explanation
See the description of abend AEIA for further details.
CONTAINERERR condition not handled.
System action:
This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.
AEZG System action:
User response:
Explanation
Module:
ACTIVITYBUSY condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEZK
interface program. Because of their similar
characteristics these abends are described as a group.
Explanation
See the description of abend AEIA for further details.
EVENTERR condition not handled.
System action:
This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.
AEZH System action:
User response:
Explanation
Module:
PROCESSERR condition not handled. DFHEIP

126 CICS TS for z/OS: CICS Codes


AEZL System action:
User response:
Explanation
Module:
TOKENERR condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEZP
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. SYMBOLERR condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.
AEZM System action:
User response:
Explanation
Module:
NOTFINISHED condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEZQ
interface program. Because of their similar
characteristics these abends are described as a group.
Explanation
See the description of abend AEIA for further details.
TEMPLATERR condition not handled.
System action:
This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.
AEZN System action:
User response:
Explanation
Module:
POOLERR condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEZR
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. NOTSUPERUSER condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.
AEZO System action:
User response:
Explanation
Module:
TIMERERR condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEZS
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. CSDERR condition not handled.

Chapter 1. Transaction abend codes 127


This is one of a number of abends issued by the EXEC AEZW
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. CCSIDERR condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

AEZT System action:


User response:
Explanation
Module:
DUPRES condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEZX
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. TIMEDOUT condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

AEZU System action:


User response:
Explanation
Module:
RESUNAVAIL condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEZY
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. CODEPAGEERR condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

AEZV System action:


User response:
Explanation
Module:
CHANNELERR condition not handled. DFHEIP
This is one of a number of abends issued by the EXEC AEZZ
interface program. Because of their similar
characteristics these abends are described as a group. Explanation
See the description of abend AEIA for further details. INCOMPLETE condition not handled.
System action: This is one of a number of abends issued by the EXEC
User response: interface program. Because of their similar
characteristics these abends are described as a group.
Module:
DFHEIP See the description of abend AEIA for further details.

128 CICS TS for z/OS: CICS Codes


System action: Module:
DFHEIP
User response:
AEZ2
Module:
DFHEIP
Explanation
AEZ1
BUSY condition not handled.
Explanation This is one of a number of abends issued by the EXEC
interface program. Because of their similar
APPNOTFOUND condition not handled.
characteristics these abends are described as a group.
This is one of a number of abends issued by the EXEC
See the description of abend AEIA for further details.
interface program. Because of their similar
characteristics these abends are described as a group. System action:
See the description of abend AEIA for further details. User response:
System action: Module:
DFHEIP
User response:

AFxx abend codes


AFC0 User response
The system programmer should examine the trace, the
Explanation system dump and any related CICS messages to
An attempt has been made to update a file after file identify the cause of the error.
control restart failed. Module:
DFHFCU
System action AFC7
The transaction is abnormally terminated with a
transaction dump. Explanation
The CICS definition file (CSD) manager (DFHDMPCA)
User response issued a request to DFHFCFS to enable, open or close
Determine the cause of the failure in file control the DFHCSD file. A "disastrous error" response was
restart. Restart CICS. returned from DFHFCFS to DFHDMPCA.
Module:
DFHEIFC, DFHDMPCA System action

AFC2 The task is abnormally terminated with a CICS


transaction dump.
Explanation At the time the disastrous error is detected, CICS
writes a message to the console, records an exception
DFHFCU issued a call to DFHFCFS to open a file. A trace entry and takes a system dump.
disastrous error was returned from DFHFCFS.
CICS processing continues.
System action
User response
The task is abnormally terminated with a CICS
transaction dump. The system programmer should examine the trace, the
system dump and any related CICS messages to
At the time the disastrous error is detected, CICS identify the cause of the error.
writes a message to the console, records an exception
trace entry and takes a system dump. Module:
DFHDMPCA
CICS processing continues.
AFCB

Chapter 1. Transaction abend codes 129


Explanation AFCF
Module DFHEIFC issued a resource level security
check (RSLC) request to module DFHXSRC and Explanation
received a response other than OK or EXCEPTION. A deadlock has been detected between two or more
tasks issuing file control requests.
System action
The transaction is abnormally terminated with a System action
transaction dump. The task that would have entered deadlock is abended
with a CICS transaction dump.
User response
Examine the trace to find the exception trace entry User response
created by DFHXSRC at the time of the error. Use this Examine this transaction and other transactions in the
trace entry to determine the cause of the return code system that update the same files to find the cause of
from DFHXSRC. the deadlock, then correct the error.
Module: When transactions update several files within the
DFHEIFC same unit of work, all transactions should update
AFCC these files in the same order. A transaction that
abends AFCF may be retried by specifying
RESTART(YES) in the transaction definition and by
Explanation
coding a suitable DFHREST program.
An internal logic error was detected when calling the
Module:
file control request processing module DFHFCFR.
DFHEIFC, DFHDMPCA
Either DFHFCFR returned an INVALID response to its
caller indicating an error in the caller's parameter list, AFCG
or DFHFCFR passed back a return code that was not
recognized by its caller. Explanation
A transaction has issued a sequence of file control
System action
requests that would cause the file to deadlock itself.
The transaction is abnormally terminated with a This response arises for different reasons depending
transaction dump. upon the file type.
If the file is being accessed in non-RLS mode, the
User response response is caused by the transaction making
If you need further assistance from IBM to resolve this conflicting requests against the same CI. For example,
problem, see IBM problem support for guidance on if the file is being accessed using LSR, a self deadlock
how to proceed. will arise when an attempt is made to read a record
that is in the same CI as a record that is the subject of
Module: a READ UPDATE or WRITE MASSINSERT request
DFHEIFC, DFHDMPCA issued by the same transaction.
AFCE If the file is accessed in RLS mode there is no CI
locking, but self deadlock responses can still arise.
Explanation They are caused by sequences of requests that are
either logically meaningless or which cannot be
A GETMAIN for FFLE storage has failed.
performed by VSAM RLS.

System action With VSAM RLS the most likely causes of this abend
are as follows:
The transaction is abnormally terminated with a
transaction dump. • Two successive READ UPDATE requests against the
same record by the same transaction without an
intervening REWRITE, DELETE or UNLOCK
User response
command.
Retry the failed transaction.
This is an incorrect use of file control requests.
Module:
DFHEIFC

130 CICS TS for z/OS: CICS Codes


• A transaction has created a record by WRITE migration aid when you are converting to RLS from
MASSINSERT and then, without terminating the local VSAM with CILOCK=NO specified in CICS. For
WRITE MASSINSERT sequence by issuing an more information, see VSAM RLS.
UNLOCK request, the same transaction has
Module:
attempted to modify the same record by issuing a
DFHEIFC, DFHDMPCA
READ UPDATE or DELETE request.
AFCH
This sequence of requests fails if VSAM has not
written the record out to disk. The only way to
guarantee that the record has been written to disk is Explanation
to issue the UNLOCK request. The transaction has issued a request for a remote
• A transaction has updated or deleted a record using shared data table for which it has an active browse,
a browse for update sequence and then, without but in the meantime the table has been disabled or
terminating the browse for update sequence by closed by the owning CICS system, or the owning CICS
issuing an ENDBR request, the same transaction has system has failed.
attempted to modify the same record by issuing a
separate READ UPDATE or DELETE or WRITE System action
request.
The requesting transaction abends with a transaction
This sequence of requests fails if VSAM has not dump.
written the record out to disk. The only way to
guarantee that the record has been written to disk is CICS continues normally.
to issue the ENDBR request.
User response
If the file is used to access a coupling facility data
table, then self deadlock responses are caused by In the application owning region, take whatever action
sequences of requests that are either logically normally follows the issue of a FORCE request in, or
meaningless or which cannot be performed by the failure of, the file owning CICS system.
coupling facility data tables support. See the Introduction to shared data tables for further
For coupling facility data tables, the most likely cause guidance.
of this abend is as follows:
Module:
• Two successive READ UPDATE requests have been DFHEIFC
issued against the same record by the same
AFCI
transaction without an intervening REWRITE,
DELETE or UNLOCK command.
Explanation
This is an incorrect use of file control requests.
The transaction issued a file request resulting in a call
to the main file control program (DFHFCFR). During the
System action
processing of the request the transaction was purged.
The task that would have entered deadlock is abended That is, the transaction was the subject of an explicit
with a CICS transaction dump. PURGE or FORCEPURGE request, was timed out, or
was selected by CICS for termination in an attempt to
User response alleviate an SOS condition.

Examine the previous requests made by this


System action
transaction against this file to identify the cause of the
deadlock, then correct the error. In some cases A CICS transaction dump is issued with abend code
(particularly when the file is being accessed in RLS AFCI.
mode or is using a coupling facility data table) this
A "purged" response is returned from DFHFCFR to its
abend may indicate a programming error in the
caller. The transaction issuing the file control request
program that issued the file control requests.
will eventually issue an AFCY abend with a further
When the file is being accessed in RLS mode, if the transaction dump.
programming error is a READ UPDATE with RIDFLD
specified followed by a DELETE with RIDFLD specified, User response
consider using the feature toggle
com.ibm.cics.rls.delete.ridfld to allow the DELETE with In some instances, for example if the transaction was
RIDFLD command to succeed. This is intended as a explicitly purged, no further action is necessary.

Chapter 1. Transaction abend codes 131


Otherwise examine the exception trace and the Explanation
transaction dump to identify the point at which the
During the loading of a Shared Data Table by the CFTL
purge occurred.
transaction, a call to the CICS Transaction Manager
Module: has returned a response (such as DISASTER) after
DFHFCFR which normal processing could not continue.
AFCJ
System action
Explanation Message DFHFC0949 is issued. Loading of the data
table is terminated and CFTL abends.
DFHFCU issued a call to DFHFCFS to open a file. A
purged error was returned from DFHFCFS because the
task has been waiting for a resource longer than the User response
DTIMEOUT interval specified for the CSFU transaction. Refer to the description of the message for further
information and guidance.
System action
Module:
The task is abnormally terminated with a CICS DFHDTLX
transaction dump. CICS processing continues.
AFCM

User response
Explanation
Examine the dump to determine the cause of the error.
During the loading of a data table by the CFTL
A system dump can be produced by adding the
transaction, an abend was detected, or a domain call
appropriate dump table entry using the CEMT SET
returned a response (such as DISASTER) after which
TRDUMPCODE command.
normal processing could not continue.
Module:
DFHFCU System action
AFCK A message is issued (one of DFHFC0945, DFHFC0946,
or DFHFC0947). Loading of the data table is
Explanation terminated and CFTL abends.
The transaction issued a file update request (READ
UPDATE, WRITE or DELETE) against an RLS mode data User response
set for which a DFSMSdss non-BWO backup was in If this abend is produced as a result of an abend
progress. during loading, message DFHFC0945 is issued. If it is a
result of a domain call failure, depending on which
System action domain the failure was returned by, one of the
messages DFHFC0946 or DFHFC0947 is issued. Refer
The transaction is abnormally terminated with a CICS
to the description of the message for further
transaction dump. CICS processing continues.
information and guidance.

User response Module:


DFHDTLX
All new file update requests are prohibited when a
non-BWO backup is in progress for an RLS mode data AFCN
set. This restriction is automatically lifted when the
backup completes. (A non-BWO backup is any type of Explanation
backup operation other than a Backup While Open
The transaction issued a file request that caused file
backup.) When the backup has completed, retry the
control to attempt to create a journal record but the
transaction.
record was too large for the journal buffer to
Module: accommodate. This indicates that a journal referenced
DFHDMPCA, DFHEIFC in the file definition is using an MVS logstream, which
in turn, is using a coupling facility structure which has
AFCL
been defined with a MAXBUFSIZE parameter less than
the recommended 64000.

132 CICS TS for z/OS: CICS Codes


System action User response
The task is abnormally terminated with a CICS Retry the transaction when the server is available
transaction dump. again
If the SMSVSAM server fails, it should normally
User response automatically restart itself as quickly as possible. If
Redefine the coupling facility structure that the this does not happen, consult the VSAM
logstream is using with a MAXBUFSIZE parameter of documentation which provides further guidance on
64000. The journal in error can be the forward debugging problems in the SMSVSAM server.
recovery log or the journal used for auto-archiving. If Module:
the module that detected the error is DFHDMPCA, the DFHEIFC, DFHDMPCA
error is associated with a journal referenced in the
definition of the CSD (DFHCSD). AFCS

Module:
Explanation
DFHDMPCA, DFHEIFC
The program issued a file control request against a file
AFCO
opened in RLS mode. VSAM was unable to perform this
request because the SMSVSAM server address space
Explanation was inactive.
An attempt was made to attach a transaction However, if an offsite restart is being performed (that
specifying DFHDTLX as the program to be given is, OFFSITE=YES was specified as a system
control, but the transaction was not internally initialization override), this transaction abend is also
attached by CICS. issued even if the SMSVSAM server address space is
DFHDTLX is for use by CICS system transaction CFTL. active. This is because RLS access is not allowed
This loads a Shared Data Table. during an offsite restart for any RLS file control
requests other than those issued by transactions
which have been attached by CICS to perform RLS
System action
recovery work.
The transaction is abnormally terminated. CICS
processing continues. System action
The task is abnormally terminated with a CICS
User response
transaction dump.
Establish why an attempt was made to attach CFTL
illegally, or why a transaction definition specified User response
DFHDTLX as the program to be given control.
Retry the transaction when the server is available
Module: again.
DFHDTLX
If the SMSVSAM server fails, it should normally
AFCR automatically restart itself as quickly as possible. If
this does not happen, consult the VSAM
Explanation documentation which provides further guidance on
debugging problems in the SMSVSAM server.
The program issued a file control request against a file
opened in RLS mode. While executing this request, If an offsite restart is being performed, retry the
CICS detected that the SMSVSAM server address transaction after RLS recovery has been completed
space had failed. when RLS access by user transactions is allowed
again.
System action Module:
The task is abnormally terminated with a CICS DFHEIFC, DFHDMPCA
transaction dump. AFCT
CICS disables all further RLS accesses and initiates
error recovery. Explanation
The program has made a file control request against a
file opened in RLS mode. The SMSVSAM server has

Chapter 1. Transaction abend codes 133


been recycled since an earlier RLS request from the Explanation
same unit of work. The same unit of work cannot issue
A request made against a file opened in RLS mode was
requests against two different instances of the
unable to acquire a record lock. It waited for the lock,
SMSVSAM server. Note that this abend will occur even
but the wait time exceeded the maximum wait time
if the earlier request was not successful.
applicable to that request.

System action
System action
The task is abnormally terminated with a CICS
The task is abnormally terminated with a CICS
transaction dump.
transaction dump.

User response CICS prints message DFHFC0164 and message(s)


DFHFC0165 or DFHFC0175 which identify the
Resubmit the transaction. transaction(s) or Transactional VSAM unit(s) of
Module: recovery that were immediately in front of this
DFHEIFC, DFHDMPCA transaction in the queue for the lock. Normally these
transaction(s) or Transactional VSAM unit(s) of
AFCU recovery are the owners of the lock, although this is
not the case if a chain of requests for the record has
Explanation built up.
A program made a file control request against a file
that is being accessed in VSAM RLS mode. The User response
underlying data set is in lost locks state. File control Retry the transaction.
requests are not allowed against a data set that is in
lost locks state. If the problem recurs, see messages DFHFC0164 and
DFHFC0165 or DFHFC0175 to determine the
transaction or Transactional VSAM unit of recovery
System action
that is holding the lock. In most cases the problem lies
The task is abnormally terminated with a CICS with the lock owner rather than the transaction that
transaction dump. has failed.
Examples of reasons why CICS transactions may
User response cause a timeout:
Recovery from lost locks is normally automatic. See • The transaction that holds the lock has a design
the Administering recovery and restart for a full error. For example:
explanation of lost locks recovery. You will not be able
to issue any file control requests against this data set – A conversational transaction updates a
until all systems that owned locks at the time of the recoverable record and then issues a terminal
lock structure failure have completed their lost locks control read. It does not issue syncpoint (and
recovery. therefore does not release the lock) until the end
user has responded to the terminal control read.
See the Administering recovery and restart for It may therefore hold the lock for a considerable
guidance on how to determine which CICS systems period.
still have lost locks recovery pending, for information
– A transaction updates very many records in
on commands that allow you to find the work that
recoverable files before issuing syncpoint. You are
these systems have outstanding, and on commands
recommended to keep the number of updates
that allow you to force a system to immediately
made within a unit of work small and to issue
complete lost locks recovery. The commands that
frequent syncpoints to ensure that locks are
force immediate completion of lost locks recovery
released regularly.
should only be used as a last resort as they may cause
loss of data integrity. It is better to allow the automatic • The system in which the lock holder is running is
recovery procedures to complete normally. experiencing severe performance degradation.
Investigate the reason for the performance
Module: degradation.
DFHEIFC, DFHDMPCA
• There is a deadlock between RLS and another
AFCV resource manager. For example one transaction may
be holding an RLS lock and waiting for a lock on a
transient data queue. The transaction that times out

134 CICS TS for z/OS: CICS Codes


may hold the lock on the transient data queue and the Developing CICS Applications for guidance on how
be waiting for the RLS lock. RLS can detect to write programs that avoid deadlocks.
deadlocks only when all the locks involved in the
Module:
deadlock are RLS locks. A deadlock such as this can
DFHEIFC, DFHDMPCA
appear to RLS to be a long wait for a lock and is
reported as a time out. Examine the design of the AFCY
transactions to determine whether resource
manager deadlocks can occur. Explanation
• It may be possible for RLS deadlocks to be reported The transaction issued a file request resulting in a call
as RLS timeouts if VSAM does not perform deadlock to the main file control program (DFHFCFR). During the
detection until after the time out value for the processing of the request the transaction was purged
request occurred. For example, assume that (that is, was the subject of an explicit PURGE or
DEADLOCK_DETECTION is specified as (15,4) in FORCEPURGE request, was timed out, or was selected
SYS1.PARMLIB, member IGDSMSxx. This means by CICS for termination in an attempt to alleviate an
that VSAM does not attempt to detect cross-MVS SOS condition). A "purged" response was returned
deadlocks until 4 periods of 15 (that is, 60) seconds from DFHFCFR to its caller.
have elapsed. If DTIMOUT was not active for the
transaction and the SIT specified FTIMEOUT=30, the
RLS request times out after 30 seconds, before System action
VSAM has attempted to detect cross-MVS The task is abnormally terminated with a CICS
deadlocks. Adjust FTIMEOUT, DTIMOUT, and transaction dump.
DEADLOCK_DETECTION to avoid such effects.
Exception trace entries are made between the point at
DFHFC0175 messages identify Transactional VSAM which the purge is detected and the issuing of the
units of recovery owning an RLS lock. If a abend.
Transactional VSAM application is the lock owner it
should be investigated to determine why it is holding If a task times out while waiting for a lock on a record
the lock. Some of the above considerations will be in a coupling facility data table, CICS will issue
similar for Transactional VSAM applications. message DFHFC7130 identifying the key of the locked
record and the system and unit of work that owns the
Module: lock.
DFHEIFC, DFHDMPCA
A transaction dump with abend code AFCI is taken
AFCW when the purged response is detected by DFHFCFR.

Explanation User response


The program issued a file control request against a file In some instances, for example if the transaction was
opened in RLS mode. VSAM RLS detected that this explicitly purged, no further action is necessary.
request would cause a deadlock. This transaction is
abended in order to break the deadlock chain. If using a coupling facility data table, look for any
relevant DFHFC7130 messages.
System action Otherwise examine the exception trace and the AFCI/
AFCY transaction dumps to identify the point at which
The task is abnormally terminated with a CICS the purge occurred.
transaction dump.
Module:
CICS prints message DFHFC0166 and message(s) DFHDMPCA, DFHEIFC
DFHFC0167 or DFHFC0177 which identify the other
transactions or Transactional VSAM units of recovery AFCZ
in the deadlock chain.
Explanation
User response
The transaction issued a file request resulting in a call
Retry the transaction. to the main file control program (DFHFCFR). A
"disastrous error" response was returned from
Examine the logic of all the programs involved in the
DFHFCFR to its caller.
deadlock chain to determine whether they could be
improved to avoid possible sources of deadlock. See

Chapter 1. Transaction abend codes 135


System action System action
At the time the error is detected, CICS writes a The transaction is abnormally terminated with a CICS
message to the console, records an exception trace transaction dump. CICS processing continues but it is
entry, and takes a system dump. The trace and dump probable that VSAM RLS data set quiesce support has
identify the point of error. been lost.
Subsequently, the task is abnormally terminated with
a CICS transaction dump. User response
Restart CICS. If the problem reoccurs, a more severe
User response error is indicated. In this case, you will need
assistance from IBM. See IBM problem support for
The system programmer should use the trace and
guidance on how to proceed.
dumps to determine what the error is, and why it has
occurred. Module:
DFHFCQT
Module:
DFHDMPCA, DFHEIFC AFDC
AFDA
Explanation
Explanation CICS system transaction CFQS has failed due to a
serious error. An attempt will be made to reattach the
An attempt was made to attach a transaction
transaction. CICS messages should indicate the cause
specifying DFHFCQT as the program to be given
of the error.
control, but the transaction was not internally
attached by CICS. CFQS provides support for the initiation of VSAM RLS
data set quiesce and unquiesce operations.
DFHFCQT is for use by CICS system transactions CFQS
and CFQR. These provide support for VSAM RLS data
set quiesce and unquiesce operations, DFSMSdss System action
BWO and non-BWO backups, and certain other data CFQS is abnormally terminated with a CICS
set related operations. transaction dump. CFQS is reattached and CICS
processing continues.
System action
The transaction is abnormally terminated. CICS User response
processing continues. Check Transient Data Queue CSFL for message
DFHFC6028, indicating that the reattach of CFQS was
User response successful. If the reattach fails, VSAM RLS data set
quiesce initiation support is lost. If this support is
Establish why an attempt was made to illegally attach
required, CICS must be restarted.
CFQS or CFQR, or why a transaction definition
specified DFHFCQT as the program to be given control. If it is not possible to restore VSAM RLS quiesce
initiation support, a more severe error is indicated. In
Module:
this case, you will need assistance from IBM. See IBM
DFHFCQT
problem support for guidance on how to proceed.
AFDB
Module:
DFHFCQT
Explanation
AFDD
An attempt was made by CICS to internally attach a
transaction specifying DFHFCQT as the program to be
Explanation
given control, and the transaction id was other than
CFQS or CFQR. CICS system transaction CFQR has failed due to a
serious error. An attempt will be made to reattach the
DFHFCQT is for use by CICS system transactions CFQS
transaction. CICS messages should indicate the cause
and CFQR. These provide support for VSAM RLS data
of the error.
set quiesce and unquiesce operations, DFSMSdss
BWO and non-BWO backups, and certain other data CFQR provides support for VSAM RLS data set quiesce
set related operations. and unquiesce operations, DFSMSdss BWO and non-

136 CICS TS for z/OS: CICS Codes


BWO backups, and certain other data set related System action
operations.
The transaction is abnormally terminated. CICS
processing continues.
System action
CFQR is abnormally terminated with a CICS User response
transaction dump. CFQR is reattached and CICS
Establish why an attempt was made to illegally attach
processing continues.
CFOR, or why a transaction definition specified
DFHFCOR as the program to be given control.
User response
Module:
Check Transient Data Queue CSFL for message DFHFCOR
DFHFC6028, indicating that the reattach of CFQR was
successful. If the reattach fails, VSAM RLS data set AFDG
quiesce support is lost. If this happens, CICS must be
restarted. Explanation
If it is not possible to restore VSAM RLS quiesce CICS system transaction CFOR has failed due to a
support, a more severe error is indicated. In this case, serious error. CICS messages should indicate the
you will need assistance from IBM. See IBM problem cause of the error.
support for guidance on how to proceed.
DFHFCOR provides part of the RLS offsite recovery
Module: support.
DFHFCQT
This abend indicates that this CICS system has
AFDE completed its RLS offsite recovery, but an error
occurred either in attempting to issue message
Explanation DFHFC0575D which reports this fact, or in attempting
to process the reply to message DFHFC0575D.
An attempt was made to attach a transaction
specifying DFHFCRD as the program to be given
System action
control, but the transaction was not internally
attached by CICS. CFOR is abnormally terminated with a CICS
transaction dump. CICS processing continues.
DFHFCRD is for use by CICS system transaction CSFR.
This provides support for error recovery after a failure
of the SMSVSAM server. User response
If you are using an automated procedure to check for
System action and reply to message DFHFC0575D, then you should
shut this CICS down and restart it specifying
The transaction is abnormally terminated. CICS
OFFSITE=YES again. If you are using manual
processing continues.
procedures to check for completion of all RLS offsite
recovery and to reply to message DFHFC0575D then
User response you can "tick" this CICS off the list of systems which
Establish why an attempt was made to illegally attach have completed their recovery, but you must ensure
CSFR, or why a transaction definition specified that it is not restarted with OFFSITE=NO until all other
DFHFCRD as the program to be given control. CICS systems have completed their RLS offsite
recovery. Also note that until the system is restarted,
Module: RLS access will not be allowed by this system.
DFHFCRD
Module:
AFDF DFHFCOR
AFDH
Explanation
An attempt was made to attach a transaction Explanation
specifying DFHFCOR as the program to be given
control, but the transaction was not internally VSAM has returned a response indicating that the RLS
attached by CICS. lock structure in the coupling facility is full. VSAM RLS
is unable to create any new locks.
DFHFCOR is for use by CICS system transaction CFOR.
This provides part of the RLS offsite recovery support.

Chapter 1. Transaction abend codes 137


This abend code is usually issued from various CICS Module:
systems residing within the same sysplex. DFHFCU
AFDK
System action
The transaction which issued the VSAM RLS request is Explanation
abnormally terminated with a CICS transaction dump.
A file control update request was made against an NSR
CICS processing continues.
file whilst transaction isolation was active for the task.
Using NSR files with transaction isolation active is not
User response supported. The TRANISO SIT parm is YES and the
Allocate a larger VSAM RLS lock structure and rebuild transaction definition has ISOLATE set to YES.
the RLS structure into the new larger structure. See ,
(GC28-1779) and z/OS DFSMSdfp Storage System action
Administration, (SC26-4920) for further details on
The task is abnormally terminated with a CICS
creating RLS lock structures and rebuilding lock
transaction dump. CICS processing continues.
structures.
Module: User response
DFHEIFC, DFHDMPCA
If transaction isolation is required, consider converting
AFDI the file to use LSR pools or RLS. However, if
transaction isolation is not required, another option is
Explanation to change the transaction definition to specify
ISOLATE(NO) which will cause that individual
A call to directory domain failed when trying to locate
transaction to be run without transaction isolation.
an fct entry.
Examine the dump to determine the cause of the error.
A system dump can be produced by adding the
System action appropriate dump table entry using the CEMT SET
The task is abnormally terminated with a CICS TRDUMPCODE command.
transaction dump. CICS processing continues. Module:
DFHEIFC, DFHDMPCA
User response
AFDL
Examine the dump to determine the cause of the error.
A system dump can be produced by adding the Explanation
appropriate dump table entry using the CEMT SET
TRDUMPCODE command. A file control update request was made but the task
has already updated a file that uses a different
Module: replication log stream.
DFHFCU
AFDJ System action
The task is abnormally terminated with a CICS
Explanation transaction dump. CICS processing continues.
A call to lock manager failed when trying to locate an
fct entry. User response
Using multiple replication log streams for one
System action transaction causes data integrity issues on the mirror
The task is abnormally terminated with a CICS site. This abend affects only transactions that update
transaction dump. CICS processing continues. two different recoverable files in the same unit of
work. Review your replication setup to ensure that
data sets cannot be updated by different
User response
subscriptions. If the replication setup meets this
Examine the dump to determine the cause of the error. requirement, update the LOGSTREAMID on the data
A system dump can be produced by adding the set definition so that it uses the correct log stream. A
appropriate dump table entry using the CEMT SET system dump can be produced by adding the
TRDUMPCODE command. appropriate dump table entry using the CEMT SET
TRDUMPCODE command.

138 CICS TS for z/OS: CICS Codes


Module:
DFHEIFC
AFDN System action
The transaction is abnormally terminated. CICS
Explanation processing continues.
A program has issued a file control request with an
unrecognised request type. User response
Establish why an attempt was made to inappropriately
System action attach CFCR, or why a transaction definition specified
DFHFCRN as the program to be given control.
The transaction is abnormally terminated with a
transaction dump. Module:
DFHFCRN
User response AFDP
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Explanation
how to proceed.
Module: CICS failed to disable a file defined in a CICS bundle.
DFHEIFC
AFDO
System action
Explanation
The transaction is abnormally terminated. CICS
processing continues.
An attempt was made to attach a transaction
specifying DFHFCRN as the program to be given User response
control, but the transaction was not internally
attached by CICS. Establish why the file cannot be disabled, fix the issue,
and try to disable the bundle again.
Module:
DFHFCRN is for use by CICS system transaction CFCR. DFHFCRN
This transaction is used to disable a file defined in a
CICS bundle.

AGxx abend code


AGMA

Explanation
An attempt to initiate the good morning message transaction was made without specifying a termid for it to be
displayed.

System action
The transaction is abnormally terminated with a CICS transaction dump.

User response
Use the dump to determine how the attempt to start the transaction was made. Ensure that no EXEC CICS
STARTs are made for the good morning message transaction where no termid is specified.
Module:
DFHGMM

Chapter 1. Transaction abend codes 139


AIxx abend codes
AICA Module:
DFHTAJP, DFHICP
Explanation AICD
A task has been executing for longer than the runaway
time interval (defined by the ICVR operand on the Explanation
system initialization table macro, DFHSIT) without A incorrect response was returned from a kernel (KE)
giving up control. The runaway task condition indicates domain request.
a possible loop in the application.
System action
System action
The task is abnormally terminated with a CICS
The task is terminated with an AICA transaction dump. transaction dump.

User response User response


See the Troubleshooting and support section for If you need further assistance from IBM to resolve this
guidance on dealing with loops. problem, see IBM problem support for guidance on
Module: how to proceed.
DFHSRP Module:
AICB DFHICP
AICE
Explanation
A RETRIEVE WAIT request has been reissued in Explanation
system shutdown. An incorrect response was returned from a dispatcher
(DS) domain request (other than AICG).
System action
The task is abnormally terminated with a CICS System action
transaction dump. The task is abnormally terminated with a CICS
transaction dump.
User response
None User response
Module: If you need further assistance from IBM to resolve this
DFHICP problem, see IBM problem support for guidance on
how to proceed.
AICC
Module:
Explanation DFHICP

An incorrect response was returned from a timer (TI) AICF


domain request.
Explanation
System action An incorrect response was returned from a transaction
The task is abnormally terminated with a CICS manager (TM) domain request.
transaction dump.
System action
User response The task is abnormally terminated with a CICS
If you need further assistance from IBM to resolve this transaction dump.
problem, see IBM problem support for guidance on
how to proceed.

140 CICS TS for z/OS: CICS Codes


User response tasks in the system to avoid short-on-storage
situations. Another possibility is to increase the value
If you need further assistance from IBM to resolve this
of the DTIMOUT option for the transaction.
problem, see IBM problem support for guidance on
how to proceed. Module:
DFHICP, DFHEIIC
Module:
DFHICP AICJ
AICG
Explanation
Explanation An error (INVALID, DISASTER or unexpected
EXCEPTION response) has occurred on a call to the
A PURGED response was returned from a dispatcher
storage manager (SM) domain. The domain that
domain (DS) request, with a reason code of
detected the original error will have provided an
TASK_CANCEL. TASK_CANCEL was returned as the
exception trace, a console message and, possibly, a
transaction had been explicitly cancelled.
system dump (depending on the options specified in
the dump table).
System action
The task is abnormally terminated with a CICS System action
transaction dump.
The task is abnormally terminated with a CICS
transaction dump.
User response
Notify your system programmer to determine why the User response
task has been purged.
See the related message produced by the domain that
Module: detected the original error.
DFHICP
Module:
AICH DFHICP
AICK
Explanation
The task was purged before a request to the storage Explanation
manager (SM) domain was able to complete
Module DFHEIIC has issued a resource level security
successfully. The domain that first detected the
check (RSLC) request to module DFHXSRC and
purged condition will have provided an exception
received a response other than OK or EXCEPTION.
trace.

System action
System action
The transaction is abnormally terminated with a
The task is abnormally terminated with a CICS
transaction dump.
transaction dump.

User response
User response
Examine the trace to find the exception trace entry
Investigate why the task was purged. This is either as
created by DFHXSRC at the time of the error. Use this
a result of a purge from the master terminal operator
trace entry to determine the cause of the return code
via the CEMT transaction, or by the task being timed
from DFHXSRC.
out after waiting for longer than the DTIMOUT
(deadlock timeout) value specified for the transaction. Module:
DFHEIIC
If the master terminal operator purged the task, this
may have been in an attempt to clear the system AICL
which appeared to be deadlocked for some reason.
If the task was timed out automatically as a result of Explanation
the DTIMOUT value being exceeded, this may be due DFHEIIC detected an invalid function code in the
to insufficient main storage being available for the command level parameter list. This is caused either by
number of tasks in the system. If the amount of main a storage overwrite or a CICS internal logic error.
storage cannot be increased, reduce the number of

Chapter 1. Transaction abend codes 141


System action System action
The transaction is abnormally terminated with a CICS The transaction is abnormally terminated with a CICS
transaction dump. transaction dump.

User response User response


If this problem is reproducible, a level 1 trace of the IC Determine why the intended user of the transaction is
and EI components would aid problem determination. not correctly defined.
Look in the program storage section of the transaction
Examine messages produced for the CICS job by the
dump and compare argument 0, the exec interface
external security manager (ESM). This may require the
descriptor (EID), for the command being processed
assistance of a security administrator.
with the argument 0 produced by the translator for the
same command. Any differences mean that an It may be necessary to examine the transaction dump
overwrite of the application program may have to determine why the external security manager has
occurred. If you need further assistance from IBM to informed CICS that the user is not correctly defined.
resolve this problem, see IBM problem support for
When the user has been correctly defined, consider
guidance on how to proceed.
rerunning the transaction.
Module:
Module:
DFHEIIC
DFHICXM
AICN
AICQ

Explanation
Explanation
An incorrect response has been returned from a user
Module DFHDFST is executing at a terminal which is
domain (US) request.
not permitted.

System action
System action
The task is abnormally terminated with a CICS
The transaction is abnormally terminated with a
transaction dump.
transaction dump.

User response
User response
If you need further assistance from IBM to resolve this
Determine why this transaction is executing at a
problem, see IBM problem support for guidance on
terminal.
how to proceed.
Module:
Module:
DFHDFST
DFHICP
AICR
AICO

Explanation
Explanation
A DFHTC write request has failed for IRC. The return
An unexpected EXCEPTION response was received
codes within TCATPAPR and TCTEIRET should be
from a call to the user (US) domain.
examined to determine the cause of failure.
The call was issued during initialization of a
transaction that was started without a terminal. The System action
call was made as part of processing to associate the
transaction with its intended user. The attempt to The CSNC transaction is abnormally terminated with a
associate the intended user with the transaction has CICS transaction dump.
failed.
User response
The userid for the intended user of the transaction
may not be correctly defined. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed.
Module:

142 CICS TS for z/OS: CICS Codes


DFHCRR User response
AICS Determine why the intended user of the transaction is
not correctly defined.
Explanation Examine messages produced for the CICS job by the
Module DFHDFST has encountered an error during external security manager (ESM). This may require the
Retrieve processing. assistance of a security administrator.
It may be necessary to examine the transaction dump
System action to determine why the external security manager has
informed CICS that the user is not correctly defined.
The transaction is abnormally terminated with a
transaction dump. When the user has been correctly defined, consider
rerunning the transaction.
User response Module:
Use level 1 trace entries to determine the cause of the DFHIEXM
failure. AIEB
Module:
DFHDFST Explanation
AICT The transaction id (CIEP) of the ECI for TCP/IP listener
task has been initiated invalidly, probably by entering
Explanation the id at a terminal. This transaction must only be
initiated by CICS internal processes.
Module DFHDFST has encountered an error during
START processing.
System action

System action The transaction is abnormally terminated.

The transaction is abnormally terminated with a


User response
transaction dump.
Do not initiate CIEP directly.
User response Module:
Use level 1 trace entries to determine the cause of the DFHIEP
error. AINA
Module:
DFHDFST Explanation
AIEA An application program has issued an EXEC CICS LINK
command to the indoubt testing tool program
Explanation DFHINDT but has failed to pass a commarea
containing the request to be executed. Valid requests
An unexpected EXCEPTION response was received are: ON, OFF, RESYNC COMMIT or RESYNC BACKOUT.
from a call to the user (US) domain.
The call was issued during initialization of a System action
transaction that was started without a terminal. The
The task is abnormally terminated with a CICS
call was made as part of processing to associate the
transaction dump.
transaction with its intended user. The attempt to
associate the intended user with the transaction has
failed. User response

The userid for the intended user of the transaction Correct the application program so that it passes a
may not be correctly defined. commarea to DFHINDT containing a valid request for
DFHINDT.
System action Module:
DFHINDT
The transaction is abnormally terminated with a CICS
transaction dump. AINB

Chapter 1. Transaction abend codes 143


Explanation System action
An application program has issued an EXEC CICS LINK The task is abnormally terminated with a CICS
command to the indoubt testing tool program transaction dump.
DFHINDT passing a commarea that did not contain a
valid request to be executed, Valid requests are: ON, User response
OFF, RESYNC COMMIT or RESYNC BACKOUT
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
System action
how to proceed.
The task is abnormally terminated with a CICS
Module:
transaction dump.
DFHINDT, DFHINDAP

User response AINE

Correct the application program so that it passes a


Explanation
commarea to DFHINDT containing a valid request for
DFHINDT. An error (EXCEPTION, DISASTER, INVALID,
KERNERROR or PURGED) has occurred on an
Module:
START_LINK_BROWSE command issued by the
DFHINDT
indoubt tool to recovery manager (RM) domain. For
AINC errors other than EXCEPTION, the RM domain provides
an exception trace, a console message, and possibly a
Explanation system dump (depending on the options in the dump
table).
The indoubt testing tool issued a EXEC CICS INQUIRE
EXITPROGRAM command to inquire on the status of For all errors, DFHINDT provides an exception trace,
the indoubt testing tool task related user exit program console message DFHAP0002, and possibly a system
DFHINTRU, and the command failed with a NOTAUTH dump (depending on the options in the dump table).
response.
System action
System action The task is abnormally terminated with a CICS
The task is abnormally terminated with a CICS transaction dump.
transaction dump.
User response
User response If you need further assistance from IBM to resolve this
The indoubt testing tool can be run under transaction problem, see IBM problem support for guidance on
CIND , under a user transaction where the program how to proceed.
EXEC CICS LINKs to DFHINDT. or under a transaction Module:
where the program EXEC CICS LINKs to DFHINDAP. If DFHINDT
command security checking is active for the
transaction (CMDSEC=YES), check that the user has AINF
read access to resource EXITPROGRAM. If resource
security checking is active for the transaction Explanation
(RESSEC=YES), check that the user has read access to
An EXCEPTION response with an unexpected reason
resource DFHINTRU.
occurred on an GET_NEXT_LINK call issued by the
Module: indoubt testing tool to recovery manager (RM) domain.
DFHINDT, DFHINDAP DFHINDT provides an exception trace, console
message DFHAP0002, and possibly a system dump
AIND
(depending on the options in the dump table).

Explanation
System action
The indoubt testing tool issued a EXEC CICS INQUIRE
The task is abnormally terminated with a CICS
EXITPROGRAM command to inquire on the status of
transaction dump.
the indoubt testing tool task related user exit program
DFHINTRU, and the command failed with an
unexpected response.

144 CICS TS for z/OS: CICS Codes


User response User response
If you need further assistance from IBM to resolve this If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on problem, see IBM problem support for guidance on
how to proceed. how to proceed.
Module: Module:
DFHINDT DFHINDT
AING AINI

Explanation Explanation
An error (DISASTER, INVALID, KERNERROR, or An error (EXCEPTION, DISASTER, INVALID,
PURGED) has occurred on an GET_NEXT_LINK call KERNERROR or PURGED) has occurred on an
issued by the indoubt testing tool to recovery manager INQUIRE_UOW command issued by the indoubt
(RM) domain. The RM domain provides an exception testing tool to recovery manager (RM) domain. For
trace, a console message, and possibly a system dump errors other than EXCEPTION, the RM domain provides
(depending on the options in the dump table). an exception trace, a console message, and possibly a
system dump (depending on the options in the dump
DFHINDT also provides an exception trace, console
table).
message DFHAP0002, and possibly a system dump
(depending on the options in the dump table). For all errors, DFHINDT provides an exception trace,
console message DFHAP0002, and possibly a system
System action dump (depending on the options in the dump table).

The task is abnormally terminated with a CICS


System action
transaction dump.
The task is abnormally terminated with a CICS
User response transaction dump.

If you need further assistance from IBM to resolve this


User response
problem, see IBM problem support for guidance on
how to proceed. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
Module:
how to proceed.
DFHINDT
Module:
AINH
DFHINDT

Explanation AINJ

An error (EXCEPTION, DISASTER, INVALID,


Explanation
KERNERROR or PURGED) has occurred on an
END_LINK_BROWSE command issued by the indoubt An EXCEPTION response with an unexpected reason
tool to recovery manager (RM) domain. For errors occurred on an INITIATE_RECOVERY call issued by
other than EXCEPTION, the RM domain provides an the indoubt testing tool to recovery manager (RM)
exception trace, a console message, and possibly a domain. DFHINDT provides an exception trace,
system dump (depending on the options in the dump console message DFHAP0002, and possibly a system
table). dump (depending on the options in the dump table).
For all errors, DFHINDT provides an exception trace,
console message DFHAP0002, and possibly a system System action
dump (depending on the options in the dump table). The task is abnormally terminated with a CICS
transaction dump.
System action
The task is abnormally terminated with a CICS User response
transaction dump. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed.
Module:

Chapter 1. Transaction abend codes 145


DFHINDT AINM
AINK
Explanation
Explanation An error (EXCEPTION, DISASTER, INVALID,
KERNERROR or PURGED) has occurred on an
An error (DISASTER, INVALID, KERNERROR, or
TERMINATE_RECOVERY command issued by the
PURGED) has occurred on an INITIATE_RECOVERY
indoubt testing tool to recovery manager (RM) domain.
call issued by the indoubt testing tool to recovery
For errors other than EXCEPTION, the RM domain
manager (RM) domain. The RM domain provides an
provides an exception trace, a console message, and
exception trace, a console message, and possibly a
possibly a system dump (depending on the options in
system dump (depending on the options in the dump
the dump table).
table).
For all errors, DFHINDT provides an exception trace,
DFHINDT also provides an exception trace, console
console message DFHAP0002, and possibly a system
message DFHAP0002, and possibly a system dump
dump (depending on the options in the dump table).
(depending on the options in the dump table).

System action
System action
The task is abnormally terminated with a CICS
The task is abnormally terminated with a CICS
transaction dump.
transaction dump.

User response
User response
If you need further assistance from IBM to resolve this
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
problem, see IBM problem support for guidance on
how to proceed.
how to proceed.
Module:
Module:
DFHINDT
DFHINDT
AINN
AINL

Explanation
Explanation
An error (EXCEPTION, DISASTER, INVALID,
An error (EXCEPTION, DISASTER, INVALID,
KERNERROR or PURGED) has occurred on an
KERNERROR or PURGED) has occurred on an
ADD_LINK command issued by the indoubt testing
SET_RECOVERY_STATUS command issued by the
tool to recovery manager (RM) domain. For errors
indoubt testing tool to recovery manager (RM) domain.
other than EXCEPTION, the RM domain provides an
For errors other than EXCEPTION, the RM domain
exception trace, a console message, and possibly a
provides an exception trace, a console message, and
system dump (depending on the options in the dump
possibly a system dump (depending on the options in
table).
the dump table).
For all errors, DFHINTRU provides an exception trace,
For all errors, DFHINDT provides an exception trace,
console message DFHAP0002, and possibly a system
console message DFHAP0002, and possibly a system
dump (depending on the options in the dump table).
dump (depending on the options in the dump table).

System action
System action
The task is abnormally terminated with a CICS
The task is abnormally terminated with a CICS
transaction dump.
transaction dump.

User response
User response
If you need further assistance from IBM to resolve this
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
problem, see IBM problem support for guidance on
how to proceed.
how to proceed.
Module:
Module:
DFHINTRU
DFHINDT

146 CICS TS for z/OS: CICS Codes


AINO Explanation
The indoubt testing tool task related user exit
Explanation DFHINTRU issued an EXEC CICS INQUIRE TASK
The indoubt testing tool task related user exit command to inquire on the current task to obtain the
DFHINTRU issued an EXEC CICS INQUIRE unit of work ID to include in message DFHIN1009. The
TRANSACTION command to inquire whether the command failed with a TASKIDERR response.
current transaction was in the indoubt transaction
class DFHTCIND. The command failed with a System action
NOTAUTH response. The task is abnormally terminated with a CICS
transaction dump.
System action
The task is abnormally terminated with a CICS User response
transaction dump. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
User response how to proceed.
When the indoubt testing tool is active, the task Module:
related user exit DFHINTRU is invoked whenever a DFHINTRU
CICS transaction is started. For all transactions for
which command security checking is active, ensure AINR
that the user has read access to resource
TRANSACTION. If started transaction resource Explanation
security checking is specified, for all transactions for
The indoubt testing tool task related user exit
which resource security checking is active, ensure that
DFHINTRU issued an EXEC CICS INQUIRE TASK
the user has read access to the transaction name in
command to inquire on the current task to obtain the
the specified RACF resource class.
unit of work ID to include in message DFHIN1009. The
For more information on command security and command failed with a NOTAUTH response.
resource security see the CICS Securing.
Module: System action
DFHINTRU The task is abnormally terminated with a CICS
AINP transaction dump.

Explanation User response

The indoubt testing tool task related user exit When the indoubt testing tool is active, the task
DFHINTRU issued an EXEC CICS INQUIRE related user exit DFHINTRU is invoked whenever a
TRANSACTION command to inquire whether the CICS transaction is started. For all transactions for
current transaction was in the indoubt transaction which command security checking is active
class DFHTCIND. The command failed with an (CMDSEC=YES), ensure that the user has read access
unexpected response. to resource TASK.
Module:
System action DFHINTRU
The task is abnormally terminated with a CICS AINS
transaction dump.
Explanation
User response
The indoubt testing tool task related user exit
If you need further assistance from IBM to resolve this DFHINTRU issued an EXEC CICS INQUIRE TASK
problem, see IBM problem support for guidance on command to inquire on the current task to obtain the
how to proceed. unit of work ID to include in message DFHIN1009. The
command failed with an unexpected response.
Module:
DFHINTRU
AINQ

Chapter 1. Transaction abend codes 147


System action User response
The task is abnormally terminated with a CICS If you need further assistance from IBM to resolve this
transaction dump. problem, see IBM problem support for guidance on
how to proceed.
User response Module:
If you need further assistance from IBM to resolve this DFHINDT, DFHINDAP
problem, see IBM problem support for guidance on AIPA
how to proceed.
Module: Explanation
DFHINTRU
IP interconnectivity program DFHISCOP has been
AINT initiated invalidly, probably by entering a transaction id
that refers to it, for example CISC or CISS, at a
Explanation terminal. This program must only be initiated by CICS
internal processes.
The indoubt testing tool issued a EXEC CICS ENABLE
command to enable the indoubt testing tool task
System action
related user exit program DFHINTRU, and the
command failed with a NOTAUTH response. The task is abnormally terminated.

System action User response


The task is abnormally terminated with a CICS Do not initiate CISC or CISS directly.
transaction dump.
Module:
DFHISCOP
User response
AIPB
The indoubt testing tool can be run under transaction
CIND , under a user transaction where the program
Explanation
EXEC CICS LINKs to DFHINDT. or under a transaction
where the program EXEC CICS LINKs to DFHINDAP. If IP interconnectivity receiver program DFHISRRP has
command security checking is active for the been initiated invalidly, probably by entering a
transaction (CMDSEC=YES), check that the user has transaction id that refers to it, for example CISR, at a
update access to resource EXITPROGRAM. If resource terminal. This program must only be initiated by CICS
security checking is active for the transaction internal processes.
(RESSEC=YES), check that the user has update access
to resource DFHINTRU. System action
Module: The task is abnormally terminated.
DFHINDT, DFHINDAP
AINU User response
Do not initiate CISR directly.
Explanation
Module:
The indoubt testing tool issued a EXEC CICS ENABLE DFHISRRP
command to enable the indoubt testing tool task
related user exit program DFHINTRU, and the AIPC
command failed with an unexpected response.
Explanation
System action IP interconnectivity error and message program
The task is abnormally terminated with a CICS DFHISEMP has been initiated invalidly, probably by
transaction dump. entering a transaction id that refers to it, for example
CISE, at a terminal. This program must only be
initiated by CICS internal processes.

148 CICS TS for z/OS: CICS Codes


System action User response
The task is abnormally terminated. See the related message from the domain that
detected the original error and examine the dump and
User response any exception trace entries for further information if
necessary.
Do not initiate CISE directly.
Module:
Module: DFHISCOP
DFHISEMP
AIPF
AIPD
Explanation
Explanation
IP interconnectivity program DFHISCOP received an
IP interconnectivity program DFHISCOP has been PURGED response from a call to the intersystems
initiated with invalid attach parameters by CICS communication (IS) domain to acquire or release an
internal processes. This could be the result of a IPCONN.
configuration error or a storage overwrite.
The domain that detected the original error provides
DFHISCOP should be defined as the initial program for an exception trace, a console message and, possibly, a
the IS domain connectivity transactions; these are system dump.
CISC and the transactions for TCPIPSERVICEs with
protocol IPIC, CISS by default. This error could occur if
System action
DFHISCOP is defined as the initial program for some
other CICS internal transaction. The task is abnormally terminated with a transaction
dump.
System action
User response
The task is abnormally terminated with a CICS
transaction dump. Investigate why the task was purged. This is either as
a result of a purge from the master terminal operator
User response via the CEMT transaction, or by the task being timed
out after waiting for longer than the DTIMOUT
Check that DFHISCOP is correctly defined. (deadlock timeout) value specified for the transaction.
If necessary, examine the dump and any exception If the master terminal operator purged the task, this
trace entries to determine why the attach parameters may have been in an attempt to clear the system
are missing or invalid. which appeared to be deadlocked for some reason.
Module: If the task was timed out automatically as a result of
DFHISCOP the DTIMOUT value being exceeded, this may be due
AIPE to insufficient main storage being available for the
number of tasks in the system. If the amount of main
storage cannot be increased, reduce the number of
Explanation
tasks in the system to avoid short-on-storage
IP interconnectivity program DFHISCOP received an situations. Another possibility is to increase the value
INVALID, DISASTER, or EXCEPTION response from a of the DTIMOUT option for the transaction.
call to the intersystems communication (IS) domain to
Module:
acquire or release an IPCONN, or from another domain
DFHISCOP
during IS domain initialization processing.
AIPG
The domain that detected the original error provides
an exception trace, a console message and, possibly, a
system dump. Explanation
IP interconnectivity long-running request/response
System action receiver program received an INVALID, DISASTER, or
EXCEPTION response from its PROCESS_INPUT call to
The task is abnormally terminated with a transaction
the intersystems communication (IS) domain.
dump.

Chapter 1. Transaction abend codes 149


The domain that detected the original error provides User response
an exception trace, a console message and, possibly, a
Do not initiate CISU or CISX directly.
system dump.
Module:
System action DFHISREU, DFHISREX

The task is abnormally terminated with a transaction AIPJ


dump.
Explanation
User response The IS attach client module DFHISXM received an
See the related message from the domain that INVALID, DISASTER, or unexpected EXCEPTION
detected the original error and examine the dump and response from its INITIALIZE_RECEIVER call to
any exception trace entries for further information if module DFHISIS.
necessary. The call was issued during initialization of a
Module: transaction that was started by a transaction attach
DFHISRRP message received on an IP connection. The call was
made as part of processing to associate the
AIPH transaction with its intended user. The attempt to
associate the intended user with the transaction has
Explanation failed.
IP interconnectivity long-running error and message The userid for the intended user of the transaction
program received an INVALID, DISASTER, or may not be correctly defined.
EXCEPTION response from its PROCESS_ERROR call
Security attributes defined for the IPCONN may not be
to the intersystems communication (IS) domain.
consistent with the security parameters received in
The domain that detected the original error provides the transaction attach message.
an exception trace, a console message and, possibly, a
system dump. System action
The task is abnormally terminated with a transaction
System action
dump.
The task is abnormally terminated with a transaction
dump. User response
Examine the dump and any exception trace entries for
User response
further information if necessary.
See the related message from the domain that
Verify the userid for the intended user is correctly
detected the original error and examine the dump and
defined to the external security manager. :p Verify the
any exception trace entries for further information if
IPCONN security attributes are correctly defined.
necessary.
Module:
Module:
DFHISXM
DFHISEMP
AIPK
AIPI

Explanation
Explanation
The IS attach client module DFHISXM received a
IP interconnectivity program DFHISREU or DFHISREX
PURGED response from its call to another module.
has been initiated invalidly, probably by entering the
transaction ID that refers to it, CISU or CISX, at a The call was issued during initialization of a
terminal. This program must only be initiated by CICS transaction that was started by a transaction attach
internal processes. message received on an IPIC connection.
The ISSB representing the IPIC receive session
System action allocated to this transaction has been flagged for
The task is abnormally terminated. abend following an error on the IPCONN or purge
request from the initiating system.

150 CICS TS for z/OS: CICS Codes


System action AIPN
The task is abnormally terminated with a transaction
dump. Explanation
IP interconnectivity program DFHISLQP has been
User response initiated invalidly, probably by entering a transaction
ID that refers to it, CISQ, at a terminal. This program
Look for related messages reported in the error log.
must be initiated only by CICS internal processes.
Examine the dump and any exception trace entries for
further information if necessary.
System action
Module:
DFHISXM The task is abnormally terminated.

AIPL
User response

Explanation Do not initiate CISQ directly.

The IS attach client module DFHISXM received an Module:


INVALID, DISASTER, or unexpected EXCEPTION DFHISLQP
response from its call to another module. AIPO
The call was issued during initialization of a
transaction that was started by a transaction attach Explanation
message received on an IPIC connection. The attempt
IP interconnectivity program DFHISLQP has been
to initialize the transaction has failed.
initiated with invalid attach parameters by CICS
The input message received may not be in the internal processes. This could be the result of a
expected format. configuration error or a storage overwrite.
DFHISLQP should be defined as the initial program for
System action the IS domain connectivity transaction CISQ. This
The task is abnormally terminated with a transaction error could occur if DFHISLQP is defined as the initial
dump. program for some other CICS internal transaction.

User response System action

Examine the dump and any exception trace entries for The task is abnormally terminated with a CICS
further information if necessary. transaction dump.

Module:
User response
DFHISXM
Check that DFHISLQP is correctly defined.
AIPM
If necessary, examine the dump and any exception
Explanation trace entries to determine why the attach parameters
are missing or invalid.
The transaction was connected to another transaction
in another CICS system via an IPIC link. This other Module:
transaction has abnormally terminated. DFHISLQP
AIPP
System action
The task is abnormally terminated with a CICS Explanation
transaction dump. IP interconnectivity program DFHISLQP received an
INVALID, DISASTER, or EXCEPTION response from a
User response call to the intersystems communication (IS) domain to
Correct the cause of the abend in the connected process requests that are locally queued for an
transaction. IPCONN.

Module: The domain that detected the original error provides


DFHISIS an exception trace, a console message and, possibly, a
system dump.

Chapter 1. Transaction abend codes 151


System action because a transaction id that refers to DFHISRSP, for
example CISM, has been entered at a terminal.
The task is abnormally terminated with a transaction
DFHISRSP must be started by CICS internal processes
dump.
only.

User response
System action
See the related message from the domain that
The task is abnormally ended.
detected the original error and examine the dump and
any exception trace entries for further information if
necessary. User response

Module: Do not start CISM directly.


DFHISLQP Module:
AIPR DFHISRSP
AIPT
Explanation
IP interconnectivity program DFHISLQP received an Explanation
PURGED response from a call to the intersystems IP interconnectivity remote scheduler program
communication (IS) domain to acquire or release an DFHISRSP received an INVALID, DISASTER, or
IPCONN. EXCEPTION response from its PROCESS_SCHEDULER
The domain that detected the original error provides call to the intersystems communication (IS) domain.
an exception trace, a console message and, possibly, a The domain that detected the original error provides
system dump. an exception trace, a console message and, possibly, a
system dump.
System action
The task is abnormally terminated with a transaction System action
dump. The task is abnormally ended with a transaction dump.

User response User response


Investigate why the task was purged. This is either as See the related message from the domain that
a result of a purge from the master terminal operator detected the original error and examine the dump and
via the CEMT transaction, or by the task being timed any exception trace entries for further information if
out after waiting for longer than the DTIMOUT necessary.
(deadlock timeout) value specified for the transaction.
Module:
If the master terminal operator purged the task, this DFHISRSP
may have been in an attempt to clear the system
which appeared to be deadlocked for some reason. AIPU

If the task was timed out automatically as a result of


Explanation
the DTIMOUT value being exceeded, this may be due
to insufficient main storage being available for the For CICS 4.1 and later, IPCONN names that are longer
number of tasks in the system. If the amount of main than four characters are not supported in transaction
storage cannot be increased, reduce the number of routing between CICS regions.
tasks in the system to avoid short-on-storage
situations. Another possibility is to increase the value System action
of the DTIMOUT option for the transaction.
The task is abnormally ended with a transaction dump.
Module:
DFHISLQP
User response
AIPS
Correct the IPCONN names so that they are not longer
than four characters if used in transaction routing
Explanation between CICS regions.
IP interconnectivity remote scheduler program Module:
DFHISRSP has been started invalidly, probably DFHISXM

152 CICS TS for z/OS: CICS Codes


AIS1 Explanation
An attempt to issue a STCK (Store Clock) instruction
Explanation failed.
An unexpected return code has been returned after a
DFHMROQM FUNC=ENQ command was issued. System action
This command was issued when enqueueing work for CSNC is abnormally terminated with a system dump.
the IRC control task (CSNC) during IRC initialization. All tasks using MRO links to other systems are
abnormally terminated.
System action
All tasks in other CICS regions (including shared
If IRC is being initialized during CICS initialization (as a database batch regions) that are currently
result of IRCSTRT being specified in the DFHSIT or communicating with this system are also abended.
override parameters), then CICS is abnormally
terminated. User response
If IRC is being initialized during the execution of a Repair or enable the system clock.
CEMT SET IRC OPEN command, then the CEMT
transaction is abnormally terminated. Module:
DFHCRNP
User response AIS4
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Explanation
how to proceed. An unexpected return code has been returned after a
Module: DFHMROQM FUNC=ENQUEUE command. This
DFHCRSP command was issued when enqueueing work to the
IRC 'delayed work' queue.
AIS2

System action
Explanation
CSNC is abnormally terminated with a system dump.
An unexpected return code has been returned after a All tasks using MRO links to other systems are
DFHMROQM FUNC=WAIT_Q command was issued. abnormally terminated.
This command was issued when waiting for more IRC All tasks in other CICS regions (including shared
work to process. database batch regions) that are currently
communicating with this system are also abended.
System action
CSNC is abnormally terminated with a system dump. User response
All tasks using MRO links to other systems are If you need further assistance from IBM to resolve this
abnormally terminated. problem, see IBM problem support for guidance on
All tasks in other CICS regions (including shared how to proceed.
database batch regions) that are currently Module:
communicating with this system are also abended. DFHCRNP

User response AIS5

If you need further assistance from IBM to resolve this


Explanation
problem, see IBM problem support for guidance on
how to proceed. An unexpected return code has been returned after a
DFHMROQM FUNC=ENQUEUE command was issued.
Module:
DFHCRNP This command was issued when enqueueing work to
the IRC 'immediate work' queue.
AIS3

Chapter 1. Transaction abend codes 153


System action User response
CSNC is abnormally terminated with a system dump. Investigate the reason why the task was purged. It
All tasks using MRO links to other systems are was purged either by the master terminal operator , or
abnormally terminated. as a result of a deadlock timeout.
All tasks in other CICS regions (including shared Module:
database batch regions) that are currently DFHMIRS
communicating with this system are also abended.
AIS8

User response
Explanation
If you need further assistance from IBM to resolve this
An internal logic error has been detected in module
problem, see IBM problem support for guidance on
DFHMIRS.
how to proceed.
Module: System action
DFHCRNP
The transaction is abnormally terminated with a CICS
AIS6 transaction dump.

Explanation User response


An INVALID, DISASTER or EXCEPTION condition has If you need further assistance from IBM to resolve this
occurred on a call to the storage manager domain (SM) problem, see IBM problem support for guidance on
to GETMAIN or FREEMAIN a file control read set how to proceed.
buffer.
Module:
The domain that detected the original error provides DFHMIRS
an exception trace, a console message and, possibly, a
system dump. AIS9

System action Explanation

The task is abnormally terminated with a transaction The mirror program has detected that a DPL server
dump. program has returned in an invalid state following the
completion of the LINK command. The server program
or a program it linked to has initiated a synclevel 2
User response
conversation with another program which in turn has
See the related message from the domain that issued a syncpoint. The server program has not
detected the original error. responded to the syncpoint request which is still
outstanding when control returns to the mirror
Module:
program.
DFHMIRS
The mirror program only issues this abend code if the
AIS7
LINK request did not specify SYNCONRETURN.

Explanation
System action
A PURGED condition has occurred on a call to the
The task is abnormally terminated with a transaction
storage manager domain (SM) to FREEMAIN a file
dump.
control read set buffer.
The domain that detected the original error provides User response
an exception trace, a console message and, possibly, a
system dump. Correct the design of the DTP application or
applications initiated by the server program. If the
SYNCONRETURN option is not specified on the LINK
System action
request, only the client program should initiate the
The task is abnormally terminated with a transaction syncpoint. If it is necessary to issue syncpoint
dump. requests from the DTP applications, consider using the
SYNCONRETURN option on the LINK request. See the

154 CICS TS for z/OS: CICS Codes


CICS intercommunication for further details of the User response
LINK command and its options.
Use the trace in the dump and the dumped TCTTE to
Module: analyze the problem further.
DFHMIRS
Module:
AISA DFHMIRS
AISD
Explanation
The mirror transaction (CSMI) has been attached from Explanation
some facility other than a terminal. This is not
The mirror program executed the request and received
permitted.
a nonzero return code as a result. The data flow
control state of the intersystem link being used was
System action such that this information could not be returned
The task is abnormally terminated with a CICS normally.
transaction dump.
System action
User response The mirror task is abnormally terminated with a CICS
Using the dump, check the field TCAFCAAA to identify transaction dump.
the invalid attach.
User response
Module:
DFHMIRS The transaction dump provided will provide
information required to analyze the source of the
AISB
nonzero return code at its point of origin.

Explanation Module:
DFHMIRS
The mirror transaction (CSMI) has detected errors in
the data passed to it from the attaching transaction. AISF

System action Explanation

The task is abnormally terminated with a CICS The CICS mirror program DFHMIRS has been attached
transaction dump. in an unsupported manner. The principal facility for the
mirror transaction is defined as APPC, however the
conversation is unmapped.
User response
The invalid input will be visible in the transaction System action
dump. This error is likely to be caused by some
mismatch between the two systems. A typical CICS abnormally terminates the transaction with a
example might be a DL/I request received on a system transaction dump.
generated without DL/I.
User response
Module:
DFHMIRS There is a problem with the system that caused the
mirror transaction to be attached. If you need further
AISC
assistance from IBM to resolve this problem, see IBM
problem support for guidance on how to proceed.
Explanation
Module:
The mirror transaction (CSMI) has not received a TIOA DFHMIRS
from the terminal.
AISG
System action
Explanation
The task is abnormally terminated with a CICS
transaction dump. The mirror program executed the request and
produced the reply. This would not be sent because

Chapter 1. Transaction abend codes 155


the data flow control state of the intersystem link was Explanation
such that this could not be done.
The IRC control task CSNC has abended because the
attempt to LINK to DFHCRR failed.
System action
The task (CSMI) is abnormally terminated with a CICS System action
transaction dump.
CSNC is abnormally terminated with a system dump.
All tasks using MRO links to other systems are
User response abnormally terminated. All tasks in other CICS regions
Use the transaction dump provided to analyze the (including shared database batch regions) that are
problem. currently communicating with this system are also
abnormally terminated.
Module:
DFHMIRS
User response
AISH
Ensure that program DFHCRR is available.

Explanation Module:
DFHCRNP
The new connection task, CSNC, has been invoked in
an incorrect manner (for example, from a terminal or AISK
via an EXEC CICS START request).
Explanation
System action The user transaction has been abnormally terminated
The task is abnormally terminated with a CICS during the execution of a function shipping request on
transaction dump. an APPC session. This has happened because the
mirror transaction on the remote system has
abnormally terminated, and caused a request for
User response
syncpoint rollback to be sent across the session. CICS
None. abends the user transaction in these circumstances so
that function shipping remains transparent to the
Module:
transaction.
DFHCRNP
AISI System action
The task is abnormally terminated with a CICS
Explanation
transaction dump.
A function shipping request was passed by DFHEIP to
DFHISP. This was found to be invalid by the User response
transformer, DFHXFP.
Check the log on the mirror system to determine the
reason for the original abend of the mirror task.
System action
Module:
The transaction issuing the function shipping request
DFHISP
is abnormally terminated with a CICS transaction
dump. AISL

User response Explanation


The transaction dump will provide information to The LU services manager transaction has been started
further analyze the problem. directly from a user terminal. This is not permitted.
Module:
DFHISP System action

AISJ The task is abnormally terminated with a transaction


dump.

156 CICS TS for z/OS: CICS Codes


User response System action
None. The LU services manager transaction must be The transaction is abnormally terminated with a CICS
started internally by CICS. transaction dump.
Module:
DFHLUP, DFHCLS3, DFHCLS4, DFHZLS1 User response

AISN Do not attempt to invoke the mirror transaction by


entering the transaction identifier at a terminal.
Explanation Module:
DFHMIRS
Task CSNC attempted to acquire a SUSPEND TOKEN to
enable it to suspend itself until further work arrives. AISQ
The attempt failed.
Explanation
System action
An EXEC CICS command has been issued against a
CSNC is abnormally terminated with a dump. The IRC CPI Communications session. A CPI Communications
facility is disabled. session is one that has a CPI-Communications Control
Block (CPC) associated with it.
User response
System action
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on The mirror task is abnormally terminated with a CICS
how to proceed. transaction dump.
Module:
DFHCRNP User response

AISO Do not mix EXEC commands with CPI Communications


calls on the same end of a conversation.
Explanation Module:
DFHMIRS
Task CSNC attempted to suspend itself, awaiting
further work. The attempt failed. AISR

System action Explanation


CSNC is abnormally terminated with a dump. The IRC The CICS Inter-Region Session Recovery Program
facility is disabled. (DFHCRR) has been invoked in an incorrect manner,
for example, from a terminal.
User response
System action
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on The program DFHCRR is abnormally terminated with a
how to proceed. CICS transaction dump.
Module:
DFHCRNP User response

AISP None.
Module:
Explanation DFHCRR
A mirror transaction (transaction identifiers CSHR, AISS
CSM1, CSM2, CSM3, CSM5, or CSMI) has been invoked
with an invalid principal facility. The mirror transaction Explanation
executes with an MRO session, an LU6.1 session or an
APPC session as its principal facility. A security violation has occurred while CICS was
attempting to start a conversation with a remote APPC
system. The security access level of the requestor was
insufficient to access the transaction on the connected

Chapter 1. Transaction abend codes 157


APPC system. Depending on the nature of the request System action
and the way security has been set up, the requestor
The task is abnormally terminated with a transaction
with an insufficient access level can be the local CICS
dump.
system, the requesting transaction, or the terminal
user.
User response
Note:
See the related message from the domain that
DTP programs do not abend with code AISS after a detected the original error.
security failure in the remote region.
Module:
DFHMIRS
System action
AISV
The transaction is abnormally terminated with a
transaction dump.
Explanation
User response A PURGED condition has occurred on a call to the
storage manager domain (SM) to FREEMAIN a FCENT
First, verify that the access was correctly denied.
control block.
Then, if required, change the access level.
The domain that detected the original error provides
Module:
an exception trace, a console message and, possibly, a
DFHZARM
system dump.
AIST
System action
Explanation
The task is abnormally terminated with a transaction
An unexpected return code has been returned after a dump.
DFHTC TYPE=LOCATE command.
User response
System action
Investigate why the task was purged. This is either as
CSNC is abnormally terminated with a system dump. a result of a purge from the master terminal operator
All tasks using MRO links to other systems are via the CEMT transaction, or by the task being timed
abnormally terminated. All tasks in other CICS regions out after waiting for longer than the DTIMOUT
(including shared database batch regions) that are (deadlock timeout) value specified for the transaction.
currently communicating with this system are also
If the master terminal operator purged the task, this
abended.
may have been in an attempt to clear the system
which appeared to be deadlocked for some reason.
User response
If the task was timed out automatically as a result of
The trace in the system dump should be used to the DTIMOUT value being exceeded, this may be due
analyze the problem further. to insufficient main storage being available for the
Module: number of tasks in the system. If the amount of main
DFHCRNP storage cannot be increased, reduce the number of
tasks in the system to avoid short-on-storage
AISU situations. Another possibility is to increase the value
of the DTIMOUT option for the transaction.
Explanation
Module:
An INVALID, DISASTER, or EXCEPTION condition has DFHMIRS
occurred on a call to the storage manager domain (SM)
AISW
to FREEMAIN a FCENT control block.
The domain that detected the original error provides Explanation
an exception trace, a console message and, possibly, a
system dump. An INVALID, DISASTER, or EXCEPTION condition has
occurred on a call to the storage manager domain (SM)
to GETMAIN or FREEMAIN a CRB control block.

158 CICS TS for z/OS: CICS Codes


The domain that detected the original error provides Explanation
an exception trace, a console message and, possibly, a
The LU services manager transaction has been started,
system dump.
but invalid parameters have been detected.

System action
System action
The task is abnormally terminated with a transaction
The task is abnormally terminated with a transaction
dump.
dump.

User response
User response
See the related message from the domain that
See message DFHZC4921 for further guidance.
detected the original error.
Module:
Module:
DFHLUP
DFHCRSP
AISZ
AISX

Explanation
Explanation
DFHMXP has received an unexpected reply when
A PURGED condition has occurred on a call to the
committing START PROTECT NOCHECK requests sent
storage manager domain (SM) to GETMAIN or
on a LUTYPE6.2 synclevel 1 conversation.
FREEMAIN a CRB control block.
The domain that detected the original error provides System action
an exception trace, a console message and, possibly, a
system dump. The task is abnormally terminated.

System action User response

The task is abnormally terminated with a transaction Determine what happened to transaction CVMI in the
dump. partner system. If the START PROTECT NOCHECK
requests had been committed, no further action is
necessary. If they had not been committed, user-
User response
defined action is required to recover from the error.
Investigate why the task was purged. It was purged
Module:
either as a result of a purge from the master terminal
DFHMXP
operator via the CEMT transaction, or by the task being
timed out after waiting for longer than the DTIMOUT AITA
(deadlock timeout) value specified for the transaction.
If the master terminal operator purged the task, this Explanation
may have been in an attempt to clear the system An error (INVALID, DISASTER or unexpected
which appeared to be deadlocked for some reason. EXCEPTION response) has occurred on a call to the
If the task was timed out automatically as a result of recovery manager (RM) domain to initialize the
the DTIMOUT value being exceeded, this may be due recovery status of an IRC session. The domain
to insufficient main storage being available for the provides an exit trace, and possibly a console message
number of tasks in the system. If the amount of main and a system dump (depending on the options
storage cannot be increased, reduce the number of specified in the dump table).
tasks in the system to avoid short-on-storage This failure is either the result of a task purge, or a
situations. Another possibility is to increase the value CICS logic error,
of the DTIMOUT option for the transaction.
Module: System action
DFHCRSP
The CSNC task is abnormally terminated with a CICS
AISY transaction dump.

Chapter 1. Transaction abend codes 159


User response User response
See the related diagnostic material produced by the See the related diagnostic material produced by the
recovery manager domain and determine the reason recovery manager domain and determine the reason
for the failure. In the case of a CICS logic error, you for the failure. In the case of a CICS logic error, you
need further assistance from IBM. See IBM problem need further assistance from IBM. See IBM problem
support for guidance on how to proceed. support for guidance on how to proceed.
Module: Module:
DFHCRNP DFHMIRS
AITB AITD

Explanation Explanation
An error (INVALID, DISASTER or unexpected The mirror program has received an unexpected
EXCEPTION response) has occurred on a call to the response from the RX domain.
recovery manager (RM) domain. The domain provides
There are several reasons why this error may occur:
an exit trace, and possibly a console message and a
system dump (depending on the options specified in • A request received from an EXCI client is
the dump table). inconsistent with an earlier request in the same Unit
of Work
This failure is either the result of a task purge, or a
CICS logic error, • CICS has received an unexpected response from the
Recoverable Resource Management Services
component of MVS.
System action
• There has been an internal error in the RX domain.
The task is abnormally terminated with a CICS
transaction dump.
System action
User response The mirror task is abnormally terminated with a CICS
transaction dump.
See the related diagnostic material produced by the
recovery manager domain and determine the reason
for the failure. In the case of a CICS logic error, you User response
need further assistance from IBM. See IBM problem Use the exception trace provided by the RX domain to
support for guidance on how to proceed. determine the reason for the failure. If the error is
Module: caused by an inconsistent request from an EXCI client,
DFHISP DFHMXP there may be an error in the client program.

AITC In the other cases, you might need further assistance


from IBM. See IBM problem support for guidance on
how to proceed.
Explanation
Module:
An error (INVALID, DISASTER or unexpected DFHMIRS
EXCEPTION response) has occurred on a call to the
recovery manager (RM) domain. The domain provides AITE
an exit trace, and possibly a console message and a
system dump (depending on the options specified in Explanation
the dump table).
A transaction has executed a transactional EXCI
This failure is either the result of a task purge, or a request from a batch region, and has been waiting for
CICS logic error, one of the following events for longer than the interval
specified in the RTIMOUT or DTIMOUT value for the
System action transaction.
The mirror task is abnormally terminated with a CICS • A further transactional EXCI request from the batch
transaction dump. region
• A syncpoint initiated by Resource Recovery
Management Services (RRMS).

160 CICS TS for z/OS: CICS Codes


System action DFHMIRS
The mirror task is abnormally terminated with a CICS AITG
transaction dump.
Explanation
User response
A transaction has executed a transactional EXCI
Determine why the expected event has not occurred: request from a batch region, and both of the following
events has occurred:
If a further transactional EXCI request is expected:
• A further transactional EXCI request from the batch
• The batch program may be suspended
region
If a syncpoint is expected: • A syncpoint initiated by Resource Recovery
• The batch program may be suspended before Management Services (RRMS).
reaching syncpoint Normally, only one event should occur, and not both.
• RRMS may have started syncpoint processing but is
waiting for another Resource Manager to respond to System action
the syncpoint request.
The mirror task is abnormally terminated with a CICS
See IBM problem support for guidance on how to transaction dump.
proceed.
Module: User response
DFHMIRS
Determine why both events have occurred. This
AITF situation may arise when an EXCI client times out on a
DPL request that CICS is not ready to receive and then
Explanation proceeds to take a syncpoint. If this is not the case,
you may need assistance from IBM. See IBM problem
A transaction has executed a transactional EXCI support for guidance on how to proceed.
request from a batch region, and has been purged
while waiting for one of the following events: Module:
DFHMIRS
• A further transactional EXCI request from the batch
region AITH
• A syncpoint initiated by Resource Recovery
Management Services (RRMS). Explanation
A mirror transaction processing an ECI request from a
System action TCP/IP connected client has failed while trying to
receive data from, or send data to, a client. This could
The mirror task is abnormally terminated with a CICS be a read time out, or a more serious error in the flows
transaction dump. that prevented CICS from correctly processing the
data.
User response
Determine why the expected event has not occurred: System action
If a further transactional EXCI request is expected: The mirror task is abnormally terminated with a CICS
transaction dump.
• The batch program may be suspended
If a syncpoint is expected: User response
• The batch program may be suspended before If the error was a time out, determine why the client
reaching syncpoint has not continued with the extended ECI conversation.
• RRMS may have started syncpoint processing but is Other errors will have associated IE domain messages
waiting for another Resource Manager to respond to to aid in problem determination.
the syncpoint request. Module:
See IBM problem support for guidance on how to DFHMIRS
proceed. AITI
Module:

Chapter 1. Transaction abend codes 161


Explanation Explanation
A mirror transaction processing a START CHANNEL or The ISCINVREQ condition has been raised. This can
LINK CHANNEL request has failed while trying to happen when the resource proves to be on yet another
receive data from, or send data to, a connected CICS remote system, that is, when daisy-chaining is active.
system. Because a channel may include a
considerable amount of data, it may require many calls System action
to terminal control to transmit channel data. DFHMIRS
calls program DFHAPCR to perform all the inter- The task is abnormally terminated with a CICS
system transmission of channel data. Terminal control transaction dump.
has detected an error in one of these calls. The error
could be a read time out, or a more serious error in the User response
flows that prevented CICS from correctly processing
Check that daisy-chaining of requests is intended and
the data.
that all relevant intersystem links are in service.

System action Module:


DFHMIRS
The mirror task is abnormally terminated with a CICS
transaction dump. AITL

User response Explanation

If the error was a time out, determine why the other The IPIC client sent a CCSID that was not recognized.
end has not continued with the conversation. Other
errors will have associated terminal control messages System action
to aid in problem determination. Examine trace entries
The task is abnormally terminated with a CICS
from DFHAPCR to determine terminal control error
transaction dump.
and sense information.
Module: User response
AITJ Check that the client system is using one of the client
code pages supported by CICS TS.
Explanation
Module:
A mirror transaction processing a request from a client DFHMIRS
connected using IP interconnectivity has failed while
AITM
trying to receive data from, or send data to, a client.
This could be a read time out, or a more serious error
in the flows that prevented CICS from correctly Explanation
processing the data. A command has been received by the mirror program
to call itself.
System action
The mirror task is abnormally terminated with a CICS System action
transaction dump. The task is abnormally terminated with a CICS
transaction dump.
User response
If the error was a time out, determine why the client User response
has not continued with the conversation. Other errors Correct the API command in the client system
will have associated IS domain messages to aid in program so that it does not request an EXEC CICS
problem determination. LINK PROGRAM to be executed that specifies the
Module: name of the mirror program.
DFHMIRS Module:
AITK DFHMIRS
AITN

162 CICS TS for z/OS: CICS Codes


Explanation User response
An attempt to change the TCB DFHMIRS was running Do not initiate CISP or CIS1 directly.
on has failed.
Module:
DFHISPHP
System action
AITP
The transaction is terminated.
Explanation
User response
The application context handling module, DFHMNAC,
Contact your IBM support center. has returned an unexpected response from function
Module: MIRROR_ACD.
DFHMIRS
System action
AITO
The transaction is terminated.
Explanation
User response
IP interconnectivity program DFHISPHP and
DFHISPRP has been initiated invalidly, probably by Contact your IBM support center.
entering a transaction ID that refers to it, CISP or
Module:
CIS1, at a terminal. This program must be initiated
DFHMIRS
only by CICS internal processes.

System action
The task is abnormally terminated.

AJxx abend codes


AJ01 Explanation
A CICS AbendError has been caught by the Java
Explanation environment setup class, Wrapper.
The main method of the Java environment setup class, The callUserClass method of Wrapper detects this,
Wrapper, has been invoked without an argument. sets return code ABEND_RECEIVED and invokes
Wrapper main expects the class name of the user's native method SetAbend to abend the task.
main to be passed as the first argument.
The callUserClass method of Wrapper detects this, System action
sets return code INVALID_ARGUMENTS and invokes The task is abnormally terminated with a CICS
native method SetAbend to abend the task. transaction dump.

System action User response


The task is abnormally terminated with a CICS See related messages and JVM error output in stderr
transaction dump. to determine the reason for the original abend.

User response Module:


DFJCICS
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on AJ03
how to proceed.
Explanation
Module:
DFJCICS A CicsConditionException has been caught by the Java
environment setup class, Wrapper.
AJ02

Chapter 1. Transaction abend codes 163


The callUserClass method of Wrapper detects this, System action
sets return code CONDITION_RECEIVED and invokes
The task is abnormally terminated with a CICS
native method SetAbendForCondition to abend the
transaction dump.
task. The appropriate default abend code for the
condition should be issued but, if for some reason this
is not possible, an AJ03 abend may be issued. User response
See related messages and JVM error output in stderr
System action to determine the reason for the original exception.
The task is abnormally terminated with a CICS Module:
transaction dump. DFJCICS
AJ07
User response
See related messages and JVM error output in stderr Explanation
to determine the reason for the original
The Java environment setup class, Wrapper, has been
CicsConditionException.
unable to invoke the user's main method. The class
Module: whose name was passed as an input parameter to its
DFJCICS CallUserClass method was not found.
AJ04
System action
Explanation The task is abnormally terminated with a CICS
transaction dump.
An unexpected error has been caught by the Java
environment setup class, Wrapper, attempting to
invoke the user class or an unhandled exception has User response
been thrown in the Java environment. Check that CICS has been granted read permission to
In the first case, the callUserClass method of Wrapper the target class and the entire zFS directory structure
detects this, sets return code in which the class or Jar file is located.
UNEXPECTED_EXCEPTION and invokes native method Module:
SetAbend to abend the task. In the second case, the DFJCICS
JNI code invokes the SetAbend method to abend the
task and AJ04 is set as the default abend code. AJ09

System action Explanation

The task is abnormally terminated with a CICS The Java environment setup class, Wrapper, has been
transaction dump. unable to invoke the user's main method. A public
static method, taking either a CommAreaHolder or a
String array as input, was not found in the class whose
User response
name was passed as an input parameter to the
See related messages and JVM error output in stderr CallUserClass method of Wrapper.
to determine the reason for the original exception.
Module: System action
DFJCICS The task is abnormally terminated with a CICS
AJ05 transaction dump.

Explanation User response

An unhandled exception has been caught by the Java Check that you have provided a main method, with an
environment setup class, Wrapper, as an appropriate method signature, in the specified class.
InvocationTargetException from the user class. Also check that the target class explicitly uses the
'public' class modifier and that it is stored in a jar file
The callUserClass method of Wrapper detects this, on the JVM's classpath. CICS must have read
sets return code INVOCATION_TARGET_EXCEPTION permission for the jar file.
and invokes native method setAbend to abend the
task. Module:

164 CICS TS for z/OS: CICS Codes


DFJCICS System action
AJ10 The task is abnormally terminated with a CICS
transaction dump.
Explanation
User response
The Java environment setup class, Wrapper, has
detected that the user's class has used JDBC or SQLJ. If you need further assistance from IBM to resolve this
It however has been unable to load the DB2 JDBC problem, see IBM problem support for guidance on
classes necessary to call back the JDBC/SQL driver for how to proceed.
cleanup processing following completion of the user
Module:
class.
DFJCICS

System action AJ13

The task is abnormally terminated with a CICS


Explanation
transaction dump.
An exception occurred and CICS was unable to
User response instantiate an instance of the user's class.

If you need further assistance from IBM to resolve this


System action
problem, see IBM problem support for guidance on
how to proceed. The task is abnormally terminated with a CICS
transaction dump.
Module:
DFJCICS
User response
AJ11
See related messages and JVM error output in stderr
to determine the reason for the exception. Check that
Explanation
the class has a no argument constructor as CICS
The Java environment setup class, Wrapper, has requires this in order to instantiate the class.
detected that the user's class has used JDBC or SQLJ.
Module:
It however has been unable to find the DB2 JDBC
DFJCICS
static method to call back the JDBC/SQL driver for
cleanup processing following completion of the user AJ99
class.
Explanation
System action
The Java environment setup class, Wrapper, has
The task is abnormally terminated with a CICS detected an AbendException and issued setAbend.
transaction dump. The abend code extracted from the AbendException is
too long.
User response
System action
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Task abnormal termination continues with the abend
how to proceed. code set to AJ99
Module:
DFJCICS User response

AJ12 Correct the abend code String used to create the


AbendException.
Explanation Module:
DFJCICS
The Java environment setup class, Wrapper, has
detected that the user's class has used JDBC or SQLJ. AJA0
It however has been unable to invoke the DB2 JDBC
static method to call back the JDBC/SQL driver for
cleanup processing following completion of the user
class.

Chapter 1. Transaction abend codes 165


Explanation timed out after waiting for longer than the DTIMOUT
(deadlock timeout) value specified for the transaction.
The native method SetAbendForCondition has been
passed an invalid Resp value by the Wrapper class. If the master terminal operator purged the task, this
may have been in an attempt to clear the system
System action which appeared to be deadlocked for some reason.

The task is abnormally terminated with a CICS If the task was timed out automatically as a result of
transaction dump. the DTIMOUT value being exceeded, this may be due
to insufficient main storage being available for the
number of tasks in the system. If the amount of main
User response
storage cannot be increased, reduce the number of
If you need further assistance from IBM to resolve this tasks in the system to avoid short-on-storage
problem, see IBM problem support for guidance on situations. Another possibility is to increase the value
how to proceed. of the DTIMOUT option for the transaction.
Module: Module:
DFJCICS DFHJCP
AJCD AJCS

Explanation Explanation
An error (INVALID, DISASTER, or unexpected An error (INVALID, DISASTER, or unexpected
EXCEPTION response) has occurred on a call to the EXCEPTION response) has occurred on a call to the log
storage manager (SM) domain. The domain that manager (LM) domain. The domain that detected the
detected the original error provides an exception original error provides an exception trace, a console
trace, a console message, and possibly a system dump message, and possibly a system dump (depending on
(depending on the options in the dump table). the options in the dump table).

System action System action


The task is abnormally terminated with a CICS The task is abnormally terminated with a CICS
transaction dump. transaction dump.

User response User response


See the related message from the domain that See the related message from the domain that
detected the original error. detected the original error.
Module: Module:
DFHJCP DFHJCP
AJCE AJCT

Explanation Explanation
The task was purged before a GETMAIN request to the An error (INVALID, DISASTER, or unexpected
storage manager (SM) domain was able to complete EXCEPTION response) has occurred on a call to the
successfully. The domain that first detected the recovery manager (RM) domain. The domain that
purged condition provides an exception trace. detected the original error provides an exception
trace, a console message, and possibly a system dump
System action (depending on the options in the dump table).

The task is abnormally terminated with a CICS


System action
transaction dump.
The task is abnormally terminated with a CICS
User response transaction dump.

Investigate why the task was purged. It was purged


either as a result of a purge from the master terminal
operator via the CEMT transaction, or by the task being

166 CICS TS for z/OS: CICS Codes


User response If the task was timed out automatically as a result of
the DTIMOUT value being exceeded, this may be due
See the related message from the domain that
to insufficient main storage being available for the
detected the original error.
number of tasks in the system. If the amount of main
Module: storage cannot be increased, reduce the number of
DFHJCP tasks in the system to avoid short-on-storage
situations. Another possibility is to increase the value
AJCU
of the DTIMOUT option for the transaction.

Explanation Module:
DFHJCP
A purge response has been received from either the
log manager or or the recovery manager. The domain AJST
that detected the original purge condition provides an
exception trace. Explanation
Program DFHJSON was called using EXEC CICS LINK,
System action but no channel was provided.
The task is abnormally terminated with a CICS
transaction dump. System action
CICS terminates the task with a transaction dump.
User response
Investigate why the task was purged. It was purged User response
either as a result of a purge from the master terminal
Change the application program to pass a channel.
operator via the CEMT transaction, or by the task being
timed out after waiting for longer than the DTIMOUT Module:
(deadlock timeout) value specified for the transaction. DFHJSON
If the master terminal operator purged the task, this
may have been in an attempt to clear the system
which appeared to be deadlocked for some reason.

AKxx abend codes


AKC0 System action
There is a probable user error. The transaction is
Explanation abnormally terminated.
An attempt has been made to run the CICS internal
task CSSY as a user transaction. User response
Correct the program that issued the request.
System action
Module:
CICS terminates the task with a transaction dump. DFHXCP
AKC2
User response
Investigate why the attempt was made to run CSSY as Explanation
a user transaction.
A bad response has been received from a dispatcher
Module: (DS) domain call.
DFHAPATT
AKC1 System action
The transaction is abnormally terminated with a
Explanation transaction dump and a trace entry.
A DFHKC WAIT request was issued when the ECB was
already marked as waiting.

Chapter 1. Transaction abend codes 167


User response User response
Examine the trace entry for further information. Examine the dump and any exception trace entries for
further information.
Module:
DFHXCP Module:
DFHXCP
AKC3
AKC9
Explanation
Explanation
The task has been purged, probably due to operator
action such as a CEMT TASK PURGE command. The An incorrect response has been received from a call to
task might also have been purged as a result of CICS the enqueue (NQ) domain during the processing of a
issuing a purge request. DFHKC TYPE=ENQ or a DFHKC TYPE=DEQ request.

System action System action


The transaction is abnormally terminated with a The transaction is abnormally terminated with a
transaction dump. transaction dump.

User response User response


Use the transaction dump to determine why the task Examine the dump and any exception trace entries for
was purged. In particular, if the purge was operator further information. Since the DFHKC service is only
initiated, the dump should be useful in determining used for internal enqueues, this abend indicates an
why this task needed to be explicitly purged. error in CICS. If you need further assistance from IBM
to resolve this problem, see IBM problem support for
Module:
guidance on how to proceed.
DFHXCP, DFHXMAT, DFHXMCL, DFHXMIQ, DFHXMTA
Module:
AKC6
DFHXCP

Explanation AKCB

DFHKC RESUME should always be preceded by DFHKC


Explanation
SUSPEND. If this protocol is violated then the
transaction is abnormally terminated with abend code The CICS transaction manager restart task could not
AKC6. complete because a necessary step failed. The task
has done some essential recovery operations and
System action abnormally terminated itself with code AKCB.

Transaction is abnormally terminated with abend code


System action
AKC6.
CICS writes a transaction dump for the transaction
User response manager restart task.

Examine the trace entry for further information. CICS sends three messages to the console, one to
identify the error detected by the transaction manager
Module: restart task, one to say that the task has failed, and
DFHXCP one that gives you the option of cancelling CICS or
AKC8 letting it continue. Depending on the nature of the
original error, you may see messages from some other
system component (for example, an access method).
Explanation
A bad response has been received from a call to the User response
kernel (KE) domain during the processing of a task
purge request. Use the messages and dumps to find out the cause of
the failure.
System action Module:
DFHKCRP
The transaction is abended with a transaction dump.

168 CICS TS for z/OS: CICS Codes


AKCC User response
Use the dumps to find out why the write to the log
Explanation failed.
The CICS transaction manager has abended the Module:
transaction because the purge threshold of its DFHKCQ
TRANCLASS has been reached. This is specified by the
PURGETHRESH parameter on CEDA DEFINE AKCF
TRANCLASS. See the Defining resources manual for
more details of this parameter. Explanation
While CICS transaction manager was recording
System action changes to a profile definition, a write to the catalog
The transaction is abended and messages failed.
DFHAC2004 and DFHAC2036 are issued. The
transaction dump is suppressed for this abend code. System action
CICS terminates the transaction with a transaction
User response dump.
Resubmit the transaction. The cause of the abend may
be a temporary stress condition in the system. User response
If the problem persists, determine why the Use the dumps to find out why the write to the catalog
TRANCLASS purge threshold has been reached. failed.
Ensure that PURGETHRESH has been specified Module:
correctly. Also, ensure that the MAXACTIVE value of DFHKCQ
the TRANCLASS has not been set too low.
Transactions attached after the MAXACTIVE limit has AKCR
been reached are immediately queued subject to the
PURGETHRESH limit. Explanation
If PURGETHRESH and MAXACTIVE are set correctly, Transaction manager has received an invalid request
look for a more general problem which has caused a code. The last AP F000 trace entry before the program
decrease in the capacity of the system to execute control program (PCP) ABEND TRACE entry (TRACE ID
transactions in the TRANCLASS. The decrease might, 'F2', request code X'6000') will contain the invalid
for example, be caused by a connected CICS region transaction manager request code in the fifth byte of
which processes requests for transactions in the the first section of the trace.
TRANCLASS, if this connected region has slowed
down.
System action
Examine all resources (files, links, storage, and so on)
The transaction is abnormally terminated with a CICS
used by the transactions in the TRANCLASS which is
transaction dump.
reaching the purge threshold and determine why the
capacity of the system is reduced.
User response
Module:
DFHXMAT, DFHXMCL Determine the cause of the invalid request code and
correct the problem.
AKCE
Module:
DFHXCP
Explanation
AKCS
While CICS transaction manager was recording
changes to a transaction or profile definition, a write to
the system log failed. Explanation
A deadlock timeout condition has been detected. This
System action condition may occur within a transaction that specifies
DTIMOUT to be nonzero on its installed transaction
CICS terminates the transaction with a transaction definition. Deadlock timeout occurs when a
dump. transaction has been waiting or has been suspended
for longer than the time specified in DTIMOUT.

Chapter 1. Transaction abend codes 169


The abend may be driven by a variety of internal CICS System action
events, for example:
The transaction is abnormally terminated. A
• A short on storage condition transaction dump is not provided.
• A temporary storage shortage
User response
• ENQUEUE
• An ALLOCATE request This abend is a normal one. Coding RTIMOUT in the
PROFILE entry asks for the task to be abnormally
• A RETRIEVE WAIT request. terminated if the terminal does not send input within
The abend can also occur if CICS stops running for a the specified time.
time, for example while an sdump is taken. This is Module:
because deadlock timeout is based on total elapsed DFHXCP
time, and not just the time CICS is executing.
AKCV
Analysis: The transaction receiving the AKCS abend
must have been suspended or must be waiting for a
reason such as a short on storage, enqueued on a lock, Explanation
a short on temporary storage, a suspend after A bad return code was passed as a result of the
RETRIEVE WAIT, a suspend after ALLOCATE, or an resume of a task suspended by ICP.
implicit ALLOCATE within function shipping or terminal
sharing support. If none of these apply, the trace System action
might reveal some event that has caused CICS to stop
running for a time. The transaction is terminated with a dump.

System action User response


The transaction is abnormally terminated. A dump is Check the response from the resume in the trace to
not provided unless the dump table entry for determine the cause of the error.
transaction dump code AKCS indicates that one should Module:
be taken. DFHALP

User response AKEA

The transaction should be reexecuted, and the


Explanation
situation causing the SUSPEND to occur may clear
itself. A program check has been detected by the kernel (KE)
domain.
The AKCS abend is to be expected occasionally, unless
DTIMOUT is set to zero. No special action is necessary.
System action
Module:
DFHXCP If an application is in control, the ASRA abend is
presented to the application. Otherwise, the functional
AKCT recovery routine of the CICS module in control at the
time is given control. This recovery routine produces
Explanation suitable diagnostics and may terminate CICS.
A terminal read-time-out condition has been detected.
The transaction has been waiting for a terminal input User response
message for an interval longer than specified in the Look at the kernel domain section of the system dump
RTIMOUT value for that transaction. to determine where the program check has occurred.
If an EXEC CICS HANDLE ABEND has been issued for Module:
this task, the read that was timed-out is still DFHKESTX
outstanding. To cancel this read you should issue an
EXEC CICS ABEND at the end of the user exit routine AKEB
so that CICS can clean up the terminal's TCTTE.
Explanation
An operating system abend has been detected by the
kernel (KE) domain.

170 CICS TS for z/OS: CICS Codes


System action AKEF
If an application is in control, the ASRB abend is
presented to the application. Otherwise, the functional Explanation
recovery routine of the CICS module in control at the The kernel (KE) domain has detected an error while
time is given control. This recovery routine produces processing a domain call. The error may have been
suitable diagnostics and may terminate CICS. caused by a domain gate that was not yet active during
initialization
User response
Check the console for any MVS messages that may System action
have caused this abend. If an application is in control, the transaction
Look at the kernel domain section of the system dump terminates with a system dump. Otherwise, the
to determine where the abend has occurred. functional recovery routine of the CICS module in
control at the time is given control. This recovery
Module: routine produces suitable diagnostics and may
DFHKESTX terminate CICS.
AKEC
User response
Explanation See any related messages from the kernel domain.
The kernel (KE) domain has detected runaway. Look at the kernel domain section of the system dump
to determine where the error has occurred. Check that
System action a call has not been made to a domain gate that has not
yet been made active. Check that the caller has not
If an application is in control, the AICA abend is
specified KERNERROR(YES).
presented to the application. Otherwise, the functional
recovery routine of the CICS module in control at the If the abend occurs during CICS system initialization,
time is given control. This recovery routine produces ensure that the utility (DFHCCUTL) used to initialize
suitable diagnostics and may terminate CICS. the local catalog (DFHLCD) is at the correct level. A
sample job is provided in SDFHINST(DFHDEFDS).
User response Module:
Look at the kernel domain section of the system dump DFHKERKE
to determine where the runaway has occurred. AKEG
Module:
DFHKESTX, DFHKERRU Explanation
AKED The kernel (KE) domain issued an SM GETMAIN for
kernel stack storage, but the GETMAIN request failed.
Explanation
System action
The kernel (KE) domain has been requested to initiate
abend processing as a result of a deferred abend If an application is in control, the transaction
request. terminates with a system dump. Otherwise, the
functional recovery routine of the CICS module in
System action control at the time is given control. This recovery
routine produces suitable diagnostics and may
Abend processing starts for the task that is subject to terminate CICS.
the deferred abend request.
User response
User response
Look at the kernel domain section of the system dump
The task is not abended with AKED but by an abend to determine why sufficient storage was not available.
code specified by the requestor of the deferred abend.
See the description of this abend for further guidance. If the short-on-storage condition persists, consider
increasing the size limit of the CICS DSA. You can vary
Module: the DSA dynamically using the DSALIM parameter on
DFHKEEDA the CEMT master terminal command.

Chapter 1. Transaction abend codes 171


Module: Explanation
DFHKESGM
A backlevel XPI call has been detected by the kernel
AKEH (KE) domain.

Explanation System action


The transaction was purged while running outside the Additional error messages will be produced by CICS
control of CICS. that identify the global user exit or task related user
exit that made the backlevel XPI call. If an AP domain
System action global user exit or task related user exit issued the
backlevel XPI call the ASRJ abend is presented to the
CICS terminates the transaction abnormally. application.
The EXEC CICS HANDLE ABEND command can not
handle this abend. User response
Reassemble the exit program identified by the
User response additional error messages using the latest CICS
Investigate the reason why the transaction was libraries.
purged. Module:
Possible reasons are DFHKESTX

• An operator purged the transaction AKER


• The transaction was purged because DTIMEOUT has
been exceeded Explanation
• Another transaction purged the transaction A task has been recovered from a JVM server onto the
QR TCB following a KILL against the JVM server.
Module:
DFHKESTX
System action
AKEI
The transaction is abnormally terminated. CICS
processing continues.
Explanation
The kernel (KE) domain has detected runaway while User response
the transaction is running outside the control of CICS.
None

System action Module:


DFHAPLJP
If an application is in control, the AICA abend is
presented to the application. Otherwise, the functional AKEX
recovery routine of the CICS module which was last in
control at the time of runaway detection is given Explanation
control. This recovery routine produces suitable
A program check has been detected by the kernel (KE)
diagnostics and may terminate CICS.
domain while executing under a TCB that is not
The EXEC CICS HANDLE ABEND command can not enabled for EXEC CICS commands. This is probably
handle this abend. because of an attempt to execute a CICS command in
an environment where this is not possible.
User response
System action
See the Troubleshooting and support section for
guidance on dealing with loops. If an application is in control, the ASRA abend is
presented to the application. Otherwise, the functional
Module:
recovery routine of the CICS module in control at the
DFHKESTX
time is given control. This recovery routine produces
AKEJ suitable diagnostics and may terminate CICS.

172 CICS TS for z/OS: CICS Codes


User response Explanation
Look at the kernel domain section of the system dump A kill request has been actioned when a transaction
to determine where the program check has occurred. was not protected from forcepurge but was protected
from purge. The transaction is either in a dispatcher
Module:
suspend, the deferred abend processor is in control,
DFHKESTX
the application is calling CICS, CICS is returning to the
AKEZ application, or the application is outside of the control
of CICS.
Explanation
System action
A user attach has failed because there are insufficient
kernel tasks available. This indicates an internal logic If an application is in control, the abend is presented
error. to the application. Otherwise, the functional recovery
module of the CICS module in control at the time is
System action given control. This recovery routine produces
diagnostics and might terminate CICS. This abend
Message DFHKE0001 is issued and a system dump is code cannot be handled by the application.
taken. The attach of the user transaction fails.
User response
User response
Notify the system programmer to determine why the
If you need further assistance from IBM to resolve this task has been killed.
problem, see IBM problem support for guidance on
how to proceed. Module:
DFHDSSR, DFHKEEDA, DFHEIP, DFHKEDS
Module:
DFHKETA AKKC

AKKA
Explanation

Explanation A kill request has been actioned when a transaction


was protected from force purge. The transaction is
A kill request has been actioned when a transaction either in a dispatcher suspend, the deferred abend
was not protected from purge or force purge. The processor is in control, the application is calling CICS,
transaction is either in a dispatcher suspend, the CICS is returning to the application, or the application
deferred abend processor is in control, the application is outside of the control of CICS.
is calling CICS, CICS is returning to the application, or
the application is outside of the control of CICS.
System action

System action If an application is in control, the abend is presented


to the application. Otherwise, the functional recovery
If an application is in control, the abend is presented module of the CICS module in control at the time is
to the application. Otherwise, the functional recovery given control. This recovery routine produces
module of the CICS module in control at the time is diagnostics and might terminate CICS. This abend
given control. This recovery routine produces code cannot be handled by the application.
diagnostics and might terminate CICS. This abend
code cannot be handled by the application.
User response

User response Notify the system programmer to determine why the


task has been killed.
Notify the system programmer to determine why the
task has been killed. Module:
DFHDSSR, DFHKEEDA, DFHEIP, DFHKEDS
Module:
DFHDSSR, DFHKEEDA, DFHEIP, DFHKEDS AKKD

AKKB
Explanation
A CEKL purge has been requested. Abend processing
has started for the task that is subject to the deferred
abend request.

Chapter 1. Transaction abend codes 173


System action Module:
DFHKESTX, DFHKERRU, DFHKEKIL
The task is abended with abend code AKKD.
AKKH
User response
Explanation
Notify the system programmer to determine why the
task has been purged. The kernel (KE) domain has detected a kill request
from the runaway exit program. The task was
Module:
protected from runaway when the request was
DFHKEEDA
actioned.
AKKE
System action
Explanation
If an application is in control, the abend is presented
A CEKL force purge has been requested. Abend to the application. Otherwise, the functional recovery
processing has started for the task that is subject to module of the CICS module in control at the time is
the deferred abend request. given control. This recovery routine produces
diagnostics and might terminate CICS. This abend
System action code cannot be handled by the application.

The task is abended with abend code AKKE.


User response

User response Notify the system programmer to determine why the


task has been killed.
Notify the system programmer to determine why the
task has been purged. Module:
DFHKESTX, DFHKERRU, DFHKEKIL
Module:
DFHKEEDA AKSE

AKKG
Explanation

Explanation A user has generated an addition to the keyword table,


but code has not been added to process this keyword.
The kernel (KE) domain has detected a kill request
from the runaway exit program. The task was not
System action
protected from runaway when the kill request was
actioned. The transaction is abnormally terminated and a dump
is taken.
System action
User response
If an application is in control, the abend is presented
to the application. Otherwise, the functional recovery Add code to process the keyword.
module of the CICS module in control at the time is
Module:
given control. This recovery routine produces
DFH99KC
diagnostics and might terminate CICS. This abend
code cannot be handled by the application.

User response
Notify the system programmer to determine why the
task has been killed.

ALxx abend codes


ALGA Explanation
An error has occurred obtaining a lock within the log
manager domain.

174 CICS TS for z/OS: CICS Codes


System action Explanation
The recovery routine of the module in control is A disaster response has been detected when
invoked which issues message DFHLG0002 with a processing the building block storage interface code
system dump. DFHLG0002 reports the module in used by the log manager.
control at the time of the error.
System action
User response
The recovery routine of the module in control is
See the description of message DFHLG0002 for invoked which issues message DFHLG0002 with a
further guidance. system dump. DFHLG0002 reports the module in
control at the time of the error.
Module:
DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST
User response
ALGB
See the description of message DFHLG0002 for
further guidance.
Explanation
Module:
An error has occurred releasing a lock within the log
DFHLGCM, DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST
manager domain.
ALGE
System action
Explanation
The recovery routine of the module in control is
invoked which issues message DFHLG0002 with a An unexpected error has occurred while the log
system dump. DFHLG0002 reports the module in manager was attempting to find a journal model
control at the time of the error. definition.

User response System action


See the description of message DFHLG0002 for The recovery routine of the module in control is
further guidance. invoked which issues message DFHLG0002 with a
system dump. DFHLG0002 reports the module in
Module:
control at the time of the error.
DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST
ALGC User response
See the description of message DFHLG0002 for
Explanation
further guidance.
A disaster response has been detected when
Module:
processing the building block code used by the log
DFHLGJN
manager.
ALGF
System action
Explanation
The recovery routine of the module in control is
invoked which issues message DFHLG0002 with a An unexpected error occurred when the log manager
system dump. DFHLG0002 reports the module in was attempting an enqueue or dequeue operation.
control at the time of the error.
System action
User response
The recovery routine of the module in control is
See the description of message DFHLG0002 for invoked which issues message DFHLG0002 with a
further guidance. system dump. DFHLG0002 reports the module in
control at the time of the error.
Module:
DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST
User response
ALGD
See the description of message DFHLG0002 for
further guidance.

Chapter 1. Transaction abend codes 175


Module: User response
DFHLGGL, DFHLGJN, DFHLGST
See the related message from the Storage Manager
ALGG domain where the original error was detected.
Module:
Explanation DFHAPLI
Transaction CSQC has been issued from a terminal. ALIF
This is not permitted. The transaction can only be
started internally by CICS.
Explanation

System action CICS has issued a GETMAIN request during the


initialization phase for an application program in order
The transaction is abnormally terminated. to obtain thread storage for Language Environment.
However insufficient storage was available to satisfy
User response the request.
Do not try to invoke CSQC from a terminal.
System action
Module:
DFHLGQC CICS abnormally terminates the task. CICS processing
continues.
ALIC
User response
Explanation
See the related message from the Storage Manager
CICS has issued a GETMAIN request during the domain where the original error was detected.
initialization phase for an application program in order
to obtain run time execution storage for Language Module:
Environment above the 31-bit line. However DFHAPLI
insufficient storage was available to satisfy the ALIG
request.
Explanation
System action
CICS has been unable to determine the language of
CICS abnormally terminates the task. CICS processing the user application program about to be executed.
continues. Either the program was compiled against an old level
of compiler that is no longer supported by CICS, or the
User response language of the program is not supported by CICS.
See the related message from the Storage Manager
domain where the original error was detected. System action

Module: CICS abnormally terminates the task and disables the


DFHAPLI program. CICS processing continues.

ALID
User response

Explanation Ensure that the program to be run is written in one of


the languages and compiled against a level of compiler
CICS has issued a GETMAIN request during the supported by CICS. See the Developing CICS
initialization phase for an application program in order Applications for details of the languages and compilers
to obtain run time execution storage for Language currently supported.
Environment below the 31-bit line. However
insufficient storage was available to satisfy the Module:
request. DFHAPLI
ALIH
System action
CICS abnormally terminates the task. CICS processing Explanation
continues. CICS has determined the language of a program to be
VS COBOL II, but Language Environment has indicated

176 CICS TS for z/OS: CICS Codes


that it is unable to execute the program. Normally reentrancy. They must be coded to threadsafe
Language Environment is able to execute VS COBOL II standards and defined to CICS with
programs in compatibility code. CONCURRENCY(REQUIRED).

System action System action


CICS abnormally terminates the task and disables the CICS abnormally terminates the task and disables the
program. CICS processing continues. program. CICS processing continues.

User response User response


Ensure that the program to be run is written in one of Ensure that the program is coded to threadsafe
the languages supported by CICS and Language standards and defined as CONCURRENCY(REQUIRED),
Environment, and compiled against a level of compiler or recompile the program without the XPLINK option.
supported by Language Environment. See the
A program can be defined as threadsafe by using
Language Environment Migration Guide for details of
standard CICS or CPSM resource definition facilities,
the languages and compilers currently supported, and
via program auotinstall, or by using a Language
any actions which may be necessary by the user such
Environment runtime option. The runtime option can
as re-compilation or re-linking.
be specified in the source of the program by means of
Module: a #pragma runopts(ENVAR(CICSVAR=REQUIRED))
DFHAPLI statement. Alternatively
ENVAR=('CICSVAR=REQUIRED') can be specified in a
ALII
CEEUOPT CSECT which is then linkedited with the
program.
Explanation
Module:
CICS has determined the language of a program to be DFHAPLI
OS/PLI, but Language Environment has indicated that
it is unable to execute the program. Normally ALIK
Language Environment is able to execute OS/PLI
programs in compatibility code. Explanation
CICS has determined that an OS/VS COBOL program is
System action about to be executed. However CICS no longer
CICS abnormally terminates the task and disables the supports such programs.
program. CICS processing continues.
System action
User response CICS abnormally terminates the task and disables the
Ensure that the program to be run is written in one of program. CICS processing continues.
the languages supported by CICS and Language
Environment, and compiled against a level of compiler User response
supported by Language Environment. See the
Ensure that the program is recompiled against a level
Language Environment Migration Guide for details of
of COBOL compiler supported by CICS. See the
the languages and compilers currently supported, and
Developing CICS Applications for details of the
any actions which may be necessary by the user such
languages and compilers currently supported.
as re-compilation or re-linking.
Module:
Module:
DFHAPLI
DFHAPLI
ALIL
ALIJ

Explanation
Explanation
CICS has attempted to change to an OPEN TCB on
CICS has determined that an C or C++ program
which to execute the JAVA, XPLINK or OPENAPI
compiled with the XPLINK option is about to be
program, but the change mode was unsuccessful.
executed but the program is defined with attribute
CICS may be short on storage and have insufficient
CONCURRENCY(QUASIRENT). XPLINK programs
storage to allow creation of the new TCB.
execute on open TCBs and cannot rely on quasi-

Chapter 1. Transaction abend codes 177


System action Module:
DFHAPLX
CICS abnormally terminates the task. CICS processing
continues. ALX3

User response Explanation


Check other messages from CICS to determine CICS has issued a call_main request to the Language
whether CICS is short on storage. Consider reducing Environment preinitialized services system (CEEPIPI).
max tasks (MXT) to reduce the storage requirements However, CEEPIPI has returned an error condition.
from concurrent transactions This error strongly indicates an internal failure in
Language Environment.
Module:
DFHAPLI, DFHAPLJ, DFHAPLX
System action
ALX1
CICS abnormally terminates the task. CICS processing
continues.
Explanation
CICS has issued an initialize request to the Language User response
Environment preinitialized services system (CEEPIPI).
However, CEEPIPI has returned an error condition. The full trace entry will indicate the return code from
This error strongly indicates an internal failure in Language Environment. Consult the Language
Language Environment. Environment Programming Guide manual for an
explanation of the return code.
System action Module:
DFHAPLX
CICS abnormally terminates the task. CICS processing
continues. ALX4

User response Explanation


The full trace entry will indicate the return code from CICS has issued a remove_entry request to the
Language Environment. Consult the Language Language Environment preinitialized services system
Environment Programming Guide manual for an (CEEPIPI). However, CEEPIPI has returned an error
explanation of the return code. condition. This error strongly indicates an internal
failure in Language Environment.
Module:
DFHAPLX
System action
ALX2
CICS abnormally terminates the task. CICS processing
continues.
Explanation
CICS has issued an add_entry request to the Language User response
Environment preinitialized services system (CEEPIPI).
However, CEEPIPI has returned an error condition. The full trace entry will indicate the return code from
This error strongly indicates an internal failure in Language Environment. Consult the Language
Language Environment. Environment Programming Guide manual for an
explanation of the return code.
System action Module:
DFHAPLX
CICS abnormally terminates the task. CICS processing
continues. ALX5

User response Explanation


The full trace entry will indicate the return code from CICS has issued a terminate request to the Language
Language Environment. Consult the Language Environment preinitialized services system (CEEPIPI).
Environment Programming Guide manual for an However, CEEPIPI has returned an error condition.
explanation of the return code. This error strongly indicates an internal failure in
Language Environment.

178 CICS TS for z/OS: CICS Codes


System action Environment Programming Guide manual for an
explanation of the return code.
CICS abnormally terminates the task. CICS processing
continues. Module:
DFHAPLX
User response
The full trace entry will indicate the return code from
Language Environment. Consult the Language

AMxx abend codes


AMGB response is produced when the 4-byte DATA1 field in
the user parameter contains an invalid address.
Explanation
System action
A task has been purged due to lack of storage.
The transaction is abnormally terminated with a CICS
System action transaction dump.

The task is abnormally terminated with a transaction User response


dump.
Use the transaction dump to determine why the
User response DATA1 value passed to the monitoring (MN) domain
was invalid.
Try the transaction again later. If the short-on-storage
condition persists, increase the size of the dynamic Module:
storage areas. DFHCMP

Module: AMNB
DFHMGP
Explanation
AMI1
An exception response has been received from the
Explanation monitoring (MN) domain whilst processing a user
event monitoring point (EMP) request. The exception
When the mirror task is resumed, a bad response response is produced when the 4-byte DATA2 field in
other than a time out or a cancellation was given by the user parameter contains invalid data.
the dispatcher.
System action
System action
The transaction is abnormally terminated with a CICS
The mirror transaction is abnormally terminated with a transaction dump.
transaction dump.
User response
User response
Use the transaction dump to determine why the
Use the dump and the trace to determine the cause of DATA2 value passed to the monitoring (MN) domain
the error. was invalid.
Module: Module:
DFHMIRS DFHCMP
AMNA AMNZ

Explanation Explanation
An exception response has been received from the An unexpected error response has been received from
monitoring (MN) domain while processing a user event the monitoring (MN) domain while processing a user
monitoring point (EMP) request. The exception event monitoring point (EMP) request.

Chapter 1. Transaction abend codes 179


System action System action
The transaction is abnormally terminated with a CICS An exception trace entry is written. The CMPE task is
transaction dump. abnormally terminated.

User response User response


This indicates a possible error in CICS code. An earlier Investigate why an attempt was made to run a CICS
CICS message is issued from the monitoring domain. supplied deferred rule evaluation task as a user
Follow the user response for that message. transaction.
Module: Module:
DFHCMP DFHMPDE
AMPB AMQA

Explanation Explanation
A task exceeded a policy threshold and the action DFHMQCON had enabled DFHMQTRU with a global
defined is to abend the task. work area smaller than that needed by DFHMQTRU.
This could be due to a mismatch of version level
System action between DFHMQCON and DFHMQTRU.

A DFHMP3002 message precedes this abend.


System action

User response The transaction is abnormally terminated with a CICS


transaction dump.
See DFHMP3002 message for diagnostics to
determine the cause of the abend.
User response
Module:
Check that the versions of DFHMQCON and
DFHMPXM
DFHMQTRU are compatible. If you are unable to solve
AMPC the problem, contact your IBM support center.
Module:
Explanation DFHMQTRU
An unexpected error occurred in the deferred rule AMQB
evaluation task CMPE.
Explanation
System action
DFHMQCON had enabled DFHMQTRU with a task local
An exception trace entry is written. The CMPE task is work area smaller than that needed by DFHMQTRU.
abnormally terminated with a CICS transaction dump. This could be due to a mismatch of version level
between DFHMQCON and DFHMQTRU.
User response
Inspect the CICS trace and message log to determine System action
the cause of the failure. The transaction is abnormally terminated with a CICS
Module: transaction dump.
DFHMPDE
User response
AMPD
Check that the versions of DFHMQCON and
Explanation DFHMQTRU are compatible. If you are unable to solve
the problem, contact your IBM support center.
An attempt was made to attach a CICS deferred rule
evaluation task CMPE, but the transaction was not Module:
attached internally by CICS. DFHMQTRU
AMQC

180 CICS TS for z/OS: CICS Codes


Explanation Explanation
Unrecognizable WebSphere MQ API call. All supported An internal logic error has been detected in the CICS
API calls are documented in the WebSphere MQ bridge monitor.
applications reference manual.
System action
System action
Message DFHMQ0750 is written to the CICS CSMT
The transaction is abnormally terminated with a CICS transient data queue and the CICS bridge monitor task
transaction dump. is ended abnormally.

User response User response


See the WebSphere MQ applications reference manual See the description of message DFHMQ0750 for more
for details of the supported WebSphere MQ API. information.
Module: Module:
DFHMQTRU DFHMQBR0
AMQD AMQG

Explanation Explanation
Unrecognizable RMI API call. The CICS-MQ task The CICS DPL bridge program has detected an error in
related user exit (TRUE) was invoked with an a request message for this unit of work.
unrecognizable request type.
System action
System action
All request messages for this unit of work are copied
The transaction is abnormally terminated with a CICS to the dead-letter queue with an MQFB_CICS_* reason
transaction dump. code. Corresponding error messages are written to the
CICS CSMT transient data queue. An
User response MQCRC_BRIDGE_ERROR reply is sent to the reply-to
queue if requested. The CICS bridge task is ended
Contact your IBM support center. abnormally.
Module:
DFHMQTRU User response
AMQE See the description of the accompanying messages for
more information.
Explanation Module:
An attempt to EXEC CICS LOAD the data conversion DFHMQBP0
service module CSQAVICM was unsuccessful. AMQH

System action Explanation


The transaction is abnormally terminated with a CICS The CICS bridge monitor or DPL bridge program
transaction dump. abended due to an unexpected return code from an
EXEC CICS API call.
User response
Ensure that the WebSphere MQ SCSQAUTH library has System action
been specified in the CICS DFHRPL concentation and Message DFHMQ0704 is written to the CICS CSMT
that CSQAVICM is defined as a program to CICS. A transient data queue and the CICS bridge monitor or
definition for CSQAVICM is supplied in the DFHMQ CSD DPL bridge program is abnormally terminated.
group.
Module: User response
DFHMQCON
See the description of message DFHMQ0704 for more
AMQF information.

Chapter 1. Transaction abend codes 181


Module: User response
DFHMQBR2
See the description of the accompanying messages for
AMQI more information. If the problem reoccurs, contact
your IBM support center.
Explanation Module:
The CICS bridge monitor or DPL bridge program DFHMQBP2
abended due to an unexpected return code from an AMQM
WebSphere MQ API call.
Explanation
System action
DFHMQBP0 attempted to process a Link3270 bridge
Message DFHMQ0710 is written to the CICS CSMT request but received an unspecified error. This abend
transient data queue and the CICS bridge monitor or code is only ever issued within message DFHMQ0778.
DPL bridge program is abnormally terminated.
System action
User response
Input messages are backed out to the backout-
See the description of message DFHMQ0710 for more requeue queue or dead-letter queue.
information.
Module: User response
DFHMQBP2
Examine the CICS log immediately prior to the
AMQJ DFHMQ0778 message for further information on the
type of error encountered. If the problem reoccurs,
Explanation contact your IBM support center.

The CICS DPL bridge program abended before Module:


processing any messages for the unit of work. DFHMQBP0
AMQN
System action
All request messages for this unit of work are left on Explanation
the CICS bridge queue to be handled by the CICS The Link3270 bridge has returned one or more bridge
bridge monitor. vectors. DFHMQBP0 has detected that one of the
bridge vector lengths is invalid.
User response
See the description of the accompanying messages for System action
more information. The transaction is abended. Input messages are
Module: backed out to the backout-requeue queue or dead-
DFHMQBP2 letter queue.

AMQK
User response

Explanation Check whether a transaction HANDLE ABEND routine


has recovered from a 3270 Bridge abend and
The CICS DPL bridge program abended during error suppressed the abend. If this is the case the HANDLE
processing. ABEND routine should be coded to allow the 3270
Bridge abend to continue by reissuing the abend. If the
System action problem reoccurs, contact your IBM support center.
An unexpected error occurred during CICS DPL bridge Module:
error processing. DFHMQBP0
AMSA

182 CICS TS for z/OS: CICS Codes


Explanation System action
An input data stream received from a 3270 begins with The task is abnormally terminated with a CICS
a set buffer address (SBA) order but is not followed by transaction dump.
two 1-byte address fields. This is probably due to a
hardware error. User response
Investigate why the task was purged. This is either as
System action
a result of a purge from the master terminal operator
The transaction is abnormally terminated with a CICS via the CEMT transaction, or by the task being timed
transaction dump. out after waiting for longer than the DTIMOUT
(deadlock timeout) value specified for the transaction.
User response If the master terminal operator purged the task, this
It may be possible to bypass the problem by entering may have been in an attempt to clear the system
two spaces before the data to be entered. which appeared to be deadlocked for some reason.

If the problem persists, you need further assistance. If the task was timed out automatically as a result of
See IBM problem support for guidance on how to the DTIMOUT value being exceeded, this may be due
proceed. to insufficient main storage being available for the
number of tasks in the system. If the amount of main
Module: storage cannot be increased, reduce the number of
DFHMSP tasks in the system to avoid short-on-storage
AMSB situations. Another possibility is to increase the value
of the DTIMOUT option for the transaction.
Explanation Module:
DFHMSP
An internal logic error has been detected in module
DFHMSP. AMSD

System action Explanation


The transaction is abnormally terminated with a CICS An error (INVALID, DISASTER, or unexpected
transaction dump. EXCEPTION response) has occurred on a call to the
storage manager (SM) domain. The domain that
User response detected the original error provides an exception
trace, a console message and, possibly, a system
Retry the CMSG transaction, specifying operands in a dump (depending on the options specified in the dump
different order. If this fails, keep the dump and contact table).
your IBM Support Center.
Module: System action
DFHMSP
The task is abnormally terminated with a CICS
AMSC transaction dump.

Explanation User response


The task was purged before a GETMAIN request to the See the related error message produced by the
storage manager (SM) domain was able to complete domain that detected the original error.
successfully. The task that first detected the purged
Module:
condition will have provided an exception trace.
DFHMSP

ANxx abend codes


ANQA Explanation
An error has occurred obtaining a lock within the
enqueue domain.

Chapter 1. Transaction abend codes 183


System action Explanation
The recovery routine of the module in control is An error has occurred obtaining a sysplex enqueue. An
invoked which issues message DFHNQ0002 with a unexpected environmental error has been detected.
system dump. DFHNQ0002 reports the module in
control at the time of the error. System action
Module DFHNQED issues message DFHNQ0104 and
User response
the task issuing the EXEC ENQ request is abended.
See the description of message DFHNQ0002 for
further guidance. User response
Module: See the description of message DFHNQ0104 for
DFHNQED, DFHNQIB, DFHNQNQ, DFHNQST further guidance.
ANQB Module:
DFHNQED
Explanation
ANQE
An error has occurred releasing a lock within the
enqueue domain. Explanation
An EXEC ENQ has been issued on a resource for which
System action
the enqmodel is either disabled or in the waiting state.
The recovery routine of the module in control is
invoked. This routine issues message DFHNQ0002 System action
with a system dump. DFHNQ0002 reports the module
in control at the time of the error. Module DFHNQRN issues message DFHNQ0105 and
the task issuing the EXEC ENQ request is abended.
User response
User response
See the description of message DFHNQ0002 for
further guidance. See the description of message DFHNQ0105 for
further guidance.
Module:
DFHNQED, DFHNQIB, DFHNQNQ, DFHNQST Module:
DFHNQRN
ANQC
ANQF
Explanation
Explanation
An error has occurred obtaining a sysplex enqueue.
The limit for the number of concurrent sysplex An EXEC CICS ENQ request has been issued too early
resource ENQ requests has been reached. during transaction initialization, before a recoverable
transaction environment has been established.
System action
System action
Module DFHNQED issues message DFHNQ0103 and
the task issuing the EXEC ENQ request is abended. The transaction is abnormally terminated.

User response User response

See the description of message DFHNQ0103 for This error should only occur when an exit such as the
further guidance. 3270 Bridge Exit is executing. If the exit program is
written in a high level language, the ENQ may have
Module: been issued by Language Environment.
DFHNQED
Module:
ANQD DFHEKC
ANSA

184 CICS TS for z/OS: CICS Codes


Explanation Explanation
An error has occurred obtaining the numberspace lock An error has occurred releasing a lock within the AP
within the AP domain. domain.

System action System action


The recovery routine of the module in control is The recovery routine of the module in control is
invoked which issues message DFHAP0002 with a invoked which issues message DFHAP0002 with a
system dump. DFHAP0002 reports the module in system dump. DFHAP0002 reports the module in
control at the time of the error. control at the time of the error.

User response User response


See the description of message DFHAP0002 for See the description of message DFHAP0002 for
further guidance. further guidance.
Module: Module:
DFHBRNS DFHBRNS
ANSB

AOxx abend codes


AOTA Explanation
An unexpected error was encountered by the OT
Explanation domain resynchronization transaction CJTR. The
The OT domain resynchronization transaction CJTR domain that detected the original error will have
has been started in an incorrect manner (for example, provided an exception trace, a console message and,
from a user terminal, or by a start request). This is not possibly, a system dump (depending on the options
permitted. specified in the dump table).

System action System action

The task is abnormally terminated with a transaction The task is abnormally terminated with a CICS
dump. transaction dump.

User response User response

None. The OT domain resynchronization transaction See the related message produced by the domain that
must be started internally by CICS. detected the original error.

Module: Module:
DFHOTR DFHOTR

AOTB

APxx abend codes


APC0 System action
CICS terminates the task with a transaction dump.
Explanation
A serious error occurred in a call to the program User response
manager domain when trying to link a system Use the dump to investigate why the error occurred.
program. Look at the trace records prior to the error for
abnormal conditions in processing the PGLK domain
call. This may be due to a problem with directory

Chapter 1. Transaction abend codes 185


manager, loader, or storage manager. Check the System action
program size. It may be necessary to increase the
The transaction is abnormally terminated and the
overall size limits of the DSAs or EDSAs.
program is disabled.
Module:
DFHEICRE, DFHEIG, DFHEIP, DFHEIQCS, DFHPCP, User response
DFHMCY
Refer to messages issued during CICS initialization to
APC1 determine why Language Environment is not present
in the system.
Explanation
Module:
A request for a TGT exceeding 64KB has been DFHAPLI
detected.
APCF

System action
Explanation
CICS abnormally terminates the transaction and
A CICS task has invoked a program which was defined
disables the installed program definition.
as PL/I, but the program was not compiled with a
supported PL/I compiler, or the program may not be
User response written in the PL/I language.
Change the application program to reduce the working
storage requirement. Perform CEMT NEWCOPY and System action
ENABLE for the program when it has been corrected.
CICS terminates the task, and disables the program.
Module:
DFHAPLI User response
APC2 Check that the program is PL/I. If the program is PL/I,
recompile it with a Language Environment conforming
Explanation compiler such as Enterprise PL/I for z/OS, in which
case you might need to change the source program. If
An illegal branch has been attempted by a Language
the program is not PL/I, redefine it correctly.
Environment user program following an abend
condition with an active handle label abend. Usually an Module:
Out-Of-Block GOTO will have resulted, implying that DFHAPLI
the program tried to branch to, for example, an
APCG
inactive block.

Explanation
System action
The transaction was purged either by master terminal
The transaction is abnormally terminated and the
actions or due to deadlock timeout actions as part of a
program is disabled.
request to the loader for a usable program copy.
Deadlock timeout could be caused by a program
User response whose size exceeds the available space in the DSAs or
Use the dump and trace to determine the cause of the EDSAs.
error and amend the GOTO in error.
System action
Module:
DFHAPLI CICS terminates the task with a transaction dump.
APC3
User response
Explanation Use the dump to investigate why the transaction was
purged. This may be due to waiting for loader
An attempt to run the program has failed because
resources or for program storage. Check the program
CICS has identified the program as 'Language
size. It may be necessary to increase the overall size
Environment enabled' but Language Environment
limits of the DSAs or EDSAs.
support is not present in the system.
For module list, see Diagnostics reference.

186 CICS TS for z/OS: CICS Codes


Module: APCJ
DFHACP, DFHCRNP, DFHCRSP, DFHDBCT, DFHDBDSC,
DFHEDFP, DFHEIG, DFHEIP, DFHEICRE, DFHEIQCS, Explanation
DFHEIPSH, DFHEIQIR, DFHEIQSJ, DFHFCRP, DFHFEP,
DFHICP, DFHKCQ, DFHMCP, DFHMCPE, DFHMCY, A request for a C/370 program could not be executed
DFHMSP, DFHPCPG, DFHPHP, DFHPSIP, DFHPUP, either because Language Environment was unable to
DFHRDCAL, DFHRTC, DFHSII1, DFHSIJ1, DFHSPP, recognize the program as having been compiled under
DFHSTP, DFHTACP, DFHTBSGB, DFHTCRP, DFHTDX, the C/370 Compiler, or because the program was not
DFHTFP, DFHTSPA, DFHTSRP, DFHUSBP, DFHXRCP, link-edited with the attribute AMODE(31).
DFHXRE, DFHXRSP, DFHZATA, DFHZATD, DFHZCPLN,
DFHZGAI, DFHZQ00, DFHZNCA, DFHZOPA, DFHZXCU System action
APCH The transaction is abnormally terminated and the
program is disabled.
Explanation
User response
A request for a program which CICS has identified as
VS COBOL II cannot be executed because either Ensure that the program is link-edited with the
Language Environment is not active in this address attribute AMODE(31). If necessary, recompile the
space or Language Environment cannot provide program with a Language Environment conforming
support for the COBOL language. compiler such as OS/390 C/C++.
Module:
System action DFHAPLI
The transaction is abnormally terminated and the APCK
program is disabled.
Explanation
User response
A request for a C program could not be honored either
Ensure that the correct Language Environment support because Language Environment is not active in this
is present. Refer to messages issued during CICS address space or because Language Environment
initialization to determine why COBOL support is not cannot provide support for the C language.
present.
Module: System action
DFHAPLI
The transaction is terminated abnormally and the
APCI program is disabled.

Explanation User response


A request for a program which CICS as identified as an Ensure that the correct Language Environment support
OS/PLI program cannot be executed because either is present. Refer to messages issued during CICS
Language Environment is not active in this address initialization to determine why C support is not
space or Language Environment cannot provide present.
support for the PL/I language.
Module:
DFHAPLI
System action
APCL
The transaction is abnormally terminated and the
program is disabled.
Explanation
User response A request for a program which CICS has identified as
'LE-enabled' has failed because Language
Ensure that the correct Language Environment support Environment is unable to execute the program.
is present. Refer to messages issued during CICS
initialization to determine why PL/I support is not
present. System action

Module: The transaction is abnormally terminated and the


DFHAPLI program is disabled.

Chapter 1. Transaction abend codes 187


User response User response
Ensure that the program has been compiled either See the related message from the domain that
with a Language Environment conforming compiler or detected the original error.
with a compiler which is supported by Language
Module:
Environment in compatibility mode. Refer to the
DFHAPXM
Language Environment Migration Guide to verify this
conformance. APCS
If the compiler is supported, and the relevant language
migration guides do not indicate any special actions, Explanation
refer this problem to your installation systems An attempt to run the program failed because CICS
programming facility. was unable to make a successful connection with
Module: Language Environment to determine the run-time
DFHAPLI characteristics of the program. This abend is
accompanied by message DFHAP1200 which gives the
APCN reason code set by Language Environment indicating
the nature of the error.
Explanation
An attempt to release an internal CICS program, a System action
mapset, or a partitionset because the program, The transaction is abnormally terminated and the
mapset or partitionset has not been loaded or has program is disabled.
already been deleted. This is probably an internal CICS
error.
User response

System action Refer to the Language Environment manual for the


meaning of the reason code, and take whatever action
The transaction is abnormally terminated with a CICS is necessary to correct the error.
transaction dump. The name of the program for which
the RELEASE was attempted can be found in the Module:
abend dump at TCAPCPI. DFHAPLI
APCT
User response
This is either an internal CICS error or is due to the Explanation
overwriting of CICS internal control blocks. If you need One of the following has occurred:
further assistance from IBM to resolve this problem,
see IBM problem support for guidance on how to 1. The program name in the EXEC CICS HANDLE
proceed. ABEND program is not usable at the time an abend
occurs because:
For module list, see Diagnostics reference.
• The program is not on the relocatable program
Module: library (RPL).
DFHAMPEN, DFHFEP, DFHMCP, DFHMCPE, DFHMCY,
• The program is disabled.
DFHPHP, DFHTBSSP, DFHZCPLN
• The program cannot be loaded.
APCO
2. An attempt to load a mapset or partitionset failed
because although the program is defined to CICS
Explanation
• It is not available on the RPL, or
A GETMAIN of storage for LEVEL 2 trace failed during
transaction initialization. • It is disabled, or
• It cannot be autoinstalled.
System action 3. An attempt to link to, load, or release an internal
The transaction is abnormally terminated with a CICS CICS program failed because:
transaction dump. • The program is not on the RPL.
• The program is disabled.
• The program cannot be loaded.

188 CICS TS for z/OS: CICS Codes


System action program has been link edited without the EXEC
interface module (for example, DFHECI or DFHELII)
The transaction requiring the program is abnormally
which is used by the CICS high-level language
terminated with a CICS transaction dump.
programming interface. See the Configuring for details
of what has to be done to include this module.
User response
In cases 1 and 2, define the program, mapset System action
partitionset to CICS using CEDA and ensure it is
The transaction is abnormally terminated and the
enabled.
program is disabled.
In case 3, the definition of a CICS-provided module is
incorrect. Check for associated messages issued User response
during CICS start up.
Remove the macro request from the application
For module list, see Diagnostics reference. program.
Module:
Problem determination
DFHAPLI
The trace preceding the abend indicates the program,
APCZ
mapset, or partitionset that could not be loaded,
linked to, or released. The name is also in TCAPCEPI.
Explanation
Module:
DFHACP, DFHAMPEN, DFHCRSP, DFHEDFP, DFHEIG, An attempt has been made to run an 'old-style'
DFHEIP, DFHEICRE, DFHEIPSH, DFHEIQCS, application program (that is, a program with a pre-
DFHEIQSJ, DFHFEP, DFHICP, DFHMCP, DFHMCPE, release 1.6 or a DFHE program stub) that has been
DFHMCY, DFHMELDE, DFHPCPG, DFHPHP, DFHPUP, link-edited with the RENT or REFR attributes. These
DFHRDCAL, DFHSII1, DFHTBSGB, DFHTFP, DFHTSRP, types of programs are not reentrant and therefore
DFHZCPLN, DFHZQ00, DFHZXCU cannot be loaded into read-only storage.

APCW
System action

Explanation The transaction is abnormally terminated.

The program language is defined as COBOL but the


User response
level of the compiler under which it is compiled cannot
be determined. Most probably, the program was Relink the program without the RENT and REFR
compiled under an OS/VS COBOL compiler but the attributes.
required level of support for that compiler is not
Module:
present in the system.
DFHAPLI

System action APGA

The transaction is abnormally terminated and the


Explanation
program is disabled.
An error has occurred obtaining a lock within the
User response Program Manager domain.

The program source will need to be converted and


System action
compiled with a Language Environment conforming
COBOL compiler such as Enterprise COBOL. CICS abnormally terminates the task. CICS processing
continues.
Module:
DFHAPLI
User response
APCY
Contact your local IBM support center for assistance.
Explanation Module:
DFHPGAI, DFHPGAQ, DFHPGDD, DFHPGDM,
In an MVS/ESA environment, a CICS macro request
DFHPGEX, DFHPGIS, DFHPGLD, DFHPGLE, DFHPGLK,
has been issued from a PL/I or COBOL application.
Alternatively, it is possible that the application

Chapter 1. Transaction abend codes 189


DFHPGLU, DFHPGPG, DFHPGRE, DFHPGRP, DFHPGST, User response
DFHPGUE, DFHPGXE, DFHPGXM
For an AMODE(64) assembler application program,
APGB ensure that the binder places the AMODE(64) CICS
stub, DFHEAG, at the front of the load module. You can
Explanation use the CICS-supplied procedure DFHEGTAL to
translate, assemble and bind the AMODE(64)
An error has occurred releasing a lock within the program. .p:If the assembler application program is
Program Manager domain. not AMODE(64), change any AMODE 64 statements in
the program or the binder job to the correct AMODE.
System action You can use the CICS-supplied procedure DFHEITAL
to translate, assemble and bind the AMODE(24) or
CICS abnormally terminates the task. CICS processing
AMODE(31) program.
continues.
Module:
User response DFHAPLI3

Contact your local IBM support center for assistance. APGE

Module:
Explanation
DFHPGAI, DFHPGAQ, DFHPGDD, DFHPGDM,
DFHPGEX, DFHPGIS, DFHPGLD, DFHPGLE, DFHPGLK, The AMODE(64) CICS stub program, DFHEAG, is
DFHPGLU, DFHPGPG, DFHPGRE, DFHPGRP, DFHPGST, included at the front of the load module, but the entry
DFHPGUE, DFHPGXE, DFHPGXM point of the assembler application program indicates
that it is not AMODE(64).
APGC

System action
Explanation
The task is abnormally terminated with a CICS
A transaction has tried to allocate an excessive
transaction dump.
amount of storage for containers. A transaction must
not allocate more than 5% of the storage available for
holding containers above the bar. User response
For an AMODE(24) or AMODE(31) assembler
System action application program, ensure that the binder places the
DFHEAI stub program at the front of the load module.
CICS issues message DFHPG0400, and abnormally
You can use the CICS-supplied procedure DFHEITAL
terminates the task. CICS processing continues.
to translate, assemble and bind the AMODE(24) or
AMODE(31) program.
User response
For an AMODE(64) assembler application program,
If the program is incorrect, correct it to allocate less change any AMODE statements in the program or the
container storage. If the program is correct, increase binder job to AMODE 64. If there are no AMODE
MEMLIMIT so that the program does not use more statements then include an AMODE 64 statement in
than 5% of the storage available. the program, the binder job, or both, you can use the
Module: CICS-supplied procedure DFHEGTAL to translate,
DFHPGCR assemble and bind the AMODE(64) program.

APGD Module:
DFHAPLI3
Explanation APIA
The entry point of an assembler application program
indicates that it is AMODE(64), but the AMODE(64) Explanation
CICS stub program, DFHEAG, is not included at the The transaction id (CPIH) of the Pipeline Inbound
front of the load module. HTTP router program has been initiated invalidly,
probably by entering the id at a terminal. This
System action transaction must only be initiated by CICS internal
processes.
The task is abnormally terminated with a CICS
transaction dump.

190 CICS TS for z/OS: CICS Codes


System action Explanation
The transaction is abnormally terminated. A provider mode Web service invocation has failed.
This may be due to a problem whilst processing a
User response SOAP request message or generating a SOAP response
message.
Do not initiate CPIH directly.
Module: System action
DFHPIDSH
CICS abends the transaction and a SOAP Fault
APIB message is sent to the requester.

Explanation User response


The Pipeline outbound router program received an Examine the CICS trace for exception traces issued
error response from the Pipeline Manager when it from DFHPITL. These will identify the source of the
started the pipeline. failure. If validation is currently disabled for the failing
WEBSERVICE then consider enabling it and reproduce
System action the problem. This causes CICS to call a Java based
program to validate the SOAP message against the
The outbound router program is abnormally WSDL for the WEBSERVICE. If the SOAP message is
terminated. malformed then a message will be issued to describe
the problem in more detail.
User response
Module:
Examine the trace and associated messages to DFHPITP
determine why the Pipeline Manager failed to start
APIH
successfully.
Module: Explanation
DFHPIRT
The transaction id (CPIL) of the Pipeline WebSphere
APIC MQ Listener program has been initiated invalidly,
probably by entering the id at a terminal. This
Explanation transaction must only be initiated by being triggered
by an inbound WebSphere MQ message.
The Pipeline HTTP outbound router program received
an error response from its attempt to do an EXEC CICS
GET CONTAINER call to obtain the pipeline name from System action
the DFHWS-PIPELINE container. Both a trace and The transaction is abnormally terminated with a CICS
message DFHPI0998 are issued and these will be an transaction dump.
indication of what the error was. If the trace point id is
'09DD'x then a CONTAINERERR was returned to
User response
DFHPIRT. A point id of '09DE'x indicates that a
LENGERR was returned. Do not initiate CPIL directly.
Module:
System action DFHPILSQ
The outbound router program is abnormally APII
terminated.
Explanation
User response
An attempt has been made to use WebSphere MQ as
Examine the trace and associated messages to the transport for CICS Web Services, but the
determine why the Pipeline failed to start successfully. WebSphere MQ stub CSQCSTUB could not be loaded
Module: during CICS Initialisation. The WebSphere MQ library
DFHPIRT CSQCLOAD needs to be included in the DFHRPL
concatenation to permit use of WebSphere MQ as a
APIG transport for CICS Web Services

Chapter 1. Transaction abend codes 191


System action Module:
DFHPISN
The attempt to use WebSphere MQ as a transport for
CICS Web Services has been rejected. Any further APIL
such attempts will also be rejected.
Message DFHAP0900 is produced. Explanation

The task is abnormally terminated with a CICS The CICS supplied SOAP Handler has failed with a
transaction dump. disaster response.

User response System action

The WebSphere MQ library CSQCLOAD must be CICS attempts to run the pipeline in an error mode. A
included in the DFHRPL concatenation to allow use of dump is taken.
WebSphere MQ as a transport for CICS Web Services.
This is in addition to the other WebSphere MQ libraries User response
needed for WebSphere MQ support in CICS.
Keep the dump and contact your IBM Support Center.
Module:
Module:
DFHPILSQ
DFHPISN
APIJ
APIM

Explanation
Explanation
A WebSphere MQ function call issued by transaction
The transaction id (CPIQ) of the Pipeline Inbound
CPIL was unsuccessful and has set a non-zero reason
WebSphere MQ router program has been initiated
code. The transaction CPIL is used to start a PIPELINE
invalidly, probably by entering the id at a terminal. This
for a message received from WebSphere MQ.
transaction must only be initiated by CICS internal
processes.
System action
Message DFHPI0111 is produced, which includes the System action
WebSphere MQ reason code. The task is abnormally
The transaction is abnormally terminated.
terminated with a CICS transaction dump.

User response
User response
Do not initiate CPIQ directly.
Check the WebSphere MQ reason code in the
WebSphere MQ messages manual, and examine the Module:
trace to determine why the WebSphere MQ function DFHPIDSQ
call failed. You may need help from IBM to resolve this
APIN
problem.
Module: Explanation
DFHPILSQ
The Web Services Atomic Transaction (WS-AT) handler
APIK has detected a problem. The transaction id (CPIS) of
the Pipeline WSAT resync program has been initiated
Explanation invalidly, probably by entering the id at a terminal. This
transaction must only be initiated by CICS internal
The CICS supplied SOAP Handler received an
processes.
unexpected response from another module.

System action
System action
The transaction is abnormally terminated.
CICS attempts to run the pipeline in an error mode. No
dump is taken.
User response
User response Do not initiate CPIS directly.
Examine the CICS joblog for associated messages. Module:

192 CICS TS for z/OS: CICS Codes


DFHPIR User response
APIO Examine the trace and associated messages to
determine why the Registration/Protocol Services
Explanation program has failed.

The Web Services Atomic Transaction (WS-AT) handler Module:


has detected a problem. The WSAT Registration DFHWSATX.
Services program has encountered an error, which has APIR
prevented it from completing the processing of a
registration or 2PC protocol request. The program is
Explanation
abnormally terminated.
The Web Services Atomic Transaction (WS-AT) handler
System action:
has detected a problem. The WSAT application
handler program has encountered an attempt to use
User response one-way messages in a WS-AT message. This
Examine the trace and associated messages to combination is not permitted in WS-AT. The program is
determine why the Registration Services program has abnormally terminated.
failed. System action:
Module:
DFHPIRS User response
APIP Examine the trace and associated messages to
determine which messages are at fault.
Explanation Module:
The Web Services Atomic Transaction (WS-AT) handler DFHWSATH.
has detected a problem. The WSAT Coordination APIS
Context header handler program has encountered an
unrecoverable error, which has prevented it from
Explanation
successfully creating or processing a coordination
context. The program is abnormally terminated. CICS encountered a GETMAIN failure during
transaction initialization.
System action:

System action
User response
A severe error message and system dump should have
Examine the trace and associated messages to
preceeded this abend.
determine why the Coordination Services program has
failed.
User response
Module:
DFHWSATH Use related diagnostics to determine the cause of the
problem.
APIQ
Module:
DFHPIXM.
Explanation
APIT
The Web Services Atomic Transaction (WS-AT) handler
has detected a problem. The WSAT application
handler program has encountered an unrecoverable Explanation
error, which has prevented it from creating or The Web Services Atomic Transaction (WS-AT) handler
processing a registration message or a protocol has detected a problem. The attempt to resynchronize
message. The program is abnormally terminated. outstanding units of work has failed.
System action:
System action
The transaction is abnormally terminated.

Chapter 1. Transaction abend codes 193


User response User response:
Investigate why the UOWs cannot be resynchronized. Module:
Module: APL3
DFHPIR
APIU Explanation
Abend codes with 'PL' as the middle two characters
Explanation are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide.
The Pipeline WebSphere MQ Listener program has
encountered an attempt to parse a target URI that is System action:
longer than 255 bytes. The maximum length of a
User response:
target URI in the RFH2 header is expected to be 255
bytes. Module:
APL4
System action
The program is abnormally terminated. Explanation
Abend codes with 'PL' as the middle two characters
User response are issued by PL/I, and are described in further detail
Examine the trace and associated messages to in the Enterprise PL/I for z/OS Programming Guide.
determine which messages are at fault. System action:
Module: User response:
DFHPILSQ.
Module:
APL0
APL5
Explanation
Explanation
Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail Abend codes with 'PL' as the middle two characters
in the Enterprise PL/I for z/OS Programming Guide. are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide.
System action:
System action:
User response:
User response:
Module:
Module:
APL1
APL6
Explanation
Explanation
Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail Abend codes with 'PL' as the middle two characters
in the Enterprise PL/I for z/OS Programming Guide. are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide.
System action:
System action:
User response:
User response:
Module:
Module:
APL2
APL7
Explanation
Explanation
Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail Abend codes with 'PL' as the middle two characters
in the Enterprise PL/I for z/OS Programming Guide. are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide.
System action:

194 CICS TS for z/OS: CICS Codes


System action: Explanation
User response: Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail
Module:
in the Enterprise PL/I for z/OS Programming Guide.
APL8
System action:

Explanation User response:

Abend codes with 'PL' as the middle two characters Module:


are issued by PL/I, and are described in further detail APLD
in the Enterprise PL/I for z/OS Programming Guide.
System action: Explanation
User response: Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail
Module:
in the Enterprise PL/I for z/OS Programming Guide.
APL9
System action:

Explanation User response:

Abend codes with 'PL' as the middle two characters Module:


are issued by PL/I, and are described in further detail APLE
in the Enterprise PL/I for z/OS Programming Guide.
System action: Explanation
User response: Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail
Module:
in the Enterprise PL/I for z/OS Programming Guide.
APLA
System action:

Explanation User response:

Abend codes with 'PL' as the middle two characters Module:


are issued by PL/I, and are described in further detail APLF
in the Enterprise PL/I for z/OS Programming Guide.
System action: Explanation
User response: Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail
Module:
in the Enterprise PL/I for z/OS Programming Guide.
APLB
System action:

Explanation User response:

Abend codes with 'PL' as the middle two characters Module:


are issued by PL/I, and are described in further detail APLG
in the Enterprise PL/I for z/OS Programming Guide.
System action: Explanation
User response: Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail
Module:
in the Enterprise PL/I for z/OS Programming Guide.
APLC
System action:
User response:
Module:
APLH

Chapter 1. Transaction abend codes 195


Explanation Explanation
Abend codes with 'PL' as the middle two characters Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide. in the Enterprise PL/I for z/OS Programming Guide.
System action: System action:
User response: User response:
Module: Module:
APLI APLN

Explanation Explanation
Abend codes with 'PL' as the middle two characters Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide. in the Enterprise PL/I for z/OS Programming Guide.
System action: System action:
User response: User response:
Module: Module:
APLJ APLO

Explanation Explanation
Abend codes with 'PL' as the middle two characters Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide. in the Enterprise PL/I for z/OS Programming Guide.
System action: System action:
User response: User response:
Module: Module:
APLK APLP

Explanation Explanation
Abend codes with 'PL' as the middle two characters Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide. in the Enterprise PL/I for z/OS Programming Guide.
System action: System action:
User response: User response:
Module: Module:
APLL APLQ

Explanation Explanation
Abend codes with 'PL' as the middle two characters Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide. in the Enterprise PL/I for z/OS Programming Guide.
System action: System action:
User response: User response:
Module: Module:
APLM APLR

196 CICS TS for z/OS: CICS Codes


Explanation Explanation
Abend codes with 'PL' as the middle two characters Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide. in the Enterprise PL/I for z/OS Programming Guide.
System action: System action:
User response: User response:
Module: Module:
APLS APLY

Explanation Explanation
Abend codes with 'PL' as the middle two characters Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide. in the Enterprise PL/I for z/OS Programming Guide.
System action: System action:
User response: User response:
Module: Module:
APLT APLZ

Explanation Explanation
Abend codes with 'PL' as the middle two characters Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide. in the Enterprise PL/I for z/OS Programming Guide.
System action: System action:
User response: User response:
Module: Module:
APLU APLX

Explanation Explanation
Abend codes with 'PL' as the middle two characters Abend codes with 'PL' as the middle two characters
are issued by PL/I, and are described in further detail are issued by PL/I, and are described in further detail
in the Enterprise PL/I for z/OS Programming Guide. in the Enterprise PL/I for z/OS Programming Guide.
System action: System action:
User response: User response:
Module: Module:
APLV APP1

Explanation Explanation
Abend codes with 'PL' as the middle two characters The DFHIC TYPE=GET response code was not a
are issued by PL/I, and are described in further detail normal response.
in the Enterprise PL/I for z/OS Programming Guide.
System action: System action

User response: The transaction is abnormally terminated with a CICS


transaction :i1.DFHP3270 abend codes dump.
Module:
APLW

Chapter 1. Transaction abend codes 197


User response of data passed to it is less than or equal to 5, there is
no data to be printed.
Analyze the dump. The response code is in the low-
order byte of register 0. Module:
DFHP3270
Module:
DFHP3270 APP3
APP2
Explanation
Explanation An attempt to request data has been sent to a
nonprinter or unsupported device type by either:
The length of data that has been passed to DFHP3270
via temporary storage is less than or equal to 5. • A terminal operator entering CSPP as a transaction
code, or
System action • A transaction issuing a DFHTEP request.
The transaction is abnormally terminated with a CICS
transaction dump. System action
The transaction is abnormally terminated. A CICS
User response transaction dump is not provided.
Check the user DFHTEP. If it is not at fault, submit an
APAR. User response
If this abend has occurred, the data that DFHP3270 1. Ensure that the terminal operator ceases to use
obtained from temporary storage was probably put CSPP as a transaction code, or
there with an incorrect length. The user may have 2. Correct the user DFHTEP program.
requested indirectly that this data be placed in
temporary storage either by an application request for Module:
printing (for example ISSUE PRINT) or by pressing the DFHP3270
Print Request key. However, CICS should control the APR1
data length for this request. Under normal
circumstances, the only way the user could have
Explanation
requested directly that data is to be placed in
temporary storage is in the user's TEP. The user should An abnormal DFHIC TYPE=PUT response code was
check any invocations of DFHIC TYPE=PUT in handling received during print key processing.
print requests, particularly when dealing with the
"printer unavailable or busy" condition, and ensure System action
that the length field is set correctly.
The transaction is abnormally terminated with a CICS
transaction dump. The keyboard of the terminal on
Problem determination
which the print key was depressed remains locked to
Register 6 points to the data retrieved from temporary indicate the failure of the operation.
storage via a DFHIC TYPE=GET macro invocation. The
layout of this data is: User response
• Terminal data area length (2 bytes) Analyze the dump. The response code is in low-order
• Write control indicator (1 byte) byte of register 0.
• Write control or carriage control character (1 byte) Module:
• Data (variable length) DFHPRK

Analysis: DFHP3270 has been called to handle a print APSJ


request from a 3270 Information Display System
terminal. It obtains from temporary storage the data to Explanation
be printed, via a DFHIC TYPE=GET invocation. It
The abending transaction invoked the system spooler
ensures that some data to be printed is present. The
initialization program (DFHPSIP) illegally, that is from
area returned from temporary storage contains the
a program other than the CICS module, DFHSIJ1.
data to be printed preceded by 4 bytes as described
above. DFHP3270 has found that, because the length

198 CICS TS for z/OS: CICS Codes


System action Explanation
CICS terminates the transaction abnormally. The EXEC A storage area for VSAM macro return codes contained
CICS HANDLE ABEND command can not handle this an invalid value.
abend.
System action
User response
CICS terminates the task abnormally with a dump.
Remove any calls or links to DFHPSIP from your
application programs. If you can find no invocation of User response
DFHPSIP in your application, you need further
assistance to resolve this problem. See IBM problem Check the syntax and input data of the spool
support for guidance on how to proceed. commands issued by the failing transaction. Check any
JES failures that occurred at the same time.
Module:
DFHPSIP Module:
DFHPSPST
APST
APSW
Explanation
Explanation
A task issued a SPOOL command without the
mandatory NOHANDLE operand. An abend occurred within a CICS system spooler
subtask.
System action
System action
CICS terminates the task abnormally with a dump.
CICS terminates the task abnormally with a dump.
User response
User response
Correct the syntax of the command, specifying
NOHANDLE. This is an internal CICS error. If you need further
assistance from IBM to resolve this problem, see IBM
Module: problem support for guidance on how to proceed.
DFHEPS
Module:
APSU DFHPSPST
APSX
Explanation
The CICS SVC passed an invalid JES interface return Explanation
code to the CICS system spooler (an MVS subtask).
A CICS storage area used for notification of invalid
parameters contained an invalid value.
System action
CICS terminates the task abnormally. System action
CICS terminates the task abnormally with a dump.
User response
This is an internal error - check any JES failures that User response
occurred at the same time.
Check the syntax and input data of the spool
If you need further assistance from IBM to resolve this commands issued by the failing transaction. Check any
problem, see IBM problem support for guidance on JES failures that occurred at the same time.
how to proceed.
Module:
Module: DFHPSPST
DFHPSPST
APSY
APSV

Chapter 1. Transaction abend codes 199


Explanation timed out after waiting for longer than the DTIMOUT
(deadlock timeout) value specified for the transaction.
A CICS storage area for MVS macro return codes
contained an invalid value. If the master terminal operator purged the task, this
may have been in an attempt to clear the system
System action which appeared to be deadlocked for some reason.

CICS terminates the task abnormally with a dump. If the task was timed out automatically as a result of
the DTIMOUT value being exceeded, this may be due
to insufficient main storage being available for the
User response
number of tasks in the system. If the amount of main
Check the syntax and input data of the spool storage cannot be increased, reduce the number of
commands issued by the failing transaction. Check any tasks in the system to avoid short-on-storage
JES failures that occurred at the same time. situations. Another possibility is to increase the value
of the DTIMOUT option for the transaction.
Module:
DFHPSPST Module:
DFHPSPST
APSZ
APTJ
Explanation
Explanation
A CICS area, used to store a JES interface return code,
contained an invalid value. An error (INVALID, DISASTER, or unexpected
EXCEPTION response) has occurred on a call to the
System action storage manager (SM) domain. The domain that
detected the original error will have provided an
CICS terminates the task abnormally with a dump. exception trace, a console message and, possibly, a
system dump (depending on the options specified in
User response the dump table).
Check the syntax and input data of the spool
commands issued by the failing transaction. Check any System action
JES failures that occurred at the same time. The task is abnormally terminated with a CICS
This is an internal CICS error. If you need further transaction dump.
assistance from IBM to resolve this problem, see IBM
problem support for guidance on how to proceed. User response
Module: See the related message from the domain that
DFHPSPST detected the original error.
APTI Module:
DFHPSPST
Explanation APUA
The task was purged before a GETMAIN request to the
storage manager (SM) domain was able to complete Explanation
successfully. The domain that first detected the
An internal error was detected when module DFHPUP
purged condition will have provided an exception
was invoked. The GETSTG parameter is missing on a
trace.
call to DFHPUP (PUPF).

System action
System action
The task is abnormally terminated with a CICS
• In a CICS environment, the CEDA transaction is
transaction dump.
abnormally terminated with a CICS transaction
dump.
User response
• In a batch environment, processing is abnormally
Investigate why the task was purged. It was purged terminated with an operating system dump.
either as a result of a purge from the master terminal
operator via the CEMT transaction, or by the task being

200 CICS TS for z/OS: CICS Codes


User response Explanation
If you need further assistance from IBM to resolve this The RDO language definition table (DFHEITSP) could
problem, see IBM problem support for guidance on not be located in the library.
how to proceed.
Module: System action
DFHPUP • In a CICS environment, the CEDA transaction is
APUB abnormally terminated with a CICS transaction
dump.
Explanation • In a batch environment, processing is abnormally
terminated with an operating system dump.
An internal error was detected when module DFHPUP
was invoked. The GETSTG parameter is missing on a
User response
call to DFHPUP (PUPU).
Ensure that module DFHEITSP is in the library and is
System action valid for this release of CICS.

• In a CICS environment, the CEDA transaction is Module:


abnormally terminated with a CICS transaction DFHPUP
dump. APUE
• In a batch environment, processing is abnormally
terminated with an operating system dump. Explanation
The RDO language definition table (DFHEITSP) could
User response
not be loaded because of a lack of available storage.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on System action
how to proceed.
Processing is abnormally terminated with an operating
Module: system dump.
DFHPUP
APUC User response
Allocate more storage and resubmit the offline COPY
Explanation or APPEND command(s) that failed.
An internal error was detected when module DFHPUP Module:
was invoked. An invalid function code was supplied for DFHPUP (Batch environment)
a domain call to DFHPUP.
APUF
System action
Explanation
• In a CICS environment, the CEDA transaction is
abnormally terminated with a CICS transaction Either the RDO language definition table is invalid or it
dump. is missing from the library.
• In a batch environment, processing is abnormally
terminated with an operating system dump. System action
• In a CICS environment, the CEDA transaction is
User response abnormally terminated with a CICS transaction
dump.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on • In a batch environment, processing is abnormally
how to proceed. terminated with an operating system dump.

Module:
User response
DFHPUP
Ensure that module DFHEITSP is in the library and is
APUD
valid for this release of CICS.
Module:

Chapter 1. Transaction abend codes 201


DFHPUP System action
APUG • In a CICS environment, the CEDA transaction is
abnormally terminated with a CICS transaction
Explanation dump.
• In a batch environment, processing is abnormally
An internal error was detected in module DFHPUP.
terminated with an operating system dump.
Storage could not be obtained for the CSD record
buffer.
User response
System action If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
• In a CICS environment, the CEDA transaction is
how to proceed.
abnormally terminated with a CICS transaction
dump. Module:
• In a batch environment, processing is abnormally DFHPUP
terminated with an operating system dump. APUJ

User response Explanation


If you need further assistance from IBM to resolve this An internal error was detected in module DFHPUP.
problem, see IBM problem support for guidance on Storage cannot be freed for the CSD record buffer.
how to proceed.
Module: System action
DFHPUP
• In a CICS environment, the CEDA transaction is
APUH abnormally terminated with a CICS transaction
dump.
Explanation • In a batch environment, processing is abnormally
terminated with an operating system dump.
An internal error was detected in module DFHPUP.
Storage could not be obtained for the argument list.
User response
System action If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
• In a CICS environment, the CEDA transaction is
how to proceed.
abnormally terminated with a CICS transaction
dump. Module:
• In a batch environment, processing is abnormally DFHPUP
terminated with an operating system dump. APUK

User response Explanation


If you need further assistance from IBM to resolve this • In a CICS environment, storage could not be
problem, see IBM problem support for guidance on acquired for a buffer to contain logged RDO
how to proceed. commands in the CEDA transaction.
Module: • In a batch environment, storage could not be
DFHPUP acquired for a buffer to contain back-translated
resource definitions from the CSD.
APUI

System action
Explanation
• In a CICS environment, the CEDA transaction is
An internal error was detected in module DFHPUP.
abnormally terminated with a CICS transaction
Storage cannot be freed for the argument list.
dump.
• In a batch environment, processing is abnormally
terminated with an operating system dump.

202 CICS TS for z/OS: CICS Codes


User response 2. If you need further assistance from IBM to resolve
this problem, see IBM problem support for
If you need further assistance from IBM to resolve this
guidance on how to proceed.
problem, see IBM problem support for guidance on
how to proceed. Module:
DFHPUP
Module:
DFHPUP APUM
APUL
Explanation
Explanation Refer to the description of abend APUL.
Note: System action:
The description of this abend also applies to APUM, User response:
APUN and APUO.
Module:
CICS cannot find a match for a function code in the DFHPUP
language definition table, because the parameterized
APUN
resource definition contains an unrecognized resource
type code.
Explanation
The abend code issued depends on the DFHPUP
operation that was invoked before the error occurred: Refer to the description of abend APUL.

Abend System action:


DFHPUP operation User response:
APUL Module:
FLATTEN DFHPUP
APUM APUO
TRANCASE
Explanation
APUN
Refer to the description of abend APUL.
COMPARE
System action:
APUO
User response:
BACKTRANS
Module:
The cause of the abend is either: DFHPUP
1. A language definition table (DFHEITSP or APUP
DFHEITCU) in the library is invalid for the CICS
release you are running, or
Explanation
2. A CICS logic error has occurred.
An internal error occurred in DFHPUP processing of
the language definition table for RDO. There was a
System action stack error building a keyword list for the syntax tree.
• In a CICS environment, the CEDA transaction is
abnormally terminated with a CICS transaction System action
dump.
• In a CICS environment, the CEDA transaction is
• In a batch environment, processing is abnormally abnormally terminated with a CICS transaction
terminated with an operating system dump. dump.
• In a batch environment, processing is abnormally
User response terminated with an operating system dump.
Your response depends on which of the two possible
reasons apply:
1. Ensure that the DFHEITSP and DFHEITCU modules
in the library are valid for this release of CICS.

Chapter 1. Transaction abend codes 203


User response Explanation
If you need further assistance from IBM to resolve this An internal error occurred in DFHPUP processing of a
problem, see IBM problem support for guidance on CSD record buffer. The integer data length for a
how to proceed. keyword field is invalid.
Module:
DFHPUP System action

APUQ • In a CICS environment, the CEDA transaction is


abnormally terminated with a CICS transaction
dump.
Explanation
• In a batch environment, processing is abnormally
An internal error occurred in DFHPUP processing of terminated with an operating system dump.
the language definition table for RDO. Too many
keywords found in syntax expansion.
User response

System action Ensure that the module DFHEITSP is in the library and
is valid for this release of CICS.
• In a CICS environment, the CEDA transaction is
abnormally terminated with a CICS transaction Module:
dump. DFHPUP
• In a batch environment, processing is abnormally APUT
terminated with an operating system dump.
Explanation
User response
An internal error occurred in DFHPUP processing of an
If you need further assistance from IBM to resolve this argument list or a CSD record buffer. The keyword
problem, see IBM problem support for guidance on existence bit number, which is the KEP(1) value in
how to proceed. language definition table DFHEITSP, is not valid.
Module:
DFHPUP System action

APUR • In a CICS environment, the CEDA transaction is


abnormally terminated with a CICS transaction
dump.
Explanation
• In a batch environment, processing is abnormally
An internal error occurred in DFHPUP processing of an terminated with an operating system dump.
argument list or a CSD record buffer. The data type for
a keyword field conflicts with the data type specified in
User response
the language definition table.
Ensure that the module DFHEITSP is in the library and
System action is valid for this release of CICS.

• In a CICS environment, the CEDA transaction is Module:


abnormally terminated with a CICS transaction DFHPUP
dump. APUZ
• In a batch environment, processing is abnormally
terminated with an operating system dump. Explanation
CICS has found an unrecognized resource type code in
User response
a CSD record. The unrecognized code does not match
Ensure that the module DFHEITSP is in the library and any of the function codes in the language definition
is valid for this release of CICS. table. This abend can occur for one of the following
reasons:
Module:
DFHPUP 1. You are using a CICS release that does not support
a type of definition that was created on the CSD file
APUS
by a later CICS release.

204 CICS TS for z/OS: CICS Codes


2. The language definition table (DFHEITSP or 3. If you need further assistance from IBM to resolve
DFHEITCU) is invalid for this CICS release. this problem, see IBM problem support for
3. The CSD manager (DFHDMP) has passed an invalid guidance on how to proceed.
CSD record buffer to DFHPUP. This is a CICS Module:
internal logic error. DFHPUP
APXA
System action
• In a CICS environment, the CEDA transaction is Explanation
abnormally terminated with a CICS transaction
dump The user transaction's profile could not be found.

• In a batch environment, processing is abnormally


System action
terminated with an operating system dump.
The task is abnormally terminated with a CICS
User response transaction dump. The user transaction is not started.

Determine which of the possible reasons caused the


User response
error. If you can eliminate reasons 1 and 2, you can
assume that reason 3 applies. Check that the profile name in the user transaction
definition is correct, and that this profile has been
Take action corresponding to the reason you have
established as follows: defined.
Module:
1. Avoid operations on groups containing definition-
DFHAPXM
types that are unsupported by the CICS release you
are running.
2. Ensure that the library contains versions of
DFHEITSP and DFHEITCU that are valid for the
CICS release you are running.

ARxx abend codes


ARCB User response
If the associated message indicates that program
Explanation DFHEDP could not be found, check that IBM-supplied
CICS has attempted to enable a task-related user exit, group DFHEDP is included in the group list used at
or a global user exit during initialization, but failed CICS cold or initial start time.
because the exit program could not be found. If the associated message indicates that program
On all types of start, CICS attempts to enable DFHEDP, DFHLETRU could not be found, check that IBM-
the EXEC DLI task-related user exit and DFHLETRU, supplied group DFHMISC is included in the group list
the language environment task-related user exit. On used at CICS cold or initial start time.
an emergency restart, CICS enables transaction For transaction backout exit programs, including the
backout exit programs as specified by the first two file control backout programs, ensure the program has
TBEXITS system initialization parameters. been defined and is in a library available to CICS.
On all types of start, CICS attempts to enable file If necessary, use the dump to find out why the exit
control backout programs as specified by the third, program could not be enabled.
fourth, fifth and sixth TBEXITS system initialization
parameters. Module:
DFHRCEX
System action ARHA
CICS issues a message to the console indicating which
exit program is involved. CICS initialization then Explanation
terminates abnormally with a system dump. The SAA resource recovery interface has been invoked
with an invalid first parameter. The first parameter

Chapter 1. Transaction abend codes 205


should be the code of the function to be performed. User response
This is a CICS internal logic error.
A level 2 trace for 'CP' of the transaction shows the
course of events before this error occurred (such as
System action the modules called and their parameters) plus details
The transaction is abnormally terminated with a CICS of the error itself. If you need further assistance from
transaction dump. IBM to resolve this problem, see IBM problem support
for guidance on how to proceed.
User response Module:
DFHCPIR
A level 2 trace for 'CP' of the transaction shows the
course of events before this error occurred (such as ARLA
the modules called and their parameters) plus details
of the error itself. If you need further assistance from Explanation
IBM to resolve this problem, see IBM problem support
for guidance on how to proceed. An error has occurred obtaining a lock within the
Resource Lifecycle domain.
Module:
DFHCPIR
System action
ARHB
CICS abnormally terminates the task. CICS processing
continues.
Explanation
The SAA resource recovery interface has been invoked User response
with an invalid number of parameters for the call.
Contact your local IBM support center for assistance.

System action Module:


DFHRLDM
the transaction is abnormally terminated with a CICS
transaction dump. ARLB

User response Explanation

The exception trace point produced with this abend An error has occurred releasing a lock within the
contains the SAA resource recovery verb name that Resource Lifecycle domain.
was issued incorrectly. Use this to determine where
the application program was in error and amend System action
application program accordingly. The Systems
CICS abnormally terminates the task. CICS processing
Application Architecture Common Programming
continues.
Interface Resource Recovery Reference, SC31-6821,
provides a detailed description of the SAA resource
recovery verbs and how they should be called. User response

Module: Contact your local IBM support center for assistance.


DFHCPIR Module:
ARHC DFHRLDM
ARLC
Explanation
The SAA resource recovery interface has detected an Explanation
unexpected return code from the syncpoint program. An attempt has been made to run the CICS internal
This is a CICS internal logic error. task CRLR as a user transaction.

System action System action


The transaction is abnormally terminated with a CICS CICS terminates the task with a transaction dump.
transaction dump.

206 CICS TS for z/OS: CICS Codes


User response User response
Investigate why the attempt was made to run CRLR as See the user response for the message.
a user transaction.
Module:
Module: DFHRPMS
DFHRLRP
ARP4
ARLD
Explanation
Explanation
The server controller has performed an exception
The Resource Lifecycle resolution transaction, CRLR, disable because of an internal error.
experienced a failure.
System action
System action
One of the following messages is issued: DFHRP0503,
CICS terminates the task with a transaction dump. DFHRP0559, DFHRP0697, DFHRP0726, DFHRP0728,
DFHRP0730, DFHRP0741.
User response
User response
Contact your local IBM support center for assistance.
You need further assistance from IBM to resolve this
Module:
problem. See External Interfaces Guide and IBM
DFHRLRP
problem support for guidance on how to proceed.
ARM0
Module:
DFHRPMS
Explanation
ARP5
An attempt was made to attach a transaction
specifying DFHRMXN3 as the program to be given
Explanation
control, but the transaction was not internally
attached by CICS. An invalid attempt was made to start the server
controller.
DFHRMXN3 is for use by CICS system transaction
CSKP. This provides support for activity keypoints,
System action
System action The following message is issued: DFHRP0640.
The transaction is abnormally terminated. CICS
processing continues. User response
See the user response for the message.
User response
Module:
Establish why an attempt was made to attach CSKP DFHRPMS
incorrectly, or why a transaction definition specified
ARP9
DFHRMXN3 as the program to be given control.
Module: Explanation
DFHRMXN3
There was not enough storage for the connection
ARP2 manager.

Explanation System action


The server controller detected an internal error during None.
CICS ONC RPC enable processing.
User response
System action
You need further assistance from IBM to resolve this
One of the following messages is issued: DFHRP0508, problem. See External Interfaces Guide and IBM
DFHRP0509, DFHRP0528, DFHRP0529, DFHRP0590, problem support for guidance on how to proceed.
DFHRP0591.

Chapter 1. Transaction abend codes 207


Module: • The CICS program was on a different system from
DFHRPC01 CICS ONC RPC, and the specified system name was
not valid.
ARPA
• The converter program name was not valid.
Explanation • The converter program is defined as remote.
An unexpected response from DFHSUSN has occurred • The alias is not authorized to use the converter
when trying to sign off a user of the CRTE transaction
in the target system when processing a CANCEL System action
request.
One of the following messages is issued: DFHRP0121,
This abend can be caused by incorrect use of the DFHRP0131, DFHRP0138, DFHRP0139, DFHRP0141,
VTAM VARY INACT command. Otherwise it indicates DFHRP0156, DFHRP0157, DFHRP0159.
that there may be an error in CICS.
User response
System action
See the user response for the message.
The CSSF transaction (CRTE cancel processor
Module:
transaction) is terminated with an ARPA abend.
DFHRPAS

User response ARPH

Ensure that the VTAM VARY inact command is used


Explanation
correctly. If this is not the cause of the abend, you
need further assistance from IBM to correct this The alias detected a global work area error.
problem. See IBM problem support for guidance on
how to proceed. System action
Module: The following message is issued: DFHRP0118.
DFHRTC
ARPF User response
See the user response for the message.
Explanation
Module:
The alias could not be initialized. DFHRPAS
ARPI
System action
One of the following messages is issued: DFHRP0103, Explanation
DFHRP0104, DFHRP0106, DFHRP0108, DFHRP0109.
The alias detected a logic error.
User response
System action
See the user response for the message.
One of the following messages is issued: DFHRP0107,
Module: DFHRP0133, DFHRP0135, DFHRP0137, DFHRP0143,
DFHRPAS DFHRP0144, DFHRP0148, DFHRP0149, DFHRP0155,
ARPG DFHRP0164, DFHRP0168, DFHRP0170.

Explanation User response

The alias was not able to link to the CICS program or See the user response for the message.
the Encode function of the converter one of the Module:
following reasons: DFHRPAS
• The userid supplied for the alias was not valid. ARPJ
• The CICS program is not defined as a resource to the
external security manager. Explanation
• The CICS program name is not valid. The alias ends for one of the following reasons:

208 CICS TS for z/OS: CICS Codes


• An unexpected response was received from CICS Explanation
during transaction initialization.
The alias detected an error in user code.
• The external security manager is no longer available.
• The remote CICS region in which the CICS program System action
was running abended.
One of the following messages is issued: DFHRP0161,
• The CICS program, which was running in a remote DFHRP0162, DFHRP0163, DFHRP0169.
CICS region, abended.
• The reply could not be sent to the client. User response
See the user response for the message.
System action
Module:
One of the following messages is issued: DFHRP0105, DFHRPAS
DFHRP0132, DFHRP0136, DFHRP0140, DFHRP0145,
DFHRP0146, DFHRP0147, DFHRP0150, DFHRP0165, ARPN
DFHRP0166, DFHRP0167.
Explanation
User response The alias detected an error while trying to switch
See the user response for the message. TCBs.
Module:
DFHRPAS System action

ARPK The following message is issued: DFHRP0151.

Explanation User response

The alias detected a CICS logic error. See the user response for the message.
Module:
System action DFHRPAS
One of the following messages is issued: DFHRP0102, ARPO
DFHRP0122, DFHRP0142, DFHRP0160.
Explanation
User response The alias program detected an abend.
See the user response for the message.
Module: System action
DFHRPAS One of the following messages is issued: DFHRP0181,
ARPL DFHRP0182, DFHRP0183.

Explanation User response

The alias detected an authorization error. See the user response for the message.
Module:
System action DFHRPAS
One of the following messages is issued: DFHRP0119, ARPU
DFHRP0120, DFHRP0132, DFHRP0134.
Explanation
User response
The connection manager could not access the CICS
See the user response for the message. ONC RPC data set, and received an error response
when it tried to send message DFHRP1512.
Module:
DFHRPAS
System action
ARPM
None.

Chapter 1. Transaction abend codes 209


User response DFHRPC01
You need further assistance from IBM to resolve this ARPZ
problem. See External Interfaces Guide and IBM
problem support for guidance on how to proceed. Explanation
Module: The connection manager has insufficient authority.
DFHRPC01
ARPV System action
The following message is issued: DFHRP1902.
Explanation
The connection manager received an unexpected User response
response from CICS following an EXEC CICS
See the user response for the message.
command.
Module:
System action DFHRPC0B

One of the following messages is issued: DFHRP1540, ARSA


DFHRP1651, DFHRP1954.
Explanation
User response An attempt has been made to invoke the CRST
See the user response for the message. transaction from a terminal. CRST is an internal CICS
transaction and cannot be invoked in this way.
Module:
DFHRPC0E
System action
ARPW
The task is abnormally terminated.

Explanation
User response
The connection manager received an unexpected
None.
response from CICS following an EXEC CICS
command. Module:
DFHRSTK
System action ARTA
The following message is issued: DFHRP1969.
Explanation
User response The task does not own a terminal as its principal
See the user response for the message. facility.

Module:
System action
DFHRPC0E
The task is abnormally terminated with a CICS
ARPX
transaction dump.

Explanation
User response
The connection manager was started against an invalid
Ensure that DFHRTE has not been specified as the
terminal.
program for a task other than CRTE. Ensure that CRTE
has not been initiated by means other than terminal
System action input.
The following message is issued: DFHRP1522. Module:
DFHRTE
User response
ARTB
See the user response for the message.
Module:

210 CICS TS for z/OS: CICS Codes


Explanation Explanation
There is no input TIOA or the data length is zero. An error was encountered when attempting to read
from or write to temporary storage.
System action
System action
The task is abnormally terminated with a CICS
transaction dump. The task is abnormally terminated with a CICS
transaction dump.
User response
User response
Ensure that DFHRTE has not been specified as the
program for a task other than CRTE. Ensure that CRTE Determine the cause of the temporary storage
has not been initiated by means other than terminal problem and correct it.
input.
Module:
Module: DFHRTE
DFHRTE
ARTF
ARTC
Explanation
Explanation
An attempt has been made to use the routing
The link to the required system is not usable for an transaction (CRTE) from a terminal that has a
unknown reason. permanent transaction code set.

System action System action


The task is abnormally terminated with a CICS The task is abnormally terminated with a CICS
transaction dump. transaction dump.

User response User response


If you need further assistance from IBM to resolve this Inform the system programmer.
problem, see IBM problem support for guidance on
Module:
how to proceed.
DFHRTE
Module:
ARTG
DFHRTE
ARTD Explanation
CICS could not find the profile specified for a
Explanation
transaction being routed.
An internal logic error has been detected.
System action
System action
CICS terminates the task abnormally with a dump.
The task is abnormally terminated with a CICS
transaction dump. User response
Check your transaction and profile definitions.
User response
Module:
If you need further assistance from IBM to resolve this
DFHRTE
problem, see IBM problem support for guidance on
how to proceed. ARTH
Module:
DFHRTE Explanation

ARTE An error (INVALID, DISASTER or EXCEPTION


response) has occurred on a call to schedule a remote
terminal delete by DFHRTE during sign-off for a

Chapter 1. Transaction abend codes 211


surrogate terminal session running CRTE. The domain DFHXMXM
that detected the original error provides an exception
ARUC
trace, a console message and, possibly, a system
dump (depending on the options specified in the dump
table). Explanation
A RUN SYNCHRONOUS command caused an attempt
System action to attach a transaction with an invalid USERID.
CICS terminates the task abnormally with a dump.
System action
User response CICS terminates the invoked transaction abnormally
with a dump. The RUN SYNCHRONOUS command that
See the related message produced by the domain that
was issued by the application returns with a resp2
detected the original error.
value of 27.
Module:
DFHRTE User response
ARUA More details can be found in the trace.
Module:
Explanation
DFHXMRU
An exception condition was returned on the ADD_LINK
ARUD
during the BIND phase of ATTACH for the transaction
invoked by the RUN command.
Explanation
System action A RUN SYNCHRONOUS command caused an attempt
to attach a child transaction. The parent transaction
CICS terminates the invoked transaction abnormally
which issued the RUN SYNCHRONOUS command was
with a dump. The RUN SYNCHRONOUS command that
then purged before the child task could be run.
was issued by the application returns with an error
response of INVREQ (RESP2 28).
System action
User response CICS terminates the invoked transaction abnormally
with a dump.
More details can be found in the trace.
Module: User response
DFHXMRU
None
ARUB
Module:
DFHXMXM
Explanation
ARXA
A RUN SYNCHRONOUS command caused an attempt
to attach a transaction defined as remote. Only
transactions defined as local may be run Explanation
synchronously. A transactional EXCI request has been received from a
batch region. CICS has encountered an error when
System action attempting to express interest in an RRMS Unit of
Recovery.
CICS terminates the invoked transaction abnormally
with a dump. The RUN SYNCHRONOUS command that DFHRXUW provides an exception trace, console
was issued by the application returns with an error message DFHRX0002, and possibly a system dump
response of ACTIVITYERR or PROCESSERR (RESP2 (depending on the options in the dump table).
27).
System action
User response
The transaction is terminated with a CICS transaction
More details can be found in the trace. dump.
Module:

212 CICS TS for z/OS: CICS Codes


User response System action
Resource Recovery Services (RRS) may have been shut The transaction is terminated with a CICS transaction
down after the request was received by CICS. If this is dump.
the case, retry the EXCI request once RRS has been
restarted. User response
If this is not the case, use the exception trace provided If CICS was started with system initialization
by the RX domain to determine the reason for the parameter RRMS=NO, restart CICS specifying
failure. You might need further assistance from IBM in RRMS=YES (or route transactional EXCI requests to
this situation. See IBM problem support for guidance another CICS system).
on how to proceed.
Otherwise, investigate why the RX domain did not
Module: initialize succesfully. A failure during initialization of
DFHRXUW the domain is accompanied by a console message and
ARXB a system dump. See IBM problem support for
guidance on how to proceed.
Explanation Module:
DFHRXUW
An error (EXCEPTION, DISASTER, INVALID,
KERNERROR or PURGED) has occurred on an ARZ2
ADD_LINK call to the recovery manager (RM) domain.
For errors other than EXCEPTION, the RM domain Explanation
provides an exception trace, a console message, and
possibly a system dump (depending on the options in An attempt to service a GIOP request failed during
the dump table). task attach due to required resources being
unobtainable, or missing information from request
For all errors, DFHRXUW provides an exception trace, data.
console message DFHRX0002, and possibly a system
dump (depending on the options in the dump table).
System action

System action The request fails and the task is abnormally


terminated with abend code ARZ2. CICS takes a
The transaction is terminated with a CICS transaction transaction dump, unless module DFHDUIO is not
dump. loaded.

User response User response


See IBM problem support for guidance on how to Use the transaction dump to determine the cause of
proceed. the failure. For further assistance, or if module
Module: DFHDUIO is not loaded and no transaction dump is
DFHRXUW available, contact your system programmer.

ARXC Module:
DFHRZXM
Explanation ARZ3
A transactional EXCI request has been received from a
batch region when either: Explanation

• CICS did not register as a resource manager with An attempt to service a GIOP request failed during
Recoverable Resource Management Services (RRMS) task attach due to required resources being
because system initialization parameter RRMS=NO unobtainable, or missing information from request
was specified. data.
• the RX domain did not succesfully complete its
initialization. System action
The request fails and the task is abnormally
terminated with abend code ARZ3. CICS takes a
transaction dump, unless module DFHDUIO is not
loaded.

Chapter 1. Transaction abend codes 213


User response ARZE
Use the transaction dump to determine the cause of
the failure. For further assistance, or if module Explanation
DFHDUIO is not loaded and no transaction dump is A command has failed due to a serious failure in a
available, contact your system programmer. CICS component (resource manager).
Module:
DFHRZIX, DFHRZTCX System action
ARZ4 The transaction is abnormally terminated with abend
code ARZE. CICS takes a transaction dump, unless
Explanation module DFHDUIO is not loaded.

An attempt to service a GIOP request failed during


User response
task attach due to required resources being
unobtainable, or missing information from request Use the transaction dump to determine the cause of
data. the failure. For further assistance, or if module
DFHDUIO is not loaded and no transaction dump is
System action available, contact your system programmer.

The request fails and the task is abnormally Module:


terminated with abend code ARZ4. CICS takes a DFHRZLN, DFHRZRM, DFHRZSO, DFHRZSO1,
transaction dump, unless module DFHDUIO is not DFHRZTA, DFHRZXM
loaded. ARZF

User response Explanation


Use the transaction dump to determine the cause of A command has failed due to a serious failure in a
the failure. For further assistance, or if module CICS component (resource manager).
DFHDUIO is not loaded and no transaction dump is
available, contact your system programmer.
System action
Module:
DFHRZRM, DFHRZSO1 The transaction is abnormally terminated with abend
code ARZF. CICS takes a transaction dump, unless
ARZ5 module DFHDUIO is not loaded.

Explanation User response


The target request stream task detected that the Use the transaction dump to determine the cause of
source task was no longer active. The target task is the failure. For further assistance, or if module
unable to process the request it was attached for. DFHDUIO is not loaded and no transaction dump is
available, contact your system programmer.
System action Module:
The request fails and the task is abnormally DFHRZLN, DFHRZRM, DFHRZSO, DFHRZSO1,
terminated with abend code ARZ5. CICS takes a DFHRZTA, DFHRZXM
transaction dump, unless module DFHDUIO is not ARZI
loaded.
Explanation
User response
A command has failed due to a serious failure in a
Investigate why the source task has terminated before CICS component (resource manager).
this target began initialisation. There may be relevant
messages in the CICS log. Otherwise a CICS trace or
system dump will be required to identify the problem. System action
One possible cause is that the source task was timed The transaction is abnormally terminated with abend
out and purged before the target task started. code ARZI. CICS takes a transaction dump, unless
Module: module DFHDUIO is not loaded.
DFHRZXM

214 CICS TS for z/OS: CICS Codes


User response System action
Use the transaction dump to determine the cause of The transaction is abnormally terminated with abend
the failure. For further assistance, or if module code ARZJ. CICS takes a transaction dump, unless
DFHDUIO is not loaded and no transaction dump is module DFHDUIO is not loaded.
available, contact your system programmer.
Module: User response
DFHRZLN, DFHRZRM, DFHRZSO, DFHRZSO1, Use the transaction dump to determine the cause of
DFHRZTA, DFHRZXM the failure. For further assistance, or if module
ARZJ DFHDUIO is not loaded and no transaction dump is
available, contact your system programmer.
Explanation Module:
DFHRZLN, DFHRZRM, DFHRZSO, DFHRZSO1,
A command has failed due to a serious failure in a
DFHRZTA, DFHRZXM
CICS component (resource manager).

ASxx abend codes


ASCA Investigate the earlier failure (which is accompanied
by a console message and a system dump).
Explanation Module:
A DFHSC TYPE=GETMAIN request has resulted in a DFHSMSCP
call to the storage manager (SM) domain which has ASCP
returned an INVALID or DISASTER response.
Explanation
System action
A task which has issued an unconditional DFHSC
The transaction is terminated with a CICS transaction TYPE=GETMAIN request has been purged while
dump. waiting for sufficient contiguous main storage to
become free.
User response
There has been an earlier failure which led to the System action
response from the storage manager domain. The task is abnormally terminated with a CICS
Investigate the earlier failure (which is accompanied transaction dump.
by a console message and a system dump).
Module: User response
DFHSMSCP Investigate why the task was purged. This will either
ASCB have been as a result of a purge from the master
terminal operator via the CEMT transaction, or by the
Explanation task being timed out after waiting for longer than the
DTIMOUT (deadlock timeout) value specified for the
A DFHSC TYPE=FREEMAIN request has resulted in a transaction.
call to the storage manager (SM) domain which has
returned an INVALID or DISASTER response. If the task was purged by the master terminal operator
then this may have been in an attempt to clear the
system which appeared to be deadlocked for some
System action reason.
The transaction is terminated with a CICS transaction If the task was timed out automatically as a result of
dump. the DTIMOUT value being exceeded then this may be
due to insufficient main storage being available for the
User response number of tasks in the system. If the amount of main
There has been an earlier failure which led to the storage cannot be increased then the number of tasks
response from the storage manager domain. in the system should be reduced to avoid short-on-
storage situations. Another possibility would be to

Chapter 1. Transaction abend codes 215


increase the value of the DTIMOUT option for the User response
transaction.
If you need further assistance from IBM to resolve this
Module: problem, see IBM problem support for guidance on
DFHSMSCP how to proceed.
ASCR Module:
DFHSFP
Explanation ASFB
A DFHSC macro request has been issued with an
invalid request type. Explanation
An attempt was made to execute the CICS signoff
System action program without an associated terminal.
The transaction is terminated with a CICS transaction
dump. System action
Detection of the invalid request by DFHSMSCP causes CICS terminates the transaction with a dump. This
a console message and a system dump to be abend code is usually accompanied by message
produced. DFHCE3598.

User response User response


Use the associated console message and system Only use the signoff program when there is a related
dump to investigate the problem. terminal.
Module: Module:
DFHSMSCP DFHSFP
ASDA ASFC

Explanation Explanation
The default shutdown transaction (CESD) has been An attempt was made to execute the CICS signoff
started directly from a terminal. This is not permitted. program against an APPC session.
This transaction can only be started internally by CICS.
System action
System action
CICS terminates the transaction with a dump. This
The transaction is abnormally terminated with a abend code is usually accompanied by message
transaction dump. DFHCE3598.

User response User response


None. Only use the signoff program when there is a related
terminal.
Module:
DFHCESD Module:
DFHSFP
ASFA
ASH2
Explanation
Explanation
An internal logic error occurred in DFHSFP because of
an unexpected response from EXEC CICS. This abend An attempt to service a Scheduler Services request
code is usually accompanied by message DFHCE3598 failed due to required resources being unobtainable.
which contains the associated return codes. This may result in a request being unserviceable or an
Activity being marked abended depending on the
System action nature of the failure.

The transaction is abnormally terminated with a CICS


transaction dump.

216 CICS TS for z/OS: CICS Codes


System action ASHA
The transaction is abnormally terminated with abend
code ASH2. CICS takes a transaction dump, unless Explanation
module DFHDUIO is not loaded. A command has failed due to a serious failure in a
CICS component (resource manager).
User response
Check that any required links between regions are System action
available. Check the Distributed Routing Program The transaction is abnormally terminated with abend
name is correct and the program is usable. Use the code ASHA. CICS takes a transaction dump, unless
transaction dump to determine the cause of the module DFHDUIO is not loaded.
failure. For further assistance, or if module DFHDUIO
is not loaded and no transaction dump is available,
User response
contact your system programmer.
Use the transaction dump to determine the cause of
Module:
the failure. For further assistance, or if module
DFHSHXM
DFHDUIO is not loaded and no transaction dump is
ASH3 available, contact your system programmer.
Module:
Explanation DFHSHDM
A transaction bound to a Scheduler Services request ASHB
has backed out. No other abend code has been set.
The SH abend request uses this abend code by
default. Explanation
A command has failed due to a serious failure in a
System action CICS component (resource manager).
The transaction continues backing out. A subsequent
task will process the SH abend request. System action
The transaction is abnormally terminated with abend
User response code ASHB. CICS takes a transaction dump, unless
module DFHDUIO is not loaded.
None.
Module: User response
DFHSHRM
Use the transaction dump to determine the cause of
ASH4 the failure. For further assistance, or if module
DFHDUIO is not loaded and no transaction dump is
Explanation available, contact your system programmer.

A Scheduler Services request attempted to attach a Module:


transaction that is currently disabled. DFHSHDM
ASHR
System action
The transaction is abnormally terminated with abend Explanation
code ASH4. CICS takes a transaction dump, unless A command has failed due to a serious failure in a
module DFHDUIO is not loaded. CICS component (resource manager).

User response System action


Check the status of the transaction. For further The transaction is abnormally terminated with abend
assistance, or if module DFHDUIO is not loaded and no code ASHR. CICS takes a transaction dump, unless
transaction dump is available, contact your system module DFHDUIO is not loaded.
programmer.
Module:
DFHSHXM

Chapter 1. Transaction abend codes 217


User response Explanation
Use the transaction dump to determine the cause of An attempt has been made to run the CICS internal
the failure. For further assistance, or if module task CPLT as a user transaction.
DFHDUIO is not loaded and no transaction dump is
available, contact your system programmer. System action
Module: CICS terminates the task with a transaction dump.
DFHSHRSP
ASHU User response
Investigate why the attempt was made to run CPLT as
Explanation a user transaction.
In the process of transferring the request from one Module:
region to another an abend occurred due to a routing DFHSIPLT
failure. The Request cannot be routed to a suitable
region. The request is unserviceable. ASJ7

System action Explanation

The transaction is abnormally terminated with abend An error has caused the JVM server to receive a
code ASHU. CICS takes a transaction dump, unless SIGABRT signal.
module DFHDUIO is not loaded.
System action
User response CICS produces a system dump and terminates
Check the links between regions are available. Check immediately.
the Distributed Routing Program name is correct and
the program is usable. Use the transaction dump to User response
determine the cause of the failure. For further
Contact IBM support.
assistance, or if module DFHDUIO is not loaded and no
transaction dump is available, contact your system Module:
programmer. DFHSJSC
Module: ASJA
DFHSHRSP
ASIA Explanation
An error has occurred obtaining a lock within the Java
Explanation domain.
An error has occurred on a call to the storage manager
(SM) domain. The domain that detected the original System action
error will have provided an exception trace, a console CICS abnormally terminates the task. CICS processing
message and, possibly, a system dump (depending on continues.
the options specified in the dump table).
User response
System action
Contact your local IBM support center for assistance.
The task is abnormally terminated with a CICS
transaction dump. CICS then terminates abnormally. Module:
DFHSJST
User response ASJB
See the related message from the domain that
detected the original error. Explanation

Module: An error has occurred releasing a lock within the Java


DFHSII1 domain.

ASIB

218 CICS TS for z/OS: CICS Codes


System action User response
CICS abnormally terminates the task. CICS processing See the related message produced by the domain that
continues. detected the original error.
Module:
User response DFHSJJS
Contact your local IBM support center for assistance. ASJO
Module:
DFHSJST Explanation
ASJH The JVMServer resolution transaction CJSR, has
encountered an internal error.
Explanation The CICS system transaction CJSR provides support
A JVM has terminated due to a program check or other for initializing new JVMServers. If this fails it is likely
reason. that there is an underlying error with the CICS system.

System action System action

CICS terminates the task with a transaction dump. The transaction is abnormally terminated. CICS
processing continues.
User response
User response
Check the JVM's STDOUT and STDERR files, and any
JVM dumps for further information. See the related message produced by the domain that
detected the original error.
Module:
DFHSJIN Module:
DFHSJIT
ASJI
ASJS
Explanation
Explanation
Program DFHSJJI was called using EXEC CICS LINK,
but no channel was provided. A Java application running in a JVMSERVER invoked
the System.exit() method.
System action
System action
CICS terminates the task with a transaction dump.
CICS produces a system dump and terminates
immediately.
User response
Change the application program to pass the correct User response
channel.
Change the application to avoid invoking System.exit(),
Module: or implement a Java Security Manager to prevent
DFHSJJI System.exit() from being invoked.
ASJL Module:
DFHSJSC
Explanation
ASJR
An error has occurred after linking to an application
running in Liberty.CICS issues this abend in order to Explanation
release resources associated with the task that issued
the LINK. DFHSJJS was invoked by a caller running within a JVM
server. While the request was being processed, the
JVM server terminated. DFHSJJS is not able to return
System action
control to the caller in the usual manner.
CICS abnormally terminates the task. CICS processing
continues.

Chapter 1. Transaction abend codes 219


System action System action
The transaction is abnormally terminated. CICS CICS terminates the transaction with a dump. This
processing continues. abend code is usually accompanied by message
DFHCE3548.
User response
User response
None.
If you need further assistance from IBM to resolve this
Module:
problem, see IBM problem support for guidance on
DFHSJJS
how to proceed.
ASNA
Module:
DFHSNP
Explanation
ASND
An internal logic error occurred in DFHSNP because of
an unexpected response from EXEC CICS.
Explanation

System action A request from DFHSNTU to ENQ on the address of the


SNEX has failed during signoff terminal user.
CICS terminates the transaction with a dump. This
abend code is usually accompanied by message
System action
DFHCE3548.
A transaction dump is taken and the task which issued
User response the signoff is abended.

If you need further assistance from IBM to resolve this


User response
problem, see IBM problem support for guidance on
how to proceed. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
Module:
how to proceed.
DFHSNP
Module:
ASNB
DFHSNTU

Explanation ASOA

An attempt was made execute the CICS sign on


Explanation
program without an associated terminal. This abend
code is usually accompanied by message DFHCE3548. The TCP/IP listener task CSOL has been incorrectly
started from a terminal. It can only be enabled by the
System action Sockets Domain at CICS system initialization or by
using CEMT SET TCPIP OPEN or the equivalent SPI
CICS terminates the transaction with a dump. function.

User response System action


Only use the sign on program when there is a related The transaction is abnormally terminated with a
terminal. transaction dump.
Module:
DFHSNP User response
ASNC None.
Module:
Explanation DFHSOL
The signon program attempted to send a request to ASOB
the user but failed to do so.

220 CICS TS for z/OS: CICS Codes


Explanation Explanation
The Sockets Domain has encountered a locking error The TCP/IP listener task CSOL has abended.
while attempting to issue a lock.
System action
System action
The transaction is abnormally terminated with a
The transaction is abnormally terminated with a transaction dump.
transaction dump.
User response
User response
Investigate why the transaction was abended. The
The exception trace prior to this abend gives more exception trace prior to this abend gives more
information as to why this abend was issued. information as to why this abend was issued.
Module: Module:
DFHSOCK DFHSODM DFHSOIS DFHSOLS DFHSOUE DFHSOL
DFHSOS00-23
ASP1
ASOC
Explanation
Explanation
Intersystem communication failed while a syncpoint
The TCP/IP listener task CSOL has encountered an was being taken. Communication with the coordinator
unlocking error while attempting to issue an unlock. system has been interrupted, and the failure occurred
during the critical indoubt period of syncpoint
System action processing. As a result this CICS system is in doubt
about the outcome of the unit of work for the
The transaction is abnormally terminated with a transaction.
transaction dump.
Alternatively, a transaction may have timed out while
waiting for Recoverable Resource Management
User response
Services (RRMS) to provide the outcome of the unit of
The exception trace prior to this abend gives more work, or RRMS may have failed during the critical
information as to why this abend was issued. indoubt period.
Module: The transaction definition specifies WAIT(YES) as an
DFHSOL indoubt attribute. Therefore the unit of work is not
completed but is shunted and allowed to wait for
ASOD
resynchronization with the coordinator system. If the
WAITTIME attribute is specified on the transaction
Explanation definition, the unit of work waits for the specified time.
The TCP/IP transaction attach module DFHSOXM If after that time the coordinator system has not
encountered an error during the bind stage of resynchronized, a unilateral decision is made about
transaction attach processing for a new task. the unit of work as specified by the ACTION keyword
on the transaction definition. A WAITTIME of zero, the
default, means an indefinite wait. The unit of work can
System action
also be forced to take a unilateral decision by means
The transaction is abnormally terminated with a of a CEMT SET UOW command.
transaction dump.
System action
User response
The transaction is abnormally terminated. The EXEC
The exception trace prior to this abend gives more CICS HANDLE ABEND command cannot handle this
information as to why this abend was issued. abend.
Module: The associated unit of work is shunted awaiting the
DFHSOXM return of the coordinator system. Recoverable
resources updated by the unit of work remain locked.
ASOL
The locks are released when the unit of work is backed
out or committed at resynchronization time, or when a
unilateral decision is made by this system.

Chapter 1. Transaction abend codes 221


Message DFHAC2201 is sent to the terminal end user ASP3
if possible, and message DFHAC2231 is sent to
transient data destination CSMT. Explanation
An application has requested syncpoint, either via
User response
EXEC CICS SYNCPOINT or implicitly via EXEC CICS
None. Any updates performed by the unit of work are RETURN. The coordinator of the syncpoint is not this
resolved automatically when resynchronization with CICS system but is remote. During the syncpoint
the coordinator system takes place. protocol the remote coordinator has decided that the
unit of work cannot be committed and must be backed
Alternatively, the user can force resolution of the
out.
updates independently of the coordinator system by
making a CEMT request to commit or back out the unit This error can occur with external resource managers
of work. connected to CICS via the resource manager interface
(RMI) as well as CICS systems connected via LU 6.2,
Module:
MRO and IPIC. If an external resource manager such
DFHAPAC
as DB2 is the only recoverable resource updated in the
ASP2 transaction, the recovery manager (RM) domain can
optimize the syncpoint protocol. In this instance, the
Explanation external resource manager becomes the syncpoint
coordinator. In this instance if the external resource
A syncpoint has been attempted when an intersystem manager returns with a backed out response, an ASP3
conversation is in a state in which the EXEC CICS abend results.
SYNCPOINT command is not allowed. If CICS is
connected to a system which must act as LAST
System action
AGENT, such as IMS, then this ABEND will be issued
from SYNCPOINT processing if a PREPARE has been The transaction is abnormally terminated and
received on a link to another system. In order to recoverable resources updated by the unit of work are
support syncpointing CICS must act as COORDINATOR backed out. The EXEC CICS HANDLE ABEND command
when it is directly connected to the LAST AGENT, the cannot handle this abend.
COORDINATOR system may send PREPARE syncpoint
Message DFHAC2220 is sent to the terminal end user
commands but never receives them.
if possible, and message DFHAC2250 is sent to
transient data destination CSMT.
System action
The task is abnormally terminated with a CICS User response
transaction dump which includes terminal control
Refer to the remote coordinator system to determine
information. In particular, the dump contains state
why the unit of work was backed out.
information for the links used by this transaction. The
EXEC CICS HANDLE ABEND command cannot handle Module:
this abend. DFHAPAC
ASP7
User response
Ensure that the application issues an EXEC CICS Explanation
SYNCPOINT command only when its sync level 2
conversations are in the correct state. The EXEC CICS A resource manager involved in syncpoint protocols
SYNCPOINT command may be issued only when each has replied 'No' to a request to 'Prepare'. The resource
conversation is in one of the following states: manager may be local to this CICS system, or may be a
remote resource manager on another CICS system, or
SEND an external resource manager communicating through
PEND-RECEIVE (Not for MRO) the resource manager interface (RMI).
PEND-FREE
SYNC-RECEIVE System action
SYNC-SEND (Not for MRO) CICS terminates the transaction abnormally.
SYNC-FREE Recoverable resources updated by the unit of work are
Module: backed out. The EXEC CICS HANDLE ABEND command
DFHAPAC cannot handle this abend.

222 CICS TS for z/OS: CICS Codes


If it is a local resource manager that has voted no, supporting sessions are allocated (e.g. issue an
message DFHAC2218 is sent to the terminal end user EXEC CICS FREE first), or
if possible, and message DFHAC2248 is sent to • Change the configuration so that either APPC or MRO
transient data destination CSMT. sessions are used for communication. These are the
If it is a remote resource manager that has voted no, only two session types which support syncpoint
message DFHAC2219 is sent to the terminal end user rollback.
if possible, and message DFHAC2249 is sent to Alternatively, following a session failure during a
transient data destination CSMT. previous syncpoint, CICS may have decided to rollback
this unit-of-work in order to preserve data integrity.
User response Since the unit-of-work contains a session which does
not support syncpoint rollback, this abend ensues. In
This abend is caused by a prior problem. For example:
this case, no action is required in response to this
• the resource manager cannot flush its buffers abend, although action may be required to deal with
because of an I/O error the original failure.
• the resource manager cannot communicate with Module:
CICS because of a TP failure. DFHAPAC
• Event Processing is unable to emit a synchronous ASP9
event
Inspect the CICS message log to determine the cause Explanation
of the earlier problem and corrrect it. An ASP7 can also
occur during terminal or connection install if CICS is The transaction requested syncpoint via EXEC CICS
short on storage. For instance if message DFHAC2248 SYNCPOINT, but this is not allowed in a transaction
shows the transaction as CATA then look for earlier that is acting on behalf of an Activity.
short on storage messages.
System action
Module:
DFHAPAC CICS terminates the transaction abnormally. EXEC
CICS HANDLE ABEND command cannot handle this
ASP8 abend.

Explanation User response


The transaction requested syncpoint rollback, but was The error indicates an invalid attempt to syncpoint the
using a type of processing for which syncpoint rollback transaction.
is not supported.
Module:
System action DFHEISP

CICS terminates the transaction abnormally. The EXEC ASPA


CICS HANDLE ABEND command cannot handle this
abend. Explanation
Message DFHAC2217 is sent to the terminal end user The task was purged before a request to recovery
if possible, and message DFHAC2247 is sent to manager (RM) domain was able to complete
transient data destination CSMT. successfully. The domain that first detected the
purged condition provides an exception trace.
User response
System action
This error may be an application error or a
configuration error. Some communication sessions, The task is abnormally terminated with a CICS
(for example, LU6.1) do not support syncpoint transaction dump. If processing is at a point where
rollback, and if CICS detects such a session during data integrity might not be maintained, CICS is
rollback processing, the task is abended. This abnormally terminated.
restriction is described in the CICS
intercommunication. To resolve the problem, either: User response
• Change the application so that it does not issue Investigate why the task was purged. This is either as
syncpoint rollback commands while the non- a result of a purge from the master terminal operator

Chapter 1. Transaction abend codes 223


via the CEMT transaction, or by the task being timed dump (depending on the options specified in the dump
out after waiting for longer than the DTIMOUT table).
(deadlock timeout) value specified for the transaction.
If the master terminal operator purged the task, this System action
may have been in an attempt to clear the system The task is abnormally terminated with a CICS
which appeared to be deadlocked for some reason. transaction dump.
If the task was timed out automatically as a result of
the DTIMOUT value being exceeded, this may be due User response
to insufficient main storage being available for the
See the related message from the domain that
number of tasks in the system. If the amount of main
detected the original error.
storage cannot be increased, reduce the number of
tasks in the system to avoid short-on-storage Module:
situations. Another possibility is to increase the value DFHSPP
of the DTIMOUT option for the transaction.
ASPD
If CICS is abnormally terminated, it should be
emergency restarted to ensure that data integrity is Explanation
maintained.
The transaction requested syncpoint via EXEC CICS
Module: SYNCPOINT, or rollback via EXEC CICS SYNCPOINT
DFHAPAC ROLLBACK, but this is not allowed in a transaction that
ASPB is associated with an OTS transaction.

Explanation System action

An error (INVALID, DISASTER or unexpected CICS terminates the transaction abnormally. EXEC
EXCEPTION response) has occurred on a call to the CICS HANDLE ABEND command cannot handle this
recovery manager (RM) domain. The domain that abend.
detected the original error will have provided an
exception trace, a console message and, possibly, a User response
system dump (depending on the options specified in
The error indicates an invalid attempt to syncpoint the
the dump table).
transaction.

System action If DB2 is being accessed in the transaction, check that


the DB2ENTRY or DB2CONN pool definition used by
The task is abnormally terminated with a CICS the transaction does not specify DROLLBACK(YES).
transaction dump. If processing is at a point where
data integrity might not be maintained, CICS is Module:
abnormally terminated. DFHEISP
ASPF
User response
See the related message from the domain that Explanation
detected the original error. If CICS was abnormally CICS issued an internal syncpoint request resulting in
terminated, it should be emergency restarted to a syncpoint with an intersystem session which has
ensure that data integrity is maintained. returned ROLLEDBACK to recovery manager (RM)
Module: domain. As a result, the transaction is abnormally
DFHAPAC terminated because the unit of work which was being
syncpointed has been backed out.
ASPC
This could result from shutting down IRC or from the
failure of a connected CICS region.
Explanation
An error (INVALID or DISASTER) has occurred on a call System action
to the bridge syncpoint routine (DFHBRSP). The
domain that detected the original error will have The transaction is abnormally terminated. Recoverable
provided an exception trace, and, possibly, a system resources updated by the unit of work are backed out

224 CICS TS for z/OS: CICS Codes


and locks released. The EXEC CICS HANDLE ABEND System action
command cannot handle this abend.
The transaction does not abend. CICS synclevel 1
Message DFHAC2215 is sent to the terminal end user commit processing continues, with the aim of
if possible, and message DFHAC2245 is sent to committing as many synclevel 1 resources as possible.
transient data destination CSMT.
User response
User response
Examine the transaction dump to determine why the
Determine why the remote intersystem session message data was invalid. It is likely that the error is in
returned a ROLLEDBACK response to the syncpoint the remote system.
request. Once this has been corrected retry the
See the for more information about syncpointing.
transaction.
Module:
To avoid ASPF abends in future, ensure that no in-
DFHCR2U
flight units of work exist before shutting down IRC.
ASPN
Module:
DFHAPAC
Explanation
ASPI
A transaction has issued an EXEC CICS RETURN in
backout required program state. The backout required
Explanation
program state is set when an application receives or
During CICS synchronization level 1 (synclevel 1) issues an abend, or receives a backout request on a
commit, an unexpected FMH or no data has been protected conversation.
received from the partner system. Local resources and
synclevel 2 partners have been committed, but System action
synclevel 1 function-shipped resource updates may
have been backed out. The transaction is abnormally terminated. Recoverable
resources updated by the unit of work are backed out
and locks released. The EXEC CICS HANDLE ABEND
System action
command cannot handle this abend.
The transaction does not abend. CICS synclevel 1
Message DFHAC2216 is sent to the terminal end user
commit processing continues, with the aim of
if possible, and message DFHAC2246 is sent to
committing as many synclevel 1 resources as possible.
transient data destination CSMT.

User response
User response
Examine the transaction dump to determine why the
To avoid the transaction abend, the application should
FMH was invalid or missing, It is likely that the error is
code an EXEC CICS SYNCPOINT command before the
in the remote system.
EXEC CICS RETURN. A syncpoint issued in 'backout
See the for more information about syncpointing. required' program state results in a backout being
performed, and the ROLLEDBACK condition returned
Module:
on the EXEC CICS SYNCPOINT command. If this
DFHCR2U
condition is then handled, a subsequent EXEC CICS
ASPJ RETURN will complete successfully. For LU61
conversations the application should issue an EXEC
Explanation CICS FREE followed by an EXEC CICS SYNCPOINT
ROLLBACK, in order to avoid a subsequent ASP8
During CICS synchronization level 1 (synclevel 1) abend.
commit, unexpected syncpoint message data has
been received from the partner system. Local Module:
resources and synclevel 2 partners have been DFHAPAC
committed, but synclevel 1 function-shipped resource ASPO
updates may have been backed out.
Explanation
An intersystem session failed while a syncpoint was
being taken. The intersystem session that failed was

Chapter 1. Transaction abend codes 225


the link to the coordinator system. The failure above and if you wish CICS to ensure that data
occurred during the indoubt period of syncpoint integrity is maintained, change the indoubt transaction
processing. As a result this CICS system is in doubt as definition to specify WAIT(YES) so that CICS
to the outcome of the unit of work for the transaction. automatically handles indoubt failures and
resynchronizes the unit of work when the link to the
The unit of work is not shunted to await the return of
coordinator system is reestablished.
the coordinator system, but is instead unilaterally
committed. The unit of work is not shunted for one of Module:
the following reasons: DFHAPAC
• The transaction definition specifies WAIT(NO). ASPP
• The unit of work includes an MRO session to a back-
level CICS system which does not support the Explanation
WAIT(YES) option, and the role of the session in the An intersystem session failed while a syncpoint was
unit of work is such that it cannot await the return of being taken. The intersystem session that failed was
the coordinator system. the link to the coordinator system, and the failure
• The unit of work includes an LU6.1 session, and the occurred during the critical indoubt period of
role of the session in the unit of work is such that it syncpoint processing. As a result this CICS system is in
cannot await the return of the coordinator system. doubt as to the outcome of the unit of work for the
• The unit of work involves a task related user exit transaction.
which is not enabled with the INDOUBTWAIT option. The unit of work is not shunted to await the return of
• The unit of work has updated a recoverable transient the coordinator system. Instead it is unilaterally
data destination, which is defined with WAIT(NO). backed out. The unit of work is not shunted for one of
the following reasons:
• The unit of work involves the installation of CICS
resource definitions from the CSD (CICS system • The transaction definition specifies WAIT(NO).
definition) file. • The unit of work includes an MRO session to a back-
The unit of work is committed, rather than backed out, level CICS system which does not support the
because the transaction definition specifies WAIT(YES) option, and the role of the session in the
ACTION(COMMIT). unit of work is such that it cannot await the return of
the coordinator system.
The fact that the unit of work is committed is
remembered by the recovery manager (RM) domain • The unit of work includes an LU6.1 session, and the
until the unit of work is resynchronized with the role of the session in the unit of work is such that it
coordinator system. At this time, according to whether cannot await the return of the coordinator system.
the coordinator system committed or backed out, the • The unit of work involves a task related user exit
recovery manager domain issues resynchronization which is not enabled with the INDOUBTWAIT option.
messages reporting whether or not the resolution of • The unit of work has updated a recoverable transient
the unit of work in the subordinate system was data destination, which is defined with WAIT(NO).
consistent with the coordinator system.
• The unit of work involves the installation of CICS
resource definitions from the CSD (CICS system
System action
definition) file.
The transaction is abnormally terminated. Recoverable
The unit of work is backed out, rather than committed,
resources updated by the unit of work are committed
because the transaction definition specifies
and locks released. The EXEC CICS HANDLE ABEND
ACTION(BACKOUT).
command cannot handle this abend.
The fact that the unit of work is backed out is
Message DFHAC2202 is sent to the terminal end user
remembered by recovery manager (RM) domain until
if possible, and message DFHAC2232 is sent to
the unit of work is resynchronized with the coordinator
transient data destination CSMT.
system. At this time, according to whether the
coordinator system backed out or committed, the
User response recovery manager domain issues resynchronization
Any updates performed by the unit of work are messages reporting whether or not the resolution of
committed. There is a danger that recoverable the unit of work in the subordinate system was
resources will be inconsistent with the coordinator consistent with the coordinator system.
system if the coordinator system has backed out. If
the reason for the failure is the first of those listed

226 CICS TS for z/OS: CICS Codes


System action Explanation
The transaction is abnormally terminated. Recoverable Intersystem communication failed while a syncpoint
resources updated by the unit of work are backed out was being taken. Communication with the coordinator
and locks released. The EXEC CICS HANDLE ABEND system has been interrupted, and the failure occurred
command cannot handle this abend. during the critical indoubt period of syncpoint
processing. As a result this CICS system is in doubt as
Message DFHAC2203 is sent to the terminal end user
to the outcome of the unit of work for the transaction.
if possible, and message DFHAC2233 is sent to
transient data destination CSMT. However, this CICS system has not updated any
recoverable resources in the unit of work and hence
User response does not require the unit of work to be shunted to
await resynchronization of its resources later. The
Any updates performed by the unit of work are backed coordinator system commits or backs out its
out. There is a danger that recoverable resources will resources. No resources on this system need to be
be inconsistent with the coordinator system if the kept in step.
coordinator system has committed. If the reason for
the failure is the first of those listed above and if you This error can occur with external resource managers
wish CICS to ensure that data integrity is maintained, connected to CICS via the resource manager interface
change the indoubt transaction definition to specify (RMI) as well as CICS systems connected via IPIC, LU
WAIT(YES) so that CICS automatically handles indoubt 6.2 and MRO. If an external resource manager such as
failures and resynchronizes the unit of work when the DB2 is the only recoverable resource updated in the
link to the coordinator system is reestablished. transaction, the recovery manager (RM) domain can
optimize the syncpoint protocol. In this instance, the
Module: external resource manager becomes the syncpoint
DFHAPAC coordinator. If the link to the external resource
ASPQ manager is lost during this time, CICS will be indoubt
as to whether the external resource manager updates
were committed or backed out.
Explanation
During phase 2 of the two phase syncpoint protocol an System action
error occurred while communicating with a remote
system. The error occurred after the recoverable The transaction is abnormally terminated. There are
resources were committed or backed out, so data no recoverable resources affected in this CICS system.
integrity is not in danger. The EXEC CICS HANDLE ABEND command cannot
handle this abend.
System action Message DFHAC2222 is sent to the terminal end user
if possible, and message DFHAC2252 is sent to
The transaction is abnormally terminated. Recoverable
transient data destination CSMT.
resources updated by the unit of work will have
backed out or committed depending on the decision
taken by the recovery manager (RM) domain, which User response
was not influenced by this later problem. The EXEC Refer to messages on the remote system to determine
CICS HANDLE ABEND command cannot handle this if the remote resources were backed out or
abend. committed.
Message DFHAC2221 is sent to the terminal end user Module:
if possible, and message DFHAC2251 is sent to DFHAPAC
transient data destination CSMT.
ASQA
User response
Explanation
Refer to earlier messages issued by the
communication or remote resource management The CLS2 transaction was processing
components of CICS to determine the cause of the resynchronization work but the communications
intersystem communication problem. session which it was using has failed.

Module:
DFHAPAC
ASPR

Chapter 1. Transaction abend codes 227


System action User response
The work is reexecuted on a new session. If The error indicates an invalid attempt to start the
reexecution has has already been attempted, the transaction.
transaction terminates.
Module:
DFHCRRSY
User response
ASQD
The error may be caused by the failure of several
sessions between communicating systems during the
Explanation
resynchronization process. To confirm this, examine
the CSMT transient data queue for the relevant period. The CLS2 transaction was attached but could not use
the transaction manager interface to obtain input
Another cause could be logic errors within the
parameters.
resynchronization program, either on this system or on
the partner system, which caused the session to be
terminated. In this case, CSMT transient data System action
messages indicate the nature of the error. The transaction is abnormally terminated.
Module:
DFHCRRSY User response
ASQB The error indicates a failure in the transaction
manager. See the exception trace entries produced by
Explanation the transaction managed to determine the reason for
the error.
The CLS2 transaction was executing exchange log
names or resynchronization with a remote system Module:
when a logic error occurred. DFHCRRSY
ASQE
System action
The transaction is abnormally terminated with a Explanation
transaction dump. The CLS2 transaction was executing exchange log
Message DFHRS2158 may also be issued. names with a remote system and 3 retry attempts
have failed to solicit a warm exchange log names
reply, in response to a warm exchange log names
User response
request sent by CICS.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on System action
how to proceed.
The transaction is abnormally terminated with a
Module: transaction dump.
DFHCRRSY
ASQC User response
This abend indicates an error in the remote system. It
Explanation should have saved the log name sent by CICS and, on
The CLS2 transaction was attached with an receiving a later exchange lognames request, should
unexpected start code. The transaction can be then respond with a warm reply.
attached due to terminal input (on a communications Module:
session), or via a system attach. Neither of these DFHCRRSY
methods was used.
ASQG
System action
Explanation
The transaction is abnormally terminated.
The CLS2 transaction was executing resynchronization
work and has failed during the receipt of data from
remote system via an MRO session. The data was
longer than expected.

228 CICS TS for z/OS: CICS Codes


System action User response
The transaction is abnormally terminated with a This indicates an error in the CICS recovery manager
transaction dump. which has produced its own exception trace records.
Look at the trace records and the CSMT message log
User response for further information about the error.

The abend indicates a CICS logic error, possibly in the Module:


remote system. The transaction storage in the dump DFHCRRSY
shows the data received. The transaction trace shows ASQK
the preceding flows between the systems, which
should match those documented in the z/OS
Explanation
Communications Server: SNA Programmer's LU 6.2
Reference manual, SC30-6808. The CLS2 transaction was processing exchange
lognames or resynchronization for a connected partner
If you need further assistance from IBM to resolve this
identified by a netname. The connection entry
problem, see IBM problem support for guidance on
associated with the netname was located and locked,
how to proceed.
but could not be unlocked in subsequent processing.
Module: This indicates a CICS internal logic error.
DFHCRRSY
ASQH System action
The transaction is abnomally terminated with a
Explanation transaction dump.
The CLS2 transaction was executing resynchronization Message DFHRS2156 may also issued.
work and has failed during the receipt of data from
remote system via an MRO session. The data was User response
shorter than the minimum length expected.
This indicates an error either in the CICS table
manager, (which may have produced its own exception
System action
trace records) or in the resynchronization program
The transaction is anormally terminated with a itself. Look at the trace records and the CSMT message
transaction dump. log for further information which might have indicated
an error in the table manager program or in the table
User response entry for the connection. If you need further
assistance from IBM to resolve this problem, see IBM
This indicates a CICS logic error, possibly in the problem support for guidance on how to proceed.
remote system. The transaction storage in the dump
shows the data received. If you need further Module:
assistance from IBM to resolve this problem, see IBM DFHCRRSY
problem support for guidance on how to proceed. ASQL
Module:
DFHCRRSY Explanation
ASQI The CLS2 transaction was executing the
resynchronization of a unit of work with a connected
Explanation partner, and has locked the associated data managed
by the CICS recovery manager. The invocation of the
The CLS2 transaction was executing the exchange TERMINATE_RECOVERY command to unlock the data
lognames process as part of the initialization sequence failed.
for an APPC connection. An attempt to invoke the CICS
recovery manager to save a logname failed.
System action

System action The transaction is abnormally terminated with a


transaction dump.
The transaction is abnormally terminated with a
transaction dump. Message DFHRS2154 is also issued.

Message DFHRS2157 may also be issued.

Chapter 1. Transaction abend codes 229


User response Explanation
This indicates an error either in the CICS recovery An operating system abend has occurred and CICS has
manager (which may have produced its own exception been able to abend the current transaction.
trace records) or in the resynchronization program
itself. Look at the trace records and the CSMT message System action
log for further information. If you need further
assistance from IBM to resolve this problem, see IBM The task is abnormally terminated and CICS issues
problem support for guidance on how to proceed. either message DFHAP0001 or DFHSR0001

Module:
User response
DFHCRRSY
Refer to the description of the associated message to
ASQM
determine the cause of the original operating system
abend, and take the necessary corrective action.
Explanation
Module:
A CICS internal logic error has occurred in the DFHSRP
management of dynamic storage for the
resynchronization program. ASRD

System action Explanation

The transaction is abnormally terminated with a The task has been abnormally terminated for one of
transaction dump. these reasons:
• A program contains an assembler macro call which
User response is no longer supported by CICS.
This indicates that the resynchronization program has • An invalid attempt has been made to access the CSA
exhausted the available space for recording storage or TCA.
areas. The symptoms may indicate that the program • An attempt to access a TCA via field CSAQRTCA
was looping without executing the error recovery (previously CSACDTA) has been made.
process. If you need further assistance from IBM to
• A non-assembler program has been wrongly defined
resolve this problem, see IBM problem support for
to CICS as an assembler program.
guidance on how to proceed.
• An application program has been link-edited without
Module: an appropriate exec interface stub.
DFHCRRSY
This error appears as a program check.
ASRA
System action
Explanation
The task is abnormally terminated and CICS issues
The task has terminated abnormally because of a message DFHSR0618, followed by either DFHAP0001
program check. or DFHSR0001.

System action User response


The task is abnormally terminated and CICS issues Refer to the description of the associated messages to
either message DFHAP0001 or DFHSR0001. Message determine and correct the error.
DFHSR0622 may also be issued.
It is likely that either R12 which usually addresses the
TCA or R13 which usually addresses the CSA is
User response
pointing to an area of storage that you are not allowed
Refer to the description of the associated message or to access.
messages to determine and correct the cause of the
Module:
program check.
DFHSRP
Module:
ASRE
DFHSRP
ASRB

230 CICS TS for z/OS: CICS Codes


Explanation Module:
DFHSRP
The task has been abnormally terminated because an
attempt has been made to access a CICS-DB2 RCT ASRJ
load module.
The RCT nolonger exists as a load module and cannot Explanation
be accessed directly. The task has terminated abnormally because a AP
To access information about CICS DB2 resource domain global user exit or task related user exit
definitions, use the CICS SPI commands EXEC CICS invoked by the task has made a backlevel XPI call.
INQUIRE/SET DB2CONN, EXEC CICS INQUIRE/SET
DB2ENTRY and EXEC CICS INQUIRE/SET DB2TRAN. System action
This error appears as a program check. The task is abnormally terminated. CICS will have
issued error message DFHAP0702 or DFHAP0708
System action which will have identified the exit program that made
the backlevel XPI call.
The task is abnormally terminated and CICS issues
message DFHSR0619, followed by either DFHAP0001
User response
or DFHSR0001.
Reassemble the exit program using the latest CICS
User response libraries.

Change the application to use the CICS SPI commands Module:


to access information about CICS DB2 resource DFHSRP
definitions.

ATxx abend codes


ATC1 Use the messages and dumps to find out the cause of
the failure.
Explanation Module:
The CICS terminal control restart task could not DFHTCRP
complete because a necessary step failed. The task ATC2
has done some essential recovery operations and
abnormally terminated itself with code ATC1. Explanation

System action A CICS SET VTAM OPEN command has failed due to
VTAM rejecting a CICS request.
CICS writes a transaction dump for the terminal
control restart task. System action
CICS sends two messages to the console, one to Message DFHZC2302, DFHZC2304 or DFHZC2307 is
identify the error detected by the terminal control sent to the console, and CICS terminates the
restart task, and DFHTC1001 to report that the task transaction abnormally with a transaction dump.
has failed. A third message follows either to say that
CICS has terminated abnormally with a dump, or to
ask you to reply GO or CANCEL. Depending on the User response
nature of the original error, you may see messages The RPL with the VTAM request code and return code
from some other system component (for example, an can be found in the RA pool addressed from
access method). TCTVRVRA. Use the z/OS Communications Server: SNA
Programming manual, to determine the cause of the
User response error and the actions necessary to correct it. After
correcting the error, either retry the request or
First, if CICS has requested a response, you must
terminate CICS and restart the network in your own
reply. If you reply 'GO', CICS continues processing, but
time.
without terminal control. If you reply 'CANCEL', CICS
terminates abnormally with a dump. Module:

Chapter 1. Transaction abend codes 231


DFHZSLS System action
ATC3 The task is abnormally terminated with a CICS
transaction dump. CICS processing continues.
Explanation
User response
A write to a TLX device was issued with a data length
of 0 causing TIOA data length (TIOATDL) to be zero. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
System action how to proceed.

The transaction is abnormally terminated with a CICS Module:


transaction dump. DFHETL
ATC6
User response
For an error writing to a TLX device correct the error in Explanation
the user program by ensuring that a data length for DFHETL has a SEND DATA request with a data length
data to be placed in the terminal input/output area greater than 65 528 bytes which is the maximum that
(TIOA) is provided at write time. it can process.
Module:
DFHZARL DFHZARQ System action
ATC4 The transaction is abnormally terminated with a CICS
transaction dump.
Explanation
User response
A serious CAVM error has occurred. The XRF TCB has
abended. This is a CICS internal logic error. If you need further
assistance from IBM to resolve this problem, see IBM
System action problem support for guidance on how to proceed.

CICS abnormally terminates with a system dump. Module:


DFHETL
User response ATC7
Use the dump and the guidance in any messages
issued by other system components to diagnose and Explanation
correct the original error. DFHZSUP has detected a bad response from an
See the Troubleshooting and support section for INITIAL-CALL request to DFHZARL. This response is
further guidance on using system dumps. returned to DFHZSUP in the DFHLUC parameter list.

Module:
System action
DFHTCRP
The transaction is abnormally terminated with a CICS
ATC5
transaction dump.

Explanation
User response
An internal logic error has been detected during APPC
Examine field LUCCDRCD in the DFHLUC parameter
mapped processing. The conversation state
list. This appears in the ENTRY/EXIT trace points for
maintained by DFHZARL does not match the state
DFHZARL. If trace is switched off, then it can be found
which is jointly maintained by DFHETL and DFHZARM.
in DFHZSUP's LIFO entry in the transaction dump.
This problem could also arise when CICS is receiving
• LUCCDRCD = 'A0000100' - session failure
application data. CICS may receive and end of chain
notification before receiving all the data expected. • LUCCDRCD = 'A0010100' - read timeout
• LUCCDRCD = 'A0010000' - deadlock timeout.
(The offset for LUCCDRCD can be found in CICS Data
Areas).

232 CICS TS for z/OS: CICS Codes


If LUCCDRCD is X'00000000', the error is the result of User response
a connection failure. In this case examine the CSMT
None.
log for further diagnostic information.
Module:
Module:
DFHZARQ
DFHZSUP
ATCB
ATC8

Explanation
Explanation
The CICS application program issued two consecutive
An error has occurred during the processing of an
DFHTC writes or two consecutive DFHTC reads, but in
inbound function management header (FMH). Either a
either case did not issue an intervening wait.
length error has been detected, for example,
incomplete FMH received, or an invalid field has been
detected within the FMH. System action
The transaction is abnormally terminated with a CICS
System action transaction dump.
The transaction is abnormally terminated with a CICS
transaction dump. User response
Take corrective action within the program being
User response executed.
Notify the system programmer of the error. The This is almost certainly an application program error.
problem is probably in the remote system that has Determine the flow of control through the application
sent the invalid FMH. and determine why an intervening wait is not issued.
The trace table may be useful to discover where the
Module:
application is issuing the read and write requests. If
DFHETL
necessary, start trace or auxiliary trace using the
ATC9 master terminal command and rerun the transaction
to obtain a trace. The output of the auxiliary trace can
Explanation be printed using the trace utility program, DFHTU710.

A DFHKC RESUME macro call has been issued for a


Problem determination
task without first issuing DFHKC SUSPEND. DFHKC
RESUME must be preceded by DFHKC SUSPEND. A transaction dump is provided with this abend. In the
dump, register 12 addresses the current TCA, and
System action register 10 and the field TCAFCAAA address the TCTTE
associated with this task. In TCATPOS2, bit
The transaction is abnormally terminated with a TCATPOWR (X'01') indicates that a write is requested
transaction dump. by the DFHTC macro, and bit TCATPORR (X'10')
indicates that a read is requested. In TCTTEOS, bit
User response TCTTEOWR (X'01') indicates that a write is in progress,
and bit TCTTEORR (X'10') indicates that a read is in
Examine the trace entry to locate the error.
progress.
Module:
Analysis:
DFHZNCE
ATCA
Register Label Description
Explanation
R10=@TCTTE TCZARQ05 Bit TCATPOWR is on in byte
The system was in a final quiesce mode when the CICS R12=@TCA (TCZAQ1W) TCATPOS2, and bit TCTTEOWR
application program issued a DFHTC macro. is on in byte TCTTEOS.

R10=@TCTTE TCZARQ05 Bit TCATPOWR is on in byte


System action R12=@TCA (TCZAQ2W) TCATPOS2, and bit TCTTEORR
is on in byte TCTTEOS.
The task requesting the I/O is abnormally terminated
R10=@TCTTE TCZARQ12 Bit TCATPORR is on in byte
with a CICS transaction dump.

Chapter 1. Transaction abend codes 233


R12=@TCA TCATPOS2, and bit TCTTEORR System action
is on in byte TCTTEOS.
The transaction is abnormally terminated with a CICS
Module: transaction dump.
DFHZARQ
ATCC User response
Correct the error in the user program by ensuring that
Explanation a terminal input/output area (TIOA) is provided at
An application program, using a pipeline session, has write time.
either issued more than one write request or issued a This is almost certainly an application program error.
read request.:sysact. The transaction is abnormally Determine the flow of control through the application
terminated with a CICS transaction dump. and determine why a TIOA has not been specified.
System action:
Problem determination
User response A transaction dump is provided with this abend. In the
Correct the application program so that it will not issue dump, register 12 addresses the current TCA, and
more than one consecutive WRITE to a pipeline register 10 and the field TCAFCAAA addresses the
session terminal. TCTTE associated with this task. Register 8 and
TCTTEDA should contain the address of the TIOA to be
Module: used in the I/O request, but actually they contain zero.
DFHZARQ For a 3270 data stream terminal, byte TCTETDST has
ATCD bit TCTETTSI (X'01') set. An erase-all-unprotected
request is indicated by the setting of bit TCTTEEUI
(X'40') in byte TCTTEEUB, and a read buffer request is
Explanation indicated by the setting of bit TCTTERBI (X'80') in byte
This abend code is used whenever a CTYPE request or TCTTERBB. Analysis:
a QUEUE request is issued and VTAM or a ZCP function
has not been included in the system.
Register Label Description
It is also used to abend a task that issues an APPC
command when the CICS system is not at a level to
support APPC. R10=@TCTTE TCZARQ41 NIOABAR (register 8)
contains zero.
R8=0 Register 8 has been loaded
field TCTTEDA of the TCTTE
System action associated with this task.
The transaction is abnormally terminated with a CICS
transaction dump. Module:
DFHZARQ
User response ATCF
Correct the transaction so that it does not issue a
CTYPE macro instruction if VTAM is not generated into Explanation
the system, or include the ZCP function for which the A DFHTC CTYPE macro was issued to a non-VTAM
CTYPE or QUEUE request was issued. terminal control table terminal entry (TCTTE), or a
Module: DFHTC CTYPE=COMMAND or RESPONSE macro was
DFHZDSP, DFHZERH issued to a VTAM 3270 TCTTE.

ATCE System action

Explanation The transaction is abnormally terminated with a CICS


transaction dump.
A CICS application program has issued a DFHTC
request without specifying the address of a TIOA, but User response
the request is not an ERASE ALL UNPROTECTED or a
READBUF request for a 3270 data stream terminal. Ensure that the program issues CTYPE macros to
VTAM terminals only, and does not issue
CTYPE=COMMAND or RESPONSE to a VTAM 3270.

234 CICS TS for z/OS: CICS Codes


Module: Explanation
DFHZCRQ
The task was purged before a domain call was able to
ATCG complete successfully. The task that first detected the
purged condition provides an exception trace.
Explanation
System action
A CICS application program has issued a DFHTC
request for a terminal that it does not own. The The task is abnormally terminated with a CICS
problem of ownership may be because the task transaction dump.
previously issued a WRITE,LAST request (which would
have detached the terminal from that task) or because User response
the task incorrectly specified the terminal to which the
request is directed. Investigate why the task was purged. It was purged
either as a result of a purge from the master terminal
operator via the CEMT transaction, or by the task being
System action
timed out after waiting for longer than the DTIMOUT
The transaction is abnormally terminated with a CICS (deadlock timeout) value specified for the transaction,
transaction dump. or by CICS issuing a purge request.
If the master terminal operator purged the task, this
User response may have been in an attempt to clear the system
This is most probably an application error (unless which appeared to be deadlocked for some reason.
storage has been completely overwritten). Determine If the task was timed out automatically as a result of
the flow from the trace table and when a request to the DTIMOUT value being exceeded, this may be due
the DFHZCP detach routine, DFHZDET, or a DFHTC to insufficient main storage being available for the
WRITE,LAST was issued. number of tasks in the system. If the amount of main
storage cannot be increased, reduce the number of
Problem determination tasks in the system to avoid short-on-storage
situations. Another possibility is to increase the value
Register 12 addresses the current TCA and register 10
of the DTIMOUT option for the transaction.
contains the address of the TCTTE. The address of the
TCTTE was obtained either from TCAFCAAA in the When CICS purges a task, it does so to allow an
case of a non-ISC transaction, or from TCATPTA if bit operation to complete which would be held up by the
TCATPTTA (X'40') is on in byte TCATPOC3 (this presence of active tasks, or to ensure data integrity.
indicates that TERM=YES was specified on the DFHTC For example, CICS will purge a task which has made
request and that this is an ISC transaction). In the recoverable updates to a coupling facility data table if
TCTTE thus located, the field TCTTECA does not it determines that the coupling facility data table
contain the address of the TCA, indicating that this server for the pool in which that table resides has
TCA is not owned by this task. recycled, to ensure that all updates in the unit of work
will be backed out.
Analysis: A DFHTC request has been issued specifying
a TCTTE in which the field TCTTECA does not contain For module list,see Diagnostics reference.
the address of the TCA.
Module:
DFHBSM62 DFHBSS DFHBSSZ DFHBSTZ DFHBSTZV
DFHBSTZ1 DFHBSTZ2 DFHTBSB DFHTBSBP
Register Label Description DFHTBSD DFHTBSDP DFHTBSL DFHTBSLP DFHTBSQ
DFHTBSR DFHTBSRP DFHTBSSP DFHTCRP
R10=@TCTTE TCZARQ05 TCTTECA is not equal DFHTOASE DFHTOATM DFHTOLCR DFHTOLUI
to register 12.
DFHTRZCP DFHTRZIP DFHTRZPP DFHTRZXP
DFHTRZYP DFHTRZZP DFHZCQCH DFHZCQDL
Module:
DFHZCQIQ DFHZCQIS DFHZCQRS DFHZCQ00
DFHZARQ
DFHMRXM DFH62XM
ATCH
ATCI

Explanation
An error (INVALID, DISASTER, or unexpected
EXCEPTION response) has occurred on a call to

Chapter 1. Transaction abend codes 235


module DFHRTSU. The module that detected the If an abend has been issued, use the transaction dump
original error provides an exception trace, a console to determine where the abend occurred. This is a CICS
message and, possibly a system dump (depending on logic error.
the options specified in the dump table).
Module:
DFHZATA DFHZATD DFHZATR
System action
ATCK
The task is abnormally terminated with a CICS
transaction dump.
Explanation

User response An application program has issued a WRITE to a VTAM


terminal specifying CCOMPL=NO without being
See the related message produced by the module that authorized to do so.
detected the original error.
Module: System action
DFHZSUP DFHMRXM DFH62XM
The transaction is abnormally terminated with a CICS
ATCJ transaction dump.

Explanation User response


This abend is issued by DFHZATA in the following Specify CHAINCONTROL in the transaction profile.
circumstances:
Module:
• Transaction CATA is issued from a terminal DFHZARQ
• The address of the AWE (TCAFCAAA) is 0 ATCL
• The AWE is invalid (TCTWETYP should be
TCTTEAWE) Explanation
• An abend is issued early in DFHZATA. An error has occurred either during automatic
This abend is issued by DFHZATD in the following journaling or automatic logging of terminal messages
circumstances: to or from this transaction. The message being logged
will be one associated with an explicit READ or WRITE
• Transaction CATD is issued from a terminal in the application program.
• The address of the AWE (TCAFCAAA) is 0
• TCAFCAAA is an AWE and not a terminal System action
• An abend is issued early in DFHZATD. The transaction is abnormally terminated with a CICS
transaction dump.
This abend is issued by DFHZATR in the following
circumstances:
User response
• Transaction CATR is issued from a terminal
Use the dump to ascertain why the journal or log
• An abend is issued early in DFHZATD.
record could not be written correctly. If a journal
record length error is indicated, TIOATDL may have
System action been corrupted.
CICS rejects the request.
Problem determination
User response Register 12 addresses the current TCA and field
Determine the issuing program and the reason for the TCAJCAAD and register 4 address the JCA. The log
abend and take the appropriate action as follows: manager request is contained in JCATR2 and the
response code is in JCAJCRC.
Do not try to invoke CATA, CATD or CATR from a
terminal. Possible request codes are:

If the address in TCAFCAAA is incorrect, the calling


mechanism has failed. This is a CICS logic error. X'8001' - WRITE
X'8003' - PUT

236 CICS TS for z/OS: CICS Codes


Possible response codes are: X'06' - LERROR - Journal record length error
X'07' - IOERROR - I/O error.

X'01' - IDERROR - Journal identification error Analysis:


X'02' - INVREQ - Invalid request
X'03' - STATERR - Status error
X'05' - NOTOPEN - Journal not open
X'06' - LERROR - Journal record length error Register Label Description
X'07' - IOERROR - I/O error.

The address of the TIOA is contained in register 8 and R4=@JCA TCZARQJP JCAJCRC is nonzero.
TCZSUPJW Journal error.
its data length is in TIOATDL.
Analysis: Module:
DFHZSUP DFH62XM DFHTFXM
ATCO
Register Label Description

Explanation
R4=@JCA TCZARQPJ JCAJCRC is nonzero.
An application program has attempted to perform a
Module: function not supported by a terminal or system.
DFHETL, DFHTCPCM, DFHZARQ
Possible errors are:
ATCN
1. SIGNAL not supported.

Explanation A DFHTC TYPE=SIGNAL request with the


WAIT=YES option was issued to a VTAM logical unit
An error has occurred during the automatic journaling that CICS does not support for the receipt of the
or automatic logging of the initial input message of this SIGNAL indicator.
transaction. This input message is the message that
2. WRITE STRUCTURED FIELD not supported.
actually caused the transaction to be invoked.
This write may have been attempted as a result of a
System action SEND command with the STRFIELD keyword to a
device that does not support this function.
The transaction is abnormally terminated with a CICS
transaction dump. 3. APPC mapped conversation not supported.
The application has attempted to perform a normal
User response terminal control command on a session that is in
use for an APPC unmapped conversation. (Only
Use the dump to ascertain why the log record could EXEC CICS GDS commands are permitted.)
not be written correctly.
If a journal record length error is indicated, TIOATDL System action
(X'08') may have been corrupted.
The transaction is abnormally terminated with a CICS
transaction dump.
Problem determination
Register 12 addresses the current TCA and field User response
TCAJCAAD and register 4 address the JCA. The log
manager request is contained in JCATR2 and the Correct the application program.
response code is in JCAJCRC. Module:
Possible request codes are: DFHZARQ
ATCQ
X'8001' - WRITE
X'8003' - PUT Explanation

Possible response codes are: The application program issued a write operation to a
terminal that was in send status. In order to allow this
write to proceed, a signal command was sent, and
X'01' - IDERROR - Journal identification error DFHZCP started to read data from the terminal waiting
X'02' - INVREQ - Invalid request
X'03' - STATERR - Status error for the change direction indication. As each data
X'05' - NOTOPEN - Journal not open

Chapter 1. Transaction abend codes 237


record is received, it is placed on temporary storage retrieve the saved data from temporary storage, and
and, for one of these operations, a temporary storage an error has occurred.
error has occurred.
System action
System action
The transaction is abnormally terminated with a CICS
The transaction is abnormally terminated with a CICS transaction dump.
transaction dump.
User response
User response
Determine the cause of the temporary storage error
Check that temporary storage has been included in the and correct it.
system and that it has sufficient space.
If a temporary storage identification error is indicated,
If an invalid request is indicated, check that the length examine TCTTETI for a valid terminal identification.
of the data being written to temporary storage is not
greater than the VSAM control interval size minus 84. Problem determination
The length of the data is in TIOATDL (which is 8
greater than the length of the data that is read in by Register 12 addresses the current TCA. TCACCSV1
DFHZCP). contains a saved copy of TCATSTR that contains the
temporary storage response code. The temporary
storage response code may be one of:
Problem determination
Register 12 addresses the current TCA. TCACCSV1
X'01' - ENERROR - Entry error
contains a saved copy of TCATSTR containing the X'02' - IDERROR - Identification error
temporary storage response code. The temporary X'04' - IOERROR - I/O error
X'20' - INVREQ - Invalid request
storage response code may be one of:
The temporary storage identification is constructed by
X'04' - IOERROR - I/O error concatenating the character string "DFHQ" with the
X'08' - NOSPACE - No temporary storage space terminal identification from TCTTETI. The temporary
X'20' - INVREQ - Invalid request.
storage identification is placed in TCATSDI.
The temporary storage identification is constructed by Analysis: After the DFHTS TYPE=GETQ, the temporary
concatenating the character string "DFHQ" with the storage response code was not zero.
terminal identification from TCTTETI. The temporary
storage identification is placed in TCATSDI.
Register 8 and field TCTTEDA address the TIOA that is Register Label Description
being written to temporary storage. The address
passed to temporary storage is that of TIOATDL. R12=@TCA ZRAR90 TCATSTR is not zero.

Analysis: After the DFHTS TYPE=PUTQ, the temporary


Module:
storage response code was not zero.
DFHZRAR
ATCS
Register Label Description
Explanation
R12=@TCA ZRAQ60 TCATSTR is nonzero.
An application program attempted to send data to a
logical unit after a SIGNAL data flow command with an
Module:
RCD (request change direction) has been received.
DFHZRAQ
This condition arises when the application handles the
ATCR IGREQCD exceptional condition incorrectly.

Explanation System action


An application program has issued a read operation, The transaction is abnormally terminated with a CICS
after a previous write operation has caused DFHZCP to transaction dump.
read-ahead data from the terminal in order to avoid a
lock-out. DFHZCP has now issued a DFHTS GETQ to

238 CICS TS for z/OS: CICS Codes


User response outstanding (EIBSYNC is set). This holds for APPC
or non-APPC systems
Handle the IGREQCD exceptional condition correctly.
2. When issued by DFHETL, the application is
Module: communicating with an APPC system, and is not in
DFHZARQ the correct state to perform the attempted
ATCT operation. This holds for APPC systems only
3. When issued by DFHZISP, a TCTTE free was
Explanation requested, and there is an outstanding sync point
request. This holds for non-APPC systems only
An attempt to build a surrogate TCTTE to represent a
remotely-owned terminal failed. 4. When issued by DFHZISP, a TCTTE free was
requested, the TCTTE is in receive mode, and
RAQ=NO was specified in the installed profile
System action
definition. This holds for non-APPC systems only.
The task is abnormally terminated with a CICS
transaction dump. System action
The transaction is abnormally terminated with a CICS
User response
transaction dump.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on User response
how to proceed.
The response depends on the reason for the error as
Module: follows:
DFHZSUP DFHMRXM DFH62XM
1. Issue a sync point and then issue the request.
ATCU
2. Issue the free request and reallocate the session.

Explanation 3. Either change the application to issue receives until


EIBRECV is not set, or specify RAQ=YES in the
An application program attempted to send data to a installed profile definition. (If you specify RAQ=YES
logical unit, but was in receive mode (EIBRECV is set), in the installed profile definition, ensure that all
and read-ahead queuing was not specified in installed input messages are read before the transaction is
profile definition (RAQ=NO). terminated.)
4. See the CICS documentation where rules for the
System action correct use of commands are given. Then correct
The transaction is abnormally terminated with a CICS the application.
transaction dump. The application program has attempted an operation
on a logical unit that is invalid, because the program's
User response current status on the session with that logical unit
does not permit it. An investigation of the TCTTE (that
Either change the application program to issue
is, Session), status bytes, and TCA type of request
receives until EIBRECV is not set, or specify RAQ=YES
bytes will reveal which of the above problems are
in the installed profile definition (If RAQ=YES is
relevant.
specified, ensure that all input messages are read
before the transaction is terminated.) When the cause of the problem has been ascertained,
the application program should be changed to ensure
Module:
that the session-oriented information is acted upon
DFHZARQ
before any further requests are sent across that
ATCV session. The session status information is made
available to the application program in the exec
Explanation interface block (EIB) immediately following the
execution of RECEIVE, CONVERSE, or RETRIEVE
An application attempted an operation on a logical requests across the session. The relevant bytes must
unit, but was not in the correct mode for one of the be tested, strictly in the order shown, and acted upon,
following reasons: before any further operations are attempted on the
1. When issued by DFHZARQ, CICS cannot perform session. In addition, the status information bytes
the current request because another request is themselves are necessarily volatile in that they are
reset before the execution of every EXEC CICS...

Chapter 1. Transaction abend codes 239


statement. Thus it is good programming practice to TCTEURCV (X'01') set if the application is in RECEIVE
save them into application user storage after a mode. Bit TCTESRAQ (X'80') in byte TCTEIRAQ
RECEIVE, CONVERSE, or RETRIEVE for later testing. indicates that read-ahead queuing is coded on the
The states are: installed profile definition for this transaction.
1. EIBSYNC The type-of-request bits in the TCA are set as follows:
the application must take a syncpoint • TCATPOS1 TCATPIS (X'01') Signal requested.
2. EIBFREE – TCATPFRE (X'03') Free TCTTE.
the application must free the session (or terminate • TCATPOS2 TCATPORR (X'10') Receive requested.
when the session will be freed automatically) – TCATPOWR (X'01') Send requested.
3. EIBRECV Analysis:
the application must continue receiving data by
issuing further RECEIVE commands; by definition,
data cannot be sent while in this state. Number Label Description

Some of these status tests can sometimes be omitted


(for example, testing of the EIBSYNC status is not DFHZARQ
1. TCZAQW8 Attempting to receive
essential if it is known that the application program on when sync point or Free
the remote system never issues sync point requests Session outstanding.
2. TCZAQ2W Attempting to send while
itself). However, the tests should always be carried in receive mode.
out, particularly if the remote application might be 3. ZARQNOPG Issuing SIGNAL while in
send mode.
amended at a future date, in which event the session
handling logic may well be altered. Also, it may be that DFHZISP
the remote transaction itself causes an unsuspected 4. ZISPVTCK Attempting to free session
while sync point request is
flow on the session. For example, if the remote outstanding.
program issues EXEC CICS SEND..... LAST across the
session, followed by RETURN, a syncpoint request Module:
(RQD2) will be added onto the transmitted data. (The DFHETL, DFHZARQ, DFHZISP
application programmer is referred to the CICS
ATCW
documentation for a discussion of this topic). As a
result of this addition, an unsuspected syncpoint
request is received by the local application, which Explanation
abend if the session is freed without the sync point The system has been generated without an installed
request being honored. profile definition for an LU6.1 or APPC session.
Note:
System action
An ATCV abend is also raised by module DFHETL if a
state error occurs during processing of an APPC The transaction is abnormally terminated with a CICS
mapped application (that is, the program attempts to transaction dump.
perform an operation while in the wrong state). The
handling of APPC mapped applications is described in User response
the CICS Diagnostics reference. Some commands are
processed by DFHZARQ, as above, and others by Notify the system programmer of the error.
various other modules invoked by DFHETL. Rules for Module:
using commands for APPC are given in the CICS DFHZSUP DFHMRXM DFH62XM
documentation. Reference to this guide should reveal
the programming error. ATCX

Problem determination Explanation

Register 12 addresses the current TCA. Register 10 An error (INVALID, DISASTER, or unexpected
and field TCAFCAAA address TCTTE. The terminal byte EXCEPTION response) has occurred on a call to the
TCTTECRE has bit TCTEUCOM (X'02') set if sync point storage manager (SM) domain. The domain that
is required, and TCTEUFRT (X'04') set if Free Session is detected the original error provides an exception
required; TCTESMDI has TCTEUSMD (X'02') set if the trace, a console message and, possibly, a system
application is in SEND mode. TCTERCVI has

240 CICS TS for z/OS: CICS Codes


dump (depending on the options specified in the dump Explanation
table).
An error (INVALID, DISASTER or EXCEPTION
An application program that issues terminal control response) has occurred on the
requests after an ATCX abend may cause further SET_NETWORK_IDENTIFIER call to the security
problems. domain as part of opening the CICS VTAM ACB (for
example, EXEC CICS SET VTAM OPEN or CEMT SET
System action VTAM OPEN). The domain that detected the original
error provides an exception trace, a console message,
The task is abnormally terminated with a CICS and depending on the options specified in the dump
transaction dump. table, a system dump.

User response System action


See the related message produced by the domain that The task is abnormally terminated with a CICS
detected the original error. transaction dump. The VTAM ACB is closed.
For module list,see Diagnostics reference.
User response
Module:
DFHBSMIR, DFHBSMPP, DFHBSM62, DFHBSS, Use the dump, the trace and the console message to
DFHBSTB, DFHBSTB3, DFHBSTC, DFHBSTZ, diagnose and correct the original error. Retry the
DFHBSTZB, DFHBSTZO, DFHBSTZR, DFHBSTZV, command when the earlier error is resolved.
DFHBSTZ1, DFHBSTZ2, DFHBSZZS, DFHAPRT,
Module:
DFHCRP, DFHQRY, DFHZARL, DFHZARQ, DFHZERH,
DFHZSLS
DFHZGET, DFHZFRE, DFHZNAC, DFHZRVS, DFHZSUP,
DFHMRXM, DFH62XM DFHZTSP, DFHZXST ATD3
ATCY
Explanation
Explanation The task has been purged, probably due to operator
action such as a CEMT TASK PURGE command. The
An error has occurred during the processing of an
task might also have been purged as a result of CICS
inbound function management header (FMH). Either a
issuing a purge request.
length error has been detected, for example,
incomplete FMH received, or an invalid field has been
detected within the FMH. System action
The transaction is abnormally terminated with a
System action transaction dump.
The transaction is abnormally terminated with a CICS
transaction dump. User response
Use the transaction dump to determine why the task
User response was purged. In particular, if the purge was operator
initiated, the dump should be useful in determining
Notify the system programmer of the error. The
why this task needed to be explicitly purged.
problem is probably in the remote system that has
sent the invalid FMH. Module:
DFHTDB
If the inbound FMH is from a system with an earlier
release of CICS then you may need to set ATD9
USEDFLTUSER. See 'Attach Time Security and the
USEDFLTUSER option' in chapter 12 of the CICS Explanation
Securing.
An incorrect response has been received from a call to
Module: the enqueue (NQ) domain during the processing of an
DFHZARQ, DFHZSUP DFHMRXM DFH62XM ENQUEUE or a DEQUEUE request.
ATCZ
System action
The transaction is abnormally terminated with a
transaction dump.

Chapter 1. Transaction abend codes 241


User response User response
Examine the dump and any exception trace entries for The transaction should be reexecuted, and the
further information. Since this is only used for internal situation causing the SUSPEND to occur may clear
enqueues, this abend indicates an error in CICS. If you itself.
need further assistance from IBM to resolve this
The ATDS abend is to be expected occasionally, unless
problem, see IBM problem support for guidance on
DTIMOUT is set to zero. No special action is necessary.
how to proceed.
Module:
Module:
DFHTDB
DFHTDB
ATDY
ATDC

Explanation
Explanation
Transient data initialization has failed. A console
A transaction has issued an EXEC CICS READQ,
message, DFH12xx, gives the reason for the failure.
WRITEQ or DELETEQ command against a logically
recoverable transient data queue. The task was
enqueued because another task currently owns the System action
enqueue. While waiting to obtain the enqueue, the Transient data initialization terminates abnormally.
task was purged. This abend is always followed by an ATDZ abend for
the failing function, and by message DFHSI1521 (if
System action CICS abends unconditionally), or message
DFHSI1522, which prompts you to reply GO or
The transaction is abnormally terminated with a CICS
CANCEL.
transaction dump.

User response
User response
See the associated console message for information
Investigate why the transaction was purged. It may
regarding the cause of the failure. Then respond to
have been purged via CEMT or automatically, by
message DFHSI1522, if it has been issued.
DTIMEOUT for example.
Module:
Module:
DFHTDRP
DFHETD
ATDZ
ATDS

Explanation
Explanation
A CICS function invoked by transient data initialization
A deadlock timeout condition has been detected. This
has failed. If the failing function is a transient data
condition may occur within a transaction that specifies
routine, this abend is preceded by a console message
DTIMOUT to be nonzero on its installed transaction
and an ATDY abend.
definition. Deadlock timeout occurs when a
transaction has been waiting or has been suspended
for longer than the time specified in DTIMOUT. System action

The abend is driven by the internal CICS event, Transient data initialization terminates abnormally.
ENQUEUE. This abend is always followed by message DFHSI1521
(if CICS abends unconditionally), or message
Analysis: The transaction receiving the ATDS abend DFHSI1522, which asks you to reply GO or CANCEL.
must have been suspended after issuing an ENQUEUE
request.
User response

System action Refer to the associated console message for further


information regarding the cause of the failure. Then
The transaction is abnormally terminated. A dump is respond to message DFHSI1522, if it has been issued.
not provided (even if a dump table entry has been set
up). Module:
DFHTDRP DFHTDB
ATFE

242 CICS TS for z/OS: CICS Codes


Explanation timed out after waiting for longer than the DTIMOUT
(deadlock timeout) value specified for the transaction,
A FREEMAIN request to the storage manager has
or by CICS issuing a purge request.
failed while CICS was executing a CEDA CHECK or
CEDA INSTALL command. If the master terminal operator purged the task, this
may have been in an attempt to clear the system
System action which appeared to be deadlocked for some reason.

CICS abnormally terminates the task with a If the task was timed out automatically as a result of
transaction dump. the DTIMOUT value being exceeded, this may be due
to insufficient main storage being available for the
number of tasks in the system. If the amount of main
User response
storage cannot be increased, reduce the number of
Use the dump and any associated messages issued by tasks in the system to avoid short-on-storage
the storage manager to investigate the FREEMAIN situations. Another possibility is to increase the value
failure. of the DTIMOUT option for the transaction.
Module: When CICS purges a task, it does so to allow an
DFHTOUT1 operation to complete which would be held up by the
presence of active tasks.
ATGE
Module:
Explanation DFHTMP

A GETMAIN request to the storage manager has failed ATMB


while CICS was executing a CEDA CHECK or CEDA
INSTALL command. Explanation
An error (INVALID, DISASTER or unexpected
System action EXCEPTION response) has occurred on a call to the
CICS abnormally terminates the task with a storage manager (SM) domain. The domain that
transaction dump. detected the original error will have provided an
exception trace, a console message and, possibly, a
system dump (depending on the options specified in
User response
the dump table).
Use the dump and any associated messages issued by
the storage manager to investigate the GETMAIN System action
failure.
The task is abnormally terminated with a CICS
Module: transaction dump.
DFHTOUT1
ATMA User response
See the related message from the domain that
Explanation detected the original error.
The task was purged before a GETMAIN request to the Module:
storage manager (SM) domain was able to complete DFHTMP
successfully. The domain that first detected the
purged condition will have provided an exception ATNA
trace.
Explanation
System action A terminal operator entered the transaction
The task is abnormally terminated with a CICS identification for NACP.
transaction dump.
System action
User response The transaction is abnormally terminated with a CICS
Investigate why the task was purged. It was purged transaction dump.
either as a result of a purge from the master terminal
operator via the CEMT transaction, or by the task being

Chapter 1. Transaction abend codes 243


User response critical point of processing and immediate termination
would put the integrity of the system at risk.
Do not reenter the NACP transaction identification
(CSNE).
System action
Module:
DFHZNAC The task is abnormally terminated with a CICS
transaction dump when the task next requests any
ATNB action against the terminal, or issues a sync point
request involving the terminal.
Explanation
The application program has issued a terminal control User response
request for a terminal for which a previous request Check destination CSMT for possible further
was terminated with an abend AZCT, because of a information. Use the dump to determine why the task
read timeout condition. The terminal control blocks was abnormally terminated by NEP. Abend ATND is
are not in a fit state to allow a new request to be often associated with delayed response by the task
processed. due to a problem with a resource. If delayed long
enough, a user might cancel their emulator session,
System action triggering an ATND abend. If you suspect this is the
case, investigate possible slow down or hangs in tasks.
The task is abnormally terminated with a CICS
transaction dump. Module:
DFHZARQ, DFHZARL, DFHZSUP
User response ATNI
Change the application program to issue an abend
when handling an abend AZCT. Explanation
Module: There are two forms of this abend:
DFHZARQ
VTAM form
ATNC
The node error program (NEP) or NACP decides the
task should be abnormally terminated. DFHZNAC
Explanation informs the request module to abend the
The application program has issued a terminal control transaction after the TC unit has completed.
request for a terminal for which a previous terminal Non-VTAM form
control request was terminated with an abend ATCH,
because the task was purged. The terminal control The terminal error program (TEP) or terminal
blocks are not in a fit state to allow a new request to abnormal condition program (TACP) decides the
be processed. task should be abnormally terminated. DFHTACP
informs DFHZARQ to abend the transaction after
the TC unit has completed.
System action
The task is abnormally terminated with a CICS System action
transaction dump.
The task is abnormally terminated with a CICS
transaction dump.
User response
Change the application program to issue an abend User response
when handling an abend ATCH.
This usually occurs when, due to a hardware failure, a
Module: network device rejects the data stream sent to it. The
DFHZARQ device itself may indicate an error code that will give a
ATND specific reason for the rejection. Check the CSMT log
for further information.
Explanation This abend can also result from an error in a
connected system such as a mirror transaction abend.
The node error program (NEP) or NACP decides that a
task should abnormally terminate, but the task is at a

244 CICS TS for z/OS: CICS Codes


Abend ATNI can occur if a user application does not Explanation
correctly handle an error return code from an external
CICS has received an abnormal response from a
resource manager, such as DB2.
request to DFHZCUT to timeout a local userid table
For the NEP (VTAM) form, run a VTAM trace type=BUF (LUIT). This is caused by an internal error in DFHZCUT.
for the logical unit and repeat the error.
For the TEP (non-VTAM) form, run a link trace for the System action
line or local channel address for the device. CICS terminates the CESC transaction with a dump.
Examine the data stream and error response to
determine the cause of the error. User response
This type of error occurs if the definitions in the TCT do If you need further assistance from IBM to resolve this
not match the attributes of the actual device. problem, see IBM problem support for guidance on
how to proceed.
Module:
DFHZARL, DFHZARM, DFHZARQ, DFHZRAQ, DFHZSUP Module:
DFHCESC
ATOA
ATOD
Explanation
Explanation
You have attempted to invoke the CESC transaction
with a terminal as principal facility. This is not allowed. CICS has received an abnormal response from an
EXEC CICS CANCEL TRANSACTION(CESC) request.
System action
System action
CICS terminates the CESC transaction. No dump is
produced. CICS terminates the CESC transaction with a dump.

User response User response


Ensure that the CESC transaction is not run against a If you need further assistance from IBM to resolve this
terminal. problem, see IBM problem support for guidance on
how to proceed.
Module:
DFHCESC Module:
DFHCESC
ATOB
ATOE
Explanation
Explanation
CICS has received an abnormal response from an
EXEC CICS START TRANSACTION(CESC) request. This CICS cannot determine the time at which an XRF
is caused by an internal error. takeover began.

System action System action


CICS terminates the CESC transaction with a dump. CICS terminates the CESC transaction with a dump.

User response User response


If you need further assistance from IBM to resolve this If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on problem, see IBM problem support for guidance on
how to proceed. how to proceed.
Module: Module:
DFHCESC DFHCESC
ATOC ATOF

Chapter 1. Transaction abend codes 245


Explanation Module:
DFHCESC
CICS has received an abnormal response from an
EXEC CICS DELAY TRANSACTION(CESC) request. ATOT

System action Explanation


CICS terminates the CESC transaction with a dump. An error has occurred in the invocation of the CEGN
transaction. CEGN has issued an EXEC CICS RETRIEVE
User response command to retrieve the CEGN parameter list. Either
the EXEC CICS RETRIEVE command has failed or it has
If you need further assistance from IBM to resolve this succeeded but the retrieved data is invalid.
problem, see IBM problem support for guidance on
how to proceed. The most likely cause of this error is an invalid attempt
by a user to invoke CEGN (for example, from a terminal
Module: or via an EXEC CICS START request).
DFHCESC
ATOG System action
CICS terminates the CEGN transaction with a
Explanation transaction dump.
CICS has received an abnormal response from an
EXEC CICS START TRANSACTION(CEGN) request. This User response
is caused by an internal error.
Determine how CEGN was invoked. If it was invoked
by CICS, you will need further assistance from IBM to
System action resolve this problem. See IBM problem support for
CICS terminates the CEGN transaction with a dump. guidance on how to proceed.
Module:
User response DFHCEGN
If you need further assistance from IBM to resolve this ATOU
problem, see IBM problem support for guidance on
how to proceed. Explanation
Module: The CEGN transaction has attempted to issue an EXEC
DFHCESC CICS RETURN but the command has failed.
ATOH
System action
Explanation CICS terminates the transaction with a dump.
An attempt has been made to invoke the CESC
transaction with an invalid function code. The CESC User response
transaction should only be invoked by CICS. Valid
If you need further assistance from IBM to resolve this
codes are TERM_TIMEOUT, XRF_TIMEOUT, and
problem, see IBM problem support for guidance on
ENABLE_TIMEOUT.
how to proceed.
The most likely cause of this error is an invalid attempt
Module:
by a user to invoke CESC.
DFHCEGN

System action ATOV

CICS terminates the CESC transaction with a


Explanation
transaction dump.
The CEGN transaction has attempted to issue an EXEC
User response CICS GETMAIN, ASSIGN, or SEND but the command
has failed.
Determine how CESC was invoked. If it was invoked by
CICS, you will need further assistance from IBM to
System action
resolve this problem. See IBM problem support for
guidance on how to proceed. CICS terminates the transaction with a dump.

246 CICS TS for z/OS: CICS Codes


User response User response
If you need further assistance from IBM to resolve this If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on problem, see IBM problem support for guidance on
how to proceed. how to proceed.
Module: Module:
DFHCEGN DFHTPQ.
ATPA ATPD

Explanation Explanation
An error occurred when trying to estimate the length of An error occurred when trying to retrieve a CICS
a CICS message owned by the message domain. message from the message domain.

System action System action


CICS terminates the transaction with a dump. CICS terminates the transaction with a dump.

User response User response


If you need further assistance from IBM to resolve this If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on problem, see IBM problem support for guidance on
how to proceed. how to proceed.
Module: Module:
DFHTPR. DFHTPQ.
ATPB ATPE

Explanation Explanation
An error occurred when trying to retrieve a CICS The task was purged before a GETMAIN request to the
message from the message domain. storage manager (SM) domain was able to complete
successfully. The task that first detected the purged
System action condition will have provided an exception trace.

CICS terminates the transaction with a dump.


System action

User response The task is abnormally terminated with a CICS


transaction dump.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
User response
how to proceed.
Investigate why the task was purged. It was purged
Module:
either as a result of a purge from the master terminal
DFHTPR.
operator via the CEMT transaction, or by the task being
ATPC timed out after waiting for longer than the DTIMOUT
(deadlock timeout) value specified for the transaction,
Explanation or by CICS issuing a purge request.

An error occurred when trying to estimate the length of If the master terminal operator purged the task, this
a CICS message owned by the message domain. may have been in an attempt to clear the system
which appeared to be deadlocked for some reason.
System action If the task was timed out automatically as a result of
the DTIMOUT value being exceeded, this may be due
CICS terminates the transaction with a dump.
to insufficient main storage being available for the
number of tasks in the system. If the amount of main
storage cannot be increased, reduce the number of
tasks in the system to avoid short-on-storage

Chapter 1. Transaction abend codes 247


situations. Another possibility is to increase the value DFHTRP
of the DTIMOUT option for the transaction.
ATSA
When CICS purges a task, it does so to allow an
operation to complete which would be held up by the Explanation
presence of active tasks.
The transaction CTSD was attached other than by an
Module: internal request from the TS domain.
DFHTPQ, DFHTPR.
ATPF System action
The transaction is abnormally terminated with a CICS
Explanation transaction dump.
An error (INVALID, DISASTER, or unexpected
EXCEPTION response) has occurred on a call to the User response
storage manager (SM) domain. The domain that
Investigate why the CTSD transaction was started.
detected the original error will have provided an
This transaction is intended for CICS internal use only
exception trace, a console message and, possibly, a
and should not be started by a user or from a terminal.
system dump (depending on the options specified in
the dump table). Module:
DFHTSDQ
System action ATSB
The task is abnormally terminated with a CICS
transaction dump. Explanation
The transaction CTSD was attached with invalid
User response parameters.
See the related message produced by the domain that
detected the original error. System action
Module: The transaction is abnormally terminated with a CICS
DFHTPQ, DFHTPR. transaction dump.
ATRA
User response
Explanation You need further assistance from IBM to resolve this
problem. See IBM problem support for guidance on
The field engineering global trap exit program,
how to proceed.
DFHTRAP, requested task abnormal termination.
However, the currently active task was not a system Module:
task (for example, task dispatcher) and it was not DFHTSDQ
about to abend.
ATSC

System action
Explanation
CICS disables the trap exit so that it will not be
The task was canceled during execution of a
reentered, and terminates the currently active task
temporary storage command.
abnormally.

System action
User response
The transaction is abnormally terminated with a CICS
This is a user-requested task abend.
transaction dump.
If you want to use the trap again, you must reactivate
it as follows: User response
CSFE DEBUG,TRAP=ON Investigate the reason the task was canceled. The task
You should use the global trap exit only in has been canceled by the master terminal operator or
consultation with an IBM support representative. automatically by either the deadlock timeout

Module:

248 CICS TS for z/OS: CICS Codes


(DTIMEOUT) mechanism or the read timeout User response
(RTIMOUT) mechanism.
Identify the failing temporary storage request in the
Module: application and verify whether the length supplied on
DFHEITS, DFHICP, DFHTSP the request agrees with the data area size. Correct the
application as appropriate.
ATSD
Note:
Explanation If the error occurs in DFHTSP and not in DFHETS, there
An INVALID or DISASTER response was received from is probably an internal logic error in temporary
a request to the Temporary Storage (TS) Domain. storage. In this case you will need further assistance
from IBM. See IBM problem support for guidance on
how to proceed.
System action
Module:
The transaction is terminated with a CICS transaction
DFHEITS
dump.
ATSU
User response
Explanation
There has been an earlier failure which lead to the
response from TS. Investigate the earlier failure A DISASTER response caused by an IOERR was
(which is accompanied by a console message and a received from a request to the Temporary Storage (TS)
system dump). Domain.
Module:
DFHEITS, DFHICP, DFHTSP System action

ATSP The transaction is terminated with a CICS transaction


dump.
Explanation
User response
A task has attempted to issue a WRITEQ TS request
for a recoverable TS queue that has already been There has been a failure during the creation of a
deleted in the same unit of work. temporary storage record. The likelihood is that an
IOERR occurred during the buffer preparation prior to
the new record being added to it. It is recommended
System action
that the queue be deleted to avoid future references to
The task is abnormally terminated with a CICS the failed record.
transaction dump.
Module:
DFHEITS, DFHTSP, DFHICP
User response
ATUF
Correct the application to avoid issuing a WRITEQ TS
request to a recoverable queue in a unit of work in
Explanation
which the queue has already been deleted.
Insufficient space exists to build the parameter list for
Module:
the DYNALLOC SVC.
DFHEITS, DFHTSP
ATSQ System action
The task is abnormally terminated and a dump is
Explanation
taken.
A move of data to or from temporary storage has
failed. The probable reason is that the size of the area User response
being passed to CICS is inconsistent with the data
length being used. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed.
System action
Module:
The transaction is abnormally terminated with a CICS
DFH99KO
transaction dump.

Chapter 1. Transaction abend codes 249


AUxx abend codes
AUEL Exit Handler by a User Exit Program. The value of
UERCPURG is defined by the macro DFHUEXIT
Explanation TYPE=EP, ID=xxxxxxxx, where xxxxxxxx is the exit
point by which the exit program is enabled. This code
Internal logic error in CICS user exit management. This does not apply to exit points in domains. The exit
arises when an attempt to obtain or release the lock program returns this value when it has made a request
on the chain of EPB's fails unexpectedly. for CICS services using the exit programming Interface
(XPI) and when the XPI call has had a RESPONSE code
System action of PURGED. Exit programs must not set UERCPURG
return code under any other circumstance.
The task is abnormally terminated with a CICS
transaction dump.
System action
User response The task is abnormally terminated with a CICS
transaction dump.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed. User response

Module: Refer to the Developing system programs for CICS for


DFHUEM, DFHERM. the use of this return code.

AUEP Module:
DFHUEH
Explanation
The task has been abnormally terminated because a
return code of UERCPURG has been sent to the User

AWxx abend codes


AW2A Explanation
The CICS Web Interface has encountered an error
Explanation while performing a transaction attach call for the alias
The DFHW2A Web2.0 alias program was executed in a task.
transaction that was not attached by CICS Web
Support. This is usually caused by attempting to issue System action
the CW2A transaction directly from a terminal. This is Message DFHWB0727 describing the error is written
not supported. to the CWBO transient data destination and a trace
entry is made.
System action
The task is abnormally terminated with a CICS User response
transaction dump. See the associated message for guidance.

User response Module:


DFHWBXN
Do not attempt to execute the CW2A transaction from
a terminal. AWB3

Module: Explanation
DFHW2W2
CICS Web transaction, CWXN, has been illegally
AWB2 started either with data, or by a user at a terminal, with
the wrong start code.

250 CICS TS for z/OS: CICS Codes


System action does not appear to be executing in a valid Web
environment.
The CICS Web Interface is not started.

System action
User response
The program writes an exception trace point 4623.
CICS Web Transaction Execution should only ever be
started by Sockets Domain using DFHXMAT ATTACH,
not by a user at a terminal or with data. User response

Module: Determine how the environment variables program


DFHWBXN was invoked. It is only meaningful to execute the
program from a transaction that has been initiated
AWB4 from the Web, either through the CICS Web Interface
or through the Business Logic Interface.
Explanation
Module:
The CICS Web Transaction Execution has received a DFHWBENV
bad response from an INQUIRE_TRANSACTION call to
AWB8
determine the start code for the CWXN transaction.

Explanation
System action
The CICS Web Interface environment garbage
The CICS Web Interface is not started.
collection task CWBG has been started directly from a
terminal. This is not permitted.
User response
CICS Web Transaction Execution should only ever be System action
started by Sockets Domain using DFHXMAT ATTACH,
The transaction is abnormally terminated with a
not by a user at a terminal or with data.
transaction dump.
Module:
DFHWBXN User response
AWB5 None.
Module:
Explanation
DFHWBGB
The CICS Web Interface Server Controller could not
AWB9
continue with enable processing because the
requested port is not available.
Explanation
System action The CICS Web Interface connection manager failed
due to lack of storage.
An exception trace entry 4106 is written, and message
DFHWB0131 is issued.
System action
User response A transaction dump is taken.
Terminate the TCP/IP application which is using the
requested port, and use CBWB to enable the feature User response
again, or use CWBC to enable the CICS web Interface You need further assistance from IBM to resolve this
using a different port number. problem. See IBM problem support for guidance on
Module: how to proceed.
DFHWBM Module:
AWB7 DFHWBC01
AWBA
Explanation
The CICS Web Interface environment variables
program was invoked, but the invoking transaction

Chapter 1. Transaction abend codes 251


Explanation commarea that was passed was absent or was too
short to contain valid information.
CICS Web Receive process has received an exception
response from the Web Send Receive function,
DFHWBSR, which could be one of the following errors: System action

• An error in the Analyzer program The CICS Web Interface utility is not executed.
• No Analyzer program specified
User response
• Unable to link to Analyzer program
Ensure that the program passes a commarea that is
• An Analyzer data length error
long enough to contain the expected parameters for
• An Analyzer header length error the utility you are invoking.
• A codepage conversion error Module:
• A storage error occurred DFHWBENV, DFHWBTL
• An error that the connection has been closed AWBD
• A sockets receive error
Explanation
System action CICS detected an error during transaction initialization
An error message is sent to the client and the CWBO for a directly attached user transaction because CICS
transient data queue. either failed to authenticate the user or Web Receive
process has received an exception response from the
Web Send Receive function, DFHWBSR, which could
User response
be one of the following errors:
Refer to any error messages accompanying this abend
• A storage error occurred
to determine why the abend has occurred.
• Method in the request not implemented by the
Module: server
DFHWBXN
• A socket receive error
AWBB
• Request header is invalid

Explanation • A codepage conversion error


• An error that the connection has been closed
The incoming parameter list to the CICS Web Business
Logic Interface program is not in the expected format.
At present, the structure is assumed to be fixed and System action
only a single version level is recognized. An error message is sent to the client and the CWBO
transient data queue.
System action
The CICS Web Business Logic Interface program is not User response
executed. Refer to any error messages accompanying this abend
to determine why the abend has occurred.
User response
Module:
Ensure that the program receives a parameter list in DFHWBXM
the correct format.
AWBE
Module:
DFHWBBLI Explanation
AWBC The CICS Web Interface detected that a Converter
program attempted to change the address of the
Explanation response buffer when it was not allowed to do so.
No commarea was passed to a CICS Web Interface
utility program. One of the utility programs supplied System action
with the CICS Web Interface was executed, but the The data in the new response buffer is not returned to
the Web browser. A CICS transaction dump is taken.

252 CICS TS for z/OS: CICS Codes


User response System action
The Converter program is only allowed to replace the An exception trace entry 4544 is written. Message
response buffer if the converter_volatile flag in DFHWB0102 is written to the CWBO destination.
the Converter parameter list is set to '1'. Check that
your Converter program is not trying to return a new User response
response buffer when this flag is set to '0'.
You need further assistance from IBM to resolve this
Module: problem. See IBM problem support for guidance on
DFHWBBLI how to proceed.
AWBF Module:
DFHWBA
Explanation
AWBJ
The CICS Web Interface alias detected an error in its
initialization. The alias was not started by EXEC CICS Explanation
START, or there was an error in the EXEC CICS
RETRIEVE command for the start data. The CICS Web Interface alias received an unexpected
response when it switched to the RP TCB.
System action
System action
If there is an error in EXEC CICS RETRIEVE, message
DFHWB0103 is written to the CWBO destination. A An exception trace entry 454E is written. Message
CICS transaction dump is taken. DFHWB0105 is written to the CWBO destination. A
transaction dump is taken.
User response
User response
If the alias was not started by EXEC CICS START,
check if it is being started from a terminal. This is not See the associated message for guidance.
allowed. Otherwise, see the associated message for Module:
guidance. DFHWBA
Module: AWBK
DFHWBA
AWBH Explanation
The CICS Web Interface alias detected an abend in the
Explanation converter or the CICS program servicing the request.
The CICS Web Interface alias detected a logic error.
System action
System action An exception trace entry 4550 is written. Message
An exception trace entry 454F is written. Message DFHWB0108 is written to the CWBO destination.
DFHWB0106 is written to the CWBO destination. A
CICS transaction dump is taken. User response
Use related diagnostics to determine the user
User response response.
Use related diagnostics to determine the user Module:
response. DFHWBA
Module: AWBL
DFHWBA
AWBI Explanation
The CICS Web Interface alias detected an error in an
Explanation EXEC CICS LINK command for program DFHWBBLI.
The CICS Web Interface alias received an unexpected
response from EXEC CICS ASSIGN STARTCODE

Chapter 1. Transaction abend codes 253


System action System action
An exception trace entry 4543 is written. Message Message DFHWB0114 is written to the CWBO
DFHWB0101 is written to the CWBO destination. A transient data destination and a transaction dump is
transaction dump is taken. taken. An exception trace entry, 4567, is also written.

User response User response


See the associated message for guidance. See the associated message for guidance.
Module: Module:
DFHWBA DFHWBA
AWBM AWBP

Explanation Explanation
The CICS Web Interface alias detected error response The CICS Web Interface alias has detected that the
from the Business Logic Interface program application has started sending a chunked response
DFHWBBLI. over the socket but has not terminated the sequence
of web send chunk commands with a zero length
System action chunk.

Message DFHWB0101 is written to the CWBO


System action
destination. A transaction dump is taken.
A transaction dump is taken.
User response
User response
See the associated message for guidance.
Check the application to see why the terminating
Module:
chunk was not sent.
DFHWBA
Module:
AWBN
DFHWBA

Explanation AWBQ

The CICS Web Interface alias detected an error in an


Explanation
EXEC CICS LINK command for program DFHWBEP.
The CICS Web Business Logic Interface program
System action detected an error in its parameter list.

Message DFHWB0101 is written to the CWBO


System action
destination. A transaction dump is taken.
If the abend was issued from the Business Logic
User response Interface program, DFHWBBLI, an exception trace
entry '4581' is made and message DFHWB0119 is
See the associated message for guidance. written to the CWBO transient data destination. If the
Module: abend was issued from the Web Interface program,
DFHWBA DFHWBA1, an exception trace entry '4560' is written
and message DFHWB0124 is sent to the CWBO
AWBO destination. A transaction dump is taken.

Explanation User response


The CICS Web Interface alias program has received a See the associated message for guidance.
non-HTTP request for an HTTP service or a SSL
request has been sent to a non-SSL TCPIPSERVICE. Module:
DFHWBA1, DFHWBBLI
AWBR

254 CICS TS for z/OS: CICS Codes


Explanation AWBX
The CICS Web Business Logic Interface program
detected a logic error. Explanation
The CICS Web Interface connection manager was
System action started against an invalid terminal type.
If the abend was issued from the Business Logic
Interface program, DFHWBBLI, an exception trace System action
entry '4583' is made and message DFHWB0118 is An exception trace entry 4308 is written. Message
written to the CWBO transient data destination. If the DFHWB1522 is written to the CWBO destination.
abend was issued from the Web Interface program,
DFHWBA1, an exception trace entry '4558' is written
User response
and message DFHWB0123 is sent to the CWBO
destination. See the associated message for guidance.
Module:
User response DFHWBC01
Use related diagnostics to determine the user AWBZ
response.
Module: Explanation
DFHWBA1, DFHWBBLI
The CICS Web Interface connection manager detected
AWBU a NOTAUTH response to EXEC CICS EXTRACT EXIT.

Explanation System action


The CICS Web Interface connection manager could Message DFHWB1902 is written to the CWBO
not get storage to send a message to the terminal. destination.

System action User response


Processing continues. See the associated message for guidance.
Module:
User response DFHWBC0B
Use related diagnostics to determine the user AWC1
response.
Module: Explanation
DFHWBC01
The CICS Web Interface 3270 bridge exit DFHWBLT
AWBV could not establish a partnership with the Web
terminal translation task which started the abended
Explanation transction.

The CICS Web Interface connection manager detected


System action
an error response on EXEC CICS DEQ.
An exception trace entry 4106 is written, and message
System action DFHWB0131 is issued.

An exception trace entry 4345 is written. Message


User response
DFHWB1651 is written to the CWBO destination.
Use related diagnostics to determine the user
User response response.

You need further assistance from IBM to resolve this Module:


problem. See IBM problem support for guidance on DFHWBLT
how to proceed. AWC2
Module:
DFHWBC04

Chapter 1. Transaction abend codes 255


Explanation Explanation
The CICS Web Interface 3270 bridge exit DFHWBLT The CICS Web Interface 3270 bridge exit DFHWBLT
was passed an invalid state token by attach abended during attach processing because it could not
processing. getmain a brxa user area.

System action System action


An exception trace entry 410C is written, and message Message DFHWB0132 is issued, and an exception
DFHWB0130 is issued. trace entry 410D is written.

User response User response


Use related diagnostics to determine the user Use related diagnostics to determine the user
response. On a busy CICS region, the most likely cause response. The most likely cause of this abend is that
is that the bridged transaction started after the state CICS is having storage problems.
data had been discarded by Web 3270 garbage
Module:
collection process.
DFHWBLT
Module:
AWC6
DFHWBLT
AWC3 Explanation
The CICS Web Interface 3270 bridge exit DFHWBLT
Explanation
has detected an inconsistency in its request
An application using the CICS Web 3270 function parameters or state data.
issued an unsupported combination of BMS and
Terminal Control commands. System action
Message DFHWB0133 is issued, and an exception
System action
trace entry is written.
An exception trace entry is written.
User response
User response
Use related diagnostics to determine the user
Use related diagnostics to determine the user response. The most likely cause of this abend is a
response. storage overwrite.
Module: Module:
DFHWBLT DFHWBLT
AWC4 AWC7

Explanation Explanation
The CICS Web Interface 3270 bridge exit DFHWBLT CICS detected an error during transaction initialization
has been reinvoked after returning an earlier error. for a CICS Web alias transaction.

System action System action


An exception trace entry is written. Message DFHWB0360 is issued. No transaction dump
is taken for this abend.
User response
User response
Use related diagnostics to determine the user
response. Use related diagnostics to determine the user
response. The most likely cause of this abend is an
Module:
invalid userid being passed to CICS by the CICS Web
DFHWBLT
Interface Analyzer user replaceable module. The
AWC5 userid is invalid if:
• It is not defined in the external security manager

256 CICS TS for z/OS: CICS Codes


• It is revoked Module:
• It is not authorized to access this CICS region DFHWKP

Module: AWSA
DFHWBXM
Explanation
AWC8
DFHWSSE1 failed to address the EIB.
Explanation
System action
CICS detected an error during transaction initialization
for a CICS Web alias transaction. The task is abnormally terminated.

System action User response


A transaction dump is taken for this abend. You need further assistance from IBM to resolve this
problem. See IBM problem support for guidance on
User response how to proceed.

Use related diagnostics to determine the user Module:


response. DFHWSSE1

Module: AWSC
DFHWBXM
Explanation
AWC9
A container which is required by a SOAP Feature
Explanation pipeline stage was not found.

CICS detected an error during transaction initialization System action


for a CICS IPCONN acquire server-side transaction.
The task is abnormally terminated with a CICS
System action transaction dump.

A severe error message and system dump should have User response
preceeded this abend.
Check that user-written programs in earlier pipeline
User response stages use the correct containers.

Use related diagnostics to determine the cause of the Module:


problem. DFHWSPMI,DFHWSPMO

Module: AWSD
DFHWBXM
Explanation
AWKY
DFHWSSE1 failed to read a Container.
Explanation
System action
A request to PURGE or WRITE a record using the
global catalog during warm keypointing has failed. The task is abnormally terminated.

System action User response


The task is abnormally terminated with a CICS You need further assistance from IBM to resolve this
transaction dump. problem. See IBM problem support for guidance on
how to proceed.
User response Module:
Check for problems with the global or local catalog. DFHWSSE1
See any DFHCCnnnn messages issued by the CICS AWSH
catalog domain for further guidance.

Chapter 1. Transaction abend codes 257


Explanation Explanation
A BTS activity that represents a stage in the SOAP An EXEC CICS DEFINE COUNTER or EXEC CICS GET
Feature pipeline was found by the pipeline manager to COUNTER command has returned a bad response.
be in an incorrect state.
System action
System action
The task is abnormally terminated with a CICS
The task is abnormally terminated with a CICS transaction dump.
transaction dump.
User response
User response
Check the options table DFHNCOPT for possible
Check that user-written programs in earlier pipeline errors. Look in the CICS job log for any AXMSCnnnn
stages use the correct BTS protocols. messages.
Module: Module:
DFHWSPMI,DFHWSPMO DFHWSDSH
AWSJ AWSP

Explanation Explanation
DFHWSSE1 failed to get the length of a Container. An application making a Web Service request passed a
SOAPAction HTTP request header exceeding 256
System action bytes in length to the SOAP Feature pipeline.

The task is abnormally terminated.


System action

User response The task is abnormally terminated.

You need further assistance from IBM to resolve this


User response
problem. See IBM problem support for guidance on
how to proceed. Check that SOAPAction headers exceeding 256 bytes
in length are not constructed by applications invoking
Module:
Web Services.
DFHWSSE1
Module:
AWSL
DFHWSRT

Explanation AWSQ

The SOAP Feature inbound pipeline manager could not


Explanation
link to the message adapter.
This is normal behavior when a user stage of the
System action pipeline abends.

The task is abnormally terminated with a CICS


System action
transaction dump.
The task is abnormally terminated with a CICS
User response transaction dump.

Check previous CICS messages to determine why the


User response
message adapter could not be linked to.
Correct the user abend.
Module:
DFHWSPMI Module:
DFHWSPMI
AWSN
AWSR

258 CICS TS for z/OS: CICS Codes


Explanation AWSU
Either the TARGET-URI or the REQUEST-BODY
container was not found when an application invoked Explanation
the SOAP Feature pipeline to make a Web Service An invalid URI was passed to the SOAP Feature
request. requester pipeline as the location of a Web Service
provider.
System action
The task is abnormally terminated with a CICS System action
transaction dump. The task is abnormally terminated with a CICS
transaction dump.
User response
Check that the application making the Web Service User response
request supplies the required containers. Check that applications making Web Service
Module: requesting specify valid URIs for locations of Web
DFHWSRT Service providers.

AWSS Module:
DFHWSRT
Explanation AWSX
The SOAP Feature service provider pipeline was
requested to invoke the message adapter under a Explanation
different transaction ID or user ID to the pipeline, but DFHWSSE1 received an unexpected response from the
was unable to satisfy the request. WSSE API.

System action System action


The task is abnormally terminated. The task is abnormally terminated.

User response User response


Check that transaction ID and user ID requested are You need further assistance from IBM to resolve this
valid, and that the user ID with which the pipeline is problem. See IBM problem support for guidance on
running is a surrogate of the requested user ID. how to proceed.
Module: Module:
DFHWSPMI DFHWSSE1
AWST AWSY

Explanation Explanation
The HTTP or WebSphere MQ transport stage of the A problem was encountered in the DFHPIRT outbound
SOAP Feature pipeline has encountered an input or router program. This usually implies that one of the
output error. containers used by DFHPIRT was not populated
correctly.
System action
The task is abnormally terminated. System action
The task is abnormally terminated with a CICS
User response transaction dump.
Use CICS or WebSphere MQ messages to help you
determine the cause of the problem. The error may be User response
transient, in which case you can retry. Check that applications using DFHPIRT correctly
Module: populate the control containers required for pipeline
DFHWSTOH processing.

Chapter 1. Transaction abend codes 259


Module: DFHPIRT

AXxx abend codes


AXF0 User response
Try the transaction again later.
Explanation
If the short-on-storage condition persists, increase the
A task has been purged due to lack of storage in a size of the dynamic storage area using the DFHSIT
dynamic storage area (DSA). DSA parameter.
Module:
System action DFHXFP
The task is abnormally terminated with a transaction AXF3
dump.
Explanation
User response
The storage manager module DFHSMMC has returned
Try the transaction again later. a condition not expected by DFHXFP.
If the short-on-storage condition persists, consider
increasing the size limit of the CICS DSAs. You can System action
vary the DSAs dynamically using the DSALIM and
EDSALIM parameters on the CEMT master terminal The task is abnormally terminated with a transaction
command. dump.

Module: User response


DFHXFP
Look for any related CICS messages and abends to
AXF1 determine if there has been a prior failure in CICS
storage.
Explanation
Module:
The storage manager module, DFHSMGF, has returned DFHXFP
a condition not expected by DFHXFP.
AXF4
System action
Explanation
The task is abnormally terminated with a transaction
dump. The task was purged before a GET_BUFFER request to
the EXEC interface service routines module
(DFHEISR), was able to complete successfully. The
User response domain that first detected the purged condition
Look for any related CICS messages and abends to provides an exception trace.
determine if there has been a prior failure in CICS
storage. System action
Module: The task is abnormally terminated with a CICS
DFHXFP transaction dump.
AXF2
User response
Explanation Investigate why the task was purged. It was purged
A task has been purged due to lack of storage in the either as a result of a purge from the master terminal
DSA. operator via the CEMT transaction, or by the task being
timed out after waiting for longer than the DTIMOUT
(deadlock timeout) value specified for the transaction.
System action
If the master terminal operator purged the task, this
The task is abnormally terminated with a transaction may have been in an attempt to clear the system
dump. which appeared to be deadlocked for some reason.

260 CICS TS for z/OS: CICS Codes


If the task was timed out automatically as a result of Explanation
the DTIMOUT value being exceeded, this may be due
The key length for a file control request that is to be
to insufficient main storage being available for the
sent to a remote system has to be obtained from the
number of tasks in the system. If the amount of main
file control table, and has proved to be zero.
storage cannot be increased, reduce the number of
tasks in the system to avoid short-on-storage
situations. Another possibility is to increase the value System action
of the DTIMOUT option for the transaction. The task is abnormally terminated with a CICS
Module: transaction dump.
DFHXFX
User response
AXF5
Ensure that the key length has been defined either in
Explanation the remote file definition that is being used, or as a
length option from the application program that is
An error (INVALID, DISASTER, or unexpected using it.
EXCEPTION response) has occurred on a call to the
EXEC interface service routines module(DFHEISR). Module:
The domain that detected the original error provides DFHXFP
an exception trace, a console message, and possibly, a AXFB
system dump (depending on the options specified the
dump table).
Explanation

System action An unacceptable function management header (FMH)


type has been found. It must be type 05, type 06, or
The task is abnormally terminated with a CICS type 43.
transaction dump.
System action
User response
The task is abnormally terminated with a CICS
See the related message from the domain that transaction dump.
detected the original error.
Module: User response
DFHXFX
If you need further assistance from IBM to resolve this
AXF8 problem, see IBM problem support for guidance on
how to proceed.
Explanation Module:
A keyword such as TOKEN, CONSISTENT, DFHXFP
REPEATABLE, UNCOMMITTED, or NOSUSPEND has AXFC
been specified on a file control command for shipping
to a system which does not support these functions.
Explanation

System action The request passed to the data transformation


program is unknown to CICS. This abend can also
The task is abnormally terminated with a CICS occur in an MRO/IRC system as a result of an invalid
transaction dump. EXEC CICS START request issued from the user's node
error program (DFHZNEP).
User response
Ensure that CICS in the file-owning region is at the System action
correct level. The task is abnormally terminated with a CICS
Module: transaction dump.
DFHXFX
User response
AXFA
See the Developing system programs for CICS for
restrictions on the use of EXEC CICS commands from

Chapter 1. Transaction abend codes 261


within an NEP. If this is not the cause of the abend, you User response
will need further assistance from IBM. See IBM
If you need further assistance from IBM to resolve this
problem support for guidance on how to proceed.
problem, see IBM problem support for guidance on
Module: how to proceed.
DFHXFP
Module:
AXFD DFHXFP
AXFG
Explanation
The request that is passed to the data transformation Explanation
program cannot be sent to a remote system; for
An unacceptable argument number has been found in
example, a storage control request.
the data following a function management header
(FMH) of type 43.
System action
The task is abnormally terminated with a CICS System action
transaction dump.
The task is abnormally terminated with a CICS
transaction dump.
User response
If you need further assistance from IBM to resolve this User response
problem, see IBM problem support for guidance on
If you need further assistance from IBM to resolve this
how to proceed.
problem, see IBM problem support for guidance on
Module: how to proceed.
DFHXFP
Module:
AXFE DFHXFP
AXFH
Explanation
The transformation requested does not exist; for Explanation
example, a DL/I schedule reply is not recognized by
The argument number in the data following a function
the outbound request processor in the data
management header (FMH) of type 43 is acceptable,
transformation program.
however, the argument itself is not expected.

System action
System action
The task is abnormally terminated with a CICS
The task is abnormally terminated with a CICS
transaction dump.
transaction dump.

User response
User response
If you need further assistance from IBM to resolve this
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
problem, see IBM problem support for guidance on
how to proceed.
how to proceed.
Module:
Module:
DFHXFP
DFHXFP
AXFF
AXFI

Explanation
Explanation
An unacceptable queue organization has been found in
The data length for a WRITEQ TD or READQ TD is zero.
a queue model function management header (FMH).
The abend can also occur when determining the length
for file control requests.
System action
The task is abnormally terminated with a CICS
transaction dump.

262 CICS TS for z/OS: CICS Codes


System action System action
The task is abnormally terminated with a CICS The task is abnormally terminated with a CICS
transaction dump. transaction dump.

User response User response


Notify the system programmer. Check that daisy-chaining of requests is intended and
that all relevant intersystem links are in service.
Module:
DFHXFP Module:
DFHXFP
AXFJ
AXFN
Explanation
Explanation
The error code held in UIBFCTR and UIBDLTR cannot
be converted to an equivalent SNA error code. The user domain module, DFHUSAD, has returned a
condition not expected by DFHXFX.
System action
System action
The task is abnormally terminated with a CICS
transaction dump. The task is abnormally terminated with a transaction
dump.
User response
User response
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Look for any related CICS messages, abends or
how to proceed. exception traces to determine if there has been a prior
failure in user domain or security domain.
Module:
DFHXFP Module:
DFHXFX
AXFL
AXFO
Explanation
Explanation
Transformers 2 and 4 expect to receive a function
management header (FMH), possibly followed by user The check on the DS and DBA parameters in an attach
data. A null chain of data has been received. function management header (FMH) has failed. This
abend represents a user error resulting from a
System action mismatch in the system definitions for both ends of an
intersystem link.
The task is abnormally terminated with a CICS
transaction dump.
System action

User response The task is abnormally terminated with a CICS


transaction dump.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
User response
how to proceed.
Notify the system programmer.
Module:
DFHXFP Module:
DFHXFP
AXFM
AXFP
Explanation
Explanation
The ISCINVREQ condition has been raised. This can
happen when the resource proves to be on yet another CICS requires a second function management header
remote system, that is, when daisy-chaining is active. (FMH) to follow an attach FMH. No second FMH was
received.

Chapter 1. Transaction abend codes 263


System action used to retrieve large segments, and/or if FLS causes
excessive expansion of segments.
The task is abnormally terminated with a CICS
transaction dump.
System action
User response The task is abnormally terminated with a CICS
transaction dump.
Notify the system programmer.
Module: User response
DFHXFP
Notify the system programmer.
AXFQ
Module:
DFHXFP
Explanation
AXFT
Either the function management header (FMH) just
received is too short or too long to be a valid FMH, or
an expected FMH is not present. Explanation
An estimate of the size of the output I/O area has been
System action made, and it exceeds the maximum possible size of
65 535.
The task is abnormally terminated with a CICS
transaction dump. Note:
While the estimated size may exceed the actual size,
User response the difference will only be a few bytes.
Check that the transaction profile parameter, INBFMH, This abend is likely to occur if a database calls, inserts,
is set to ALL. If communicating across a distributed or replaces multiple segments, and many qualified
program link, ensure that the requested function is segment search arguments are specified.
supported on the partner system.
Module: System action
DFHXFP
The task is abnormally terminated with a CICS
AXFR transaction dump.

Explanation User response


The CICS command level interface imposes a Notify the system programmer.
maximum length of 32 767 for data. The length of the
Module:
data just received exceeds this limit.
DFHXFP

System action AXFU

The task is abnormally terminated with a CICS


Explanation
transaction dump.
A two-level cursor is present in a function
User response management header (FMH) relating to a linear
(temporary storage) queue. However, these cursors
Notify the system programmer. are valid only for hierarchical queues that are not
Module: supported by CICS.
DFHXFP
System action
AXFS
The task is abnormally terminated with a CICS
Explanation transaction dump.

A PSB has been scheduled successfully. However, the


maximum possible length of an I/O area exceeded
65 535. This abend is likely to occur if path calls are

264 CICS TS for z/OS: CICS Codes


User response • the remote system does not support full syncpoint
protocols, or
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on • the exchange log name sequence could have failed,
how to proceed. resulting in a mismatch, or
Module: • the request has not completed within the allocated
DFHXFP time (10 seconds).

AXFV System action

Explanation CICS terminates the task abnormally.

The user domain module, DFHUSAD, has returned a User response


condition not expected by DFHXFX.
Check that the request was directed to the correct
System action remote system, and that the remote system is set up
to support full syncpoint protocols (synclevel 2).
The task is abnormally terminated with a transaction
dump. Module:
DFHXFP
User response AXFY
Look for any related CICS messages, abends or
exception traces to determine if there has been a prior Explanation
failure in user domain or security domain. An APPC conversation failure has occurred when an
Module: attach between CICS systems was issued.
DFHXFX
System action
AXFW
The task is abnormally terminated with a transaction
Explanation dump.

An invalid length specification has been given in a CICS User response


command-level request corresponding to one of the
data variables. Check the connection to the remote CICS system and
try to reestablish it.
The CICS-architected FMH is followed by zero or more
self-describing data variables for each parameter Module:
specified. DFHXFP
AXFZ
System action
The task is abnormally terminated with a CICS Explanation
transaction dump. The monitoring domain module, DFHMNOD, has
returned a condition not expected by DFHXFX.
User response
Check for an invalid or zero length specified in a CICS System action
command-level request, or for data truncation in a The task is abnormally terminated with a transaction
user-written node error program (NEP). dump.
Module:
DFHXFP User response
AXFX Look for any related CICS messages, abends or
exception traces to determine if there has been a prior
Explanation failure in the monitoring domain.
A function shipping request by an APPC link failed Module:
because DFHXFX
AXGA

Chapter 1. Transaction abend codes 265


Explanation Explanation
Program DFHAPCR has returned an unexpected The application context handling module, DFHMNAC,
response. DFHAPCR performs the following functions:- has returned an unexpected response from function
GET_ACD.
• Extracts the contents of all containers making up a
channel and transmits them to a remote system.
System action
• Recreates the channel and containers from inbound
data received from a remote system. The task is abnormally terminated with a transaction
dump.
DFHAPCR has either detected an error in inbound data
or has received an unexpected response whilst
extracting or recreating channel data. User response

One cause of this error is that an EXCI job using Contact your IBM support center.
channels and containers has sent a Module:
DFHTRANSACTION channel to a CICS release that DFHXFX, DFHXFP
does not support transaction channels. Transaction
channels are supported in CICS TS 5.2 and higher. AXGD

System action Explanation

The task is abnormally terminated with a CICS The application context handling module, DFHMNAC,
transaction dump. has returned an unexpected response from function
MIRROR_ACD.
User response
System action
Look for any related CICS messages and abends to
determine if there has been a prior failure in Program The task is abnormally terminated with a transaction
Manager, which manages containers. Look for dump.
exception trace entries from Program Manager or
DFHAPCR to determine the cause of the error. User response
If an EXCI job is sending a transaction channel to a pre Contact your IBM support center.
CICS TS 5.2 system, change the EXCI job to use a non Module:
transaction channel. DFHXFX, DFHXFP
Module:
AXGE
DFHXFX,DFHXFP
AXGB Explanation
A distributed program link (DPL) request, specifying
Explanation channel name DFHTRANSACTION, has also specified a
The application context handling module, DFHMNAC, COMMAREA that is too large for the terminal I/O area
has returned an unexpected response from function (TIOA).
IS_ACD_SET.
System action
System action The task is abnormally terminated with a transaction
The task is abnormally terminated with a transaction dump.
dump.
User response
User response Check if the request is using the correct length for the
Contact your IBM support center. COMMAREA. If a DFHTRANSACTION channel is
specified the COMMAREA size should not exceed 24
Module: KB. In this case to accommodate a size greater than
DFHXFP 24 KB specify a user channel instead of a COMMAREA.
AXGC Module:
DFHXFP

266 CICS TS for z/OS: CICS Codes


AXMA System action
The recovery routine of the module in control is
Explanation invoked. This routine issues message DFHXM0002
An error has occurred obtaining a lock within the with a system dump. DFHXM0002 reports the module
transaction manager domain. in control at the time of the error.

System action User response

The recovery routine of the module in control is See the description of message DFHXM0002 for
invoked which issues message DFHXM0002 with a further guidance.
system dump. DFHXM0002 reports the module in Module:
control at the time of the error. DFHXMAT, DFHXMXE
AXMD
User response
See the description of message DFHXM0002 for Explanation
further guidance.
An attempt has been made to run the CICS internal
For module list, see Diagnostics reference. task CSXM as a user transaction.
Module:
DFHXMAT, DFHXMBD, DFHXMCL, DFHXMDD, System action
DFHXMFD, DFHXMLD, DFHXMQD, DFHXMST, CICS terminates the task with a transaction dump.
DFHXMTA, DFHXMXD, DFHXMXE
AXMB User response
Investigate why the attempt was made to run CSXM as
Explanation a user transaction.
An error has occurred releasing a lock within the Module:
transaction manager domain. DFHXMAB

System action AXMU

The recovery routine of the module in control is Explanation


invoked. This routine issues message DFHXM0002
with a system dump. DFHXM0002 reports the module During transaction attach the userid that had been
in control at the time of the error. assigned to the transaction was found to be invalid.

User response System action


See the description of message DFHXM0002 for CICS terminates the task with a transaction dump.
further guidance.
For module list, see Diagnostics reference. User response

Module: Determine how the invalid userid had been assigned to


DFHXMAT, DFHXMBD, DFHXMCL, DFHXMDD, the transaction. It might have been output by a user-
DFHXMFD, DFHXMLD, DFHXMQD, DFHXMST, replaceable module.
DFHXMTA, DFHXMXD, DFHXMXE Module:
AXMC DFHXMAT
AXMY
Explanation
An severe error has occurred allocating a unique Explanation
transaction number to a new transaction. During transaction attach an unexpected error
occurred obtaining transaction class membership.

Chapter 1. Transaction abend codes 267


System action User response
The transaction is no longer considered for class First, if CICS has requested a response, you must
membership. It is then abnormally terminated with a reply. If you reply 'GO', CICS continues processing, but
CICS transaction dump. without support for the external security manager.
CICS security still operates. If you reply 'CANCEL',
User response CICS terminates abnormally with a dump.

Use the dump to determine why the transaction failed Use the messages and dumps to find out the cause of
to obtain membership of its transaction class. the failure.

Module: Module:
DFHXMAT DFHXSMN

AXMZ AXSB

Explanation Explanation

A serious failure in another component has been A system transaction has been started from a
detected by the transaction manager domain. terminal; this is not permitted. Category 1 transactions
can only be started internally by CICS.
System action
System action
The task in control is abnormally terminated with a
transaction dump. Further diagnostics should have The task is abnormally terminated. No transaction
been taken by the failing component. dump is taken.

User response User response

Look for earlier messages identifying the source of the None.


problem. Refer to the descriptions of these messages Module:
for further guidance. DFHXMTA
Module: AXSC
DFHXMTA
AXSA Explanation
The task was purged before a GETMAIN request to the
Explanation storage manager (SM) domain was able to complete
The CICS security control task could not complete successfully. The task that first detected the purged
because a necessary step failed. The task has done condition will have provided an exception trace.
some essential recovery operations and abnormally
terminated itself with code AXSA. System action
The task is abnormally terminated with a CICS
System action transaction dump.
CICS writes a transaction dump for the security control
restart task. User response
CICS sends messages to the console, one to identify Investigate why the task was purged. It was purged
the error detected by the security control task, and, if either as a result of a purge from the master terminal
the error occurred during initialization, one to say that operator via the CEMT transaction, or by the task being
security initialization or CEMT PERFORM SECURITY timed out after waiting for longer than the DTIMOUT
REBUILD has failed. A third message follows either to (deadlock timeout) value specified for the transaction.
say that CICS has terminated abnormally with a dump,
If the master terminal operator purged the task, this
or to ask you to reply GO or CANCEL. Depending on the
may have been in an attempt to clear the system
nature of the original error, you may see messages
which appeared to be deadlocked for some reason.
from some other system component (for example, an
access method). If the task was timed out automatically as a result of
the DTIMOUT value being exceeded, this may be due
to insufficient main storage being available for the

268 CICS TS for z/OS: CICS Codes


number of tasks in the system. If the amount of main System action
storage cannot be increased, reduce the number of
A system dump will be taken with an associated
tasks in the system to avoid short-on-storage
DFHAP0002 message. The task is abnormally
situations. Another possibility is to increase the value
terminated with a CICS transaction dump.
of the DTIMOUT option for the transaction.
Module: User response
DFHXSMN
If you need further assistance from IBM to resolve this
AXSD problem, see IBM problem support for guidance on
how to proceed.
Explanation
Module:
An error (INVALID, DISASTER, or unexpected DFHSAML
EXCEPTION response) has occurred on a call to the
AXSG
storage manager (SM) domain. The domain that
detected the original error provides an exception
trace, a console message and, possibly, a system Explanation
dump (depending on the options specified in the dump The DFHSAML program is not running in CICS key.
table).
System action
System action
The task is abnormally terminated with a CICS
The task is abnormally terminated with a CICS transaction dump.
transaction dump.
User response
User response
Install the DFHSAML program definition provided in
See the related message produced by the domain that the group DFHSAML.
detected the original error.
Module:
Module: DFHSAML
DFHTCRP
AXTA
AXSE
Explanation
Explanation
The calculation of the length of data to be shipped has
The CICS security token service has been called failed.
without a channel.
System action
System action
The task is abnormally terminated with a CICS
The task is abnormally terminated with a CICS transaction dump.
transaction dump.
User response
User response
If you need further assistance from IBM to resolve this
Change the program calling the DFHSAML processor. problem, see IBM problem support for guidance on
Ensure that you call it using the interface defined in how to proceed.
the SAML programming interface.
Module:
Module: DFHAPRX, DFHXTP
DFHSAML
AXTB
AXSF
Explanation
Explanation
An attempt to obtain a buffer to ship data has failed.
The CICS security token service encountered a severe
error.

Chapter 1. Transaction abend codes 269


System action System action
The task is abnormally terminated with a CICS The task is abnormally terminated with a CICS
transaction dump. transaction dump.

User response User response


If you need further assistance from IBM to resolve this If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on problem, see IBM problem support for guidance on
how to proceed. how to proceed.
Module: Module:
DFHAPRX, DFHXTP DFHAPRX, DFHXTP
AXTC AXTF

Explanation Explanation
An attempt to transform data ready for shipment has No relay process function management header (FMH)
failed. was received from the remote system.

System action System action


The task is abnormally terminated with a CICS The task is abnormally terminated with a CICS
transaction dump. transaction dump.

User response User response


If you need further assistance from IBM to resolve this If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on problem, see IBM problem support for guidance on
how to proceed. how to proceed.
Module: Module:
DFHAPRX, DFHXTP DFHAPRX, DFHXTP
AXTD AXTG

Explanation Explanation
No buffer was received from a remote system. Transformation of data received from remote system
failed.
System action
System action
The task is abnormally terminated with a CICS
transaction dump. The task is abnormally terminated with a CICS
transaction dump.
User response
User response
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Check that the reason for failure of the transformation
how to proceed. process was not incorrect definition of the remote
terminal. In particular check that the user area length
Module:
specified for the terminal is the same in both local and
DFHAPRX, DFHXTP
remote systems. If the terminal definitions are correct,
AXTE you need further assistance to resolve this problem. If
you need further assistance from IBM to resolve this
Explanation problem, see IBM problem support for guidance on
how to proceed.
Incorrect data was received from a remote system.
The data was not long enough. Module:
DFHAPRX, DFHXTP
AXTH

270 CICS TS for z/OS: CICS Codes


Explanation Module:
DFHAPRX, DFHXTP
An attempt to locate terminal identifier failed.
AXTK
System action
Explanation
The task is abnormally terminated with a CICS
transaction dump. An APPC conversation failure occurred when an attach
between CICS systems was issued.
User response
System action
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on The task is abnormally terminated with a CICS
how to proceed. transaction dump.
Module:
DFHAPRX, DFHXTP User response

AXTI Check the connection to the remote CICS system and


try to reestablish it.
Explanation Module:
DFHXTP
The major request byte LUCOPN0 of the DFHLUC
parameter list specified to the transaction-routing AXTL
transformer is invalid, or corresponds to a request that
is not shipped to a remote system. The parameter list Explanation
will be found in the dynamic storage of the
transformer's caller and may be located using the The processing of APPC mapped data requires the
output from auxiliary trace. generation of an APPC attach FMH with default values.
In particular, the sync level requested is defaulted to
2. However, the session that is to be used has been
System action
bound with a sync level of 1.
The task is abnormally terminated with a transaction
dump. System action
The task is abnormally terminated with a CICS
User response
transaction dump.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on User response
how to proceed.
Check that:
Module:
DFHAPRX, DFHXTP • The CONNECTION resource for the remote system
has not been defined as single-session.
AXTJ
• The remote system is capable of supporting a sync
level of 2.
Explanation
• Exchange lognames has completed for the
An unexpected combination of bit settings in the fields connection. You can use the command CEMT
XTSSTAT and XTSTCOPC in the parameter list of the INQUIRE CONNECTION to do this. See the CICS
transaction-routing transformer was made. intercommunication for more details of the exchange
lognames process.
System action • The correct sync level has been requested.
The task is abnormally terminated with a transaction Module:
dump. DFHXTP
AXTM
User response
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed.

Chapter 1. Transaction abend codes 271


Explanation System action
An attempt has been made to route a message- The transaction routing request is terminated and a
protected transaction over an APPC link bound at sync message is sent to the terminal owning region (TOR) to
level 1. The attempt has failed because such indicate that the transaction routing request has failed.
transactions can be routed only over an APPC link that The CICS security manager issues a DFHSNxxxx
has been bound at sync level 2. message to the transient data queue, CSCS.

System action User response


The task is abnormally terminated with a CICS The most likely cause of this abend is that the terminal
transaction dump. being shipped to the application owning region (AOR)
has preset security with a userid which is not valid in
User response the AOR. To confirm this, check the associated
DFHSNxxxx message on the CSCS transient data
If the transaction is to be routed to CICS OS/2 (which queue in the AOR which gives the precise reason for
is bound at synclevel 1), remove the message the failure of the preset security signon request. This
protection option. If the transaction is to be routed to could be the result of an unauthorized transaction
another host system and message protection is routing request.
required, the link must be redefined so that it can be
bound at synclevel 2. Module:
DFHAPRX, DFHXTP
Module:
DFHXTP AXTP

AXTN
Explanation

Explanation An exception response has been returned to the


transaction-routing transformer module from
The transaction-routing transformer module detected DFHCCNV
that the application buffer chained off a TCTTE at FUNCTION(CONVERT_DS3270_FOR_SBCS). The
offset TCTERCSA has a corrupted header. This is module was called for a CICS client virtual terminal
caused either by a CICS logic error or by a storage which requested conversion from ASCII to EBCDIC for
overwrite. data coming from the client. However, the conversion
failed.
System action
The transaction is abnormally terminated with a CICS System action
transaction dump. The transaction routing request is terminated and a
message is sent to the terminal owning region (TOR) to
User response indicate that the transaction routing request has failed.
The CICS security manager issues a DFHSNnnnn
This is a CICS internal logic error. If you need further
message to the transient data queue, CSCS.
assistance from IBM to resolve this problem, see IBM
problem support for guidance on how to proceed.
User response
Module:
DFHAPRX, DFHXTP Examine the response and reason returned in the
DFHCCNV commarea DFHC32. The client and server
AXTO codepages will have already been validated so this
may be a CICS error. You may need to contact IBM for
Explanation further assistance. See IBM problem support for
guidance on how to proceed.
An exception response has been returned to the
transaction-routing transformer module from the CICS Module:
security manager. Prior to the call to the CICS security DFHAPRX, DFHXTP
manager, the transformer module detected that a
AXTQ
shipped terminal definition had preset security. The
transformer then invoked the CICS security manager in
order to perform a preset security signon for the userid
sent with the shipped terminal information. It is this
preset security signon attempt which failed.

272 CICS TS for z/OS: CICS Codes


Explanation • A transaction running in an AOR has created a
channel. The transaction has terminated by issuing
An exception response has been returned to the
EXEC CICS RETURN TRANSID CHANNEL to name the
transaction-routing transformer module from
next transaction in the pseudo-conversation and
DFHCCNV
pass the channel to it. However the TOR is not at a
FUNCTION(CONVERT_DS3270_FOR_SBCS). The
high enough CICS level to support channels.
module was called for a CICS client virtual terminal
which requested conversion from EBCDIC to ASCII for • A transaction running in an AOR has created a
data to be sent to the client. However the conversion channel. The transaction has terminated by issuing
failed. EXEC CICS RETURN TRANSID CHANNEL to name the
next transaction in the pseudo-conversation and
pass the channel to it. The channel is transmitted to
System action
the TOR and is held there until the next transaction
The transaction routing request is terminated and a in the pseudo-conversation starts. However, when
message is sent to the terminal owning region (TOR) to the next transaction is initiated, it is found to reside
indicate that the transaction routing request has failed. in an AOR that is not at a high enough CICS level to
The CICS security manager issues a DFHSNnnnn support channels.
message to the transient data queue, CSCS.
System action
User response
The transaction routing request is terminated and a
Examine the response and reason returned in the message is sent to the terminal owning region (TOR) to
DFHCCNV commarea DFHC32. The client and server indicate that the transaction routing request has failed.
codepages will have already been validated so this
may be a CICS error. You may need to contact IBM for User response
further assistance. See IBM problem support for
guidance on how to proceed. If channels are passed between transactions in a
pseudo-conversation, you must ensure that all TOR
Module: and AOR systems involved in passing the channel are
DFHAPRX, DFHXTP at a high enough CICS level to support channels.
AXTR Module:
DFHAPRX, DFHXTP
Explanation
AXTU
An exception response has been returned to the
transaction-routing transformer module from Explanation
DFHPGLE FUNCTION(LOAD_EXEC) whilst trying to
load EXEC program DFHCCNV. Program DFHAPCR has returned an unexpected
response. DFHAPCR performs the following functions:-
System action • Extracts the contents of all containers making up a
channel and transmits them to a remote system.
The transaction routing request is terminated and a
message is sent to the terminal owning region (TOR) to • Recreates the channel and containers from inbound
indicate that the transaction routing request has failed. data received from a remote system.
The CICS security manager issues a DFHSNnnnn DFHAPCR has either detected an error in inbound data
message to the transient data queue, CSCS. or has received an unexpected response whilst
extracting or recreating channel data.
User response
Examine the response and reason returned from System action
DFHPGLE to determine why CICS was unable to call The task is abnormally terminated with a CICS
DFHCCNV. transaction dump.
Module:
DFHAPRX, DFHXTP User response
AXTS Look for any related CICS messages and abends to
determine if there has been a prior failure in Program
Explanation Manager, which manages containers. Look for
One of the following conditions has occured.

Chapter 1. Transaction abend codes 273


exception trace entries from Program Manager or Module:
DFHAPCR to determine the cause of the error. DFHAPRX, DFHXTP

AZxx abend codes


AZAB User response
Issue the CCIN transaction only from a client.
Explanation
Module:
DFHZARM has a SEND DATA request with a data DFHZCN1
length greater than 65 528 bytes which is the
maximum that it can process. AZAF

System action Explanation

The transaction is abnormally terminated with a CICS DFHZCN1 was started for transaction CCIN. However
transaction dump. either the environment is wrong or the client
architecture has been violated. This abend is always
issued in conjunction with a DFHZC32nn message
User response which explains the problem in more detail.
This is a CICS internal logic error. If you need further
assistance from IBM to resolve this problem, see IBM System action
problem support for guidance on how to proceed.
Exception trace point AP30xx is written. The
Module: transaction is abnormally terminated.
DFHZARM
AZAD User response
Look for a DFHZC32nn message on the console or
Explanation CSNE and look for exception trace points AP30xx. Use
DFHZCN1 has been started from an unexpected these to diagnose the problem.
system. The CCIN transaction can only be issued by a Module:
client. DFHZCN1
AZAG
System action
The transaction is abnormally terminated. Exception Explanation
trace point AP3008 is written. Data1 holds the XMIQ
start type. DFHZCT1 has been started from an unexpected
system. The CTIN transaction can only be issued by a
client.
User response
Issue the CCIN transaction only from a client. System action
Module: The transaction is abnormally terminated with a CICS
DFHZCN1 transaction dump. Exception trace point AP302A is
AZAE written. Data1 holds the XMIQ start type.

Explanation User response

DFHZCN1 was started from a terminal facility, but not Issue the CTIN transaction only from a client.
an LU6.2 session. The CCIN transaction may only be Module:
issued by a client. DFHZCT1
AZAH
System action
The transaction is abnormally terminated.

274 CICS TS for z/OS: CICS Codes


Explanation User response
DFHZCT1 was started from a terminal facility, but not Either use the default definitions for CCIN or ensure
an LU62 session. The CTIN transaction can only be that it is defined as a local transaction.
issued by a client.
Module:
DFHZCN1
System action
AZAK
The transaction is abnormally terminated with a CICS
transaction dump. Exception trace point AP3032 is
Explanation
written. Data1 holds the principal facility address.
DFHZCT1 was started for transaction CTIN. However,
User response the CTIN transaction is being started on a surrogate,
which means that it has been defined as a remote
Issue the CTIN transaction only from a client. transaction. CTIN must be a local transaction and be
Module: run on a CICS region which is directly connected to a
DFHZCT1 client.

AZAI
System action

Explanation Exception trace point AP3039 is written. The


transaction is abnormally terminated.
DFHZCT1 was started for transaction CTIN. However
either the environment is wrong or the client
User response
architecture has been violated. This abend is always
issued in conjunction with a DFHZC32nn message Either use the default definitions for CTIN or ensure
which explains the problem in more detail. that it is defined as a local transaction.
Module:
System action DFHZCT1
Exception trace point AP30xx is written. The AZCA
transaction is abnormally terminated.
Explanation
User response
An internal logic error has been detected during APPC
Look for a DFHZC32nn message on the console or mapped processing. The conversation state
CSNE and look for exception trace points AP30xx. Use maintained by DFHZARL does not match that
these to diagnose the problem. maintained jointly by DFHETL and DFHZARM.
Module: The problem may also arise when CICS is assembling
DFHZCT1 application data and receives end of chain before
AZAJ receiving all of the data that is expected.

Explanation System action

DFHZCN1 was started for transaction CCIN. However, The task is abnormally terminated with a CICS
the CCIN transaction is being started on a surrogate, transaction dump. CICS processing continues.
which means that it has been defined as a remote
transaction. CCIN must be a local transaction and be User response
run on a CICS region which is directly connected to a
If you need further assistance from IBM to resolve this
client.
problem, see IBM problem support for guidance on
how to proceed.
System action
Module:
Exception trace point AP3041 is written. The DFHZARM
transaction is abnormally terminated.
AZCB

Chapter 1. Transaction abend codes 275


Explanation from the LL fields and concatenation flags) does not
match the length actually received. CICS determines
CICS has received sense code X'088901xx' during
the length of application data that is to be received
APPC mapped processing. This should be followed by
from the LL fields and concatenation flags. However,
an error data GDS (generalized data stream) variable.
CICS has not received all of the data that is expected.
CICS has attempted to receive the error data. However
This abend can be caused by a loss of data following
this attempt has failed because no data has been
the failure of a persistent sessions restart in a partner
received or because the data received is not for an
system. In this case, no logic error has occurred
CICS ISSUE ERROR of the correct length.
because any updates are backed out.
CICS expects the error data to indicate that the other
system does not recognize GDS ID X'12F2' (function System action
management data).
The task is abnormally terminated with a CICS
transaction dump.
System action
The task is abnormally terminated with a CICS User response
transaction dump.
If this abend is not caused by the failure of a persistent
The erroneous GDS ID is returned to the remote sessions restart in a partner system, you will need
system for further analysis there. further assistance from IBM. See IBM problem support
for guidance on how to proceed.
User response
Module:
Check for session failure and for abend by the DFHETL, DFHZARM
transaction in the other system.
AZCE
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Explanation
how to proceed.
An intersystem error has been detected during APPC
Module: mapped processing. The length of application data
DFHZARM that is to be received (as determined from the LL fields
AZCC and concatenation flags) exceeds the CICS
implementation limit of 32 767, for receive and
converse commands, or 65 000 for CICS transaction
Explanation
routing or function shipping requests.
The failing transaction has sent function management
data to a transaction running in a system that does not System action
provide support for application function management
data. The task is abnormally terminated with a CICS
transaction dump.
System action
User response
The task is abnormally terminated with a CICS
transaction dump. Reduce the amount of data that the transaction in the
remote system is transmitting to CICS.
User response Module:
DFHETL, DFHZARM
Check that the remote system can support application
function management data. AZCF
Module:
DFHZARM Explanation

AZCD An internal logic error has been detected during APPC


mapped processing. An invalid request has been
passed to DFHZARL.
Explanation
A possible intersystem logic error has been detected
during APPC mapped processing. The length of
application data that is to be received (as determined

276 CICS TS for z/OS: CICS Codes


System action AZCI
The task is abnormally terminated with a CICS
transaction dump. Explanation
The processing of APPC mapped data requires
User response generation of an APPC attach function management
header (FMH) with default values. In particular, the
If you need further assistance from IBM to resolve this
sync level requested is defaulted to 2. However, the
problem, see IBM problem support for guidance on
session that is to be used has been bound with a sync
how to proceed.
level of 1.
Module:
DFHZARM System action
AZCG The task is abnormally terminated with a CICS
transaction dump.
Explanation
An internal logic error has been detected during APPC User response
mapped processing. DFHZARM expects the TCTTE Check that:
passed to have been defined as APPC, TCTEILUC
(TCTELUC) set on, and TCTECVT set to TCTEMAPD (to • The CONNECTION resource for the remote system
indicate a mapped conversation). has not been defined as single-session.
• The remote system is capable of supporting a sync
System action level of 2.
The task is abnormally terminated with a CICS • Exchange lognames has completed for the
transaction dump. connection. You can use the CEMT INQUIRE
CONNECTION to do this. See the CICS
intercommunication for details of the exchange
User response
lognames process.
If you need further assistance from IBM to resolve this
Module:
problem, see IBM problem support for guidance on
DFHETL, DFHZARM, DFHZARQ
how to proceed.
AZCJ
Module:
DFHZARM
Explanation
AZCH
An APPC structured field with GDS ID X'12F1' (null
data) has been sent to a remote system that does not
Explanation
support the receipt of these fields. The remote system
Sense code X'0889xxxx' has been received has responded negatively and has terminated the
unexpectedly during the processing of APPC mapped conversation.
data.
This represents a violation of the APPC architecture by System action
the remote system. The task is abnormally terminated with a CICS
transaction dump.
System action
The task is abnormally terminated with a CICS User response
transaction dump. The problem is in the remote system. If you need
further assistance from IBM to resolve this problem,
User response see IBM problem support for guidance on how to
proceed.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Module:
how to proceed. DFHZARM
Module: AZCK
DFHETL, DFHZARM

Chapter 1. Transaction abend codes 277


Explanation System action
An internal logic error has been detected during error The task is abnormally terminated with a CICS
recovery for APPC mapped processing. The transaction dump.
conversation was being switched to RECEIVE state by
an internal CICS SEND INVITE, but the conversation User response
had already been FREEd by the partner.
See the related message produced by the domain that
detected the original error.
System action
Module:
The task is abnormally terminated with a CICS
DFHZARM
transaction dump. CICS processing continues.
AZCN
User response
Explanation
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on The task has been purged before a GETMAIN request
how to proceed. to the storage manager (SM) domain was able to
complete successfully. The task that first detected the
Module:
purged condition provides an exception trace.
DFHZARM
AZCL System action
The task is abnormally terminated with a CICS
Explanation
transaction dump.
CICS has received sense code X'088901xx' during
APPC mapped processing. The generalized data User response
stream (GDS) should contain a valid GDS identity in the
error data but CICS does not recognize the value. The Investigate why the task was purged. It was purged
values recognized by CICS are: either as a result of a purge from the master terminal
operator via the CEMT transaction, or by the task being
timed out after waiting for longer than the DTIMOUT
X'12F1' null data (deadlock timeout) value specified for the transaction.
X'12F2' function management data
X'12FF' application data. If the master terminal operator purged the task, this
may have been in an attempt to clear the system
System action which appeared to be deadlocked for some reason.

The task is abnormally terminated with a CICS If the task was timed out automatically as a result of
transaction dump. the DTIMOUT value being exceeded, this may be due
to insufficient main storage being available for the
number of tasks in the system. If the amount of main
User response
storage cannot be increased, reduce the number of
Check for session failure and for an abend by the tasks in the system to avoid short-on-storage
transaction in the other system. situations. Another possibility is to increase the value
of the DTIMOUT option for the transaction.
Module:
DFHZARM Module:
DFHZARM
AZCM
AZCO
Explanation
Explanation
An error (INVALID, DISASTER, or unexpected
EXCEPTION response) has occurred on a call to the The VTAM persistent sessions initialization transaction
storage manager (SM) domain. The domain that CGRP has been started directly from a terminal. This is
detected the original error provides an exception not permitted. This transaction can only be started
trace, a console message and, possibly, a system internally by CICS.
dump (depending on the options specified in the dump
table).

278 CICS TS for z/OS: CICS Codes


System action Explanation
The transaction is abnormally terminated with a A logic or protocol error has been detected during
transaction dump. processing of an APPC SYNCPOINT ROLLBACK
request. An attempt has been made to restore the
User response conversation state to what it was after completion of
the last successful unit of work. This saved state does
None. not match flows received from the partner.
Module: The problem arises during rollback in one of the
DFHZCGRP following situations:
AZCP • The saved state is receive, and the partner sent
change direction on the last flow, indicating that the
Explanation partner expects CICS to be in send state
A logic error has been detected in ZCP. An allocation • The saved state is send, and the partner did not send
request for a starting task cannot be satisfied. the change-direction indicator on the last flow,
indicating that the partner expects CICS to be in
receive state.
System action
The task is abnormally terminated with a CICS System action
transaction dump.
The task is abnormally terminated with a CICS
transaction dump. Other processing continues.
User response
If you need further assistance from IBM to resolve this User response
problem, see IBM problem support for guidance on
how to proceed. The problem can arise because of a failure in CICS, or
a failure in the partner. To determine which is failing,
Module: analyze the flows at the last successful syncpoint. Try
DFHZSUP DFH62XM to determine the states the two LUs were in at this
AZCQ point. Look at the last syncpoint flow into CICS from
the partner, before the abend. From this flow,
calculate whether the change-direction indicator on
Explanation
the SPCMOD modifier byte is on. ( See the Systems
An error (INVALID, DISASTER or unexpected Network Architecture Formats (GA27-3136) manual
EXCEPTION response) has occurred on a call to the for further information on the SPCMOD modifier byte.)
recovery manager (RM) domain to change the recovery The indicator must only be set when the saved CICS
status of an intercommunication session. The domain conversation state is send. If the last CICS state was
provides an exit trace, and possibly a console message send, and the indicator is on, CICS is at fault. Similarly,
and a system dump (depending on the options if the last CICS state was receive, and the indicator is
specified in the dump table). off, CICS is at fault.
If the last CICS state was send and the indicator is off,
System action or the last CICS state was receive, and the indicator is
The task is abnormally terminated with a CICS on, CICS has received a change-direction indicator
transaction dump. when it was not expecting one. In this case, examine
the partner for a logic error.
User response Module:
DFHZARL
This failure is either the result of a task purge, or it
represents a CICS logic error and you will need AZCT
assistance from IBM.
See the related diagnostic material produced by the Explanation
recovery manager domain. A terminal read-time-out condition has been detected.
Module: The transaction has been waiting for a terminal input
DFHZSUP DFHMRXM DFH62XM message for an interval longer than specified in the
RTIMOUT value for that transaction.
AZCR

Chapter 1. Transaction abend codes 279


Coding RTIMOUT in the PROFILE entry causes the task Module:
to be abnormally terminated if the terminal does not DFHZCOVR
send input within the specified time.
AZCW

System action
Explanation
The transaction is abnormally terminated. A dump is
An attempt has been made to run the CICS internal
not provided unless the dump table entry for
task CSTP as a user transaction.
transaction dump code AZCT indicates that one should
be taken.
System action
User response CICS terminates the task with a transaction dump.
If a HANDLE ABEND command has been issued for
this task, the read that was timed-out is still User response
outstanding. In order to cancel this read, issue an Investigate why the attempt was made to run CSTP as
ABEND command at the end of the user exit routine so a user transaction.
that CICS can clean up the terminal's TCTTE. No
further terminal control commands should be issued. Module:
DFHZCSTP
Module:
DFHZARQ AZI1

AZCU
Explanation

Explanation An IRC data transmission request has been issued, but


cannot be completed because the transmission
The COVR transaction has been started directly from a protocol has been violated.
terminal, or by a START command. This is not
permitted. This transaction can only be started If the session is not used for distributed transaction
internally by CICS. processing, that is if it is used for function shipping or
transaction routing, then the problem is caused by a
CICS logic error.
System action
If the session is used for distributed transaction
The transaction is abnormally terminated. No
processing, then the following are possible causes of
transaction dump is taken.
the abend:

User response • An invalid terminal control command, such as ISSUE


SIGNAL, was issued
None.
• A send request was issued but the session was not
Module: in send state, or a read request was issued but the
DFHZCOVR session was not in receive state.
AZCV
System action
Explanation The task is abnormally terminated with a CICS
transaction dump.
A logic error has been detected in the COVR
transaction while trying to connect to VTAM.
User response
System action Determine the cause of the abend and if appropriate,
correct the application. For further guidance, refer to
The task is abnormally terminated with a CICS
the section on the EXEC Interface block (EIB) in the
transaction dump.
CICS intercommunication. The EIB describes the state
of the session after a request has been issued.
User response
Module:
If you need further assistance from IBM to resolve this DFHZARQ
problem, see IBM problem support for guidance on
how to proceed. AZI2

280 CICS TS for z/OS: CICS Codes


Explanation DFHZARQ
An IRC data transmission request has been issued but AZI4
cannot be completed. Possible causes of the problem
include: Explanation
• The transaction running in the connected system has An IRC data transmission request has been issued, but
been purged, or cannot be completed because the other system has
• The transaction running in the connected system has become unavailable for interregion communication.
been timed out, or
• The abending transaction has attempted to SEND System action
while in RECEIVE state, or The task is abnormally terminated with a CICS
• The abending transaction has attempted to RECEIVE transaction dump.
while in SEND state.
If the abend was caused by DFHIRP rejecting the User response
transmission request, the dump will contain DFHIRP's Rerun the transaction when IRC is available.
return code in the field TCTEIRET for the TCTTE
representing the failed IRC session. The address of Module:
this TCTTE is in field B of the trace entry representing DFHZARQ
the DFHTC data transmission request. AZI5
The meanings of the DFHIRP return codes are given in
the copybook, DFHIRSDS. Explanation
An IRC data transmission request has been issued, but
System action the data sent by the connected system in response to
The task is abnormally terminated with a CICS the request violated IRC protocols.
transaction dump.
System action
User response The task is abnormally terminated with a CICS
If the cause of the error was a purge or a time-out, no transaction dump.
further action is required.
User response
If the error was caused by a condition such as an
attempted SEND while in RECEIVE state or vice versa, If you need further assistance from IBM to resolve this
analyze the dump and correct the protocol violation. problem, see IBM problem support for guidance on
how to proceed.
Module:
DFHZARQ Module:
DFHZARQ
AZI3
AZI6
Explanation
Explanation
A terminal control request issued by an application to
a remotely-owned terminal failed because the The transaction was connected to another transaction
conversation with the other system failed. in another CICS system via an IRC link. This other
transaction has abnormally terminated.
System action
System action
The task is abnormally terminated with a CICS
transaction dump. The task is abnormally terminated with a CICS
transaction dump.
User response
User response
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Correct the cause of the abend in the connected
how to proceed. transaction.
Module: Module:

Chapter 1. Transaction abend codes 281


DFHZARQ Module:
DFHZIS2
AZI7
AZIA
Explanation
Explanation
The transaction was processing an MRO request which
involved waiting for a response from a connected The transaction attempted to acquire or free storage
subsystem. The 'wait' request was rejected by the during MRO processing. The response from the CICS
CICS dispatcher. storage manager (SM) domain indicated that the
request was invalid.
System action
System action
The transaction is abnormally terminated with a dump.
The task is abnormally terminated with a dump.
User response
User response
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on If you need further assistance from IBM to resolve this
how to proceed. problem, see IBM problem support for guidance on
how to proceed.
Module:
DFHZIS2 Module:
DFHZIS2
AZI8
AZIB
Explanation
Explanation
The error log data received with an ISSUE-ABEND flow
on an IRC connection was not in the correct format. The transaction was purged whilst waiting for storage
to receive MRO data from a connected subsystem. The
System action purge may have been the result of operator action,
such as CEMT SET TASK PURGE, or as the result of the
The task is abnormally terminated with a CICS waiting time exceeding the DTIMOUT value for the
transaction dump. transaction.

User response System action


If you need further assistance from IBM to resolve this The task is abnormally terminated with a dump.
problem, see IBM problem support for guidance on
how to proceed.
User response
Module:
If the condition is caused by time-out, examine the
DFHZIS1
DTIMOUT value for the failing transaction and increase
AZI9 it if it is too low.
Module:
Explanation DFHZIS2
The transaction was processing an MRO request which AZIC
involved waiting for a response from a connected
subsystem. During the wait, the failing transaction was
Explanation
purged. The purge can only have been the result of
operator action, such as a CEMT SET TASK PURGE. An INVALID, DISASTER, or EXCEPTION condition has
occurred on a call to the storage manager domain
System action (DFHSMGFM) to FREEMAIN a CRB control block.

The task is abnormally terminated with a dump. The domain that detected the original error provides
an exception trace, a console message, and possibly a
system dump.
User response
Investigate the reason the transaction was purged.

282 CICS TS for z/OS: CICS Codes


System action • A CICS logic error. IRC protocols are not available to
MRO distributed transaction processing applications.
The task is abnormally terminated with a transaction
They are for CICS internal use only.
dump.
• A transaction abend on a connected system. This
User response results in an FMH 7 flow over an LU6.2 connection
and causes this abend to be issued.
Please see the related message from the domain that
detected the original error. System action
Module: The task is abnormally terminated with a transaction
DFHZIS2 dump.
AZID
User response
Explanation Check whether a mixture of mapped and unmapped
A PURGED condition has occurred on a call to the conversations are being used as this can cause this
storage manager domain (DFHSMGFM) to FREEMAIN a abend. Check for any other reasons for transactions to
CRB control block. be abending on the attached system.

The domain that detected the original error provides If a CICS logic error is involved, you will need further
an exception trace. assistance from IBM. See IBM problem support for
guidance on how to proceed.
System action Module:
DFHZARQ
The task is abnormally terminated with a transaction
dump. AZIF

User response Explanation


Investigate why the task was purged. It was purged An error (INVALID, DISASTER or unexpected
either as a result of a purge from the master terminal EXCEPTION response) has occurred on a call to the
operator via the CEMT transaction, or by the task being recovery manager (RM) domain to change the recovery
timed out after waiting for longer than the DTIMOUT status of an intercommunication session. The domain
(deadlock timeout) value specified for the transaction. provides an exit trace, and possibly a console message
If the master terminal operator purged the task, this and a system dump (depending on the options
may have been in an attempt to clear the system specified in the dump table).
which appeared to be deadlocked for some reason. This is either the result of a task purge, a CICS logic
If the task was timed out automatically as a result of error, or of the inappropriate use of the indoubt test
the DTIMOUT value being exceeded, this may be due transaction, CIND. CIND should be activated only on
to insufficient main storage being available for the the CICS system where the syncpoint processing was
number of tasks in the system. If the amount of main initiated. In particular, CIND should not be used on any
storage cannot be increased, reduce the number of of the CICS mirror transactions.
tasks in the system to avoid short-on-storage
situations. Another possibility is to increase the value System action
of the DTIMOUT option for the transaction. The task is abnormally terminated with a CICS
Module: transaction dump.
DFHZIS2
User response
AZIE
Determine whether CIND has been activated for a
Explanation transaction that did not initiate the syncpoint
processing. If CIND is not being used see the related
An interregion communication (IRC) ISSUE-ERROR or diagnostic material produced by the recovery manager
ISSUE-ABEND flow has been received in violation of domain and determine the reason for the failure.
IRC protocols. This can be caused by:
In the case of a CICS logic error, you need further
assistance from IBM. See IBM problem support for
guidance on how to proceed.

Chapter 1. Transaction abend codes 283


Module: System action
DFHZARQ
The transaction is abnormally terminated with a CICS
AZIG transaction dump.

Explanation User response


An MRO session read-time-out condition has been Use the trace to investigate why the task was purged.
detected. The transaction has been waiting for an MRO Check if the master terminal operator was responsible.
session for an interval longer than specified in the
Module:
RTIMOUT value for that transaction.
DFHZARRA
Coding RTIMOUT in the PROFILE entry causes the task
AZR4
to be abnormally terminated if the session does not
respond within the specified time.
Explanation
System action An unexpected response has been received from a
dispatcher domain call.
The transaction is abnormally terminated. A dump is
not provided unless the dump table entry for
transaction dump code AZIG indicates that one should System action
be taken. The transaction is abnormally terminated with a
transaction dump.
User response
If a HANDLE ABEND command has been issued for User response
this task, the read that was timed-out is still If you need further assistance from IBM to resolve this
outstanding. In order to cancel this read, issue an problem, see IBM problem support for guidance on
ABEND command at the end of the user exit routine so how to proceed.
that CICS can clean up the terminal's TCTTE. No
further terminal control commands should be issued. Module:
DFHZARER
Module:
DFHZIS2 AZR5

AZR2
Explanation

Explanation An unexpected response has been received from a


dispatcher domain call.
Module DFHZARRA is unable to acquire main memory
for a new application buffer because the storage
System action
manager GETMAIN failed.
The transaction is abnormally terminated with a
System action transaction dump.

The transaction is abnormally terminated with a CICS


User response
transaction dump.
If you need further assistance from IBM to resolve this
User response problem, see IBM problem support for guidance on
how to proceed.
Use the trace to identify the failing return from the
storage manager and analyze the reason for failure. Module:
DFHZARR1
Module:
DFHZARRA AZR6

AZR3
Explanation

Explanation An exception condition was raised as the result of a


request from the APPC communications routine
During a GETMAIN request, the storage domain DFHZARL to the CICS recovery manager domain. This
detected that the task has been purged. is either caused by a CICS logic error or by the

284 CICS TS for z/OS: CICS Codes


inappropriate use of the indoubt test transaction, User response
CIND. CIND should be activated only on the CICS
If this problem is reproducible, then a level 1 and 2
system where the syncpoint processing was initiated.
trace of the TC component would aid problem
In particular, CIND should not be used on any of the
determination. If you need further assistance from
CICS mirror transactions.
IBM to resolve this problem, see IBM problem support
for guidance on how to proceed.
System action
Module:
The transaction is abnormally terminated with a DFHZARR0
transaction dump.
AZRD
User response
Explanation
Determine whether CIND has been activated for a
transaction that did not initiate the syncpoint The logical and physical APPC receive buffers have
processing. If CIND is not being used, you will need become out of step. This problem is caused either by a
further assistance from IBM to resolve the problem. storage overwrite or by a CICS internal logic error.
See IBM problem support for guidance on how to
proceed. System action
Module: The transaction is abnormally terminated with a CICS
DFHZARER transaction dump.
AZRA
User response
Explanation If this problem is reproducible, then a level 1 and 2
trace of the TC component would aid problem
DFHZARRC detected that the address of an FMH in the
determination. Check the TCTTE in the transaction
APPC was not in the receive buffer. The cause could
dump for printable characters or other signs of a
either be a storage overwrite or a CICS internal logic
storage violation error.
error.
Module:
System action DFHZARR0

The transaction is abnormally terminated with a CICS AZRE


transaction dump.
Explanation
User response The logical APPC receive buffer (addressed by
If this problem is reproducible, a level 1 and 2 trace of TCTERBLA) starts before or after the physical receive
the TC component would aid problem determination. buffer (addressed by TCTERBLA). This is not valid as
Check the TCTTE in the transaction dump for printable the logical receive buffer is the part of the physical
characters or other signs of a storage violation error. receive buffer that is yet to be processed. This
problem could be caused either by a storage overwrite
Module: or by a CICS internal logic error.
DFHZARRC
AZRB System action
The transaction is abnormally terminated with a CICS
Explanation transaction dump.
Module DFHZARR0 was called with an invalid first
parameter. The first parameter should be the code of User response
the function to be performed. This is a CICS logic error.
If this problem is reproducible then a level 1 and 2
trace of the TC component would aid problem
System action determination. Check the TCTTE in the transaction
The transaction is abnormally terminated with a CICS dump for printable characters or other signs of a
transaction dump. storage violation error.
Module:
DFHZARR0

Chapter 1. Transaction abend codes 285


AZRF System action
The transaction is abnormally terminated with a CICS
Explanation transaction dump.
The DFHZUSR state machine has returned an invalid
state error at a point where it should not be possible. User response
This is a CICS internal logic error.
If this problem is reproducible, then a level 1 and 2
trace of the TC component would aid problem
System action determination. If you need further assistance from
The transaction is abnormally terminated with a CICS IBM to resolve this problem, see IBM problem support
transaction dump. for guidance on how to proceed.
Module:
User response DFHZARR
If this problem is reproducible, then a level 1 and 2 AZRI
trace of the TC component would aid problem
determination. If you need further assistance from Explanation
IBM to resolve this problem, see IBM problem support
for guidance on how to proceed. One of the parameters passed to DFHZARR1. was
invalid. This is a CICS internal logic error.
Module:
DFHZARRF System action
AZRG The transaction is abnormally terminated with a CICS
transaction dump.
Explanation
The DFHZUSR state machine has returned an invalid User response
state error at a point where it should not be possible. If this problem is reproducible, then a level 1 and 2
This is a CICS internal logic error. trace of the TC component would aid problem
determination. If you need further assistance from
System action IBM to resolve this problem, see IBM problem support
The transaction is abnormally terminated with a CICS for guidance on how to proceed.
transaction dump. Module:
DFHZARR1
User response AZRJ
If this problem is reproducible, then a level 1 and 2
trace of the TC component would aid problem Explanation
determination. If you need further assistance from
IBM to resolve this problem, see IBM problem support The length of a record that DFHZARR0 has been
for guidance on how to proceed. requested to remove from the APPC receive buffer, is
longer than the buffer itself. This problem could be
Module: caused either by a storage overwrite or by a CICS
DFHZARR internal logic error.
AZRH
System action
Explanation The transaction is abnormally terminated with a CICS
The DFHZARR state variable RECEIVE_TYPE, used to transaction dump.
control receive processing, has been set to an invalid
value. The only other module that has access to this User response
variable is DFHZARRF. This is a CICS internal logic If this problem is reproducible, a level 1 and 2 trace of
error. the TC component would aid problem determination.
Check the TCTTE in the transaction dump for printable
characters or other signs of a storage violation error.
Module:

286 CICS TS for z/OS: CICS Codes


DFHZARR0 System action
AZRK The transaction is abnormally terminated with a CICS
transaction dump.
Explanation
User response
The DFHLUC parameter list passed back from
DFHZERH to DFHZARRF contained an invalid If this problem is reproducible, a level 1 and 2 trace of
combination of LUCCIERR, LUCCIFRE, and LUCCIRBK the TC component would aid problem determination.
fields. This is a CICS internal logic error. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
System action how to proceed.

The transaction is abnormally terminated with a CICS Module:


transaction dump. DFHZARR
AZRN
User response
If this problem is reproducible, a level 1 and 2 trace of Explanation
the TC component would aid problem determination. The DFHLUC parameter list passed back from
If you need further assistance from IBM to resolve this DFHZERH to DFHZARRF did not have LUCCIERR set
problem, see IBM problem support for guidance on on. This is a CICS internal logic error.
how to proceed.
Module: System action
DFHZARRF
The transaction is abnormally terminated with a CICS
AZRL transaction dump.

Explanation User response


Module DFHZARRF was called with an invalid first If this problem is reproducible, a level 1 and 2 trace of
parameter. The first parameter should be the code of the TC component would aid problem determination.
the function to be performed. This is a CICS internal If you need further assistance from IBM to resolve this
logic error. problem, see IBM problem support for guidance on
how to proceed.
System action Module:
The transaction is abnormally terminated with a CICS DFHZARRF
transaction dump. AZRO

User response Explanation


If this problem is reproducible, a level 1 and 2 trace of Module DFHZARER was called with an invalid first
the TC component would aid problem determination. parameter. The first parameter should be the code of
If you need further assistance from IBM to resolve this the function to be performed. This is a CICS internal
problem, see IBM problem support for guidance on logic error.
how to proceed.
Module: System action
DFHZARRF
The transaction is abnormally terminated with a CICS
AZRM transaction dump.

Explanation User response


Module DFHZARR called one of its own internal If this problem is reproducible, a level 1 and 2 trace of
routines at the wrong time. This is a CICS internal logic the TC component would aid problem determination.
error. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed.

Chapter 1. Transaction abend codes 287


Module: System action
DFHZARER
The transaction is abnormally terminated with a CICS
AZRP transaction dump.

Explanation User response


Module DFHZARER detected an invalid response from If this problem is reproducible, a level 1 and 2 trace of
DFHZNAC. This is a CICS internal logic error. the TC component would aid problem determination.
Check the TCTTE in the transaction dump for printable
System action characters or other signs of a storage violation error.

The transaction is abnormally terminated with a CICS Module:


transaction dump. DFHZARRA
AZRS
User response
If this problem is reproducible, a level 1 and 2 trace of Explanation
the TC component would aid problem determination. Module DFHZARRA is unable to acquire main memory
If you need further assistance from IBM to resolve this for a new application buffer into which it is supposed
problem, see IBM problem support for guidance on to copy some data. This is because the DFHLUC
how to proceed. receive request is SUBTYPE=LLID, SET=YES and
Module: DFHZARRA does not know the length to acquire on the
DFHZARER GETMAIN. DFHZARRA requires the length of the
record currently being received, but it has been set to
AZRQ 0 in error. This is a CICS logic error. The exception
trace point that accompanies this abend code gives
Explanation the TCTTE address.
Module DFHZARRA was called with an invalid
parameter. This is a CICS internal logic error. System action
The transaction is abnormally terminated with a CICS
System action transaction dump.
The transaction is abnormally terminated with a CICS
transaction dump. User response
If this problem is reproducible, a level 1 and 2 trace of
User response the TC component would aid problem determination.
If you need further assistance from IBM to resolve this
If this problem is reproducible, a level 1 and 2 trace of
problem, see IBM problem support for guidance on
the TC component would aid problem determination.
how to proceed.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on Module:
how to proceed. DFHZARRA
Module: AZRT
DFHZARRA
AZRR Explanation
Module DFHZARRA has detected that the application
Explanation buffer, into which it is supposed to copy some data, is
invalid. This is either because the address of the buffer
Module DFHZARRA detected that the application
is zero or because its length is less than that of the
buffer chained off of a TCTTE at offset TCTERCSA had
data to be copied into it. This is a CICS logic error. The
a corrupted header. This is caused either by a CICS
exception trace point that accompanies this abend
logic error or by a storage overwrite. The exception
code gives the buffer address and length plus the data
trace point that accompanies this abend code gives
address and length.
the TCTTE address.

288 CICS TS for z/OS: CICS Codes


System action Module:
One of the parameters passed to DFHZARR1
The transaction is abnormally terminated with a CICS
transaction dump. AZRW

User response Explanation


If this problem is reproducible, a level 1 and 2 trace of Module DFHZARRA detected a negative record length
the TC component would aid problem determination. in the TCTTE (field TCTELLC). This is caused either by a
If you need further assistance from IBM to resolve this CICS logic error or by a storage overwrite. The
problem, see IBM problem support for guidance on exception trace point that accompanies this abend
how to proceed. code gives the TCTTE address and the value of
TCTELLC.
Module:
DFHZARRA
System action
AZRU
The transaction is abnormally terminated with a CICS
transaction dump.
Explanation
Module DFHZARRF detected an unexpected response User response
from DFHZARR0. This is a CICS logic error. The
exception trace point that accompanies this abend If this problem is reproducible, a level 1 and 2 trace of
code gives the invalid response code. the TC component would aid problem determination.
Check the TCTTE in the transaction dump for printable
characters or other signs of a storage violation error.
System action
Module:
The transaction is abnormally terminated with a CICS
DFHZARRA
transaction dump.
AZRY
User response
Explanation
If this problem is reproducible, then a level 1 and 2
trace of the TC component would aid problem Module DFHZARR detected an unexpected response
determination. If you need further assistance from from DFHZARRC. This is a CICS logic error. The
IBM to resolve this problem, see IBM problem support exception trace point that accompanies this abend
for guidance on how to proceed. code gives the invalid response code.
Module:
DFHZARRF System action

AZRV The transaction is abnormally terminated with a CICS


transaction dump.
Explanation
User response
Module DFHZARR1 detected an unexpected response
from DFHZARR0. This is a CICS logic error. The If this problem is reproducible, a level 1 and 2 trace of
exception trace point that accompanies this abend the TC component would aid problem determination.
code gives the invalid response code. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed.
System action
Module:
The transaction is abnormally terminated with a CICS
DFHZARR
transaction dump.
AZRZ
User response
Explanation
If this problem is reproducible, a level 1 and 2 trace of
the TC component would aid problem determination. Module DFHZARR detected an unexpected response
If you need further assistance from IBM to resolve this from an internal subroutine. This is a CICS logic error.
problem, see IBM problem support for guidance on The exception trace point that accompanies this abend
how to proceed. code gives the invalid response code.

Chapter 1. Transaction abend codes 289


System action Explanation
The transaction is abnormally terminated with a CICS The TCTTE passed via the DFHZSTAM macro to the
transaction dump. processing DFHZSTAP program does not relate to an
MRO or an APPC Conversation. This is a CICS internal
User response logic error.

If this problem is reproducible, a level 1 and 2 trace of


System action
the TC component would aid problem determination.
If you need further assistance from IBM to resolve this The transaction is abnormally terminated with a CICS
problem, see IBM problem support for guidance on transaction dump.
how to proceed.
Module: User response
DFHZARR If you need further assistance from IBM to resolve this
AZS0 problem, see IBM problem support for guidance on
how to proceed.
Explanation Module:
DFHZSTAP
An invalid request was passed via the DFHZSTAM
macro to the processing DFHZSTAP program. This is a AZS3
CICS internal logic error.
Explanation
System action
The TCTTE passed via the DFHZSTAM macro to the
The transaction is abnormally terminated with a CICS processing DFHZSTAP program for an APPC
transaction dump. Conversation, but the LUC Extension Control Block
was not located. This is a CICS internal logic error.
User response
System action
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on The transaction is abnormally terminated with a CICS
how to proceed. transaction dump.
Module:
DFHZSTAP User response

AZS1 If you need further assistance from IBM to resolve this


problem, see IBM problem support for guidance on
how to proceed.
Explanation
Module:
No TCTTE pointer was passed via the DFHZSTAM
DFHZSTAP
macro to the processing DFHZ program. This is a CICS
internal logic error. AZS4

System action Explanation


The transaction is abnormally terminated with a CICS While processing a DFHZSTAM request in DFHZSTAP,
transaction dump. the DFHZUSRM LUC State Machine was found to have
an invalid setting. This is a CICS internal logic error.
User response
System action
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on The transaction is abnormally terminated with a CICS
how to proceed. transaction dump.
Module:
DFHZSTAP User response

AZS2 If you need further assistance from IBM to resolve this


problem, see IBM problem support for guidance on
how to proceed.

290 CICS TS for z/OS: CICS Codes


Module: User response
DFHZSTAP
The conversation with the routing system should be an
AZS5 MRO session or an LU type 6.2 conversation. Ensure
that the transaction is being attached by the CICS
Explanation relay program in the connected system and not by a
user program.
Whilst processing a DFHZSTAM request in DFHZSTAP,
the Internal State number was found to have an invalid If the transaction is being attached by the CICS relay
setting. This is a CICS internal logic error. program in the connected system, you need further
assistance to resolve this problem. See IBM problem
support for guidance on how to proceed.
System action
Module:
The transaction is abnormally terminated with a CICS
DFHZTSP
transaction dump.
AZT3
User response
Explanation
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on The task is being routed back to the region from where
how to proceed. it came.
Module:
DFHZSTAP System action

AZS6 CICS abnormally terminates the transaction with a


transaction dump.
Explanation
User response
Whilst processing a DFHZSTAM request in DFHZSTAP,
the Internal State number was found to have an invalid Correct the transaction definition.
setting. This is a CICS internal logic error. Module:
DFHZTSP, DFHAPRT, DFHRTE
System action
AZT6
The transaction is abnormally terminated with a CICS
transaction dump. Explanation
The task in the application-owning region has received
User response
a ROLLBACK request from the terminal-owning region,
If you need further assistance from IBM to resolve this but the conversation is continuing. The terminal-
problem, see IBM problem support for guidance on owning region has violated the transaction routing
how to proceed. protocol.
Module:
DFHZSTAP System action

AZT1 CICS abnormally terminates the transaction with a


transaction dump.
Explanation
User response
The task has been attached improperly in the
application-owning region when transaction routing. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed.
System action
Module:
CICS abnormally terminates the transaction with a
DFHZTSP
transaction dump.
AZT7

Chapter 1. Transaction abend codes 291


Explanation AZTA
A session terminal control table (TCT) entry for a
remotely owned APPC terminal or connection could Explanation
not be added to the TCT. The task does not own a terminal as its principal
facility.
System action
The task is abnormally terminated with a CICS System action
transaction dump. The task is abnormally terminated with a CICS
transaction dump.
User response
If you need further assistance from IBM to resolve this User response
problem, see IBM problem support for guidance on If you need further assistance from IBM to resolve this
how to proceed. problem, see IBM problem support for guidance on
Module: how to proceed.
DFHZTSP Module:
AZT8 DFHZTSP, DFHAPRR
AZTB
Explanation
A session terminal control table (TCT) entry for a Explanation
remotely owned APPC terminal or connection could An attempt to install or delete a remote terminal in
not be deleted from the TCT. this CICS system has failed. This may be because
CATA was trying to install a local terminal at the same
System action time as CITS was installing a remote terminal with the
The task is abnormally terminated with a CICS same termid. In this situation CICS gives priority to the
transaction dump. locally installed terminal (CATA). This abend can occur
if the CITS/CDTS/CMTS/CFTS transactions take an
excessively long time to execute, for example due to
User response the CICS system having reached MAXTASK or the
If you need further assistance from IBM to resolve this short on storage (SOS) condition. This abend can also
problem, see IBM problem support for guidance on occur if the CITS/CDTS/CMTS/CFTS transactions are
how to proceed. not available (that is , if the transactions have not been
installed).
Module:
DFHZTSP
System action
AZT9
The task which is being initialized for transaction
routing is abnormally terminated with a CICS
Explanation transaction dump.
A session terminal control table (TCT) entry for a
remotely owned APPC terminal or connection could User response
not be deleted from the TCT because it is locked by
If there was an abend AZI6/AZTS abend in the TOR
another task.
then retry the request after the locally installed
terminal with the same TERMID has logged off. If the
System action CICS system reached MAXTASK or short on storage
The task is abnormally terminated with a CICS (SOS) conditions, retry the request when the CICS
transaction dump. system is processing less work. Alternatively it may be
necessary to update the MAXTASK value or the
storage allocation for the CICS system. Otherwise,
User response
verify that the listed transactions exist and have been
The other task may be transitory in nature, and if so, installed. If the failure persists then you need further
another attempt will succeed. assistance to resolve this problem. See IBM problem
Module: support for guidance on how to proceed.
DFHZTSP

292 CICS TS for z/OS: CICS Codes


Module: Module:
DFHZTSP, DFHAPRA DFHAPRT
AZTC AZTF

Explanation Explanation
An attempt to install or delete a remote terminal in DFHZTSP tried to GETMAIN or FREEMAIN a TCTTE
this system has failed. This is because a short-on- whose length (TCTTETEL) is longer than the largest
storage (SOS) condition has caused the failure of a TCTTE SUBPOOL and is therefore invalid. This implies
GETMAIN for the attach of CITS, CDTS, or CFTS. a storage violation or a CICS internal logic error.
This abend can also occur during shutdown if the
transaction definition specifies System action
SHUTDOWN(DISABLED). The transaction is abnormally terminated with a CICS
transaction dump.
System action
The transaction is abnormally terminated with a CICS User response
transaction dump. Use the transaction dump to identify the TCTTE in
error. First, check whether this is a storage overwrite.
User response If so, check in your statistics to see if you are getting a
number of storage violations caused by the same
Investigate the reason for the SOS condition. See the
transaction. If this is the case, then a user-supplied
Troubleshooting and support section for guidance on
application is probably causing the problem.
dealing with the SOS condition.
If it is not a storage violation problem, or if there is a
Retry the transaction later.
random storage violation, there might be an error in
Module: CICS. In this case, you need further assistance to
DFHZTSP, DFHAPRA resolve the problem. See IBM problem support for
guidance on how to proceed.
AZTE
Module:
Explanation DFHZTSP

An attempt to use EDF and to route a transaction to a AZTG


remote region has failed.
Explanation
This is because the CEDF transaction was used to start
an EDF session and then there was an attempt to route An attempt has been made to attach a task on a
a transaction to a remote region. remotely-owned terminal without an intersystem
TCTTE as its principal facility.
Communication between the local region and the
remote region uses an IPIC connection.
System action
However the remote region is an earlier version of
CICS which does not support use of EDF with an IPIC The task is abnormally terminated with a CICS
connection. transaction dump.

System action User response

The task is abnormally ended with a CICS transaction If you need further assistance from IBM to resolve this
dump. problem, see IBM problem support for guidance on
how to proceed.
User response Module:
DFHZTSP
You can do one of the following:
AZTH
• Enable CEDX for the transaction on the remote
region.
• Release the IPIC connection and run the transaction
with EDF enabled using another connection type.

Chapter 1. Transaction abend codes 293


Explanation System action
An error response was received from the remote The task is abnormally terminated with a CICS
terminal control macro. transaction dump.

System action User response


The task is abnormally terminated with a CICS Inform the system programmer. Check the terminal
transaction dump. resource definitions in the systems involved.
Module:
User response DFHZTSP, DFHAPRA
If you need further assistance from IBM to resolve this AZTM
problem, see IBM problem support for guidance on
how to proceed.
Explanation
Module:
The data received from the remote system does not
DFHZTSP
contain an FMH (function management header).
AZTI
System action
Explanation
The task is abnormally terminated with a CICS
An attempt has been made to attach a task on a transaction dump.
remotely-owned terminal, but the terminal is not
defined in this system as a remotely-owned terminal. User response
This may occur after an AZVK abend when CICS If you need further assistance from IBM to resolve this
attempts to delete the surrogate TCTTE, but there is problem, see IBM problem support for guidance on
still a transaction running against it. how to proceed.
Alternatively, another task holds a lock on this Module:
terminal. DFHZTSP
AZTN
System action
The task is abnormally terminated with a CICS Explanation
transaction dump.
Conversation with a remote system has been
unexpectedly terminated.
User response
Check the terminal control table definitions in the System action
systems involved. If the definitions are correct, check
that no other tasks have locks held on the terminal The task is abnormally terminated with a CICS
(CECI, for example). transaction dump.

Check to see if an AZVK abend occurred earlier for this


User response
terminal and determine if the link session timing out
was the original cause. All should be well once the If you need further assistance from IBM to resolve this
long running transaction finishes. problem, see IBM problem support for guidance on
how to proceed.
Module:
DFHZTSP, DFHAPRA Module:
DFHZTSP
AZTL
AZTO
Explanation
Explanation
An attempt has been made to attach a task to a
remotely-owned terminal that cannot be used to run The TCTTE ownership chain is in error.
this transaction.

294 CICS TS for z/OS: CICS Codes


System action System action
The task is abnormally terminated with a CICS The task is abnormally terminated with a CICS
transaction dump. transaction dump.

User response User response


If you need further assistance from IBM to resolve this Ensure that the required BMS support has been
problem, see IBM problem support for guidance on generated.
how to proceed.
Module:
Module: DFHZTSP, DFHAPRR
DFHZTSP
AZTS
AZTP
Explanation
Explanation
The conversation with the remote system failed.
A BMS TYPE=STORE request issued on behalf of a
remote transaction failed. System action
The task is abnormally terminated with a CICS
System action
transaction dump.
The task abnormally terminates with a CICS
transaction dump. User response
Investigate why the conversations with the remote
User response
system failed. The transaction on the remote system
Inform the system programmer. Check that the has probably been abnormally terminated or the
required BMS support has been generated. session has failed.
Module: If message 'DFHZC4930 Session unbound following
DFHZTSP, DFHAPRR read timeout.' occurred just before the AZTS then the
AZTS is caused by a timeout occurring on an APPC
AZTQ
session when CICS attempted to converse with the
remote system.
Explanation
Module:
Invalid BMS data received from remote system. DFHZTSP, DFHAPRR, DFHAPRA
AZTT
System action
The task is abnormally terminated with a CICS Explanation
transaction dump.
An attempt was made to attach a task on a remote
system, but the connection with the remote system is
User response
not an APPC or MRO connection.
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on System action
how to proceed.
The task is abnormally terminated with a CICS
Module: transaction dump.
DFHZTSP, DFHAPRR
AZTR User response
Redefine the connection as APPC or MRO, or avoid
Explanation using transaction routing on this connection.
A BMS TYPE=PAGEOUT request issued on behalf of a Module:
remote system failed. DFHZTSP
AZTU

Chapter 1. Transaction abend codes 295


Explanation User response
The task does not own the link TCTTE after a sync Check the terminal control table definitions in the
point has been taken. systems involved.
Check to see if a read timeout abend occurred on the
System action TOR for the same terminal to determine if this is the
The task is abnormally terminated with a CICS cause. Wait until the transaction terminates before
transaction dump. retrying any further transactions on this terminal.
Module:
User response DFHZTSP, DFHAPRA
If you need further assistance from IBM to resolve this AZTY
problem, see IBM problem support for guidance on
how to proceed. Explanation
Module: A session TCT entry for a remotely owned APPC
DFHZTSP terminal or connection could not be created because
AZTV to do so would exceed the maximum number of APPC
sessions permitted.
Explanation The maximum number of sessions depends on
whether the PTF shipped for APAR PQ27823 is
An invalid function management header (FMH) has
installed. The basic limit is 46656 and the names are
been received from the remote system.
in the range -AAA to -999. The APAR doubles this limit
to 93312 giving an additional range of AAA- to 999-.
System action
The task is abnormally terminated with a CICS System action
transaction dump.
The task is abnormally terminated with a CICS
transaction dump.
User response
If you need further assistance from IBM to resolve this User response
problem, see IBM problem support for guidance on
Inform the system programmer. Either wait for the
how to proceed.
system to become less busy, or delete some APPC
Module: sessions.
DFHZTSP
The system programmer should consider increasing
AZTW the number of CICS TORs.
Module:
Explanation DFHZTSP
An attempt was made to attach a task on a remotely- AZTZ
owned terminal that was already running a task.
This may be caused by a read time out occurring in the Explanation
terminal owning region for the link session being used
The CICS relay program DFHCRT has been attached in
by this transaction. The read timeout is specified in
an unsupported manner.
profile DFHCICSS. Although the session has timed out
the transaction may still be running and the surrogate
TCTTE is unable to accept any more transactions until System action
the first one has finished. CICS abnormally terminates the transaction with a
transaction dump.
System action
The task is abnormally terminated with a CICS User response
transaction dump. The relay transaction executes with an MRO session or
an LU type 6.2 conversation as its principal facility.
Ensure that the transaction is being attached by APPC

296 CICS TS for z/OS: CICS Codes


terminal sharing logic and not directly by a user AZVC
transaction.
If the transaction is being attached by APPC terminal Explanation
sharing logic, you need further assistance to resolve An unexpected error has occurred in DFHZATS. This is
this problem. See IBM problem support for guidance probably caused by DFHZATS being unable to address
on how to proceed. the CSA, EIB or the TCA. It can also occur if DFHZATS
Module: is called with an EXEC CICS START command for
DFHZTSP transactions CITS, CFTS, CMTS or CDTS. These are
internal CICS transactions and should not be called in
AZVA this way.

Explanation System action


DFHZTSP has timed out waiting for service transaction The task is abnormally terminated with a CICS
CITS to complete during the creation of a remote transaction dump.
terminal while attaching a task in the application-
owning region.
User response
The probable cause of this is that the application-
If you need further assistance from IBM to resolve this
owning region is very busy, so the CITS transaction has
problem, see IBM problem support for guidance on
been waiting to be dispatched for longer than the
timeout value allowed by DFHZTSP. Lack of storage on how to proceed.
the target system is one possible reason why CITS has Module:
not been dispatched, or has been dispatched but has DFHZATS
not completed.
AZVD
System action
Explanation
The task is abnormally terminated with a CICS
transaction dump. An unexpected error has occurred in the install
procedure of DFHZATS.
User response
System action
Retry the transaction when the system becomes less
busy. For more information on improving transaction The task is abnormally terminated with a CICS
throughput on the target system, see the Improving transaction dump.
performance.
User response
Module:
DFHZATS This is a CICS logic error. If you need further
assistance from IBM to resolve this problem, see IBM
AZVB problem support for guidance on how to proceed.
Module:
Explanation
DFHZATS
DFHZCQ has failed to create the remote terminal
AZVE
definition. A previous message or messages should
indicate the reason for the failure.
Explanation
System action DFHZATS is trying to install a remote terminal with the
The task is abnormally terminated with a CICS same terminal id as an existing TCT entry.
transaction dump.
System action
User response The task is abnormally terminated with a CICS
See the previous message or messages for further transaction dump.
guidance.
Module:
DFHZATS

Chapter 1. Transaction abend codes 297


User response User response
Change the terminal names to ensure that a duplicate If you need further assistance from IBM to resolve this
does not occur in the same system. problem, see IBM problem support for guidance on
how to proceed.
Module:
DFHZATS Module:
DFHZATS
AZVF
AZVI
Explanation
Explanation
One of the remote install or delete transactions of
DFHZATS (CITS, CFTS, CMTS or CDTS) has been An error has occurred in the remote delete routine
started directly from a terminal. This is not permitted. while an attempt was being made to delete a single
These transactions can only be started internally by remote terminal.
CICS.
System action
System action
The task is abnormally terminated with a CICS
The transaction is abnormally terminated with a transaction dump.
transaction dump.
User response
User response
Check the CADL transient data queue for any
None. associated messages indicating the reason for the
error. If you cannot resolve the problem, you will need
Module:
assistance from IBM. See IBM problem support for
DFHZATS
guidance on how to proceed.
AZVG
Module:
DFHZATS
Explanation
AZVJ
An error has occurred in the remote delete routines.
Explanation
System action
An error has occurred during the mass deletion of
The task is abnormally terminated with a CICS remote terminals. This is caused by a CICS logic error.
transaction dump.
System action
User response
The task is abnormally terminated with a CICS
If you need further assistance from IBM to resolve this transaction dump.
problem, see IBM problem support for guidance on
how to proceed.
User response
Module:
If you need further assistance from IBM to resolve this
DFHZATS
problem, see IBM problem support for guidance on
AZVH how to proceed.
Module:
Explanation DFHZATS
An error has occurred in the remote delete routine AZVK
during the mass deletion of remote terminals.
Explanation
System action
An unexpected return code has been received from
The task is abnormally terminated with a CICS the remote delete routine during the deletion of a
transaction dump. single remote terminal.

298 CICS TS for z/OS: CICS Codes


This may occur after an AZTW abend when CICS User response
attempts to delete the surrogate TCTTE, but there is
If you need further assistance from IBM to resolve this
still a transaction running against it. It may also occur
problem, see IBM problem support for guidance on
without an AZTW if the link session timed out leaving
how to proceed.
the transaction in the AOR still running but followed by
a logoff from the terminal which initiated the long Module:
running transaction. DFHZATMF
AZVN
System action
The task is abnormally terminated with a CICS Explanation
transaction dump.
The remote delete flag transaction of DFHZATMF
(CRMF) has been started directly from a terminal. This
User response is not permitted. This transaction can only be started
Look for an accompanying DFHZC6911 message internally by CICS.
indicating the reason for the delete failure, and take
appropriate action. System action
Check to see if the link session for this terminal timed The transaction is abnormally terminated with a
out and whether the terminal then issued another transaction dump.
transaction or logged off. All should be well once the
long running transaction finishes. User response
Module: None.
DFHZATS
Module:
AZVL DFHZATMF
AZVO
Explanation
An error has occurred during the mass flagging of Explanation
remote terminals for deletion.
The remote delete transaction of DFHZATMD (CRMD)
has been started directly from a terminal. This is not
System action
permitted. This transaction can only be started
The task is abnormally terminated with a CICS internally by CICS.
transaction dump.
System action
User response
The transaction is abnormally terminated with a
If you need further assistance from IBM to resolve this transaction dump.
problem, see IBM problem support for guidance on
how to proceed. User response
Module: None.
DFHZATS
Module:
AZVM DFHZATMD
AZVP
Explanation
An error has occurred in DFHZATMF. This is probably Explanation
caused by DFHZATMF being unable to address the
CSA, EIB, or the TCA. An error has occurred in DFHZATMD. This is probably
caused by DFHZATMD being unable to address the
CSA, EIB, or the TCA.
System action
The task is abnormally terminated with a CICS System action
transaction dump.
The task is abnormally terminated with a CICS
transaction dump.

Chapter 1. Transaction abend codes 299


User response User response
If you need further assistance from IBM to resolve this Examine the autoinstall user program to determine the
problem, see IBM problem support for guidance on reason for the failure.
how to proceed.
Module:
Module: DFHZATS
DFHZATMD
AZVU
AZVQ
Explanation
Explanation
DFHZATS was attempting to autoinstall a shipped
A request to install a shipped terminal definition has terminal, a virtual terminal or a shipped connection
been rejected by the autoinstall user program. and the autoinstall URM was called. However the
autoinstall failed for one of the following reasons:
System action • The name returned by the URM in
The task is abnormally terminated with a CICS SELECTED_SHIPPED_TERMID started with one of
transaction dump. these characters:
<
User response >
Retry the transaction when the system is less busy. -
• The value in the SIT VTPREFIX parameter contained
Module:
imbedded blanks or a character that is not allowed
DFHZATS
for terminal names.
AZVR
System action
Explanation
The task is abnormally terminated with a CICS
An attempt to install a shipped terminal definition has transaction dump.
failed because the autoinstall user program has issued
an unexpected return code. User response
If you need further assistance from IBM to resolve this
System action
problem, see IBM problem support for guidance on
The task is abnormally terminated with a CICS how to proceed.
transaction dump.
Module:
DFHZATS
User response
AZXA
Examine the autoinstall user program to determine
why this return code was issued.
Explanation
Module:
An unexpected error, with reason code 5, has been
DFHZATS
detected in the catchup program, DFHZXCU. See the
AZVS description of message DFHXG6492 for further
details.
Explanation
System action
An attempt to install a shipped terminal definition has
failed because an error has occurred in the autoinstall Console message DFHXG6492 is issued, and CICS
user program. continues after abending the transaction.

System action User response


The task is abnormally terminated with a CICS Refer to message DFHXG6492.
transaction dump.
Module:
DFHZXCU

300 CICS TS for z/OS: CICS Codes


AZXB User response
Refer to message DFHXG6492.
Explanation
Module:
An unexpected error, with reason code 4, has been DFHZXCU
detected in the catchup program, DFHZXCU. See the
description of message DFHXG6492 for further
details.

System action
Console message DFHXG6492 is issued, and CICS
continues after abending the transaction.

Chapter 1. Transaction abend codes 301


302 CICS TS for z/OS: CICS Codes
Chapter 2. System abend and dump codes

Abend and dump codes are used by the following system components and products:
• The CICS system
• IMS
• The CICS translator
• The CICS system dump program
• The CICS utility program, DFHCSDUP
• The external CICS interface
• The CICS JVM interface
• Language Environment®

CICS system dump codes


To help proceed with problem diagnosis, CICS references a system dump code that corresponds to the
event that requested a CICS system dump. In most cases, system dump codes correspond to a DFH
message with the DFH prefix removed.
For example, system dump code DM0001 corresponds to message DFHDM0001 with the DFH tag
removed. For further information, look up the relevant message where appropriate.
However, there are some exceptions to this format, as shown in the following list.
System dump code
Corresponding message or exception condition
ABNDU603
This system dump code refers to a USER abend code and is associated with message DFHSR0603.
ABNDU605
This system dump code refers to a USER abend code and is associated with message DFHSR0605.
APTRAPPC
This system dump code is associated with message DFHTR1001.
APTRAPUS
This system dump code is associated with message DFHTR1000.
APUSER
This system dump code is issued through the use of the CEBT transaction when performing a
PERFORM SNAP command.
APXRFTO
This system dump code has no DFH message associated with it. An error in the currently active CICS
system has occurred. An alternate CICS system is now taking control and is requesting that the active
CICS system produces a dump of itself.
CCVNOSP
This dump along with the DFHCC0203 message is provided for diagnostic purposes when a "no
space" response is received from VSAM while attempting to write a catalog record.
MT0001
This system dump code has no DFH message associated with it. It indicates that a dump was
requested by a user of CEMT, issuing either a PERFORM SNAP or a PERFORM DUMP.
For more information about using dumps in problem diagnosis, see Using dumps in problem
determination.

© Copyright IBM Corp. 1974, 2020 303


DHxx (IMS) abend codes
If the IMS high-level programming interface (HLPI) has found a condition caused by a programming error,
or if DL/I has returned a status code to HLPI that indicates an error, IMS returns a status code xx to CICS
Transaction Server for z/OS. Some more common abend codes are listed here. For a full list of xx status
codes that can make up a DHxx abend, see DL/I status codes in IMS product documentation.
DHTA Explanation
A task has issued a terminate request but the request
Explanation failed because the program specification block (PSB) is
A task has issued a program specification block (PSB) not scheduled.
schedule request but the PSB could not be found. See the description of the DL/I status code TG in the
See the description of the DL/I status code TA in the IMS messages and codes manual for guidance.
IMS messages and codes manual for guidance. System action:
System action: User response:
User response: Module:
Module: DHTH
DHTC
Explanation
Explanation A task has issued a DL/I request but the request failed
A task has issued a program specification block (PSB) because the program specification block (PSB) is not
schedule request but the PSB has already been scheduled.
scheduled. See the description of the DL/I status code TH in the
See the description of the DL/I status code TC in the IMS messages and codes manual for guidance.
IMS messages and codes manual for guidance. System action:
System action: User response:
User response: Module:
Module: DHTJ
DHTE
Explanation
Explanation A task has issued a program specification block (PSB)
A task has issued a program specification block (PSB) schedule request but the request failed because CICS
schedule request but a PSB initializaton error is not connected to DBCTL.
occurred. See the description of the DL/I status code TJ in the
See the description of the DL/I status code TE in the IMS messages and codes manual for guidance.
IMS messages and codes manual for guidance. System action:
System action: User response:
User response: Module:
Module:
DHTG

01xx (translator) abend codes


0100 Explanation
The listing data set has not opened successfully.

304 CICS TS for z/OS: CICS Codes


System action System action
The CICS command level translator terminates The CICS command-level translator terminates
abnormally. A system dump is produced if a abnormally. A system dump is produced if a
SYSABEND or SYSUDUMP DD statement is provided. SYSABEND or SYSUDUMP DD statement is provided.
User response:
User response If you need further assistance from IBM to resolve this
Ensure correct JCL or determine what is causing the problem, see IBM problem support for guidance on
open error. how to proceed.

Module: Module:
DFHEAP (for assembler language), DFHECP (for DFHEAP (for assembler language), DFHECP (for
COBOL), DFHEDP (for C), DFHEPP (for PL/I) COBOL), DFHEDP (for C), DFHEPP (for PL/I)

0101

Explanation
The translator encountered a program check from
which it could not recover.

02xx (DFHPD710) abend codes


0211 0212

Explanation Explanation
A program check has occurred while the system dump A sixth program check has occurred during execution
formatting program was handling an earlier program of the system dump formatting program.
check.
System action
System action
The system dump formatting program terminates
The system dump formatting program terminates abnormally. A system dump is produced if a
abnormally. A system dump is produced if a SYSABEND or SYSUDUMP DD statement is provided.
SYSABEND or SYSUDUMP DD statement is provided.
User response: User response
The program check preceding the abend is This abend is preceded by five DFHPD0123 messages,
accompanied by message DFHPD0123. See the one for each of the five earlier program checks. See
description of this message for more guidance. the description of this message for more guidance.
Module: Module:
DFHPD0680 DFHPD0680

03xx (DFHCSDUP) abend codes


0300 User response
Ensure that the JCL is correct and that the SYSIN data
Explanation set exists in sequential form. If necessary, examine
The SYSIN data set has not opened successfully. the SYSIN DD statement to determine the cause of the
error.
System action Module:
DFHCSDUP
The CSD batch update utility terminates abnormally. If
a SYSABEND or SYSDUMP DD statement is provided, a 0301
system dump is produced.

Chapter 2. System abend and dump codes 305


Explanation Explanation
The RECFM parameter specified in the SYSIN data set DFHCSDUP has found an unrecognized resource type
is invalid. code in a CSD record. The unrecognized code does not
match any of the function codes in the language
System action definition table. This can occur for one of the following
reasons:
The CSD batch update utility terminates abnormally. If
a SYSABEND or SYSUDUMP DD statement is provided, 1. You are using a CICS release that does not support
a system dump is produced. a type of definition that was created on the CSD file
by a later CICS release.
User response 2. The language definition table (DFHEITSP or
DFHEITCU) is invalid for this CICS release.
Ensure that the RECFM parameter in the SYSIN data
set is either F or V. 3. The CSD manager (DFHDMP) has passed an invalid
CSD record buffer to DFHPUP. This is a CICS
Module: internal logic error.
DFHCSDUP
0302 System action
The CSD batch update utility terminates abnormally. If
Explanation a SYSABEND or SYSUDUMP DD statement is provided,
The record length specified in the SYSIN data set is a system dump is produced.
invalid.
User response
System action Determine which of the possible reasons caused the
The CSD batch update utility terminates abnormally. If error. If you can eliminate reasons 1 and 2, you can
a SYSABEND or SYSUDUMP DD statement is provided, assume that reason 3 applies.
a system dump is produced. Take action corresponding to the reason you have
established as follows:
User response 1. Ignore the message.
Ensure that the record length specified in the SYSIN 2. Ensure that the library contains versions of
data set is no greater than 80. DFHEITSP and DFHEITCU that are valid for the
Module: CICS release you are running.
DFHCSDUP 3. If you need further assistance from IBM to resolve
this problem, see IBM problem support for
0303
guidance on how to proceed.

Explanation Module:
DFHCSDUP
The SYSPRINT data set did not open successfully.
0305
System action
Explanation
The CSD batch update utility terminates abnormally. If
a SYSABEND or SYSUDUMP DD statement is provided, An unexpected return code was received either while
a system dump is produced. trying to close the alternate SYSIN and SYSPRINT
DCBs (CLOSEDCB) or while trying to free the task local
User response storage (FREETLS).

Ensure that the SYSPRINT data set exists. If System action


necessary, examine the SYSPRINT DD statement to
determine the cause of the error. The CSD batch update utility terminates abnormally. If
a SYSABEND or SYSUDUMP DD statement is provided,
Module: a system dump is produced.
DFHCSDUP
0304

306 CICS TS for z/OS: CICS Codes


User response System action
If you need further assistance from IBM to resolve this The CSD batch update utility terminates abnormally. If
problem, see IBM problem support for guidance on a SYSABEND or SYSUDUMP DD statement is provided,
how to proceed. a system dump is produced.
Module:
DFHCSDUP User response

0307 If you need further assistance from IBM to resolve this


problem, see IBM problem support for guidance on
how to proceed.
Explanation
Module:
An attempt to print the input command failed. Since
DFHCSDUP
messages cannot be issued, the utility must terminate.
0321
System action
Explanation
The CSD batch update utility terminates abnormally. If
a SYSABEND or SYSUDUMP DD statement is provided, An internal error has occurred in module DFHCSDUP
a system dump is produced. when invoked by a CSD utility command.

User response System action


If you need further assistance from IBM to resolve this Message DFH5100 is issued and the CSD batch update
problem, see IBM problem support for guidance on utility terminates abnormally. If a SYSABEND or
how to proceed. SYSUDUMP DD statement is provided, a system dump
is produced.
Module:
DFHCSDUP
User response
0308
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
Explanation
how to proceed.
During the migration of a TCT table, a bad command
Module:
sequence was found. This can occur for one of the
DFHCSDUP
following reasons:
0322
• TYPETERM was not preceded by TERMINAL
• TERMINAL was not followed by TYPETERM Explanation

System action While processing a MIGRATE command, the specified


table to be migrated could not be loaded.
The CSD batch update utility terminates abnormally. If
a SYSABEND or SYSUDUMP DD statement is provided, System action
a system dump is produced.
Message DFH5601 is issued and the CSD batch update
User response utility terminates abnormally. If a SYSABEND or
SYSUDUMP DD statement is provided, a system dump
Correct the TCT table to be migrated and rerun the job. is produced.
Module:
DFHCSDUP User response
0309 If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
Explanation how to proceed.

DFHCSDUP has found an unrecognized function code Module:


in a command. This is a CICS internal logic error. DFHCSDUP
0323

Chapter 2. System abend and dump codes 307


Explanation User response
While processing a command, VSAM detected an error. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
System action how to proceed.

Message DFH5179 is issued preceded by either Module:


DFH5177 or DFH5178 depending on the error and the DFHCSDUP
CSD batch update utility terminates abnormally. If a 0327
SYSABEND or SYSUDUMP DD statement is provided, a
system dump is produced.
Explanation

User response The language table DFHEITCU could not be loaded.

See the description of the issued messages to


System action
determine the cause of the error.
The CSD batch update utility terminates abnormally. If
Module:
a SYSABEND or SYSUDUMP DD statement is provided,
DFHCSDUP
a system dump is produced.
0325
User response
Explanation
Refer to the preceding message which should specify
When the LIST command invoked DFHDMP to scan the the reason for the failure. If you need further
objects on the CSD file, an error occurred during assistance from IBM to resolve this problem, see IBM
execution of the DFHDMP function. problem support for guidance on how to proceed.
Module:
System action DFHCSDUP
Message DFH5180 is issued and the CSD batch update 0328
utility terminates abnormally. If a SYSABEND or
SYSUDUMP DD statement is provided, a system dump
Explanation
is produced.
The language table DFHEITCU could not be unloaded.
User response
System action
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on The CSD batch update utility terminates abnormally. If
how to proceed. a SYSABEND or SYSUDUMP DD statement is provided,
a system dump is produced.
Module:
DFHCSDUP
User response
0326
Refer to the preceding message which should specify
the reason for the failure. If you need further
Explanation
assistance from IBM to resolve this problem, see IBM
There has been an internal logic error in the problem support for guidance on how to proceed.
DFHCSDUP utility program. The data in the back-
Module:
translated output buffer is invalid. The length code
DFHCSDUP
may be out of range or the data fields in the wrong
sequence. One or more of the data fields may be 0330
invalid.
Explanation
System action
The cross reference table size for the table being
Message DFH5184 is issued and the CSD batch update migrated is too small.
utility terminates abnormally. If a SYSABEND or
SYSUDUMP DD statement is provided, a system dump
is produced.

308 CICS TS for z/OS: CICS Codes


System action Module:
DFHCSDUP
The CSD batch update utility terminates abnormally. If
a SYSABEND or SYSUDUMP statement is provided, a 0332
system dump is produced.
Explanation
User response
DFHCSDUP was invoked to perform an EXTRACT
If you need further assistance from IBM to resolve this command using a Language Environment-conforming
problem, see IBM problem support for guidance on HLL user exit, but during execution the utility recived a
how to proceed. bad return code from the Language Environment.
Module:
DFHCSDUP System action

0331 The CSD batch update utility terminates abnormally. If


a SYSABEND or SYSUDUMP statement is provided, a
system dump is produced. Register 15 contains the
Explanation
Language Environment return code. code.
DFHCSDUP was invoked to perform an EXTRACT
command using a Language Environment-conforming User response
HLL user exit, but the utility failed to initialize the CEE
environment successfully. If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed.
System action
Module:
The CSD batch update utility terminates abnormally. If
DFHCSDUP
a SYSABEND or SYSUDUMP statement is provided, a
system dump is produced. Register 15 contains the
initialization return code.

User response
If you need further assistance from IBM to resolve this
problem, see IBM problem support for guidance on
how to proceed.

04xx (external CICS interface) abend codes


0401 DFHXCSTB.
0402
Explanation
An external CICS interface (EXCI) request was issued Explanation
using the CALL API or the EXEC API, and the EXCI stub The external CICS interface module DFHXCPRH issued
DFHXCSTB link-edited with the application detected an MVS ESTAE macro to establish a recovery
that it was running in AMODE 24 or AMODE 64. The environment, but a nonzero return code was returned
external CICS interface only supports calls made in from MVS.
AMODE 31.

System action
System action
The application terminates abnormally with a dump.
The application terminates abnormally.

User response
User response
Examine the dump and any associated MVS messages
Change the application so that EXCI calls are made in produced to determine why the MVS ESTAE request
AMODE 31, or relink-edit the application AMODE 31. failed.
Module:

Chapter 2. System abend and dump codes 309


If the error occurred while processing an System action
INITIALIZE_USER request on behalf of the
Module DFHXCPRH issues an MVS abend with abend
application, an attempt to format the dump using the
code 0404 which invokes its ESTAE routine from
CICS IPCS dump formatter does not produce any
which a SYSMDUMP is taken instead of an SDUMP to
formatted output. This is because the error occurred
capture the earlier reported problem.
too early in EXCI initialization for there to be any
control blocks.
User response
Module:
DFHXCPRH Examine the SYSMDUMP to determine the cause of the
earlier reported problem.
0403
An attempt to format the SYSMDUMP produced with
the CICS IPCS dump formatter does not produce any
Explanation
formatted output for the job because the error
The external CICS interface module DFHXCPRH issued occurred too early in EXCI initialization for there to be
an MVS GETMAIN request to obtain storage for its any control blocks.
XCGLOBAL block, but a nonzero return code was
Module:
returned from MVS.
DFHXCPRH

System action 0405

Module DFHXCPRH issues an MVS abend with abend


Explanation
code 0403 which invokes its ESTAE routine to clear up
its environment. A SYSMDUMP is taken before The external CICS interface module DFHXCPRH issued
returning control to the application. An application an IEFSSREQ SSI verify request to MVS to determine
using the EXCI CALL API receives the number of the CICS SVC type 3 SVC to use. The SSI
RESPONSE(SYSTEM_ERROR) VERIFY request failed.
REASON(XCGLOBAL_GETMAIN_ERROR) in its return
area. The subreason1 field of the return area contains System action
the R15 return code from MVS indicating why the
GETMAIN failed. An application using the EXCI EXEC Module DFHXCPRH issues an MVS abend with abend
API receives RESP(LINKERR) RESP2(602). code 0405 which invokes its ESTAE routine to clear up
its environment. A SYSMDUMP is taken before
returning control to the application. An application
User response
using the EXCI CALL API receives
Use the MVS R15 return code obtained from the RESPONSE(SYSTEM_ERROR)
application or from the dump to determine why the REASON(SSI_VERIFY_FAILED) in its return area. The
MVS GETMAIN request failed. If the reason is subreason1 field of the return area contains the R15
insufficient storage, increase the region size of the return code from MVS indicating why the SSI verify
batch application. failed. An application using the EXCI EXEC API
receives RESP(LINKERR) RESP2(606).
An attempt to format the SYSMDUMP produced with
the CICS IPCS dump formatter does not produce any
formatted output for the job because the error User response
occurred too early in EXCI initialization for there to be Use the MVS R15 return code obtained from the
any control blocks. application or from the dump to determine why the
Module: SSI VERIFY request failed.
DFHXCPRH An attempt to format the SYSMDUMP produced with
0404 the CICS IPCS dump formatter does not produce any
formatted output for the job because the error
occurred too early in EXCI initialization for there to be
Explanation
any control blocks.
The external CICS interface module DFHXCPRH
Module:
needed to take an MVS SDUMP for an earlier reported
DFHXCPRH
problem. However the error has occurred too early in
EXCI initialization for EXCI dump services to be 0406
available.

310 CICS TS for z/OS: CICS Codes


Explanation An attempt to format the SYSMDUMP produced with
the CICS IPCS dump formatter does not produce any
The external CICS interface module DFHXCPRH called
formatted output for the job because the error
the CICS SVC to initialize the EXCI environment. The
occurred too early in EXCI initialization for there to be
CICS SVC call failed.
any control blocks.

System action Module:


DFHXCPRH
Module DFHXCPRH issues an MVS abend with abend
code 0406 which invokes its ESTAE routine to clear up 0408
its environment. A SYSMDUMP is taken before
returning control to the application. An application Explanation
using the EXCI CALL API receives
The external CICS interface module DFHXCPRH issued
RESPONSE(SYSTEM_ERROR)
an MVS GETMAIN request for its working storage but a
REASON(CICS_SVC_CALL_FAILURE) in its return area.
nonzero return code was returned from MVS.
The subreason1 field of the return area contains the
R15 return code from the CICS SVC indicating why it
failed. An application using the EXCI EXEC API System action
receives RESP(LINKERR) RESP2(607). Module DFHXCPRH issues an MVS abend with abend
code 0408 which invokes its ESTAE routine to clear up
User response its environment. A SYSMDUMP is taken before
returning control to the application. An application
Use the MVS R15 return code obtained from the
using the EXCI CALL API receives
application or from the dump to determine why the
RESPONSE(SYSTEM_ERROR)
CICS SVC call failed.
REASON(WS_GETMAIN_ERROR) in its return area. The
An attempt to format the SYSMDUMP produced with subreason1 field of the return area contains the R15
the CICS IPCS dump formatter does not produce any return code from MVS indicating why the GETMAIN
formatted output for the job because the error failed. An application using the EXCI EXEC API
occurred too early in EXCI initialization for there to be receives RESP(LINKERR) RESP2(601).
any control blocks.
Module: User response
DFHXCPRH Use the MVS R15 return code obtained from the
0407 application or from the dump to determine why the
MVS GETMAIN request failed. If the reason is
insufficient storage, increase the region size of the
Explanation
batch application.
The external CICS interface module DFHXCPRH issued
An attempt to format the SYSMDUMP produced with
a call to the CICS SVC to check whether the SVC in use
the CICS IPCS dump formatter does not produce any
is at the correct level to be used with the external CICS
formatted output for the job because the error
interface. The check failed indicating that the CICS
occurred too early in EXCI initialization for there to be
SVC is not at the correct level.
any control blocks.

System action Module:


DFHXCPRH
Message DFHEX0100 is output, and module
DFHXCPRH issues an MVS abend with abend code 0409
0407 which invokes its ESTAE routine to clear up its
environment. A SYSMDUMP is taken before returning Explanation
control to the application. An application using the
The external CICS interface module DFHXCPRH issued
EXCI CALL API receives RESPONSE(SYSTEM_ERROR)
an MVS GETMAIN request for storage required for its
REASON(INCORRECT_SVC_LEVEL) in its return area.
SSI VERIFY request, but a nonzero return code was
An application using the EXCI EXEC API receives
returned from MVS.
RESP(LINKERR) RESP2(627).

System action
User response
Module DFHXCPRH issues an MVS abend with abend
See the explanation of message DFHEX0100 for
code 0409 which invokes its ESTAE routine to clear up
guidance.

Chapter 2. System abend and dump codes 311


its environment. A SYSMDUMP is taken before Explanation
returning control to the application. An application
The external CICS interface dump module DFHXCDMP
using the EXCI CALL API receives
was attempting to call the CICS SVC in order for an
RESPONSE(SYSTEM_ERROR)
MVS SDUMP to be taken to capture an earlier problem.
REASON(VERIFY_BLOCK_GM_ERROR) in its return
DFHXCDMP was unable to call the SVC as no SVC
area. The subreason1 field of the return area contains
number was available. DFHXCDMP issued an 0411
the R15 return code from MVS indicating why the
abend in order that the callers ESTAE routine is
GETMAIN failed. An application using the EXCI EXEC
invoked which takes a SYSMDUMP instead.
API receives RESP(LINKERR) RESP2(605).

System action
User response
A SYSMDUMP is taken instead of an SDUMP for an
Use the MVS R15 return code obtained from the
earlier reported problem.
application or from the dump to determine why the
MVS GETMAIN request failed. If the reason is
insufficient storage, increase the region size of the User response
batch application. Use the SYSMDUMP produced to diagnose the earlier
An attempt to format the SYSMDUMP produced with reported problem.
the CICS IPCS dump formatter does not produce any An attempt to format the SYSMDUMP produced with
formatted output for the job because the error the CICS IPCS dump formatter does not produce any
occurred too early in EXCI initialization for there to be formatted output for the job because the error
any control blocks. occurred too early in EXCI initialization for there to be
Module: any control blocks.
DFHXCPRH Module:
0410 DFHXCDMP
0412
Explanation
The external CICS interface module DFHXCPRH issued Explanation
an MVS GETMAIN request for an XCUSER block but a The external CICS interface dump module DFHXCEIP
nonzero return code was returned from MVS. was processing an EXCI EXEC API request and
detected that the EXEC parameter list passed to it
System action contained a function that is not supported by the
external CICS interface.
Module DFHXCPRH issues an MVS abend with abend
code 0410 which invokes its ESTAE routine to clear up
its environment. A SYSMDUMP is taken before System action
returning control to the application. An application The application is abnormally terminated with a dump.
using the EXCI CALL API receives
RESPONSE(SYSTEM_ERROR)
User response
REASON(XCUSER_GETMAIN_ERROR) in its return
area. The subreason1 field of the return area contains This error indicates the parameter list being passed to
the R15 return code from MVS indicating why the the EXCI has not been generated by the CICS
GETMAIN failed. An application using the EXCI EXEC translator. The translator should always be used.
API receives RESP(LINKERR) RESP2(603). Correct the application to specify the correct EXCI
EXEC API command.
User response An attempt to format the SYSMDUMP produced with
Use the MVS R15 return code obtained from the the CICS IPCS dump formatter may not produce any
application or from the dump to determine why the formatted output for the job if this was the first EXCI
MVS GETMAIN request failed. If the reason is request for this TCB.
insufficient storage, increase the region size of the Module:
batch application. DFHXCEIP
Module: 0413
DFHXCPRH
0411

312 CICS TS for z/OS: CICS Codes


Explanation System action
The external CICS interface dump module DFHXCEIP The application terminates abnormally with a dump.
was processing an EXCI EXEC API request and
detected that the EXEC parameter list passed to it did User response
not require the mandatory RETCODE parameter in
which return codes are returned to the application. Examine the SYSMDUMP to determine the cause of the
earlier reported error.
An attempt to format the SYSMDUMP produced with
the CICS IPCS dump formatter may not produce any An attempt to format the SYSMDUMP produced with
formatted output for the job if this was the first EXCI the CICS IPCS dump formatter does not produce any
request for this TCB. formatted output for the job because the error
occurred too early in EXCI initialization for there to be
any control blocks.
System action
Module:
The application is abnormally terminated with a dump.
DFHXCEIP

User response 0416

This error indicates the parameter list being passed to


Explanation
the EXCI has not been generated by the CICS
translator. The translator should always be used. The external CICS interface module DFHXCEIP
Correct the application to specify RETCODE. received an unexpected return code from DFHXCBAM
when processing a channels and containers command.
Module:
DFHXCEIP
System action
0414
The application terminates abnormally with a dump.
Explanation
User response
The external CICS interface module DFHXCEIP issued
an MVS ESTAE macro to establish a recovery Examine the SYSMDUMP to determine the cause of the
environment but a nonzero return code was returned earlier reported error.
from MVS. Module:
DFHXCEIP
System action
0417
The application terminates abnormally with a dump.
Explanation
User response
The External CICS interface has refused to store data
Examine the dump and any associated MVS messages in a Container because the total storage allocated for
to determine why the MVS ESTAE request failed. the Channel will exceed 5% of MEMLIMIT.
An attempt to format the SYSMDUMP produced with
the CICS IPCS dump formatter may not produce any System action
formatted output for the job if this was the first EXCI The application terminates abnormally with a dump.
request for this TCB.
Module: User response
DFHXCEIP
Review the storage requirements for the PROGRAM. If
0415 the volume of data is correct, either delete any
unnecessary Containers from the Channel, or increase
Explanation MEMLIMIT so that the program does not use more
than 5% of the storage available.
The external CICS interface module DFHXCEIP
detected an error early in EXCI initialization before Module:
EXCI dump services were available. DFHXCEIP issues DFHXBAM
abend 0415 so that its ESTAE routine is invoked from 0418
where an SYSMDUMP is taken instead to capture the
error.

Chapter 2. System abend and dump codes 313


Explanation Explanation
The external CICS interface module DFHXCBAM The external CICS interface module DFHXCBAM
received a purged response when processing a received a disaster response when processing a
channels and containers command. channels and containers command.

System action System action


The application terminates abnormally with a dump. The application terminates abnormally with a dump.

User response User response


Examine the SYSMDUMP to determine the cause of the Examine the SYSMDUMP to determine the cause of the
earlier reported error. earlier reported error.
Module: Module:
DFHXCBAM DFHXCBAM
0419

4xxx LE/370 abend codes


Abend codes in the range 4000 to 4095 are issued by LE/370 runtime library modules for LE enabled
applications running on CICS.
When LE/370 detects an unrecoverable error, LE/370 terminates the transaction with an EXEC CICS
abend with an abend code numbered from 4000-4095. A write-to-operator (WTO) is performed to write a
CEE1000S message to the system console. This message contains the abend code and the reason code
associated with the abend.
Some of these abends can occur when the system is under stress and LE/370 is unable to acquire the
resources required to report a previous abend or failure. In this case there will usually be other symptoms
that the system is under stress (for example short on storage messages or other transactions being
purged with AEXY or AKC3 abends), and inspection of the transaction dump should allow identification of
the original abend.
LE/370 abend codes and run-time messages are described in Language Environment abend codes in z/OS
Language Environment Runtime Messages.

CICSPlex SM Abend and dump codes


When abnormal conditions occur, CICSPlex® SM attempts to recover in an orderly manner and continue
with normal processing. Occasionally conditions arise that prevent or preclude such recovery and a task,
component, or system might end. In this situation, an abend or dump code is issued.

CICS abend and dump codes


If you have to contact IBM in response to an abend or dump code, gather as much diagnostic information
as possible.
The following diagnostic information is required by IBM support to help diagnose the problem:
• Job log from the MAS.
• EYULOG from the CMAS to which the MAS was connected or was attempting to connect.
• CICS TRANDUMP data set from the MAS. Use the CICS DFHDUP utility to format the dump data set.
• CICS AUXTRACE data set from the MAS, if available. Use the EYU9XZUT trace format utility to format
the data set, as described in Using trace in CICSPlex SM. Also keep a copy of the unformatted trace data
set.
EYUI Explanation:

314 CICS TS for z/OS: CICS Codes


A non-recoverable error occurred during initialization. • Users are not attempting to use CICSPlex SM
TRANIDS directly, either from a terminal or via an
System action:
EXEC CICS START.
MAS initialization terminates. The CICS system
continues to run normally, but it is not known to If neither of these conditions exists, gather the
CICSPlex SM. specified diagnostic information and contact your IBM
support center.
User response:
Examine the MAS job log for any messages that might Module:
indicate a problem. If such messages exist, follow the EYU9XLOP
instructions associated with those messages and then
EYUR
restart the MAS. If no messages exist, or if no
appropriate action is indicated, gather the specified Explanation:
diagnostic information and contact your IBM support An error occurred while attempting to recover from an
center. abend.
Module: System action:
EYU9XLEV The failing task terminates. The CICS system
continues to run normally, but it may not be known to
EYUK
CICSPlex SM.
Explanation:
User response:
Either a non-recoverable abend occurred during MAS
Examine the MAS job log for any messages that might
initialization or a proper environment did not exist
indicate a problem. If such messages exist, follow the
when attempting to recover from an abend.
instructions associated with those messages and then
System action: restart the MAS, if necessary. If no messages exist, or
MAS initialization terminates. The CICS system if no appropriate action is indicated, gather the
continues to run normally, but it is not known to specified diagnostic information and contact your IBM
CICSPlex SM. support center.
System action: Module:
If this abend occurred during initialization, MAS EYU9XLRV
initialization terminates. The CICS system continues to
EYUV
run normally, but it is not known to CICSPlex SM.
Explanation:
User response:
The Web User Interface environment create routine in
Examine the MAS job log for any messages that might
a CMAS or MAS was called invalidly. The calling
indicate a problem. If such messages exist, follow the
process was not a CICSPlex SM service.
instructions associated with those messages and then
restart the MAS, if necessary. If no messages exist, or System action:
if no appropriate action is indicated, gather the The failing task terminates. A transaction dump is
specified diagnostic information and contact your IBM taken. CICS system processing continues.
support center.
Module: User response
EYU9XLRV Make sure that:

EYUO • No site-written programs are attempting to call


CICSPlex SM Web User Interface environment
Explanation: create.
The environment create routine in a CMAS or MAS was
• Users are not attempting to use CICSPlex SM
called invalidly. The calling process was not a
TRANIDS directly, either from a terminal or via an
CICSPlex SM service.
EXEC CICS START.
System action:
If neither of these conditions exists, contact your IBM
CICS system processing continues.
Support Center.

User response Module:


Make sure that: EYU0VGIN

• No site-written programs are attempting to call EYUX


CICSPlex SM environment create. Explanation:

Chapter 2. System abend and dump codes 315


An exception condition was detected in a remote MAS A CMAS-to-CMAS connection has terminated
but a full CICSPlex SM exception trace could not be abnormally. The receive task component of the
written at that time. This condition is not necessarily a connection has tried to terminate as cleanly as
failure in the application, but the reporting of an possible, but it has detected that it is still in a network
exception condition, which is usually the result of receive state. This makes it impossible for it to
communications problems. Communications terminate, without CICS generating an additional
exceptions cannot be sent to the connected CMAS. transaction abend describing this apparent
transmission state discrepancy. However, this network
System action:
state cannot be reset because of the reported
A transaction dump is taken to document the
connection failure. This abend is issued to preempt the
exception. Task execution continues, taking the
normal CICS abend code related to these network
appropriate action for the exception condition.
state errors.
User response:
System action:
Examine the MAS and CMAS job logs for any messages
The CPI-C or MRO receive task should now end
that might indicate a problem, especially for those
completely with this abend. When all task components
related to the communications network. If such
for the connection have terminated, the first speaker
messages exist, follow the instructions associated
CMAS of the connection pair should attempt to
with those messages. If no messages exist, or if no
reestablish the connection.
appropriate action is indicated, gather the specified
diagnostic information and contact your IBM support User response:
center. Check the CMAS job log, EYULOG, and CICS message
log for previous failures or error conditions and follow
Module:
the User Response for these messages.
EYU9XLEV, EYU9XLOP
Module:
EYUY
EYU0CLCT, EYU0CLCU, EYU0CLMT, EYU0CLMU
Explanation:

Uxxxx abend codes


In response to any of the Uxxxx abend codes, gather as much diagnostic information as possible and
contact IBM support.
For a list of available diagnostic information, see “CICS abend and dump codes” on page 314.
U100 U1802
Explanation: Explanation:
An ISPF interface failure has occurred. A failure has occurred in GSI router housekeeping.
U1600 U1803
Explanation: Explanation:
A PC has issued a call to an unavailable service. A transaction manager housekeeping failure has
occurred.
U1700 through
U1798 U1804
Explanation: Explanation:
Recovery Manager abends. A failure has occurred in the SAS/C resident module.
U1799 U1899
Explanation: Explanation:
A should-not-occur condition has occurred. System environmental conditions have caused a
failure with DYNAEC EPD.
U1800
U1900
Explanation:
Indicates that a C housekeeping failure has occurred. Explanation:
A failure has occurred with the storage manager.
U1801
U3000
Explanation:
A failure has occurred in GSI housekeeping. Explanation:

316 CICS TS for z/OS: CICS Codes


An error has occurred in a built in service function An unrecoverable control task error has occurred.
routine.
U4090
U4000
Explanation:
Explanation: A server or application initialization error has occurred.
Indicates that a pseudo GSI service failure has
U4095
occurred.
Explanation:
U4080
A task has been terminated by PGTERM.
Explanation:

System dump codes


In response to any of these dump codes, gather the following diagnostic information and contact your
IBM Support Center:
• Job log and EYULOG from the CMAS.
• Unformatted SVC dump (SDUMP). Have access to IPCS.
• CICS AUXTRACE data set from the CMAS. Use the EYU9XZUT trace format utility to format the data set.
Also keep a copy of the unformatted trace data set.
EYUXL001 initialization terminates.
Explanation: Module:
The initialization process failed. EYU9XLRV
System action: EYUXL003
initialization terminates. Explanation:
Module: The recovery routine was entered, but could not
EYU9XLEV successfully recover from the abend.
EYUXL002 System action:
processing terminates.
Explanation:
The recovery routine was entered during initialization. Module:
EYU9XLRV
System action:

CICSPlex SM Abend and dump codes


When abnormal conditions occur, CICSPlex SM attempts to recover in an orderly manner and continue
with normal processing. Occasionally conditions arise that prevent or preclude such recovery and a task,
component, or system might end. In this situation, an abend or dump code is issued.

CICS abend and dump codes


If you have to contact IBM in response to an abend or dump code, gather as much diagnostic information
as possible.
The following diagnostic information is required by IBM support to help diagnose the problem:
• Job log from the MAS.
• EYULOG from the CMAS to which the MAS was connected or was attempting to connect.
• CICS TRANDUMP data set from the MAS. Use the CICS DFHDUP utility to format the dump data set.
• CICS AUXTRACE data set from the MAS, if available. Use the EYU9XZUT trace format utility to format
the data set, as described in Using trace in CICSPlex SM. Also keep a copy of the unformatted trace data
set.
EYUI A non-recoverable error occurred during initialization.
Explanation: System action:

Chapter 2. System abend and dump codes 317


MAS initialization terminates. The CICS system If neither of these conditions exists, gather the
continues to run normally, but it is not known to specified diagnostic information and contact your IBM
CICSPlex SM. support center.
User response: Module:
Examine the MAS job log for any messages that might EYU9XLOP
indicate a problem. If such messages exist, follow the
EYUR
instructions associated with those messages and then
restart the MAS. If no messages exist, or if no Explanation:
appropriate action is indicated, gather the specified An error occurred while attempting to recover from an
diagnostic information and contact your IBM support abend.
center.
System action:
Module: The failing task terminates. The CICS system
EYU9XLEV continues to run normally, but it may not be known to
CICSPlex SM.
EYUK
User response:
Explanation:
Examine the MAS job log for any messages that might
Either a non-recoverable abend occurred during MAS
indicate a problem. If such messages exist, follow the
initialization or a proper environment did not exist
instructions associated with those messages and then
when attempting to recover from an abend.
restart the MAS, if necessary. If no messages exist, or
System action: if no appropriate action is indicated, gather the
MAS initialization terminates. The CICS system specified diagnostic information and contact your IBM
continues to run normally, but it is not known to support center.
CICSPlex SM.
Module:
System action: EYU9XLRV
If this abend occurred during initialization, MAS
EYUV
initialization terminates. The CICS system continues to
run normally, but it is not known to CICSPlex SM. Explanation:
The Web User Interface environment create routine in
User response:
a CMAS or MAS was called invalidly. The calling
Examine the MAS job log for any messages that might
process was not a CICSPlex SM service.
indicate a problem. If such messages exist, follow the
instructions associated with those messages and then System action:
restart the MAS, if necessary. If no messages exist, or The failing task terminates. A transaction dump is
if no appropriate action is indicated, gather the taken. CICS system processing continues.
specified diagnostic information and contact your IBM
support center. User response
Module: Make sure that:
EYU9XLRV • No site-written programs are attempting to call
EYUO CICSPlex SM Web User Interface environment
create.
Explanation:
• Users are not attempting to use CICSPlex SM
The environment create routine in a CMAS or MAS was
TRANIDS directly, either from a terminal or via an
called invalidly. The calling process was not a
EXEC CICS START.
CICSPlex SM service.
If neither of these conditions exists, contact your IBM
System action:
Support Center.
CICS system processing continues.
Module:
User response EYU0VGIN
Make sure that: EYUX
• No site-written programs are attempting to call Explanation:
CICSPlex SM environment create. An exception condition was detected in a remote MAS
• Users are not attempting to use CICSPlex SM but a full CICSPlex SM exception trace could not be
TRANIDS directly, either from a terminal or via an written at that time. This condition is not necessarily a
EXEC CICS START. failure in the application, but the reporting of an

318 CICS TS for z/OS: CICS Codes


exception condition, which is usually the result of connection has tried to terminate as cleanly as
communications problems. Communications possible, but it has detected that it is still in a network
exceptions cannot be sent to the connected CMAS. receive state. This makes it impossible for it to
terminate, without CICS generating an additional
System action:
transaction abend describing this apparent
A transaction dump is taken to document the
transmission state discrepancy. However, this network
exception. Task execution continues, taking the
state cannot be reset because of the reported
appropriate action for the exception condition.
connection failure. This abend is issued to preempt the
User response: normal CICS abend code related to these network
Examine the MAS and CMAS job logs for any messages state errors.
that might indicate a problem, especially for those
System action:
related to the communications network. If such
The CPI-C or MRO receive task should now end
messages exist, follow the instructions associated
completely with this abend. When all task components
with those messages. If no messages exist, or if no
for the connection have terminated, the first speaker
appropriate action is indicated, gather the specified
CMAS of the connection pair should attempt to
diagnostic information and contact your IBM support
reestablish the connection.
center.
User response:
Module:
Check the CMAS job log, EYULOG, and CICS message
EYU9XLEV, EYU9XLOP
log for previous failures or error conditions and follow
EYUY the User Response for these messages.
Explanation: Module:
A CMAS-to-CMAS connection has terminated EYU0CLCT, EYU0CLCU, EYU0CLMT, EYU0CLMU
abnormally. The receive task component of the

Uxxxx abend codes


In response to any of the Uxxxx abend codes, gather as much diagnostic information as possible and
contact IBM support.
For a list of available diagnostic information, see “CICS abend and dump codes” on page 314.
U100 Explanation:
A failure has occurred in GSI router housekeeping.
Explanation:
An ISPF interface failure has occurred. U1803
U1600 Explanation:
A transaction manager housekeeping failure has
Explanation:
occurred.
A PC has issued a call to an unavailable service.
U1804
U1700 through
U1798 Explanation:
A failure has occurred in the SAS/C resident module.
Explanation:
Recovery Manager abends. U1899
U1799 Explanation:
System environmental conditions have caused a
Explanation: failure with DYNAEC EPD.
A should-not-occur condition has occurred.
U1900
U1800
Explanation:
Explanation: A failure has occurred with the storage manager.
Indicates that a C housekeeping failure has occurred.
U3000
U1801
Explanation:
Explanation: An error has occurred in a built in service function
A failure has occurred in GSI housekeeping. routine.
U1802 U4000

Chapter 2. System abend and dump codes 319


Explanation: Explanation:
Indicates that a pseudo GSI service failure has A server or application initialization error has occurred.
occurred.
U4095
U4080
Explanation:
Explanation: A task has been terminated by PGTERM.
An unrecoverable control task error has occurred.
U4090

System dump codes


In response to any of these dump codes, gather the following diagnostic information and contact your
IBM Support Center:
• Job log and EYULOG from the CMAS.
• Unformatted SVC dump (SDUMP). Have access to IPCS.
• CICS AUXTRACE data set from the CMAS. Use the EYU9XZUT trace format utility to format the data set.
Also keep a copy of the unformatted trace data set.
EYUXL001 initialization terminates.
Explanation: Module:
The initialization process failed. EYU9XLRV
System action: EYUXL003
initialization terminates. Explanation:
Module: The recovery routine was entered, but could not
EYU9XLEV successfully recover from the abend.
EYUXL002 System action:
processing terminates.
Explanation:
The recovery routine was entered during initialization. Module:
EYU9XLRV
System action:

320 CICS TS for z/OS: CICS Codes


Notices
This information was developed for products and services offered in the U.S.A. This material might be
available from IBM in other languages. However, you may be required to own a copy of the product or
product version in that language in order to access it.
IBM® may not offer the products, services, or features discussed in this document in other countries.
Consult your local IBM representative for information on the products and services currently available in
your area. Any reference to an IBM product, program, or service is not intended to state or imply that only
that IBM product, program, or service may be used. Any functionally equivalent product, program, or
service that does not infringe any IBM intellectual property rights may be used instead. However, it is the
user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this
document. The furnishing of this document does not grant you any license to these patents. You can send
license inquiries, in writing, to:

IBM Director of Licensing


IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
United States of America

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property
Department in your country or send inquiries, in writing, to:

Intellectual Property Licensing


Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION “AS IS”


WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A
PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in
certain transactions, therefore this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically
made to the information herein; these changes will be incorporated in new editions of the publication.
IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM websites are provided for convenience only and do not in
any manner serve as an endorsement of those websites. The materials at those websites are not part of
the materials for this IBM product and use of those websites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without
incurring any obligation to you.
Licensees of this program who want to have information about it for the purpose of enabling: (i) the
exchange of information between independently created programs and other programs (including this
one) and (ii) the mutual use of the information which has been exchanged, should contact

IBM Director of Licensing


IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US

© Copyright IBM Corp. 1974, 2020 321


Such information may be available, subject to appropriate terms and conditions, including in some cases,
payment of a fee.
The licensed program described in this document and all licensed material available for it are provided by
IBM under terms of the IBM Customer Agreement, IBM International Programming License Agreement, or
any equivalent agreement between us.
Information concerning non-IBM products was obtained from the suppliers of those products, their
published announcements or other publicly available sources. IBM has not tested those products and
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM
products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of
those products.
This information contains examples of data and reports used in daily business operations. To illustrate
them as completely as possible, the examples include the names of individuals, companies, brands, and
products. All of these names are fictitious and any similarity to actual people or business enterprises is
entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programming
techniques on various operating platforms. You may copy, modify, and distribute these sample programs
in any form without payment to IBM, for the purposes of developing, using, marketing or distributing
application programs conforming to the application programming interface for the operating platform for
which the sample programs are written. These examples have not been thoroughly tested under all
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these
programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be
liable for any damages arising out of your use of the sample programs.

Programming interface information


CICS supplies some documentation that can be considered to be Programming Interfaces, and some
documentation that cannot be considered to be a Programming Interface.
Programming Interfaces that allow the customer to write programs to obtain the services of CICS
Transaction Server for z/OS, Version 5 Release 4 are included in the following sections of the online
product documentation:
• Developing applications
• Developing system programs
• Securing overview
• Developing for external interfaces
• Reference: application developmenth
• Reference: system programming
• Reference: connectivity
Information that is NOT intended to be used as a Programming Interface of CICS Transaction Server for
z/OS, Version 5 Release 4, but that might be misconstrued as Programming Interfaces, is included in the
following sections of the online product documentation:
• Troubleshooting and support
• Reference: diagnostics
If you access the CICS documentation in manuals in PDF format, Programming Interfaces that allow the
customer to write programs to obtain the services of CICS Transaction Server for z/OS, Version 5 Release
4 are included in the following manuals:
• Application Programming Guide and Application Programming Reference
• Business Transaction Services
• Customization Guide

322 Notices
• C++ OO Class Libraries
• Debugging Tools Interfaces Reference
• Distributed Transaction Programming Guide
• External Interfaces Guide
• Front End Programming Interface Guide
• IMS Database Control Guide
• Installation Guide
• Security Guide
• Supplied Transactions
• CICSPlex SM Managing Workloads
• CICSPlex SM Managing Resource Usage
• CICSPlex SM Application Programming Guide and Application Programming Reference
• Java Applications in CICS
If you access the CICS documentation in manuals in PDF format, information that is NOT intended to be
used as a Programming Interface of CICS Transaction Server for z/OS, Version 5 Release 4, but that might
be misconstrued as Programming Interfaces, is included in the following manuals:
• Data Areas
• Diagnosis Reference
• Problem Determination Guide
• CICSPlex SM Problem Determination Guide

Trademarks
IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of International Business
Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be
trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at
Copyright and trademark information at www.ibm.com/legal/copytrade.shtml.
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or
trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon,
Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or
its subsidiaries in the United States and other countries.
Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or
its affiliates.
The registered trademark Linux® is used pursuant to a sublicense from the Linux Foundation, the
exclusive licensee of Linus Torvalds, owner of the mark on a worldwide basis.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the
United States, other countries, or both.
Spring Boot is a trademark of Pivotal Software, Inc. in the U.S. and other countries.
UNIX is a registered trademark of The Open Group in the United States and other countries.

Terms and conditions for product documentation


Permissions for the use of these publications are granted subject to the following terms and conditions.
Applicability
These terms and conditions are in addition to any terms of use for the IBM website.

Notices 323
Personal use
You may reproduce these publications for your personal, noncommercial use provided that all
proprietary notices are preserved. You may not distribute, display or make derivative work of these
publications, or any portion thereof, without the express consent of IBM.
Commercial use
You may reproduce, distribute and display these publications solely within your enterprise provided
that all proprietary notices are preserved. You may not make derivative works of these publications,
or reproduce, distribute or display these publications or any portion thereof outside your enterprise,
without the express consent of IBM.
Rights
Except as expressly granted in this permission, no other permissions, licenses or rights are granted,
either express or implied, to the publications or any information, data, software or other intellectual
property contained therein.
IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use
of the publications is detrimental to its interest or, as determined by IBM, the above instructions are
not being properly followed.
You may not download, export or re-export this information except in full compliance with all
applicable laws and regulations, including all United States export laws and regulations.
IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS
ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-
INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

IBM online privacy statement


IBM Software products, including software as a service solutions, ("Software Offerings") may use cookies
or other technologies to collect product usage information, to help improve the end user experience, to
tailor interactions with the end user or for other purposes. In many cases no personally identifiable
information is collected by the Software Offerings. Some of our Software Offerings can help enable you to
collect personally identifiable information. If this Software Offering uses cookies to collect personally
identifiable information, specific information about this offering’s use of cookies is set forth below:
For the CICSPlex SM Web User Interface (main interface):
Depending upon the configurations deployed, this Software Offering may use session and persistent
cookies that collect each user’s user name and other personally identifiable information for purposes
of session management, authentication, enhanced user usability, or other usage tracking or functional
purposes. These cookies cannot be disabled.
For the CICSPlex SM Web User Interface (data interface):
Depending upon the configurations deployed, this Software Offering may use session cookies that
collect each user's user name and other personally identifiable information for purposes of session
management, authentication, or other usage tracking or functional purposes. These cookies cannot be
disabled.
For the CICSPlex SM Web User Interface ("hello world" page):
Depending upon the configurations deployed, this Software Offering may use session cookies that
collect no personally identifiable information. These cookies cannot be disabled.
For CICS Explorer®:
Depending upon the configurations deployed, this Software Offering may use session and persistent
preferences that collect each user’s user name and password, for purposes of session management,
authentication, and single sign-on configuration. These preferences cannot be disabled, although
storing a user's password on disk in encrypted form can only be enabled by the user's explicit action
to check a check box during sign-on.
If the configurations deployed for this Software Offering provide you, as customer, the ability to collect
personally identifiable information from end users via cookies and other technologies, you should seek
your own legal advice about any laws applicable to such data collection, including any requirements for
notice and consent.

324 Notices
For more information about the use of various technologies, including cookies, for these purposes, see
IBM Privacy Policy and IBM Online Privacy Statement, the section entitled "Cookies, Web Beacons and
Other Technologies" and the IBM Software Products and Software-as-a-Service Privacy Statement.

Notices 325
326 CICS TS for z/OS: CICS Codes
IBM®

You might also like