Region status server, read interval parameter (READRS)
You use the region status server read interval parameter in the CPLEXDEF, CSYSDEF, and MAS views to control how long region status data is cached by a routing region before requesting a refresh for sysplex optimized workload routing.
READRS={200|number}
In a workload running in optimized mode, the READRS value specifies the minimum interval, in milliseconds, between refreshes of a target region status from a CICS region status (RS) server. These refresh requests are issued by a routing region that is evaluating a target region for a dynamic routing request.
- A value of 0 means that a routing region requests a status update of a target region on every occasion that it examines the status of the target region.
- Values from 1 - 2000 specify the minimum time interval that must expire before the status of a target region can be refreshed.
A low interval value means that the RS server is polled more often for a status update. For workloads in QUEUE mode, this low value results in a smoother task load spread across the CICS regions in the workload target scope, assuming all other health and link factors are equal. However, the utilization of the RS server is correspondingly increased, which might result in higher utilization of your z/OS coupling facility.
The default value of the READRS parameter is 200 milliseconds.
The value specified in the EYUSTARTCPLEXDEF view set sets the read interval at the CICSplex level. However, you can override the interval at the CICS definition level to allow fine tuning of the value on an individual CICS target region basis.
You specify both the UPDATERS and the READRS parameters at the CICSplex definition (CPLEXDEF) level to establish default values for all regions in the CICSplex. You can override these values at the CICS system definition (CSYSDEF) level or at the MAS agent runtime (MAS) level.
At the CICS definition level, the value for UPDATERS and READRS is INHERIT, so that the values are adopted from the CICS system definition. By changing these values to explicit numeric values, the CICS system adopts the values specified on each successive restart. To implement a change to a running CICS region, the values must be applied using the MAS base tables or view sets. When the target region is restarted, it reemploys the specification from its CSYSDEF.