The opt parameter
Many methods have the same parameter, opt, which is
described under the abendCode method.
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
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
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
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
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
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
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
static IccAbendData* instance()
Returns a pointer to the single IccAbendData object.
If the object does not already exist, it is created by this method.
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
const char* originalAbendCode(Icc::GetOpt opt = Icc::object)
Returns the original abend code for this task in case of repeated abends.
Conditions
const char* programName(Icc::GetOpt opt = Icc::oldValue)
Returns the name of the program that caused the abend.
Conditions
[[ Contents Previous Page | Next Page Index ]]