Message format
The CICS PA messages begin with a unique message identifier, followed by message text which might contain variable information to identify the particular circumstance which caused the message.
- CPA
- The program identifier identifies the message as a CICS PA message. All CICS PA messages begin with CPA.
- nnnn
- The message identification number is a four-digit number that uniquely identifies each message.
- x
- The severity level is a letter that indicates the return
code (see Return codes), the purpose of the
message, and the type of response required. The severity levels, from least to most severe, are:
- I
- Information. No action is required.
- W
- Warning. CICS PA has detected a possible error condition that the user should evaluate.
- E
- Error. User action is required before CICS PA can continue processing.
- S
- Severe. CICS PA processing is suspended until action has been taken.
All batch command processing error messages have the same general format for the Message Text as follows:
| Severity Prefix | Operand Data | General Error Text | Specific Error Text | Source Text |
|---|---|---|---|---|
| Warning or Severe | Operand in error | General error description | Specific error description | User input in error |
- Severity Prefix
- The first part of the message indicates whether the message is
a warning message or a message which denotes a severe error. A warning
is indicated by:
** Possible Error **A warning is issued for conditions that do not prevent report program execution. However, you should analyze all warning messages to determine if the conditions cited affect the expected results. Warning messages are not printed if PARM NOINFOMSGS has been specified.
A severe command error is indicated by one of two prefixes:** Command Error *** ** Error During Scan ***These messages are printed even if PARM NOINFOMSGS was specified. Most severe command errors cause a severe error flag to be set. At the end of command input processing, this flag is tested. If the flag tests true, no record processors are run. CICS PA terminates at this point with a condition code of 16. To continue processing, you must correct the commands in error and resubmit the job.
- Operand Data
- If the error is associated with a recognizable operand, the operand is printed after the prefix. This part of the message is usually present. It is omitted when a recognizable operand cannot be associated with the error.
- General Error Text
- This describes the general nature of the error. It includes descriptive text appropriate for errors that can occur on any command; for example, a missing operand or label. This part of the message is usually present. It is omitted when the error is unique to the command being processed.
- Specific Error Text
- This is inserted by the individual command processor. It describes a condition unique to the command in error. Specific text might be provided in addition to the general text described previously to further clarify the error description. It can also be provided without general text, when the error condition is unique and the general text is inappropriate.
- Source Text
- This identifies the portion of the command input found to be in error during analysis. This part of the message is usually present.
Example:
CPA0015E ** Command Error *** LIST Operand not recognized -
valid values are: listed in the User's Guide.
The suboperand is: PUTPUT(
This message indicates a severe error that must be corrected to continue report processing. The command contains a suboperand (PUTPUT) that is not recognized by the CICS PA command processor as a valid LIST operand. Correct the command by supplying valid values as defined by the specific error text. In this case, the specific error text directs you to this book. See Using the CICS PA commands which describes all the commands and operands.
- Message Part
- Text
- Severity prefix
- ** Command Error ***
- Operand data
- LIST
- General error text
- Operand not recognized - valid values are:
- Specific error text
- listed in the User's Guide. The suboperand is:
- Source text
- PUTPUT(