Agent Technology Commands › awm_catch-Message Display Utility

awm_catch-Message Display Utility

Valid on UNIX/Linux, Windows, z/OS

awm_catch displays messages that the local agents and services exchange. Specify at least one message type and key with this utility.

Windows

install-path\services\bin

UNIX/Linux, z/OS

install-path/services/bin

Syntax

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

Pattern of message type to intercept and display, such as POLL_EVENT or FSM_CONFIG.

messageKey

Pattern of message key to listen for, such as SNMP, TRAP, or instance.

-@ orbHostName

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

A particular recipient for a message.

-s sendType|sendKey|sendData

Enables the user to send one message before starting an awm_catch session. This option prevents having an awm_config session open simultaneously.

-c maxNumberOfMessages

Maximum number of messages to be displayed.

-w waitSecond

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.