Implementing IBM Tivoli OMEGAMON XE for WebSphere Business Integration V1.1

Chapter 7. WebSphere Integration Brokers Monitoring 231

– System Command.

– Where should the action be executed.

򐂰 Until tab items

– Close this event when either occurs.

Do you want situation’s actions to automatically perform an operation on the

managed system or do you want the situation to notify the correct people to

perform some action?

7.8 Using Take Actions

Take Actions allow you to submit commands to the WebSphere Business

Integration Brokers from the CandleNet Portal using the agent. They can be

submitted from situations, from the Navigator, or from a row in a table view. The

Take Action commands for this product are prefaced with the letters

QI.

Which users can initiate Take Actions is controlled by the agent parameter file at

two levels:

򐂰 Agent level: Using defaultTakeActionAuthUsers parameter

򐂰 Broker level: Using takeActionAuthUsers parameter

The default setting is for the agent level with defaultTakeActionAuthUsers=”*”.

This means any CandleNet Portal user can issue Take Actions for the agent. The

commands are executed within the context of the agent’s authority.

Table 7-4 shows the Take Actions provided with the product.

Table 7-4 Take Actions provided by the product

Take Action Managed System Description

QI Start Component QI Agent Starts one of the following

components: UserNameServer,

ConfigMgr, or broker. Uses the

mqsistart command.

QI Stop Component QI Agent Stops one of the following

components: UserNameServer,

ConfigMgr, or broker. Uses the

mqsistop command.

232 Implementing IBM Tivoli OMEGAMON XE for WebSphere Business Integration V1.1

QI Stop Component and its

Queue Manager

QI Agent Stops one of the following

components and its associated

queue manager:

UserNameServer, ConfigMgr, or

broker. Uses the mqsistop

command.

QI Change Trace

Component

QI Agent Changes the trace level of the IBM

broker component. Uses the

mqsichangetrace command.

QI Start Broker QI Broker Starts the selected broker. Uses

the mqsistart command.

QI Stop Broker QI Broker Stops the selected broker. Uses

the mqsistop command.

QI Stop Broker and its

Queue Manager

QI Broker Stops the selected broker and its

associated queue manager. Uses

the mqsistop command.

QI Change Trace Broker QI Broker Changes the broker’s trace level.

Uses the mqsichangetrace

command.

QI Change Broker QI Broker Allows the broker to be modified.

Uses the mqsichangebroker

command.

QI Change Flow Stats QI Broker Allows the activation/deactivation

of Message Flow Accounting and

Statistics. Uses the

mqsichangeflowstats command.

QI Start Message Flow(s) QI Broker Starts one or all message flows

associated with an execution

group. Leaving the Message_Flow

argument blank will cause all flows

to be started in the give execution

group.

QI Stop Message Flow(s) QI Broker Stops one or all message flows

associated with an execution

group. Leaving the Message_Flow

argument blank will cause all flows

to be stopped in the give execution

group.

Take Action Managed System Description

Chapter 7. WebSphere Integration Brokers Monitoring 233

The destination of the Take Action is either at the agent or broker level, as

indicated in Table 7-4 on page 231. The amount of detail pre-filled for you

depends on from where you open the Take Action menu. In the following two

images, you can see that, depending on where we launched, the menu controlled

the amount of detailed that we were provided.

The image in Figure 7-18 on page 234 shows the level of detail when the Take

Action is accessed by right-clicking the QI Broker object in the Navigator. Notice

that the “Execution_Group” and “Message_Flow” are not filled in and are

highlighted in yellow.

QI Delete Retained

Publication

QI Broker Deletes a retained publication for

the given topic and subscription

point.

QI Create User Statistics QI Broker Creates user statistics associated

with the CandleNet Portal logon ID

that issues the command. The

MaxInactivityTime is in minutes.

QI Sample User Statistics QI Broker Causes the agent to take a sample

of CandleMonitor statistics for the

CandelNet Portal logon ID that

issues the command.

QI Destroy User Statistics QI Broker Cleans up all user statistics

associated with the CandleNet

Portal logon ID that issues the

command. It also releases the

storage held by these statistics.

QI Reset Statistics QI Broker Resets the statistics collected by

the Candle Monitor node to zero.

Take Action Managed System Description