Defining TS server regions

A shared TS pool consists of an XES list structure, which is accessed through a cross-memory queue server region. You start a shared TS pool in an MVS™ image by starting up a queue server region for that pool.

About this task

To start the TS server region for a shared TS pool, you can use either a batch job or a started task. The job or task must invoke the queue server region program, DFHXQMN, which is in an APF-authorized library.

Procedure

  1. Specify the DFHXQMN program either in a SYSIN data set defined in the JCL, or in the PARM parameter on the EXEC statement.
  2. Specify the mandatory and optional startup parameters for the DFHXQMN program.
    1. You must specify a SYSPRINT DD statement for the print file.
    2. You must specify a SYSIN DD statement for the server parameters.
    3. You must specify the TS pool name.
    4. You must concatenate the license activation data set (the SDFHLIC library) to the STEPLIB DD statement.
    5. It is recommended that you specify TIME=NOLIMIT.
      The server task remains in a wait during most normal processing, because server processing is performed under the TCB of the client CICS region. If you omit this parameter, your server job could fail with abend S522 (wait limit exceeded), depending on the JWT value specified in the SMFPRMxx member of SYS1.PARMLIB.
    6. Specify additional parameters as required.
      For example, you might want to control the maximum number of queues that are to be supported in the pool and the number of buffers the server is to allocate.

Sample startup job for a TS server

Figure 1 shows an example of the JCL you might use to start a TS server.
Figure 1. Sample startup job for a TS queue server
//PRODTSQ1 JOB  ...
//TSSERVER EXEC PGM=DFHXQMN,REGION=64M,TIME=NOLIMIT Start TS data sharing server
//STEPLIB  DD   DSN=CICSTS54.CICS.SDFHAUTH,DISP=SHR    Authorized library
//         DD   DSN=CICSTS54.CICS.SDFHLIC,DISP=SHR     License activation data set
//SYSPRINT DD   SYSOUT=*        Messages and statistics
//SYSIN    DD   *
POOLNAME=PRODTSQ1               Pool name
MAXQUEUES=5000                  Allow up to 5000 large queues
BUFFERS=1000                    1000 buffers (32K each, 32M total)
/*