This task shows you how to create a IBM® z/OS® Connect server and configure an IPIC
connection to a CICS® region.
Before you begin
Ensure that the following tasks are complete:
- Install and configure the CICS catalog manager example application. The procedure is described in the scenario Prepare the sample CICS application.
- Install IBM z/OS Connect v3.0 or later.
For more information, see Installing IBM z/OS Connect.
Pre-built services and an API are provided to simplify testing of this scenario.
About this task
This task consists of three parts:
- Creating a IBM z/OS Connect server with
ready-to-use services and an API for the CICS catalog manager
example application.
- Configuring an IPIC connection between your IBM z/OS Connect server and CICS.
- Testing the IPIC connection.
Procedure
-
Define a
TCPIPService
to listen for inbound IPIC requests in your
CICS region. This scenario uses a port value
of 1091. For more information about defining a TCPIPService
for inbound IPIC
requests, see Configuring the IPIC connection in the CICS Transaction Server documentation.
-
Create a server.
Enter the following command from the
<installation_path>/bin directory. For example,
/usr/lpp/IBM/zosconnect/v3r0/bin:
zosconnect create catalogManager --template=zosconnect:sampleCicsIpicCatalogManager
The
following artifacts are created:
- A catalog API service archive file, catalog.aar, in the directory
<WLP_USER_DIR>/servers/catalogManager/resources/zosconnect/apis.
- Three services archive files, inquireCatalog.sar,
inquireSingle.sar, and placeOrder.sar, in the directory
<WLP_USER_DIR>/servers/catalogManager/resources/zosconnect/services.
- A server.xml configuration file in the directory
<WLP_USER_DIR>/servers/catalogManager with the
zosconnect:cicsService-1.0
feature included.
-
Customize the IBM z/OS Connect server
configuration file.