+

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   -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.
      -c ChannelName
      ChannelName is an optional parameter.

      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.