Setting up an IPIC connection between the CICS regions

To define an IPIC connection, you create an IPCONN resource and a TCPIPSERVICE resource in each CICS® region that you want to connect.

Before you begin

To set up an IPIC connection between two CICS regions, you need the following information:

  • The application identifier (APPLID) of each of the CICS regions that you want to connect using IPIC.
  • The remote network ID (NETWORKID) for each of the CICS regions, if the CICS regions are in different CICSplexes.
  • The IP address, or the host name, of each of the CICS regions.
  • A port number on which you can connect to each of the CICS regions.

For on overview of IPIC, see Intercommunication using IP interconnectivity.

About this task

These instructions explain how to create and install the resources for the IPIC connection by using the CICS Explorer®. See www.ibm.com/cics/explorer/ for information about the CICS Explorer.

You can also create the resources using a view that lists the attributes of the resource definition, such as CICSPlex® SM or the CEDA transaction in CICS.

You could also complete this task by using CICS Configuration Manager. See CICS Configuration Manager.

Procedure

  1. From the CICS Explorer menu bar, select Window > Show view > CICSplex Repositories. The CICSplex Repositories window shows your data repository and an expandable list of the CICS regions in your CICSplex.
  2. In the CICSplex Repositories window, right-click the name of your data repository and select New > Other. The New wizard opens.
  3. In the New wizard, type resource in the filter box to show the Resource Group Definition wizard. Highlight the name of this wizard and click Next.
  4. In the New Resource Group Definition wizard, type a name and description for a group to contain your new IPIC resources.
    Tip: Add an informative description for your resource definition. The CICS Explorer uses the descriptions of resources in its displays.
  5. Click Finish to create your resource group. Refresh the CICSplex Repositories window and expand the list of items in your data repository to see your new resource group.
  6. In the CICSplex Repositories window, right-click the name of your new resource group and select New > Other to open the New wizard again. Type tcp in the filter box to show the TCP/IP Service Definition wizard. Highlight the name of this wizard and click Next.
  7. In the New TCP/IP Service Definition wizard, name the TCPIPSERVICE resource definition for one of the CICS regions, and write a useful description. Enter the port number on which you can connect to that CICS region. The CICS Explorer has prefilled the names of your data repository and your new resource group. Select the Open Editor box and click Finish to add further attributes to the TCPIPSERVICE resource definition.
  8. In the editor, change the following TCPIPSERVICE resource definition attributes from the defaults that the CICS Explorer has set:
    1. Change Authenticate to Notapplic.
    2. Change Protocol to IPIC.
    3. Change Transaction to CISS.
    4. Change Urm to DFHISAIP.
    Leave the host name and IP address as ANY.
  9. Save your changes in one of the following ways:
    • Select Explorer > Save.
    • Press Ctrl-S.
    • Exit the editor and confirm to save the changes
    Your TCPIPSERVICE resource definition appears in the list in the TCP/IP Service Definitions view for the resource group. To display this view, make sure that your resource group is highlighted in the CICSplex Repositories window, then from the CICS Explorer menu bar, select Definitions > TCP/IP Service Definitions. For any further changes to a resource definition, you can double-click it in this view to open the editor for that definition.
  10. Repeat steps 6-9 to create another TCPIPSERVICE resource definition in the resource group, using the port number on which you can connect to the other CICS region.
  11. In the CICSplex Repositories window, right-click the name of your resource group and select New > Other to open the New wizard again. Type ipic in the filter box to show the IPIC Connection Definition wizard. Highlight the name of this wizard and click Next.
  12. In the New IPIC Connection Definition wizard, the CICS Explorer has prefilled the name of your data repository and the resource group that you are using. Enter the other information as follows:
    1. Name the IPCONN resource definition for one of the CICS regions, and write a useful description.
    2. Enter the name of the TCPIPSERVICE resource definition for IPIC that you have just defined for that CICS region.
    3. Under the heading Outgoing, fill in the host name, port number, and application ID (APPLID) of the other CICS region involved in the IPIC connection, that is, the region to which this CICS region is making an outbound IPIC connection.
    When you have filled in the information, select the Open Editor box and click Finish to specify further attributes in the IPCONN resource definition.
  13. In the editor, change the values for the Receivecount and Sendcount attributes by overtyping them. To replace an existing MRO connection, use send and receive counts like those from the SESSIONS resource definition for the MRO connection. Alternatively, choose a suitable number of send and receive sessions for the connection. The number of send sessions that you specify for each IPCONN definition should match the number of receive sessions that you specify for the matching IPCONN definition in the other CICS region.
  14. In the editor, change the values for the attributes relating to security to match the settings for the existing MRO connection between the CICS regions. For example, if the MRO connection is defined with ATTACHSEC(IDENTIFY), you could use the attributes LINKAUTH(SECUSER) and USERAUTH(IDENTIFY) for a similar result on the IPIC connection. For further information about security settings for the different connection types, see Intercommunication security.
  15. Click Finish to create your resource definition. The new IPCONN resource definition is added to the list in the IPIC Connection Definitions view for the resource group.
  16. Repeat steps 11-15 to create another IPCONN resource definition in the resource group to be installed in the other CICS region.
  17. With the resource group highlighted in the CICSplex Explorer window, from the CICS Explorer menu bar select Definitions > TCP/IP Service Definitions to display your new TCPIPSERVICE resource definitions. Right-click the name of the TCPIPSERVICE resource definition that you created for one of the CICS regions, and select Install. The Perform Operation window opens.
  18. Select the box for the CICS region where you want to install this TCPIPSERVICE resource, and click OK. To verify that the resource has been installed in the CICS region, highlight the CICS region in the CICSplex Repositories window, then from the CICS Explorer menu bar select Operations > TCP/IP Services.
  19. Repeat the previous two steps to install your remaining TCPIPSERVICE resource in the other CICS region, and to install your IPCONN resources in the appropriate CICS regions. The IPCONN resource definitions are shown in the IPIC Connection Definitions view for the resource group, and you can verify the installation by selecting Operations > IPIC Connections for the CICS region.

Results

When you have installed the TCPIPSERVICE and IPCONN resources in each CICS region, the IPIC connection is ready for the application to use.

What to do next

The connection between the TOR and the AOR is still an MRO connection. This connection does not affect the processing for the application, so it remains as it was for now. In a future phase, you might want to define an IPIC connection between the TOR and the AOR, to avoid having to manage different connection types within the application.


impl_resdef_conn.html | Timestamp icon Last updated: Sunday, 4 June 2017