Validating Z APM Connect Base installation and configuration

After you install and configure Z APM Connect Base, you can validate that the software is successfully started.

1. Start the IBM Z® APM Connect Base STC.
   For example, run the operator command:

   S AGMAPROC

2. Validate whether the Base is started successfully. Check the AGAMPROC job log. If you find the following messages, the Base is started successfully.
   

   AGMZ0065I AGMZ Dispatcher Initialization Ended
   AGMZ0002I AGMZ Subsystem Ready to Accept Commands
   

   Remember: If you monitor CICS® transactions by using the CICS-MQ adapter, verify whether the Base address space is successfully initialized to monitor one or more defined IBM® MQ Subsystems. If you find the following message, the Base address space is successfully initialized:

   AGMQ0010I AGMQ MQ Subsystem xxxx : Tracking activated

3. Validate whether the Couriers are running successfully. If you find the following response messages, the Couriers are running successfully:

   AGMA0004I AGMZ Courier 50397346 Started
   AGMA0029I AGMZ Courier Controller Status: Enabled
   AGMA0032I AGMZ Number of Couriers Running: 3     
   

4. Validate whether the Z APM Connect Base is connected to Z APM Connect Distributed Gateway.
   The Z APM Connect Base Couriers don't try to connect to the Z APM Connect Distributed Gateway until it has an event to send to it. You can run the AGMA IVP command to send 6 dummy transactions to validate that the Z APM Connect Base is talking to the Z APM Connect Distributive Gateway. Execute the following command from the z/OS system log to generate 6 transactions to test the connectivity:

   /F AGMAPROC,AGMA IVP

   For more information about the command, see Base operation.

   After running the command, you can check the courier logs to determine if the connection to the Z APM Connect Distributive Gateway is successful. Specifically, look for the following information in one of the courier logs (SYS0000n output section):

   1. AGMAA04I Courier nnnnnnn Started
   2. AGMAD63I Initiating connection to tcp:myserver.mycompany.com:30455
   3. AGMAD64I Connected to tcp:myserver.mycompany.com:304455

   If you find these log entries, it indicates that the courier has received an event (a dummy transaction in this case) and has successfully connected to the DG.