When you start a region status server, you activate a pool
in an MVS™ image for that server.
Before you begin
Before you start a region status server region, you must define
the region status server structure to be used for the pool. For information
about defining a region status server list structure, see
Defining a list structure for a region status server.
About this task
You can start the server as a started task, started job,
or as a batch job. This task explains how to start a region status
server job, to run in an MVS batch
region. The job or task must start the region status server program,
DFHCFMN, from the CICS® authorized
library,
CICSTS54.CICS.SDFHAUTH.
Procedure
- Specify the DFHCFMN 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 DFHCFMN program. If you specify a startup parameter
in both the SYSIN data set and the PARM parameter,
the PARM value overrides the SYSIN value because
the MVS START command can override the PARM value.
- You must specify a SYSPRINT DD statement for the print
file.
- You must specify a SYSIN DD statement for the server
parameters.
Tip: To ensure that all pool-related
parameters are consistent across MVS images,
you must use the same SYSIN parameter data set, or an identical copy
of it, for all servers accessing the same pool, and to specify in
the PARM field any parameters that vary between servers.
- You must specify the region status pool name.
- You must concatenate the license activation data set
(the SDFHLIC library) to the STEPLIB DD statement.
- You can specify the REGION parameter. This parameter ensures that the coupling facility data table
server region has enough storage to process the maximum number of
data table requests that can run concurrently.
- You can 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 might 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 that the
server is to allocate. You might also need to add the required security
access. See Authorizing a CICS region to a coupling facility data table.
Results
The region status server is running, ready to receive and
broadcast region status data to the CICS regions
connected to it. The CICS regions
connect through the poolname that is specified in the CICSplex definition.
Region status server JCL example
Figure 1. Sample JCL to start a region status server address space//PRODRSS1 JOB ...
//RSSERVER EXEC PGM=DFHCFMN,REGION=40M,TIME=NOLIMIT CICS CFDT Server for RS
//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=DFHRSTAT Pool name
MAXTABLES=100 Allow up to 100 tables
/*
For an example of security parameters, see
Authorizing a CICS region to a coupling facility data table.