System i: Programming Message Handling APIs - IBM

*MNNR Only messages not requiring a reply are listed. This includes informational, completion,
diagnostic, request, notify, escape, reply, answered inquiry, and answered sender’s copy messages.
*MNR Only messages needing a reply are listed. This includes only unanswered inquiry messages.
*PAR Only messages that can have problem analysis run against them are listed.
*SCNR Only sender’s copy messages requiring a reply are listed. This includes only unanswered sender’s
copy messages.
Selection criteria specified. The selection criteria as specified on the call to the API.
Sender type. This field can be specified for the QMHLSTM API, but it never returns any data and the
length of data field is 0.
Sending module name. This field can be specified for the QMHLSTM API, but it never returns any data
and the length of data field is 0.
Sending procedure name. This field can be specified for the QMHLSTM API, but it never returns any
data and the length of data field is 0.
Sending program name. The sending program name or ILE program name that contains the procedure
sending the message. Under certain conditions, the actual name of the program that sent the message is
not known. In these cases, this field contains the 6-byte hexadecimal address of the program converted
into 12 displayable characters. In all other cases, the 10-character program name is returned left-justified
in the field; the final 2 characters contain blanks.
Sending statement numbers or instruction numbers. This field can be specified for the QMHLSTM API,
but it never returns any data and the length of data field is 0.
Sending user profile. The name of the user profile that the thread was running under when the message
was sent.
Severity criteria. The minimum severity of a message to be included in the list. The value must be
between 0 and 99. To retrieve all messages, specify a severity criteria of 0.
Severity criteria specified. The severity criteria as specified on the call to the API.
Size of message selection information specified. The size of the message selection information field, in
bytes, as specified in the call to the API.
Starting message key. The message key used to begin searching for messages to list from the
corresponding entry in the qualified message queue names field. You can use these special values for the
message keys:
’00000000’X The first message to be returned is the oldest message in the queue.
’FFFFFFFF’X The first message to be returned is the newest message in the queue.
If a value other than X’00000000’ or X’FFFFFFFF’ is specified and a message with that key does not exist,
an error is returned.
If the message that is specified by the starting message key exists but does not meet the selection criteria,
the severity criteria, or the date and time criteria fields that are specified, no error is returned. The search
for messages to list begins from the message that is specified by the starting message key.
Starting message key specified. The starting message keys as specified on the call to the API.
Message Handling APIs 45