Configuring an HA client region

How to configure an IPIC high availability (HA) client region.

Before you begin

Restriction: IPIC HA makes use of function provided in CICS® TS V5.2 or later. Both client and cluster regions must be at this level. TCP/IP services must be active in the CICS regions. You can activate TCP/IP services by setting the TCPIP system initialization parameter to YES. When the client attempts to connect to the cluster, there must not be any acquired IPIC connections between a client region and any region in the HA cluster or failures can occur.

Procedure

  1. Define a TCPIPSERVICE resource to receive inbound requests on the local CICS region. This resource must listen on an address and port that is exclusively reserved for this region.
    1. Specify the IP address on which this CICS region will listen in the HOST attribute. The ANY option specifies that CICS listens on any of the addresses known to TCP/IP for the host system. The host name can be up to 116 characters in length, or can be an IPv4 or IPv6 address.
    2. Specify a port number on which the local CICS region listens for incoming client requests in the PORT attribute.
    3. Specify IPIC for the PROTOCOL attribute.
    4. Specify NO for the SOCKETCLOSE attribute.
    5. Specify the 4-character ID of the CICS transaction that runs the DFHISCOP program as the value of the TRANSACTION attribute. The default transaction for IPIC is CISS.
    6. Leave the SPECIFTCPS attribute blank.
  2. Define an IPCONN resource for the client regions to connect to the HA cluster.
    1. Specify the IPCONN name. Specify a 4-character IPCONN name with four trailing spaces if you are using a 3270 interface, in other cases the four spaces will be added automatically.
    2. Specify in the HOST attribute the host name of the HA cluster. This should resolve to the IP address specified in the generic TCPIPSERVICE used by the HA cluster regions. For example, hostb.example.com The host name can be up to 116 characters in length, or can be an IPv4 or IPv6 address.
    3. Specify in the PORT attribute the port number on which the HA cluster will listen. This should be the same as the port specified in the generic TCPIPSERVICE used by the HA cluster regions.
    4. Specify the name of the TCPIPSERVICE resource defined in step 1.
    5. Specify a unique value for the HA cluster as the APPLID. It must be unique from all other APPLIDs that have been used in other IPCONN resources installed in this region.
    6. Specify YES for the HA attribute, indicating that the APPLID refers to a cluster of regions.
    7. Optional: Specify YES or NO for the INSERVICE attribute to set if you want the connection to be available when the resource is created.
    8. Specify values for the RECEIVECOUNT and SENDCOUNT attributes to set how many receive and send sessions are allowed for the IPIC connection.

Results

When the resources are enabled on the local CICS regions, then that region will be able to attempt to connect to the HA cluster.

What to do next

You can use the IBM® CICS Explorer® or Web User Interface to view and update your IPIC connections. If you do not specify AUTOCONNECT(YES) for the IPCONN resource, you must acquire the connection by updating the status of the resource.


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