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
Specify the DFHXQMN program either in a SYSIN data set
defined in the JCL, or in the PARM parameter
on the EXEC statement.
Specify the mandatory and optional startup parameters for
the DFHXQMN program.
You must specify a SYSPRINT DD statement for the print
file.
You must specify a SYSIN DD statement for the server
parameters.
You must specify the TS pool name.
You must concatenate the license activation data set
(the SDFHLIC library) to the STEPLIB DD statement.
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.
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.