SET CHANNEL

Use the SET CHANNEL statement to specify the channels to be monitored.

Remember: The SET CHANNEL statement does not affect on-demand attribute queries. Even if the agent does not sample data about particular channels, you can still get the most current data for a channel by using an on-demand attribute group query

Syntax

SET CHANNEL NAME(channel-name-mask)
       MGRNAME(manager-name) | GROUP(group-name)
       [STATUS(ADD|DELETE)]

Parameters

NAME(channel-name-mask)

Specifies a 1- through 20-character specific or generic name of the channels that you want to monitor. To specify a generic name, enter a string of characters followed by an asterisk (*). This parameter is required.

If you set this parameter to one blank character ( ), the IBM MQ Monitoring Agent does not collect sampled monitoring data for any channels.

If you set this parameter to one asterisk character (*), the agent will collect sampled monitoring data for all channels.

MGRNAME(manager-name)

Associates this SET CHANNEL statement with a queue manager that is defined on a previous SET MANAGER statement. You can use the name or nickname of the manager. The name must exactly match the name specified on the corresponding SET MANAGER statement. This parameter is required if the GROUP parameter is not specified.

GROUP(group-name)

Associates this SET CHANNEL statement with a group of queue managers defined on a previous SET GROUP statement. The name must exactly match the name specified on the corresponding SET GROUP statement. This parameter is required if the MGRNAME parameter is not specified.

STATUS(ADD|DELETE)

Specifies what to do if this SET CHANNEL statement was previously specified with the same name.

If this parameter is omitted, the result is the same as specifying ADD.

ADD: Creates a new channel definition. If this SET CHANNEL statement was previously specified with the same name, it is not modified and an error message is issued.

DELETE: Deletes a channel definition and all associated historical data.

Example

To monitor a channel named MONTANA on the SMON queue manager, specify the following statement:

SET CHANNEL NAME(MONTANA) MGRNAME(SMON)