Stage 2. Configure the agent for each remote region

Do these steps for each remote region:

  1. Using the CICS® Configuration Manager ISPF dialog, edit the CSD file used by the local region, and define connection and session resources for the link to the remote region:
    1. Press the Exit key (F3) until you return to the CICS Configuration Manager primary menu.
    2. Select primary menu option 2 CICS Resources.
    3. Enter S next to the CICS configuration for the local region (suggested name: CICSCM).

      A list panel appears with filter fields and column headings, but no list items. Instead, directly under the column headings is a "bottom of data" indicator. This empty list is normal: the panel does not display any list items until you press Enter. This allows you to adjust the filter before displaying the list, avoiding delays caused by listing more resource definitions than required.

    4. In the Filter fields above the Name and Type headings, type an asterisk (*).
    5. In the Filter field above the Group heading, type the name of a resource group for the connection and session that you are about to define.
      Suggestion: CCVLOC

      Do not define resources in the existing group named CCV510. This group is strictly for use by CICS Configuration Manager: product updates may delete and replace resource definitions in this group.

    6. On the command line, enter DEF

      A pop-up window appears, requesting details of the resource you want to define.

    7. Specify CONNECTION as the CICS resource type, and then specify a name for this resource (up to four characters).
      Suggestion: Use the SYSID of the remote region as the name of the connection resource.
    8. Press Enter.
    9. Press Tab to move the cursor to the access method field.
    10. Press the Prompt key (F4) to display a pop-up list of choices.
    11. Enter S next to the access method that you want to use.

      The previously blank fields for other attributes now appear with default values for the selected access method.

    12. Fill in appropriate values for the remaining attributes.
    13. Save the connection, and then exit the edit panel.

      You return to the list of resource definitions, showing the new connection resource definition.

    14. On the command line, enter DEF

      Define a session resource to match the connection resource that you have just defined. Define the session resource in the same group as the connection.

      Suggestion: Name the session resource after the connection, with the suffix SESS. For example, if you named the connection resource REGA, name the session resource REGASESS.
  2. Install the connection and session resources into the local region:
    1. Press the Exit key (F3) to return to the list of CICS configurations. (Primary menu option 2 CICS Resources.)
    2. Enter G next to the CICS configuration for the local region.

      A list of groups appears.

    3. Enter I next to the resource group that contains the connection and session resources (sugggested name: CCVLOC).

      A pop-up window appears, asking you to select the remote system connections to which you want to install the group.

      Start of changeRather than installing in a remote region, we want to install in the local region (the CICS region running the CICS Configuration Manager server). This is a special case, because it does not need a remote system connection. We want the CICS Configuration Manager server to install the group in its own region.End of change

      Start of changeCICS Configuration Manager recognizes that the selected CICS configuration matches the CSD file used by its local region, and displays a "Local" connection. This is not a remote system connection defined in the CICS configuration. The pop-up window displays "Local" to allow you to install resources in the local region in the same way that you would select a remote system connection to install resources in a remote region.End of change

    4. Type / next to "Local", and then press Enter.

      The pop-up window closes. If the Start of changeinstallationEnd of change was successful, the Prompt column displays "*Installed" next to the resource group. Otherwise, enter ? next to the resource group to display the reason for the failure (for a description of the reason codes, see Reason codes).

  3. Define a CICS configuration for the CSD file used by the remote region. (For a reminder of how to do this, see stage 1.)
    Suggestion: Name this CICS configuration after the application ID of the remote region.

    While you are defining this CICS configuration, enter a remote system connection name. The remote system connection name must match the name of the connection resource definition for the link to the remote region (defined in step 1). For an illustration of this concept, see Figure 1.

  4. Edit the CSD file for the remote region, and define connection and session resources for the link to the local region. Follow the procedure that you used earlier to edit the CSD file for the local region (step 1).
    Suggestion: Define the connection and session resources in a resource group named CCVREM.
  5. Edit the CSD file for the remote region again, and define the following resources for the CICS Configuration Manager agent. The details of these resources are described in member CCVXCSDR of the sample library SCCVSAMP.
    Transaction CCVR
    As for any new transaction, you might need to configure your external security manager to allow this transaction to run in the remote region. This depends on the ATTACHSEC attribute value of the connection resource for the link from the local region to the remote region:
    IDENTIFY
    The agent transaction runs under the authority of the user ID of the CICS Configuration Manager user that requested the action. To perform actions on a remote region, the CICS Configuration Manager user must be authorized to run the CCVR transaction in the remote region.
    LOCAL
    The agent transaction runs under the authority of the CICS region user ID of the CICS region running the CICS Configuration Manager server.

    The CCVR transaction invokes the CICS-supplied program DFHMIRS (in the IBM® protected group DFHISC). This program must be installed in the remote region (along with the other prerequisites for CICS intercommunication).

    Programs CCVxxxxx
    These program resource definitions are required only if program autoinstall is inactive in the remote region.
    TDqueue CCVM
    Transient data queue used by the agent.

    You can choose to define these resources by either:

    • Submitting your own JCL to invoke the CICS-supplied program DFHCSDUP, with the definitions supplied in member CCVXCSDR of the CICS Configuration Manager sample library SCCVSAMP.
    • Using CICS Configuration Manager to copy each definition from the CSD file used by the local region, as follows:
      1. Press the Exit key (F3) to return to the list of CICS configurations. (Primary menu option 2 CICS Resources.)
      2. Enter S next to the CICS configuration for the local region (suggested name: CICSCM).
      3. Type CCV510 in the Filter field above the Group column heading, and then press Enter.

        The resource definitions in the group CCV510 appear in the list. This group contains the resource definitions that you need to copy to the remote regions.

      4. Locate the resource definition required by the remote CICS region.
        Tip: On the command line, enter L CCVR to locate the CCVR transaction resource definition. (Transaction names are case sensitive: you must enter CCVR in uppercase.)
      5. Enter C (for "copy") next to the resource definition.

        A pop-up window appears, requesting details of the copy target.

      6. Select the CICS configuration for the remote region, and the resource group where you want to copy the program resource definition.
        Suggestion: Copy the resource definition to the group that already contains the connection and session resource definitions (suggested name: CCVREM).
      7. Press Enter to perform the copy.
  6. Add the CICS Configuration Manager agent programs (CCVxxxxx) to a library in the DFHRPL library concatenation, using one of the following methods:
    • Edit the CICS startup job for the remote region, and add to DFHRPL the CICS Configuration Manager application load library SCCVLINK that contains the agent programs:
      //DFHRPL   …
                 DD DSN=ccvhlq.SCCVLINK,DISP=SHR

      Then restart the remote CICS region.

    • CICS Transaction Server for z/OS® Version 3.2, or later: define and install a library resource that refers to the CICS Configuration Manager application load library.
    • Copy the agent programs to a library that is already listed in DFHRPL.
  7. Install the resources that you have just defined.

    In the previous step, if you performed a cold start after updating DFHRPL, and the resources belong to resource groups that are in the startup list, then the resources will already be installed, and you can skip this step.

    Specifically, you will need to install:

    • The resource group that contains the connection and session for the link to the local region

      and, if they are in a different group,

    • The CICS Configuration Manager agent resources, including transaction CCVR, TDqueue CCVM, and (if you defined them) the agent programs (CCVxxxxx).

    To install these resources, use the CEDA transaction supplied with CICS. For example, sign on to the remote region, and then enter:

    CEDA INSTALL GROUP(CCVREM)

    This is the last time that you will need to use CEDA INSTALL on that remote region. After configuring the CICS Configuration Manager agent, you can use CICS Configuration Manager to install resources.


Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


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