Messages Attributes

The Messages attribute group contains attributes that you can use to monitor OS400 messages. These attributes refer to message queues.

These attributes are in the operational area of work management. However, depending on the message they receive, they can have an impact on operational areas other than work management.


Data The message help with substitution text. The text of a predefined message with the message data included. If an immediate message is listed, this field contains the immediate message text. The valid value is an alphanumeric string with a maximum of 255 characters.

Data (Unicode) The message help with substitution text. The text of a predefined message with the message data included. If an immediate message is listed, this field contains the immediate message text. The valid value is an alphanumeric string with a maximum of 765 bytes.

Date and Time The date and time the message arrived in the message queue. When using the attribute, the event data is returned for all messages that satisfy the situation definition including those messages that arrived prior to when the monitoring for the situation. The valid value is a date and time in the format CYYMMDDHHmmSSmmm; for example, 096100210300000.

Help Data The message help with the substitution text (The message help for the message is listed, including the message data. If an immediate message is listed, this field contains blanks.) The valid value is an alphanumeric string with a maximum of 255 characters.

Help Data (Unicode) The message help with the substitution text (The message help for the message is listed, including the message data. If an immediate message is listed, this field contains blanks.) The valid value is an alphanumeric string with a maximum of 765 bytes.

ID The identifying code of the message received. If an immediate message is received, this field is blank. The valid value is an alphanumeric string with a maximum of 7 characters.

Key The key to the message received. The message key is a unique string of characters that identifies a particular instance of a message in a queue. The key is assigned by the command or attribute that sends the message. If the message-action parameter specifies *REMOVE, this field is blank. The valid value is a hexadecimal number.

Message Queue The name of the message queue. You cannot monitor the QHST message queue. QSYSOPR is the default. The valid value is an alphanumeric string with a maximum of 10 characters.

Message Queue Library The name of the library that contains the message queue. The default is QSYS. The valid value is an alphanumeric string with a maximum of 10 characters.

ORIGINNODE The host name for the monitored system. The valid value is an alphanumeric string with a maximum length of 64 characters.

Select Filters by specifying the criteria for the type of message listed. The attribute allows you to do early filtering by specifying selection criteria for which types of messages are listed. Failing to specify this attribute may overload IBM Tivoli Monitoring for i5/OS and the situation will not evaluate. If this is the case, you are notified by a message in the IBM Tivoli Monitoring for i5/OS log that the situation did not evaluate. To view the message log, use the DSPOMALOG command. The valid values include:

*ALL

Displays all messages (default value).

*MNNR

Displays messages that do not require a reply are listed (This includes informational, completion, diagnostic, request notify, escape, reply, answered inquiry, answered sender's copy messages.)

*MNR

Displays messages that need a reply (This includes unanswered inquiry messages.)

*PAR

Displays messages that have had a problem analysis run

*SCNR

Displays sender's copy messages requiring a reply (This includes only unanswered sender's copy messages.)

Send Job Name The name of the job that sent the message. The valid value is an alphanumeric string with a maximum of 10 characters.

Send Job Number The number of the job that sent the message. The valid value is an alphanumeric string with a maximum of 6 characters.

Send User The name of the user profile of the job that sent the message being received. The valid value is an alphanumeric string with a maximum of 10 characters.

SeveritySeverity The severity level of the message received. The higher the number, the more severe the message. The valid value is an integer in the range 0 through 99.

Time The time the message arrived in the message queue. (Messages received prior to the time when the situation is started will not be returned.) The valid value is a time in the format HHMMSS. (For example, 103000 indicates a time of 10:30:00 a.m.)

Type Indicates or identifies the type of message received. The valid values include:

01

Completion

02

Diagnostic

04

Informational

05

Inquiry

06

Sender's copy

08

Request

10

Request with prompting

14

Notify

15

Escape

21

Reply, not validity checked

22

Reply, validity checked

23

Reply, message default used

24

Reply, system default used

25

Reply, from system reply list