+

Search Tips | Advanced Search

amqsmon (Display formatted monitoring information)

Use the amqsmon sample program to display in a readable format the information contained within accounting and statistics messages. The amqsmon program reads accounting messages from the accounting queue, SYSTEM.ADMIN.ACCOUNTING.QUEUE. and reads statistics messages from the statistics queue, SYSTEM.ADMIN.STATISTICS.QUEUE.


Syntax


amqsmon

amqsmon  -m QMgrName  -t Type  -a  -i ConnectionId -c ChannelName -q QueueName  -b  -d Depth -w TimeOut -s StartTime -e EndTime -l ,Parameter


Required parameters

    -t Type
    The type of messages to process. Specify Type as one of the following:

      accounting
      Accounting records are processed. Messages are read from the system queue, SYSTEM.ADMIN.ACCOUNTING.QUEUE.

      statistics
      Statistics records are processed. Messages are read from the system queue, SYSTEM.ADMIN.STATISTICS.QUEUE.


Optional Parameters

    -m QMgrName
    The name of the queue manager from which accounting or statistics messages are to be processed.

    If we do not specify this parameter, the default queue manager is used.

    -a
    Process messages containing MQI records only.

    Only display MQI records. Messages not containing MQI records will always be left on the queue they were read from.

    -q QueueName
    QueueName is an optional parameter.

      If QueueName is not supplied: Displays queue accounting and queue statistics records only.
      If QueueName is supplied: Displays queue accounting and queue statistics records for the queue specified by QueueName only.

    If -b is not specified then the accounting and statistics messages from which the records came are discarded. Since accounting and statistics messages can also contain records from other queues, if -b is not specified then unseen records can be discarded.

    -c ChannelName
    ChannelName is an optional parameter.

      If ChannelName is not supplied: Displays channel statistics records only.
      If ChannelName is supplied: Displays channel statistics records for the channel specified by ChannelName only.

    If -b is not specified then the statistics messages from which the records came are discarded. Since statistics messages can also contain records from other channels, if -b is not specified then unseen records can be discarded.

    This parameter is available when displaying statistics messages only, ( -t statistics ).

    -i ConnectionId
    Displays records related to the connection identifier specified by ConnectionId only.

    This parameter is available when displaying accounting messages only, ( -t accounting ).

    If -b is not specified then the statistics messages from which the records came are discarded. Since statistics messages can also contain records from other channels, if -b is not specified then unseen records can be discarded.

    -b
    Browse messages.

    Messages are retrieved non-destructively.

    -d Depth
    The maximum number of messages that can be processed.

    If we do not specify this parameter, then an unlimited number of messages can be processed.

    -w TimeOut
    Time maximum number of seconds to wait for a message to become available.

    If we do not specify this parameter, amqsmon will end once there are no more messages to process.

    -s StartTime
    Process messages put after the specified StartTime only.

    StartTime is specified in the format yyyy-mm-dd hh.mm.ss. If a date is specified without a time, then the time will default to 00.00.00 on the date specified. Times are in GMT.

    For the effect of not specifying this parameter, see Note 1.

    -e EndTime
    Process messages put before the specified EndTime only.

    The EndTime is specified in the format yyyy-mm-dd hh.mm.ss. If a date is specified without a time, then the time will default to 23.59.59 on the date specified. Times are in GMT.

    For the effect of not specifying this parameter, see Note 1.

    -l Parameter
    Only display the selected fields from the records processed. Parameter is a comma-separated list of integer values, with each integer value mapping to the numeric constant of a field, see amqsmon example 5.

    If we do not specify this parameter, then all available fields are displayed.

Note:

  1. If we do not specify -s StartTime or -e EndTime, the messages that can be processed are not restricted by put time.

Parent topic: Display accounting and statistics information

Last updated: 2020-10-04