Controlling the WebSphere MQ configuration and monitoring extensions on UNIX platforms

WebSphere MQ Configuration and Monitoring Extensions runs as a Java process. If you want to work directly with the process, use the ps command to find the active Java processes.

  1. Open a command prompt and change to the directory containing the distributed files.
  2. Enter the extension command (qpmon or qpcfg) followed by the required command parameter as described in the table below. For example, qpcfg --start starts the configuration extension; qpmon --stop stops the monitoring extension.

Note

Although nearly any shell can be used with TrueSight Middleware and Transaction Monitor, many of the script files are written for the Korn shell.

Related topics

Running-performance-and-availability-monitoring-extensions

Running-WebSphere-MQ-configuration-and-monitoring-extensions

Running-application-transaction-tracing-transaction-monitoring-extensions

Command parameters

Use to...

--console

Run the extension program in the foreground, displaying log messages as they are generated. It is useful when trying to locate or troubleshoot problems.

--help

List the available command prompt options (this list) and short descriptions.

--ts-host host

Set the host of the TMTM Topic Service so that the monitoring extension can pass its information to it. host is the host name or IP address of the TMTM Topic Service.

--ts-port port

Set the port of the TMTM Topic Service so that the monitoring extension can pass its information to it. port is the port number of the TMTM Topic Service.

--start

Start the extension.

(Optional) Using cron or the /etc/rc.d/init.d directory, configure the WebSphere MQ Configuration and Monitoring Extensions to start automatically when the computer is restarted.

--status

Provides an execution status for the extension.

--stop

Stop the extension.

--version

Displays version information for the extension.

Ctrl+c

Stop the extension. This is used in console mode. The command both stops the extension and exits console mode.

Note

Permission to alter WebSphere MQ objects is set by the user who starts the configuration extension.

For information about how to secure individual agents, see Managing-WebSphere-MQ-object-security.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*