i5/OS Messages and the ILE CEE API Feedback Code
As input to an ILE CEE API, you have the option of coding a feedback code,
and using the feedback code as a return (or feedback) code check in a
procedure. The feedback code is a condition token value that is provided for
flexibility in checking returns from calls to other procedures. You can then
use the feedback code as input to a condition token. For information on the
condition tokens, see Condition Management APIs. For more information on
condition handling, see Condition Handling in the
ILE
Concepts
book.
If you code the feedback code parameter in your application to receive
feedback information from an ILE CEE API, the following sequence of events
occurs when a condition is raised:
- An informational message is sent to the caller of the API, communicating
the message associated with the condition.
- The ILE CEE API in which the condition occurred builds a condition token
for the condition. The ILE CEE API places information into the instance
specific information area. The instance specific information of the condition
token is the message reference key of the informational message. This is used
by the system to react to the condition.
- If a detected condition is critical (severity is 4), the system sends an
exception message to the caller of the ILE CEE API.
- If a detected condition is not critical (severity less than 4), the
condition token is returned to the routine that called the ILE CEE API.
- When the condition token is returned to your application, you have the
following options:
- Ignore it and continue processing.
- Signal the condition using the Signal a Condition (CEESGL) bindable
API.
- Get, format, and dispatch the message for display using the Get, Format,
and Dispatch a Message (CEEMSG) bindable API.
- Store the message in a storage area using the Get a Message (CEEMGET)
bindable API.
- Use the Dispatch a Message (CEEMOUT) bindable API to dispatch a
user-defined message to a destination that you specify.
- When the caller of the API regains control, the informational message is
removed and does not appear in the job log.
If you omit the feedback code parameter when you are calling an ILE CEE API,
the ILE CEE API sends an exception message to the caller of the bindable
API.