Using the IBM CICS sockets interface and the new Sybase TCP/IP listener for Mainframe Connect Server Option for CICS requires:
Installing IBM and Sybase RDO definitions for the required programs and transactions.
Concatenating the new sockets load library.
Configuring new listeners. You can install any number of new Sybase TCP/IP listeners and run them in a single CICS region. You can also configure each listener differently.
Enabling CICS sockets interface automatically or by using the EZAO command.
To install and configure the Server Option of
CICS sockets interface
Add the IBM CICS sockets RDO entries to your CICS region. You can find input for DFHCSDUP in tcphlq.SEZAINST(EZACICCT). Note that tcphlq refers to the high level qualifier of your system’s IBM TCP/IP configuration.
Add the new Sybase RDO entries. Input for the DFHCSDUP command is located in hlq.ESD2.OSC126.CICS.JCL(I2SOCRDO).
The Sybase listener program (SYBLSTNR)
must run in the CICS key and have concurrency set to THREADSAFE.
The listener tranid (SY01) is required to have TASKDATALOC set
to ANY and TASKDATAKEY set
to CICS. When adding listener definitions, Sybase
suggests that you copy the SY01 transaction definition.
Define the EZACONFG dataset to contain the configuration data for CICS sockets and load the system configuration parameters. You can find IBM-supplied JCL for this in tcphlq.SEZAINST(EZACICFG).
Add tcphlq.SEZATCP into the DFHRPL concatenation for the CICS region.
Add the configuration information for the first new Sybase listener (SY01) into the EZACONFG dataset. To do this, you can use the IBM EZACICD utility or an online transaction. A sample of EZACICD is shown in the following example:
EZACICD TYPE=LISTENER, Create Listener Record X APPLID=CICSDEV1 APPLID of CICS X TRANID=SY01, Use standard transaction ID X PORT=3044, Use port number 3010 X BACKLOG=40, Set backlog value to 40 X ACCTIME=30, Set timeout value to 30 seconds X NUMSOCK=100, Support 99 concurrent connections X SECEXIT=SYBTPSEC, X USERID=DFHCICS, X IMMED=NO Start listener immediately
For more information about using EZACICD, refer to z/OS Communications Server: IP CICS Sockets Guide.
The new Sybase TCP/IP listener uses the following IBM parameters:
APPLID |
The CICS region APPLID where the listener is run. |
TRANID |
The transaction ID defined for the listener. Each listener must have its own unique transaction ID. Sybase recommends using SY01, SY02, SY03 and so on. |
PORT |
The listener port number. |
IMMEDIATE |
The listener starts automatically when CICS sockets is started. |
BACKLOG |
Backlog value for the listener. |
NUMSOCK |
The size of the listener’s socket pool (“Max Sockets”). |
ACCTIME |
The timeout value of the accept select logic. The listener normally waits until action is pending for any of the sockets that it is currently managing. After processing pending actions, it also checks to see if there is a request pending to shut down the listener. If the ACCTIME value is reached, the listener checks for pending shutdown requests. |
SECEXIT |
The Sybase security extensions configuration module name (see “SYBTPSEC configuration module”). |
USERID |
The user ID that starts the listener. The listener issues the EXTRACT EXIT and SET FILE commands, and starts transactions with a surrogate user ID. The user ID specified must have authority to use EXTRACT EXIT and SET FILE commands, as well as the authority to start transactions. |
Assemble and link the SYBTPSEC configuration module. For more information about the SYBTPSEC configuration module, see “SYBTPSEC configuration module”.
Concatenate the hlq.OSC.CICS.LOADSOK sockets load library before all Sybase libraries in the CICS DFHRPL concatenation.
