This document covers the following topics:

• Installation under z/OS

• Configuration

Prerequisites for all EntireX components are described centrally. See z/OS Prerequisites.

---

Installation under z/OS

Execute job EXPINSTL located in the EXX107 data set. This will install the CICS Socket Listener with all relevant CSD entries. This job:

• installs the load modules EXXRFEC, EXXRFECX, EXXRFECU, EXXRFECA and EXXRFECS

• creates the following CICS CSD definitions:

  • program definitions for the load modules EXXRFEC, EXXRFECX, EXXRFECU, EXXRFECA and EXXRFECS, where definition for EXXRFECS needs EXECKEY(CICS)

  • transaction XRFE, which is the standard transaction name that can be maintained with the RPC Server or Adapter configuration. If you need to change this CSD entry default, you also need to adapt the configuration parameter CICS transaction ID. More information:

    • if you are using the EntireX Adapter, see Connection Parameters for CICS Socket Listener Connections

    • if you are using the RPC Server for CICS Socket Listener, see Configuring an RPC Server Instance > CICS using the Command Central GUI | Command Line

To run the CICS programs in a separate user transaction

1. Define your user transaction ID in the RPC Server for CICS Socket Listener, for example:

   cics.sl.user.transaction.id=UTSK

   For more information see Configuring the CICS Socket Listener Side in the RPC Server for CICS Socket Listener documentation.

2. Create the CSD for the user transaction ID.

3. In this CSD definition, specify EXXRFECU for the PROGRAM attribute. To define, for example, UTSK as user transaction ID, use the following commands:

   DEFINE TRANSACTION(UTSK) GROUP(...)
   DESCRIPTION(CICS Socket Listener user transaction)
   PROGRAM(EXXRFECU)

Configuration

For configuration, refer to Preparing for CICS Socket Listener (EntireX Adapter | RPC Server for CICS Socket Listener).