Storage - Domain Subpools reports
The storage subpool reports provide statistics about CICS® domain and task storage subpool allocations and use.
- Domain subpools, consisting of only those storage domain subpools that are allocated in the CICS, read-only, and shared dynamic storage areas (DSAs) (see CICS dynamic storage areas (DSAs) for a list of DSAs). 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 Reference: CICS subpools in CICS DSAs. Source field: SMDSPN |
| Location | The name of the DSA that the domain subpool is allocated
from. 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 dynamic storage areas (DSAs). 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 Reference: CICS subpools in CICS DSAs. Source field: SMDSPN |
| Location | The name of the DSA that the domain subpool is allocated
from. 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 |