Rational Developer for System z

Defining CICS primary connection regions

A CICS® test environment can consist of several Multi-Region Option (MRO) connected regions. This topic breaks down the various connection regions.

Over time, unofficial designations have been used to categorize MRO-connected regions. Typical designations are terminal owning region, web owning region, application owning region, and data owning region (DOR). A web owning region is used to implement HTTP communications with CICS, and the Application Deployment Manager CICS Resource Definition (CRD) server must run in this region.

The Application Deployment Manager identifies this region as the CICS primary connection region. The Application Deployment Manager CRD client implements web service and REST connections to the CICS primary connection region.

To define CICS primary connection regions, complete the following steps:

  1. Specify the credentials for the CICS primary connection region definitions that you will configure later in this procedure.
    1. Click Window > Preferences. A Preferences window is displayed.
    2. Click CICS Explorer > Credentials. Credentials fields are displayed.
    3. Click New.
    4. If you want to save a password for automatic login for this credential, select the Save password check box.
    5. Fill in the following fields:
      Credential
      • Name: A name for the credentials
      Authentication
      • User ID: Your user ID
      • Password (only if you selected the Save password check box)
    6. Click Apply. The credentials are saved.
  2. Configure definitions for the CICS primary connection region.
    1. In the Preferences window, click CICS Explorer > Connections. Connections fields are displayed.
    2. Fill in the following fields:
      Connection
      • Type: For operations that require a connection to the CICS Resource Definition server for Application Deployment Manager (for example, creating and editing a manifest for the Application Deployment Manager), this must be set to CICS Resource Definition Server via Web Services or CICS Resource Definition Server via REST. For improved performance or if you are using functions that require resource types that are new in CICS version 4.1 such as bundles, XML transformations, or event bindings, use the CICS Resource Definition Server via REST connection type.
        To use the CICS Explorer perspective, you can use one of the CICS Resource Definition server connection types or, for additional options, use either the CICSPlex SM Data Interface or CICS Management Interface connection type depending on which are available and configured at your site.
      • Name: Specify the name for the CRD server region.
      Location
      • Host name: Type the IP address of the server.
      • Port number: Type the port number.
      Authentication
      • Credentials: Select the name of the credentials that you saved earlier in this procedure.
      CICS Resource Definition Server
      • Default primary connection region: You can have multiple CICS environments, each consisting of several regions. Each CICS environment requires a CICS primary connection definition. However, only one of these definitions should be checked as the default CICS primary connection region that will be used by the Resource Definition Editor to retrieve resource attribute default values and as the default target region where resources will be installed.
        Note: When you switch development to a different CICS environment, you should change the default.

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)