Base operation

Edit online

This topic lists all the available operator commands that you can use to control Z APM Connect Base.

Table 1. Control of Z APM Connect Base function operator commands
Command Description
AGMA ADISPLAY ALL Displays the Courier processing events from all the address space.
AGMA CDISPLAY pid Displays the status of the Courier with UNIX System Services process ID = pid. The output is similar to the following output: 
AGMA0009I AGMA Courier ID: 83886368 (Active)
AGMA0010I AGMA    Events: 54, ASIDs: 1 Queue: 0
The output shows the USS Process ID of the Courier, the status (Active), the number of events processed, and the number of z/OS® address spaces that currently use the Queue corresponding to the Courier.
AGMA CDISPLAY ALL Displays the status of all Couriers.
AGMA CSTART Starts a new Courier.
AGMA DEBUG ON Shows debug and event information. This option produces a large amount of output. Use this option only when requested by IBM Tivoli® support.
AGMA DEBUG EVENTS Shows all valid events received by all Couriers. After you run this command, each Courier produces output similar to the following example: 
05/07/08 00:24:32 AGMAA05I Inbound Event at 
1210119872.267234
		Horizontal Link (ANY): HLINK
		Vertical Link (ANY): VLINK
		Vertical Context list:
				ApplicationName : IMS1
				ComponentName : IMS
				TransactionName : TSTAPI
				ServerName : SYSPLEX1/MVS1
AGMA DEBUG OFF Does not show debug information. By default, debug messages are not shown.
AGMA IVP Sends Installation Verification Procedure events to Z APM Connect DG.
AGMA STATUS Shows the status of Courier Controller.
AGMA STATUS ALL Shows the status of Dispatcher, Courier Controller, and all Couriers.
AGMA VER Displays the version information for major Z APM Connect Dispatcher modules.
AGMQ INIT mq_subsystem Installs MQ Exits into the specified mq_subsystem.
AGMQ TERM mq_subsystem Uninstalls MQ Exits from the specified mq_subsystem.
AGMQ STATUS ALL Displays the status information for the MQ-specific code.
AGMQ VER Displays the version information for the MQ-specific code.
AGMQ TRACKFP mq_subsystem ON Disables Fast Put to Waiting Getter feature and will allow Z APM Connect to track all the MQ to CICS transactions for the specified mq_subsystem. For more information about the Fast Put to Waiting Getter feature, see MQPUT of nonpersistent message out of sync point and fast put to waiting getter in the IBM MQ documentation.
AGMQ TRACKFP mq_subsystem OFF Re-enables Fast Put to Waiting Getter feature and Z APM Connect cannot track all the MQ to CICS transactions for the specified mq_subsystem. By default, the AGMQ FPTRACK status is OFF. For more information about the Fast Put to Waiting Getter feature, see MQPUT of nonpersistent message out of sync point and fast put to waiting getter in the IBM MQ documentation.