Take action commands

Use Take Action commands to quickly initiate commands from within IBM® MQ Monitoring agent. You can enter a command or stop or start a process at any system in your network where more than one IBM MQ Monitoring agent is installed.

Unless otherwise noted, you can invoke the commands presented here from the Take Action view, from a situation (when it becomes true), from the Navigator, or from a row in a table view. For more information on how to send a command, see the Tivoli Enterprise Portal online Help.

The Take Action commands associated with this product (commands sent to the IBM MQ Monitoring agent) have names which begin with the characters "MQ:".

Predefined Take Action commands

IBM MQ Monitoring agent provides the predefined Take Action commands described in this section. For more detailed information about any of the IBM MQ (WebSphere® MQ) commands, see WebSphere MQ Script (MQSC) Command Reference.

Exception: The predefined commands are not applicable to telemetry channels. For a telemetry channel, you must create a custom command on Tivoli® Enterprise Portal. For example, to start a telemetry channel, create a custom command with the channel type specified. The following line is an example of what you can type in the Command field when you create a custom command on Tivoli Enterprise Portal:
START CHANNEL(&Telemetry_Channel_Definitions.Channel_Name) CHLTYPE(MQTT)

Using Take Action commands in situations

Unless otherwise noted, you can use the commands described in this section in situations that you write. This feature of situations is built into Tivoli Monitoring products and is documented in Tivoli Enterprise Portal online Help and in the Administering OMEGAMON Products: Tivoli Enterprise Portal guide. The term reflex automation refers to a situation that issues a command.

To issue a command from a situation, enter the MQ: syntax form of the command on the Action tab of the Situation Editor. Figure 1 shows an example of the MQ Start Channel command used in a situation.

Figure 1. A Take Action command used in a situation
This figure illustrates the MQ Start Channel command used in a situation

This example is from the MQ_Automation_ChlStart predefined situation, which substitutes an attribute from the Channel Performance workspace. The Attribute Substitution button, visible in Figure 1, is used to select the attribute (this prevents misspellings and inserts the ampersand character (&) which is needed for attribute substitution). The single quotation marks enclosing the command parameter are required. When you are using a Take Action command in a situation, create a working, manual version of the Take Action command before you attempt to automate its use by adding it to a situation.