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
- From the CICS
Explorer menu bar, select . The CICSplex Repositories window
shows your data repository and an expandable list of the CICS regions in your CICSplex.
- In the CICSplex Repositories window,
right-click the name of your data repository and select . The New wizard opens.
- 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.
- 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.
- 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.
- In the CICSplex Repositories window,
right-click the name of your new resource group and select 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.
- 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.
- In the editor, change the following TCPIPSERVICE resource
definition attributes from the defaults that the CICS Explorer has set:
- Change Authenticate to Notapplic.
- Change Protocol to IPIC.
- Change Transaction to CISS.
- Change Urm to DFHISAIP.
Leave the host name and IP address as ANY.
- Save your changes in one of the following ways:
- Select .
- 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 . For any
further changes to a resource definition, you can double-click
it in this view to open the editor for that definition.
- 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.
- In the CICSplex Repositories window,
right-click the name of your resource group and select 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.
- 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:
- Name the IPCONN resource definition for one of the CICS regions, and write a useful
description.
- Enter the name of the TCPIPSERVICE resource definition
for IPIC that you have just defined for that CICS region.
- 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.
- 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.
- 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.
- 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.
- Repeat steps 11-15 to create another IPCONN resource definition
in the resource group to be installed in the other CICS region.
- With the resource group highlighted in the CICSplex
Explorer window, from the CICS Explorer menu bar select 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.
- 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 .
- 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 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.