Loader and Program Storage report
The Loader and Program Storage report is produced using a combination of the EXEC CICS EXTRACT STATISTICS PROGRAM and EXEC CICS EXTRACT STATISTICS STORAGE commands. The statistics data is mapped by the DFHLDGDS and DFHSMDDS DSECT.
| Field Heading | Description |
|---|---|
| LIBRARY Load requests | The number of times
the loader issued an MVS™ LOAD
request to load programs from the DFHRPL or dynamic LIBRARY concatenation
into CICS® managed storage.
Modules in the LPA are not included in this value. The value
includes both program load requests that ran on open TCBs, and program
load requests that used the RO (resource-owning) TCB. Source field: LDGLLR |
| LIBRARY Load Rate per second | The number of times
per second the loader has issued an MVS LOAD
request to load programs from the DFHRPL or dynamic LIBRARY concatenation
into CICS managed storage.
Modules in the LPA are not included in this value. The value
includes both program load requests that ran on open TCBs, and program
load requests that used the RO (resource-owning) TCB. Source field: LDGLLR / Elapsed seconds (since the last statistics reset) |
| LIBRARY Load requests on the RO TCB | The number of times
the loader issued a program load request that used the RO (resource-owning)
TCB. This value is a subset of the number of library loads shown by LIBRARY Load requests. To calculate the number of program load requests that ran on open TCBs, subtract this value from the value shown by LIBRARY Load requests. Source field: LDGLLRRO |
| Total LIBRARY Load time | The total time taken
to load programs from the DFHRPL or dynamic LIBRARY concatenation
into CICS managed storage.
Modules in the LPA are not included in this value. The value includes
both program load requests that ran on open TCBs, and program load
requests that used the RO (resource-owning) TCB. Source field: LDGLLT |
| Total LIBRARY Load time on the RO TCB | The total time taken
for program load requests that ran on the RO TCB. This value is a
subset of the number of library loads shown by Total LIBRARY Load time. To calculate the number of program load requests that ran on open TCBs, subtract this value from the value shown by Total LIBRARY Load time. Source field: LDGLLTRO |
| Average LIBRARY Load time | The average time taken
to load a program. The value is an average including both program
load requests that ran on open TCBs, and program load requests that
used the RO (resource-owning) TCB. Source field: (LDGLLT / LDGLLR) |
| Total Program Uses | The number of uses
of any program by the CICS system.
Source field: LDGPUSES |
| Average LIBRARY Load time on the RO TCB | The average time taken
to complete only those program load requests that used the RO (resource-owning)
TCB. Source field: (LDGLLT / LDGLLR) |
| Program Use to Load Ratio | The ratio of program
uses to programs loads. Source field: (LDGPUSES / LDGLLR) |
| LIBRARY Load requests that waited | The number of loader
domain requests that waited for the loader domain to complete an operation
on the program on behalf of another task. This figure is the number
of tasks that waited in the past, and does not include tasks that
are currently waiting (Current Waiting LIBRARY Load requests). Program load requests might wait for the following reasons:
Source field: LDGWTDLR |
| Total LIBRARY Load request wait time | The total suspended
time for the number of tasks shown in LIBRARY Load requests that waited. Source field: LDGTTW |
| Times LIBRARY secondary extents detected | The number of times
the loader received an end-of-extent condition during a LOAD and successfully
closed and reopened the DFHRPL or dynamic LIBRARY and retried
the LOAD. Source field: LDGDREBS |
| Average LIBRARY Load request wait time | The average loader
domain request suspend time. Source field: (LDGTTW / LDGWTDLR) |
| Current Waiting LIBRARY Load requests | The number of loader
domain requests that are currently waiting for the loader domain to
complete an operation on the program on behalf of another task. Program
load requests might wait for the following reasons:
Source field: LDGWLR |
| Peak Waiting LIBRARY Load requests | The maximum number
of tasks suspended at one time. Source field: LDGWLRHW |
| Times at Peak | The number of times
the high-water mark shown in Peak Waiting LIBRARY Load requestswas reached. This value together with the previous two values indicate the level of contention for loader resource. Source field: LDGHWMT |
| Average Not-In-Use program size | The average size of
a program currently on the Not-In-Use queue. Source field: ((LDGSTGNIU + LDGSNIU + LDGRECNIU + LDGECNIU + LDGESNIU + LDGERNIU) / 1024) / LDGPROGNIU) |
| Programs Removed by compression | The number of program
instances removed from storage by the Dynamic Program Storage Compression
(DPSC) mechanism. Source field: LDGDPSCR |
| Time on the Not-In-Use Queue | The program Not-In-Use
(NIU) queue membership time. For each program that becomes eligible
for removal from storage by the DPSC mechanism, the time between the
program becoming eligible and the actual time of its being removed
from storage is calculated. This field is the sum of these times for
all programs removed by the DPSC mechanism and as such can be greater
than the elapsed time CICS run
time. This field does not include the wait time for those programs
reclaimed from the Not-In-Use queue. Source field: LDGDPSCT |
| Average Time on the Not-In-Use Queue | The average length
of time that a program is eligible for removal from storage by the
DPSC mechanism. Source field: (LDGDPSCT / LDGDPSCR) |
| Programs Reclaimed from the Not-In-Use Queue | The number of reclaims
that CICS has made from the
Not-In-Use (NIU) queue. Reclaims occur when a request is issued for
programs currently in the Not-In-Use queue. The reclaimed instance
of a program is no longer eligible for program compression (DPSC).
Source field: LDGRECNIU |
| Programs Loaded - on the Not-In-Use Queue | The number of programs
on the Not-In-Use (NIU) queue. Source field: LDGPROGNIU |
| LIBRARY search order updates | The number of updates to the LIBRARY search
order. Source field: LDGLBSOU |
| Total LIBRARY search order update time | The total time spent updating the LIBRARY search
order. Source field: LDGLSORT |
| Average LIBRARY search order update time | The average time spent updating the LIBRARY
search order. Source field: LDGLSORT/LDGLBSOU |
| Load requests waited - search order update | The total number of waits for programs to load
while the search order is being updated. These operations could be:
Source field: LDGLWSOU |
| Field Heading | Description |
|---|---|
| Nucleus Program Storage (CDSA) | The current amount
of storage allocated to nucleus programs in the CDSA. Source field: (SMDCPS for subpool 'LDNUC ' and 'LDNRS / 1024) |
| Nucleus Program Storage (ECDSA) | The current amount
of storage allocated to nucleus programs in the ECDSA. Source field: (SMDCPS for subpool 'LDENUC ' and 'LDENRS ' / 1024) |
| Program Storage (SDSA) | The current amount
of storage allocated to programs in the SDSA. Source field: (SMDCPS for subpool 'LDPGM ' / 1024) |
| Program Storage (ESDSA) | The current amount
of storage allocated to programs in the ESDSA. Source field: (SMDCPS for subpool 'LDEPGM ' / 1024) |
| Resident Program Storage (SDSA) | The current amount
of storage allocated to resident programs in the SDSA. Source field: (SMDCPS for subpool 'LDRES ' / 1024) |
| Resident Program Storage (ESDSA) | The current amount
of storage allocated to resident programs in the ESDSA. Source field: (SMDCPS for subpool 'LDERES ' / 1024) |
| Read-Only Nucleus Program Storage (RDSA) | The current amount
of storage allocated to nucleus programs in the RDSA. Source field: (SMDCPS for subpool 'LDNUCRO ' and 'LDNRSRO ' / 1024) |
| Read-Only Nucleus Program Storage (ERDSA) | The current amount
of storage allocated to nucleus programs in the ERDSA. Source field: (SMDCPS for subpool 'LDENUCRO ' and 'LDENRSRO ' / 1024) |
| Read-Only Program Storage (RDSA) | The current amount
of storage allocated to programs in the RDSA. Source field: (SMDCPS for subpool 'LDPGMRO ' / 1024) |
| Read-Only Program Storage (ERDSA) | The current amount
of storage allocated to programs in the ERDSA. Source field: (SMDCPS for subpool 'LDEPGMRO ' / 1024) |
| Read-Only Resident Program Storage (RDSA) | The current amount
of storage allocated to resident programs in the RDSA. Source field: (SMDCPS for subpool 'LDRESRO ' / 1024) |
| Read-Only Resident Program Storage (ERDSA) | The current amount
of storage allocated to resident programs in the ERDSA. Source field: (SMDCPS for subpool 'LDERESRO ' / 1024) |
| CDSA used by Not-In-Use programs | The current amount
of CDSA storage that is occupied by Not-In-Use (NIU) programs. Source field: (LDGSTGNIU(1) / 1024) |
| ECDSA used by Not-In-Use programs | The current amount
of ECDSA storage that is occupied by Not-In-Use (NIU) programs. Source field: (LDGSTGNIU(2) / 1024) |
| SDSA used by Not-In-Use programs | The current amount
of SDSA storage that is occupied by Not-In-Use (NIU) programs. Source field: (LDGSTGNIU(3) / 1024) |
| ESDSA used by Not-In-Use programs | The current amount
of ESDSA storage that is occupied by Not-In-Use (NIU) programs. Source field: (LDGSTGNIU(4) / 1024) |
| RDSA used by Not-In-Use programs | The current amount
of RDSA storage that is occupied by Not-In-Use (NIU) programs. Source field: (LDGSTGNIU(5) / 1024) |
| ERDSA used by Not-In-Use programs | The current amount
of ERDSA storage that is occupied by Not-In-Use (NIU) programs. Source field: (LDGSTGNIU(6) / 1024) |