Stage 3. Test the agent

To test the agent, we perform two actions on the CICSĀ® Configuration Manager agent program CCVSREMP:

  1. Newcopy the agent program: we expect this to fail, because the agent program should be running.
  2. Phase-in the agent program: this should succeed.

Do these steps for each remote region:

  1. In the CICS Configuration Manager ISPF dialog, select primary menu option 2 CICS Resources.
  2. Enter S next to the CICS configuration for the remote region.
  3. Type the filter:

    CCVSREMP PROGRAM *

    and then press Enter.

    The resource definition for the agent program appears in the list.

  4. Enter N (for "newcopy") next to the resource definition.

    A pop-up window appears for the newcopy options.

    For this first action, do not select the PHASEIN option.

  5. Enter / next to the remote system connection for the remote region.

    The pop-up window closes.

    The Prompt column should display "*Errors" next to the resource definition. This is expected.

    However, if the top right corner of the panel displays the message "Command failed", it means that the agent has not been configured correctly. Use the following checklist to identify and correct the problem:

    Agent configuration checklist

    • Are the connection and session resources correctly defined in the CSD files for the local and remote regions?

      To check the status of a connection, sign on to the local or remote region and enter:

      CEMT I CONN
    • Is the agent program resource correctly defined in the CSD file for the remote region?
    • Are the connection, session, and program resources installed in the regions?
    • Does the remote region DFHRPL concatenation include the library that contains the agent program?
    • Does the remote system connection name specified in the CICS configuration for the remote region match the name of the connection resource in the CSD file used by the local region?
  6. Enter ? next to the resource definition to display the reason for the failure.

    An "exception messages" pop-up window appears, showing messages from the agent. The expected return code from the agent is 8; the expected last four digits of the reason code are 0047 ("object is in use"). For descriptions of all CICS Configuration Manager reason codes, see Reason codes.

  7. Enter N next to the resource definition.
  8. Select the PHASEIN option.
  9. Enter / next to the remote system connection.

    This time, the Prompt column should display "*Newcopied" next to the resource definition.

This completes the configuration procedure for the agent in this remote region. Repeat stages 2 and 3 for other remote regions.


Information Information

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///ccv-install-agent-test.htm