Agent Technology Commands › awm_catch-Message Display Utility

awm_catch-Message Display Utility

Valid on UNIX/Linux, Windows, z/OS

awm_catch displays messages being exchanged by the local agents and services. You must specify at least one message type and key with this utility.

Windows

install-path\services\bin

UNIX/Linux, z/OS

install-path/services/bin

This command has the following format:

awm_catch messageType messageKey [-@ orbHostName] [-d debugLevel] [-f debugFile] 
[-t=targetNode|targetName|targetClass] [-s sendType|sendKey|sendDate] 
[-c maxNumberOfMessages] [-w waitSecond] [-F messageFilterString] [-q] [-n]

messageType

Identifies the pattern of message type to intercept and display, such as POLL_EVENT or FSM_CONFIG.

messageKey

Specifies the pattern of message key to listen for, such as SNMP, TRAP, or instance.

-@ orbHostName

Specifies the node name or IP address of a remote DSM.

-d debugLevel

Runs this utility in debug mode.

-f debugFile

Name of the debug file.

-t targetNode|targetName|targetClass

Specifies a particular recipient for a message.

-s sendType|sendKey|sendData

Enables the user to send one message before starting an awm_catch session. This prevents having an awm_config session open at the same time.

-c maxNumberOfMessages

Specifies the maximum number of messages to be displayed.

-w waitSecond

Specifies the number of seconds awm_catch listens for messages before exiting.

-F messageFilterString

Searches the type, key, and data of a caught message and displays the message only if the messageFilterString is found.

-q

Runs awm_catch in quiet mode.

-n

Displays the count number of the message at the front of each message.