How to Promote a Message

Under certain limited situations, you can choose to modify the exception message to a different message. This action marks the original exception message as handled and restarts exception processing with a new exception message. This action is allowed only from direct monitor handlers and ILE condition handlers.

For direct monitor handlers, use the Promote Message (QMHPRMM) API to promote a message. The system can promote only status and escape message types. With this API, you have some control over the handle cursor placement that is used to continue exception processing. Refer to the API topic in the Programming category of the IBM® i Information Center.

For an ILE condition handler, you communicate the promote action by setting a return code value and returning to the system. For information about the actual return code values for the Register a User-Written Condition Handler (CEEHDLR) bindable API, see the API topic collection in the Programming category of the IBM i Information Center.