Public methods

The opt parameter

Many methods have the same parameter, opt, which is described under the abendCode method.

abendCode

const char* abendCode(Icc::GetOpt opt = Icc::object)
opt
An enumeration, defined in the Icc structure, that indicates whether a value should be refreshed from CICS® or whether the existing value should be retained. The possible values are described under the GetOpt enumeration in the Icc structure in topicGetOpt.

Returns the current 4-character abend code.

Conditions

INVREQ

ASRAInterrupt

const char* ASRAInterrupt(Icc::GetOpt opt = Icc::object)

Returns 8 characters of status word (PSW) interrupt information at the point when the latest abend with a code of ASRA, ASRB, ASRD, or AICA occurred.

The field contains binary zeroes if no ASRA or ASRB abend occurred during the execution of the issuing transaction, or if the abend originally occurred in a remote DPL server program.

Conditions

INVREQ

ASRAKeyType

IccValue::CVDA ASRAKeyType(Icc::GetOpt opt = Icc::object)

Returns an enumeration, defined in IccValue, that indicates the execution key at the time of the last ASRA, ASRB, AICA, or AEYD abend, if any. The possible values are:

CICSEXECKEY
The task was executing in CICS-key at the time of the last ASRA, ASRB, AICA, or AEYD abend. Note that all programs execute in CICS key if CICS subsystem storage protection is not active.
USEREXECKEY
The task was executing in user-key at the time of the last ASRA, ASRB, AICA, or AEYD abend. Note that all programs execute in CICS key if CICS subsystem storage protection is not active.
NONCICS
The execution key at the time of the last abend was not one of the CICS keys; that is, not key 8 or key 9.
NOTAPPLIC
There has not been an ASRA, ASRB, AICA, or AEYD abend.

Conditions

INVREQ

ASRAPSW

const char* ASRAPSW(Icc::GetOpt opt = Icc::object)

Returns an 8-character status word (PSW) at the point when the latest abend with a code of ASRA, ASRB, ASRD, or AICA occurred.

The field contains nulls if no ASRA, ASRB, ASRD, or AICA abend occurred during the execution of the issuing transaction, or if the abend originally occurred in a remote DPL server.

Conditions

INVREQ

ASRARegisters

const char* ASRARegisters(Icc::GetOpt opt = Icc::object)

Returns the contents of general registers 0-15, as a 64-byte data area, at the point when the latest ASRA, ASRB, ASRD, or AICA abend occurred. The contents of the registers are returned in the order 0, 1, ..., 15.

Note that nulls are returned if no ASRA, ASRB, ASRD, or AICA abend occurred during the execution of the issuing transaction, or if the abend originally occurred in a remote DPL server program.

Conditions

INVREQ

ASRASpaceType

IccValue::CVDA ASRASpaceType(Icc::GetOpt opt = Icc::object)

Returns an enumeration, defined in IccValue structure, that indicates what type of space, if any, was in control at the time of the last ASRA, ASRB, AICA, or AEYD abend. Possible values are:

SUBSPACE
The task was executing in either its own subspace or the common subspace at the time of the last ASRA, ASRB, AICA, or AEYD abend.
BASESPACE
The task was executing in the base space at the time of the last ASRA, ASRB, AICA, or AEYD abend. Note that all tasks execute in the base space if transaction isolation is not active.
NOTAPPLIC
There has not been an ASRA, ASRB, AICA, or AEYD abend.

Conditions

INVREQ

ASRAStorageType

IccValue::CVDA ASRAStorageType(Icc::GetOpt opt = Icc::object)

Returns an enumeration, defined in IccValue structure, that indicates what type of storage, if any, was being addressed at the time of the last ASRA, ASRB, AICA, or AEYD abend. Possible values are:

CICS
CICS-key storage is being addressed. This can be in one of the CICS dynamic storage areas (CDSA or ECDSA), or in one of the read-only dynamic storage areas (RDSA or ERDSA) if either of the following apply:
  • CICS is running with the NOPROTECT option on the RENTPGM system initialization parameter
  • storage protection is not active
USER
User-key storage in one of the user dynamic storage areas (RDSA or ERDSA) is being addressed.
READONLY
Read-only storage in one of the read-only dynamic storage areas (RDSA or ERDSA) when CICS is running with the PROTECT option on the RENTPGM system initialization parameter.
NOTAPPLIC
One of:
  • No ASRA or AEYD abend has been found for this task.
  • The storage affected by an abend is not managed by CICS.
  • The ASRA abend is not caused by a 0C4 abend.
  • An ASRB or AICA abend has occurred since the last ASRA or AEYD abend.

Conditions

INVREQ

instance

static IccAbendData* instance()

Returns a pointer to the single IccAbendData object. If the object does not already exist, it is created by this method.

isDumpAvailable

Icc::Bool isDumpAvailable(Icc::GetOpt opt = Icc::object)

Returns a boolean, defined in Icc structure, that indicates whether a dump has been produced. If it has, use programName method to find the name of the failing program of the latest abend.

Conditions

INVREQ

originalAbendCode

const char* originalAbendCode(Icc::GetOpt opt = Icc::object)

Returns the original abend code for this task in case of repeated abends.

Conditions

INVREQ

programName

const char* programName(Icc::GetOpt opt = Icc::oldValue)

Returns the name of the program that caused the abend.

Conditions

INVREQ

[[ Contents Previous Page | Next Page Index ]]