Modifier keyword

Modifier keywords identify problems more precisely and help to narrow the search. Most of these keywords change only certain failures.

The following table lists several modifier keywords. See the column Conditions for Using This Keyword to determine which keyword to use; follow the corresponding procedure.

Table 1. Types of modifier keywords
Keyword Conditions for Using This Keyword Description Procedure to Follow
Load Module modifier You have a related SYS1.LOGREC entry or SVC dump. Identifies the name of the load module involved. Load module modifier keyword
RECOVERY ROUTINE modifier Both conditions are true:
  • The load module and CSECT names cannot be found in the SVC dump or in the SYS1.LOGREC entry, and
  • You have an SVC dump title.
Identifies the name of the functional recovery routine (FRR) or the extended specify task abnormal exit (ESTAE) that handled the program failure. Recovery routine modifier keyword
VRA Data modifier You have access to a variable recording area (VRA) for the abend. The VRA is in the system diagnostic work area (SDWA), which when available is in the SYS1.DUMP data set and the SYS1.LOGREC data set. Identifies information stored in the VRA that describes the abend. VRA data modifier keyword
SQLCODE modifiers All these conditions are true:
  • The type-of-failure keyword was INCORROUT,
  • The function keyword was SQL,
  • You are fairly certain the problem was not caused by a user error, and
  • You have access to the SQL communication area (SQLCA).

(The SQLCA can be displayed by the application program or found in a dump.)

Identifies the additional information to describe the problem, such as:
  • SQLCODE (SQL return code)
  • Name of the CSECT that issued the return code
  • SQL subcode.
SQLCODE modifier keyword
INCORROUT modifiers The type-of-failure keyword is INCORROUT Identifies various primary and secondary modifier keywords. INCORROUT modifier keyword
MESSAGE modifier Both conditions are true:
  • The type-of-failure keyword is MSGx, and
  • The Db2-issued message you received contains variables
Identifies additional items of information provided when the message is issued. Message modifier keyword