To install and configure the CICS sockets interface
Add the IBM CICS sockets RDO entries to your CICS region. You can find input for DFHCSDUP in tcphlq.SEZAINST(EZACICCT), where tcphlq refers to the high-level qualifier of your system’s IBM TCP/IP configuration.
The Sybase listener program (SYBLSTNR)
must run in the CICS key and have concurrency set to THREADSAFE.
The listener TRANID (SY01) must have TASKDATALOC=ANY and TASKDATAKEY=CICS.
When you add listener definitions, Sybase suggests that you copy
the SY01 transaction definition.
Define the EZACONFG data set 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 Sybase listener (SY01) into the EZACONFG data set, using an online transaction or the IBM EZACICD utility, as shown:
EZACICD TYPE=LISTENER, Create Listener Record X APPLID=CICSDEV1 APPLID of CICS X TRANID=SY01, Use transaction ID X PORT=3044, Use port number 3044 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=YES Start listener immediately
For more information about EZACICD, refer to the z/OS Communications Server: IP CICS Sockets Guide.
The 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, which 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 time-out 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 a request is 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 “Customizing the 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. This user ID must have authority to use EXTRACT EXIT and SET FILE commands and the authority to start transactions. |
Assemble and link the SYBTPSEC configuration module.
