Storage - Domain Subpools reports
The storage subpool reports provide statistics about CICS® domain and task storage subpool allocations and use.
The subpool reports are in two parts:
- Domain subpools, consisting of only those storage domain subpools that are allocated in the CICS, read-only, and shared dynamic storage areas (DSAs), that is, the CDSA, RDSA, SDSA, ECDSA, ERDSA, ESDSA, ETDSA, GCDSA, and GSDSA. The information for this report is collected by using the EXEC CICS INQUIRE SUBPOOL and EXEC CICS COLLECT STATISTICS SUBPOOL commands. The domain subpools are split into two reports, with some shared fields, to represent all domain subpools information.
- Task subpools, consisting of only those subpools allocated for user task lifetime storage. The information for this report is collected using the EXEC CICS COLLECT STATISTICS TASKSUBPOOL command.
| Field Heading | Description |
|---|---|
| Subpool Name | The unique 8-character name of
the domain subpool. The values of the domain subpool field are described
in CICS subpools. Source field: SMDSPN |
| Location | The name of the DSA that the
domain subpool is allocated from. Values can be CDSA, SDSA, RDSA,
ECDSA, ESDSA, ERDSA, ETDSA, GCDSA, or GSDSA. Source field: SMDDSANAME |
| Access | The type of access of the subpool. Values are CICS, READONLY, or TRUSTED. If
storage protection is not active, storage areas revert to an access
type of CICS, except for those
in the RDSA or ERDSA.
Source field: SMDACCESS |
| Element Type | Indicates whether all elements in the subpool
are fixed length or variable length. Source field: SMDETYPE |
| Element Length | The length of each subpool element (applicable to fixed length subpools only). For further information about subpool elements, see CICS subpools. Source field: SMDFLEN |
| Initial Free | The total number of kilobytes of the elements
that are initially allocated when the domain subpool is preallocated. Source field: SMDIFREE |
| Current Elements | The current number of storage
elements in the subpool. The number of
elements remaining after FREEMAIN requests; that is, it is the difference between the number of
GETMAIN and FREEMAIN requests. Source field: SMDCELEM |
| Current Element Stg | The sum of the lengths of all
the elements in the subpool, expressed in bytes. Source field: SMDCES |
| Current Page Stg | The space taken by all the pages
allocated to the subpool, expressed in bytes (or megabytes for 64-bit
(above-the-bar) storage). Source field: SMDCPS |
| % of DSA | The current element storage of the subpool as
a percentage of the DSA in which it resides. This field does not apply to the GCDSA or GSDSA. Source field: ((SMDCPS / dsasize) * 100) |
| Peak Page Stg | The peak page storage allocated
to support the storage requirements of this subpool, expressed in
bytes (or megabytes for 64-bit (above-the-bar) storage). Source field: SMDHWMPS |
| Field Heading | Description |
|---|---|
| Subpool Name | The unique 8-character name of
the domain subpool. The values of the domain subpool field are described
in CICS subpools. Source field: SMDSPN |
| Location | The name of the DSA that the
domain subpool is allocated from. Values can be CDSA, SDSA, RDSA,
ECDSA, ESDSA, ERDSA, ETDSA, GCDSA, or GSDSA. Source field: SMDDSANAME |
| Getmain Requests | The total number of GETMAIN
requests for the subpool. Source field: SMDGMREQ |
| Freemain Requests | The total number of FREEMAIN
requests for the subpool. Source field: SMDFMREQ |
| Current Element Stg | The sum of the lengths of all
the elements in the subpool, expressed in bytes. Source field: SMDCES |
| Current Page Stg | The space taken by all the pages
allocated to the subpool, expressed in bytes (or megabytes for 64-bit
(above-the-bar) storage). Source field: SMDCPS |
| Peak Page Stg | The peak page storage allocated
to support the storage requirements of this subpool, expressed in
bytes (or megabytes for 64-bit (above-the-bar) storage). Source field: SMDHWMPS |
| Field Heading | Description |
|---|---|
| DSA Name | The abbreviated name of the CICS dynamic storage area to which the subpool
totals apply. Source field: SMDSANAME |
| Number of Subpools | The total number of subpools in this DSA. |
| Getmain Requests | The total number of GETMAIN requests for subpools
in this DSA. Source field: Total of SMDGMREQ values for each DSA. |
| Freemain Requests | The total number of FREEMAIN requests for subpools
in this DSA. Source field: Total of SMDFMREQ values for each DSA. |
| Current Elements | The total number of elements remaining after FREEMAIN requests; that is, the
difference between the total number of GETMAIN and FREEMAIN requests. Source field: Total of all SMDCELEM values for each DSA |
| Current Element Stg | The total amount of storage of the current elements,
expressed in bytes. Source field: Total of all SMDCES values for each DSA. |
| Current Page Stg | The total amount of subpool page storage
for all DSAs, expressed in kilobytes (or megabytes for 64-bit (above-the-bar)
storage). Source field: Total of all SMDCPS values for each DSA. |
| % of DSA | The current element storage of all the subpools
as a percentage of the DSA in which they reside. This field does not apply to the GCDSA or GSDSA. Source: ((Total of all SMDCPS values / dsasize) * 100) |
| % of DSA Limit | The current element storage of all the subpools
as a percentage of the limit of DSA in which they reside. This field does not apply to the GCDSA or GSDSA. Source: ((Total of all SMDCPS values / dsalimit) * 100) |
| Field Heading | Description |
|---|---|
| Subpool Name | The name of the DSA page pool that contains
the task storage. Source field: SMDSPN |
| Access | The type of access
of the subpool. Access type can be CICS (key 8) or USER (key 9). Source field: SMTACCESS |
| Getmain Requests | The total number
of task subpool GETMAIN requests from this dynamic storage area. That
is, the number of GETMAIN requests issued for this subpool. Source field: SMTGMREQ |
| Freemain Requests | The total number
of task subpool FREEMAIN requests from this dynamic storage area.. That
is, the number of FREEMAIN requests issued for this subpool. Source field: SMTFMREQ |
| Current Elements | The number of elements
in all the task subpools in this dynamic storage area. That is, the number
of elements remaining after FREEMAIN requests (the difference between the number of GETMAIN and
FREEMAIN requests). Source field: SMTCNE |
| Current Element Stg | The sum of the storage
occupied by all elements in task subpools in this dynamic storage
area, expressed in bytes. Source field: SMTCES |
| Average Element Size | The average size in bytes of an element. Source field: (SMTCES / SMTCNE) |
| Current Page Stg | The sum of the storage
in all pages allocated to task subpools in this dynamic storage area. This value
is expressed in kilobytes. Source field: SMTCPS |
| % of DSA | The current element storage of the subpool as
a percentage of the DSA in which it resides. Source field: ((SMTCPS / dsasize) * 100) |
| Peak Page Stg | The peak page storage
allocated to support task storage activity in this dynamic storage
area. This
value is expressed in kilobytes. Source field: SMTHWMPS |