Configuring the IPIC connection

Before you can test your Java™ application with a CICS® region, an IPIC connection must be available. Contact your CICS system programmer to request a TCP/IP service that accepts IPIC requests from a Liberty profile by using the following details.

About this task

The following procedure guides the CICS system programmer through the steps to define a TCP/IP service in CICS and install a sample user program for IPIC connections.

Procedure

  1. Install IPIC support in CICS by defining a TCPIPSERVICE resource with the following attributes:
    Table 1. Attributes for TCPIPSERVICE resource
    TCPIPSERVICE resource attribute Value required
    URM DFHISAIP
    Port number n
    Status OPEN
    Protocol IPIC
    Transaction CISS
    Backlog 0
    Socketclose No
  2. Verify that the TCPIPSERVICE is in service by issuing the CEMT INQUIRE TCPIPSERVICE(JCA) command.
  3. Optional: Install a sample program to test the IPIC connection.
    1. If you do not already have a copy, download the CICS Transaction Gateway Software Development Kit (SDK) and expand the archive file.
    2. Locate and copy the cicsprograms/ec01.cpp member to a COBOL source data set on z/OS®.
    3. Compile the EC01 sample program and copy the generated module into a load library that CICS can access.
    4. If the autoinstall program is not enabled, define and install a program definition for ECO1.
    5. Test the ECO1 program by issuing the CECI LINK PROG(EC01) COMMAREA(' ').
      Check that the RESPONSE is NORMAL.

Results

IPIC support is now available for use in the CICS region.