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

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 you 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 ).

-b

Browse messages.

Messages are retrieved non-destructively.

-d Depth

The maximum number of messages that can be processed.

If you 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 you 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 you do not specify this parameter, then all available fields are displayed.

Note:

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