Shared resources control (SHRCTL) block
The SHRCTL block represents the CICS region's requirements of, and the use made of, a local shared resources pool (LSRPOOL). It is used by DFHFCL when calling VSAM to build an LSRPOOL. It is also used by DFHFCL and statistics programs to hold and update file control statistics.
It lasts for the lifetime of a CICS run, and is addressable through a pointer in file control static storage. There are two hundred and fifty five pointers collectively named the SHRCTL vector.
A SHRCTL block holds information such as how many virtual and hyperspace buffers of a particular size are needed, how many strings are needed, the maximum key length allowed. CICS passes this information to VSAM when the pool is built. It also holds statistics about the pool which are sent to the statistics domain when requested or when the pool is deleted.
Each SHRCTL block represents one LSRPOOL, and there can be up to two hundred and fifty five SHRCTL blocks. The layout of each SHRCTL block is defined by the DFHFCTLS structure and by the DFHFCTSR DSECT, and they reside above the 16MB line.
- Builds a SHRCTL block for each LSRPOOL definition using user-specified information
- Catalogs each created SHRCTL block in the CICS global catalog.
- DFHFCRP restores all previously created SHRCTL blocks from the global catalog.
- For LSR pools that do not have an explicit definition, but which are implicitly defined by CICS when the first file using the pool is open, CICS creates the SHRCTL block at this time. It is catalogued and will be recovered by DFHFCRP on a warm or emergency restart.