Get a Message (CEEMGET) API

The Get a Message (CEEMGET) API retrieves a message and stores it in a buffer for manipulation or output by the caller.

The API retrieves a message and places it in the storage location referenced by the message_area parameter.

The msg_ptr parameter has a value of zero on the initial call to the CEEMGET API. If the message is too large to be contained in message_area, msg_ptr is returned containing an index into the message. The index is used in subsequent calls to CEEMGET to retrieve the remaining portion of the message. When the entire message has been retrieved, msg_ptr is returned containing a value of zero.

Authorities and Locks

None.

Required Parameter Group

cond_token (input)

A 12-byte condition token. See Using Condition Management APIs for a description of the condition token.

message_area (output by descriptor)

A valid ILE string variable, passed by reference with a descriptor. The CEEMGET API places the retrieved message into this string variable.

msg_ptr (input/output)

A 4-byte integer with a value of 0 on the initial call to CEEMGET to retrieve a message. If the message is too large to be contained in the message_area, msg_ptr will be returned containing an index into the message. The index is used in subsequent calls to CEEMGET to retrieve the remaining portion of the message. When the entire message has been retrieved, msg_ptr is returned with a value of 0.

Omissible Parameter

fc (output)

A 12-byte feedback code.

Feedback Codes and Conditions

Usage Notes

• If msg_ptr is greater than the length of the message being retrieved, then msg_ptr is set to 0, and a zero-length string is copied into message_area.

• Insert data cannot be inserted with this call.