AS400 User Message Queues Test

This test monitors a specific user’s message queues for configured message patterns.

Target of the test : An AS400 Server

Agent deploying the test : An external/remote agent

Outputs of the test : One set of results for each DisplayName configured.

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.


The IP address of the host for which this test is to be configured.


The port at which the specified host listens. By default, this is NULL


This test connects to the AS400 server being monitored to extract the required metrics. Therefore, specify the name of the AS400 server to connect to in the ServerName text box.


To enable the test to login to the specified AS400 server, you need to provide the test with the credentials of a valid user to the AS400 server. Hence, specify a valid userid.


Provide the Password that corresponds to the specified UserID.

Confirm Password

Confirm the password by retyping it in the Confirm Password text box.


Specify the Path of the user queue to be monitored. If you want to monitor the default message queue for the configured user, then provide *CURRENT in the Path text box. Please note that * is mandatory. If you would like to monitor the message queue of the specific user, you need to provide /QSYS.LIB/QUSRSYS.LIB/>>userID<<.MSGQ in the Path, where user ID represents the ID of the user whose message queue needs to be monitored.

Search Pattern

Mention the patterns of messages to be monitored by the test in Search Pattern text box. The format of your specification should be: DisplayName:Pattern .Here, DisplayName refers to the display name of the Search Pattern that will appear as the descriptor of this test in the eG monitoring console. Pattern refers to the message pattern(s) to be monitored. For example, your Search Pattern can be: RestartDM:*Restart*DM*, where RestartDM is the display name of the pattern, and *Restart*DM* monitors all messages containing the strings Restart and DM. Multiple search pattern can be provided as a comma separated list. For example, RestartDM:*Restart*DM*,MSGWaiting:*There*is*MSGW*,DMI dle:*in*target*DM*status*IDLE*.

DD Frequency

Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD frequency.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Messages in users message queue

Indicates the number of messages in the message queue during the last measurement period, which matched this pattern.