Defining and starting a region status server region

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

  1. Specify the DFHCFMN 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 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.
    1. You must specify a SYSPRINT DD statement for the print file.
    2. 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.
    3. You must specify the region status pool name.
    4. You must concatenate the license activation data set (the SDFHLIC library) to the STEPLIB DD statement.
    5. 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.
    6. 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.
    7. 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.


dfha2_def_rs_server_region.html | Timestamp icon Last updated: Sunday, 4 June 2017