This check does the following tasks:

check, if a defined channel has a correct state

define thresholds for the queue curdepth

MQS

Explanation

MQS is the enclosing tag for all Queue-Manager entries.

Parent

OSAGENT

allowed values

• QMGR

• NAME

Count

0 or 1. If you don't define QMGR, no check will run.

Example

<MQS>
    <!-- entries for queue-manager: qmgr1 -->
    <QMGR>
      <NAME>qmgr1</NAME>
      <RUNIF_DIR>/var/mqm</RUNIF_DIR>
      <!-- check channels for state running or inactive -->
      <MQCHANNEL>
        <CHNAME>.*</CHNAME>
        <ALLOWEDSTATE>RUNNING|INACTIVE</ALLOWEDSTATE>
      </MQCHANNEL>
      <!-- check curdepth of queues -->
      <MQUEUE>
        <QNAME>.*</QNAME>
        <MAXCURDEPTH>1</MAXCURDEPTH>
      </MQUEUE>
    </QMGR>

    <!-- entries for queue-manager: qmgr1 -->
    <QMGR>
      <NAME>qmgr2</NAME>
      <RUNIF_TIME>* 08-17 * * * </RUNIF_TIME>
      <!-- check channels -->
      <MQCHANNEL>
        <CHNAME>.*</CHNAME>
        <ALLOWEDSTATE>RUNNING|INACTIVE</ALLOWEDSTATE>
      </MQCHANNEL>
      <!-- check curdepth of queues -->
      <MQUEUE>
        <QNAME>.*</QNAME>
        <MAXCURDEPTH>1</MAXCURDEPTH>
      </MQUEUE>
    </QMGR>
</MQS>
        

QMGR

Explanation

QMGR is the enclosing tag for every queue manager which we have to check

Parent

OSAGENT

allowed values

• MQUEUE

• MQCHANNEL

• RUNIF_DIR

• RUNIF_TIME

Count

0 or 1. If you don't define QMGR, no check will run.

Example

<MQS>
    <QMGR>
      <NAME>qmgr1</NAME>
      <MQCHANNEL>
        <CHNAME>.*</CHNAME>
        <ALLOWEDSTATE>RUNNING|INACTIVE</ALLOWEDSTATE>
      </MQCHANNEL>
      <MQUEUE>
        <QNAME>.*</QNAME>
        <MAXCURDEPTH>1</MAXCURDEPTH>
      </MQUEUE>
    </QMGR>
    <QMGR>
      <NAME>qmgr2</NAME>
      <MQCHANNEL>
        <CHNAME>.*</CHNAME>
        <ALLOWEDSTATE>RUNNING|INACTIVE</ALLOWEDSTATE>
      </MQCHANNEL>
      <MQUEUE>
        <QNAME>.*</QNAME>
        <MAXCURDEPTH>1</MAXCURDEPTH>
      </MQUEUE>
    </QMGR>
  </MQS>
        

NAME

Explanation

Name of the queue manager

Parent

QMGR

allowed values

string

Count

1. If you don't define no QMGR-NAME, no check will run.

MQCHANNEL

Explanation

you can use regular expressions for the MQCHANNEL tags either to monitor or not. More then one MQCHANNEL pair is possible

Parent

QMGR

allowed values

• CHNAME

• ALLOWEDSTATE

• The common XML tags as described in Section 9.8, “Tags Common to All Checks and/or Checkpoints”

Count

As many as you like.

Example

Look at QMGR

CHNAME

Explanation

This entity describes a regular expression for the channel you want to monitor

Parent

MQCHANNEL

allowed values

regular expression ( i.e.: .* means all channels )

Count

1

Example

<MQCHANNEL>
  <CHNAME>.*</CHNAME>
  <ALLOWEDSTATE>RUNNING|INACTIVE</ALLOWEDSTATE>
</MQCHANNEL>
        

ALLOWEDSTATE

Explanation

This entity describes a legal state of a channel. you can use regular expressions ( i.e.: RUNNING|INACTIVE )

Parent

MQCHANNEL

allowed values

regular expression ( i.e.: .* means all channels )

Count

1

Example

<MQCHANNEL>
  <CHNAME>.*</CHNAME>
  <ALLOWEDSTATE>RUNNING|INACTIVE</ALLOWEDSTATE>
</MQCHANNEL>
        

MQUEUE

Explanation

you can use regular expressions for the MQUEUE tags to define thresholds for the curdepth of queues

Parent

QMGR

allowed values

• QNAME

• CURDEPTH

• The common XML tags as described in Section 9.8, “Tags Common to All Checks and/or Checkpoints”

Count

As many as you like.

Example

Look at QMGR

CURDEPTH

Explanation

This entity describes the maximum value for the curdepth before a status change takes place ( NORMAL -> WARNING for example )

Parent

MQUEUE

allowed values

integer value

Count

1

Example

<MQUEUE>
  <QNAME>.*</QNAME>
  <CURDEPTH>1</CURDEPTH>
</MQUEUE>