Loader domain statistics

This section contains the following statistics:

Loader domain: Global statistics

These statistics fields contain the global data collected by the loader domain. The loader domain maintains global statistics to assist the user in tuning and accounting.

These statistics can be accessed online using the EXEC CICS® COLLECT STATISTICS PROGRAM command, and are mapped by the DFHLDGDS DSECT. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.

Table 110. Loader domain: Global statistics -- All Areas
DFHSTUP name Field name Description
Library load requests LDGLLR is the number of times the loader has issued an MVS™ LOAD request to load programs from the DFHRPL library concatenation into CICS managed storage. Modules in the LPA are not included in this figure.

Reset characteristic: reset to zero

 

Total loading time LDGLLT is the time taken for the number of library loads indicated by LDGLLR. The DFHSTUP report expresses this time as hours:minutes:seconds.decimals; however, the DSECT field contains a 4-byte field which expresses the time in 16-microsecond units.

Reset characteristic: reset to zero

 

Average loading time is the average time to load a program. This value is calculated offline by DFHSTUP and hence is not available to online users. DFHSTUP expresses this time as hours:minutes:seconds.decimals.

Reset characteristic: none

 

Program uses LDGPUSES is the number of uses of any program by the CICS system.

Reset characteristic: not reset

 

Waiting requests LDGWLR is the number of loader domain requests that are currently forced to suspend due to the loader domain currently performing an operation on that program on behalf of another task. These operations could be:
  • A NEWCOPY request
  • Searching the LPA
  • A physical load in progress.

Reset characteristic: not reset

 

Requests that waited LDGWTDLR is the number of loader domain requests that were forced to suspend due to the loader domain performing an operation on that program on behalf of another task. These operations could be:
  • A NEWCOPY request
  • Searching the LPA
  • A physical load in progress.

This figure is the total number of tasks that have waited, and does not include those that are currently waiting (LDGWLR).

Reset characteristic: reset to zero

 

Peak waiting Loader requests LDGWLRHW is the maximum number of tasks suspended at one time.

Reset characteristic: reset to current value (LDGWLR)

 

Times at peak LDGHWMT is the number of times the high watermark level indicated by LDGWLRHW was reached.

This, along with the fields; LDGWTDLR and LDGWLRHW, is an indication of the level of contention for loader resource.

Reset characteristic: reset to 1

 

Total waiting time LDGTTW is the suspended time for the number of tasks indicated by LDGWTDLR. The DFHSTUP report expresses this time as hours:minutes:seconds.decimals; however, the DSECT field contains a 4-byte field which expresses the time in 16-microsecond units.

Reset characteristic: reset to zero

 

Times DFHRPL re-opened LDGDREBS is the number of times the loader received an end-of-extent condition during a LOAD and successfully closed and re-opened the DFHRPL library and retried the LOAD.

Reset characteristic: reset to zero

 

Loader domain: Global statistics -- CDSA
DFHSTUP name Field name Description
Programs removed by compression LDGDPSCR is the number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

Reset characteristic: reset to zero

 

Total Not In Use queue membership time LDGDPSCT is 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals; however, the DSECT field contains the time as a store clock (STCK) value.

Reset characteristic: reset to zero

 

Average Not In Use queue membership time is the average length of time that a program is eligible for removal from storage by the DPSC mechanism. This value is calculated by DFHSTUP.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals.

Reset characteristic: none

 

Reclaims from Not In Use queue LDGRNIU is 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).

Reset characteristic: reset to zero

 

Programs loaded but Not In Use LDGPNIU is the number of programs on the Not-In-Use (NIU) queue.

Reset characteristic: not reset

 

Amount of DSA occupied by Not In Use programs LDGCNIU is the current amount of CDSA storage which is occupied by Not-In-Use (NIU) programs.

Reset characteristic: not reset

 

Loader domain: Global statistics -- ECDSA
DFHSTUP name Field name Description
Programs removed by compression LDGDPSCR is the number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

Reset characteristic: reset to zero

 

Total Not In Use queue membership time LDGDPSCT is 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals; however, the DSECT field contains the time as a store clock (STCK) value.

Reset characteristic: reset to zero

 

Average Not In Use queue membership time is the average length of time that a program is eligible for removal from storage by the DPSC mechanism. This value is calculated by DFHSTUP.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals.

Reset characteristic: none

 

Reclaims from Not In Use queue LDGRNIU is 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).

Reset characteristic: reset to zero

 

Programs loaded but Not In Use LDGPNIU is the number of programs on the Not-In-Use (NIU) queue.

Reset characteristic: not reset

 

Amount of DSA occupied by Not In Use programs LDGCNIU is the current amount of ECDSA storage which is occupied by Not-In-Use (NIU) programs.

Reset characteristic: not reset

 

Loader domain: Global statistics -- SDSA
DFHSTUP name Field name Description
Programs removed by compression LDGDPSCR is the number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

Reset characteristic: reset to zero

 

Total Not In Use queue membership time LDGDPSCT is 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals; however, the DSECT field contains the time as a store clock (STCK) value.

Reset characteristic: reset to zero

 

Average Not In Use queue membership time is the average length of time that a program is eligible for removal from storage by the DPSC mechanism. This value is calculated by DFHSTUP.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals.

Reset characteristic: none

 

Reclaims from Not In Use queue LDGRNIU is 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).

Reset characteristic: reset to zero

 

Programs loaded but Not In Use LDGPNIU is the number of programs on the Not-In-Use (NIU) queue.

Reset characteristic: not reset

 

Amount of DSA occupied by Not In Use programs LDGCNIU is the current amount of SDSA storage which is occupied by Not-In-Use (NIU) programs.

Reset characteristic: not reset

 

Loader domain: Global statistics -- ESDSA
DFHSTUP name Field name Description
Programs removed by compression LDGDPSCR is the number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

Reset characteristic: reset to zero

 

Total Not In Use queue membership time LDGDPSCT is 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals; however, the DSECT field contains the time as a store clock (STCK) value.

Reset characteristic: reset to zero

 

Average Not In Use queue membership time is the average length of time that a program is eligible for removal from storage by the DPSC mechanism. This value is calculated by DFHSTUP.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals.

Reset characteristic: none

 

Reclaims from Not In Use queue LDGRNIU is 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).

Reset characteristic: reset to zero

 

Programs loaded but Not In Use LDGPNIU is the number of programs on the Not-In-Use (NIU) queue.

Reset characteristic: not reset

 

Amount of DSA occupied by Not In Use programs LDGCNIU is the current amount of ESDSA storage which is occupied by Not-In-Use (NIU) programs.

Reset characteristic: not reset

 

Loader domain: Global statistics -- RSDA
DFHSTUP name Field name Description
Programs removed by compression LDGDPSCR is the number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

Reset characteristic: reset to zero

 

Total Not In Use queue membership time LDGDPSCT is 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals; however, the DSECT field contains the time as a store clock (STCK) value.

Reset characteristic: reset to zero

 

Average Not In Use queue membership time is the average length of time that a program is eligible for removal from storage by the DPSC mechanism. This value is calculated by DFHSTUP.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals.

Reset characteristic: none

 

Reclaims from Not In Use queue LDGRNIU is 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).

Reset characteristic: reset to zero

 

Programs loaded but Not In Use LDGPNIU is the number of programs on the Not-In-Use (NIU) queue.

Reset characteristic: not reset

 

Loader domain: Global statistics -- ERDSA
DFHSTUP name Field name Description
Programs removed by compression LDGDPSCR is the number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

Reset characteristic: reset to zero

 

Total Not In Use queue membership time LDGDPSCT is 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals; however, the DSECT field contains the time as a store clock (STCK) value.

Reset characteristic: reset to zero

 

Average Not In Use queue membership time is the average length of time that a program is eligible for removal from storage by the DPSC mechanism. This value is calculated by DFHSTUP.

The DFHSTUP report expresses this time as hours:minutes:seconds.decimals.

Reset characteristic: none

 

Reclaims from Not In Use queue LDGRNIU is 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).

Reset characteristic: reset to zero

 

Programs loaded but Not In Use LDGPNIU is the number of programs on the Not-In-Use (NIU) queue.

Reset characteristic: not reset

 

Amount of DSA occupied by Not In Use programs LDGCNIU is the current amount of ERDSA storage which is occupied by Not-In-Use (NIU) programs.

Reset characteristic: not reset

 

Loader domain: Summary global statistics

Summary statistics are not available online.

These statistics fields contain the summary global data for the loader.

Table 111. Loader domain: Summary global statistics
DFHSTUP name Description
Library load requests is the total number of times the loader has issued an MVS LOAD request to load programs from the DFHRPL library concatenation into CICS managed storage. Modules in the LPA are not included in this figure.

 

Total loading time is the total time taken for the number of library loads indicated by 'Library load requests'. The DFHSTUP report expresses this time as days-hours:minutes:seconds.decimals.

 

Average loading time is the average time to load a program from the DFHRPL library concatenation into CICS managed storage. This value is expressed as minutes:seconds.decimals.

 

Program uses is the total number of uses of any program by the CICS system.

 

Requests that waited is the total number of loader domain requests that were forced to suspend due to the loader domain performing an operation on that program on behalf of another task. These operations could be:
  • A NEWCOPY request
  • Searching the LPA
  • A physical load in progress.

 

Peak waiting Loader requests is the peak number of tasks suspended at one time.

 

Times at peak is the total number of times the peak level indicated by the previous statistic was reached.

This, along with the previous 2 values, is an indication of the level of contention for loader resource.

 

Total waiting time is the total suspended time for the number of tasks indicated by the "Requests that waited" statistic. The DFHSTUP report expresses this time as days-hours:minutes:seconds.decimals.

 

Times DFHRPL re-opened is the total number of times the loader received an end-of-extent condition during a LOAD and successfully closed and re-opened the DFHRPL library and retried the LOAD.

 

CDSA

 

Programs removed by compression is the total number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

 

Total Not In Use queue membership time is the total 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as days-hours:minutes:seconds.decimals.

 

Average Not In Use queue membership time is the average time between a program becoming eligible for removal from storage by the DPSC and the actual time of its removal from storage. This statistic is expressed in minutes:seconds.decimals.

 

Reclaims from Not In Use queue is the total 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).

 

Programs loaded but Not In Use is the total number of programs on the Not-In-Use (NIU) queue.

 

ECDSA

 

Programs removed by compression is the total number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

 

Total Not In Use queue membership time is the total 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as days-hours:minutes:seconds.decimals.

 

Average Not In Use queue membership time is the average time between a program becoming eligible for removal from storage by the DPSC and the actual time of its removal from storage. This statistic is expressed in minutes:seconds.decimals.

 

Reclaims from Not In Use queue is the total 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).

 

Programs loaded but Not In Use is the total number of programs on the Not-In-Use (NIU) queue.

 

SDSA

 

Programs removed by compression is the total number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

 

Total Not In Use queue membership time is the total 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as days-hours:minutes:seconds.decimals.

 

Average Not In Use queue membership time is the average time between a program becoming eligible for removal from storage by the DPSC and the actual time of its removal from storage. This statistic is expressed in minutes:seconds.decimals.

 

Reclaims from Not In Use queue is the total 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).

 

Programs loaded but Not In Use is the total number of programs on the Not-In-Use (NIU) queue.

 

ESDSA

 

Programs removed by compression is the total number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

 

Total Not In Use queue membership time is the total 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as days-hours:minutes:seconds.decimals.

 

Average Not In Use queue membership time is the average time between a program becoming eligible for removal from storage by the DPSC and the actual time of its removal from storage. This statistic is expressed in minutes:seconds.decimals.

 

Reclaims from Not In Use queue is the total 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).

 

Programs loaded but Not In Use is the total number of programs on the Not-In-Use (NIU) queue.

 

RDSA

 

Programs removed by compression is the total number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

 

Total Not In Use queue membership time is the total 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as days-hours:minutes:seconds.decimals.

 

Average Not In Use queue membership time is the average time between a program becoming eligible for removal from storage by the DPSC and the actual time of its removal from storage. This statistic is expressed in minutes:seconds.decimals.

 

Reclaims from Not In Use queue is the total 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).

 

Programs loaded but Not In Use is the total number of programs on the Not-In-Use (NIU) queue.

 

ERDSA

 

Programs removed by compression is the total number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) mechanism.

 

Total Not In Use queue membership time is the total 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 CICS run time. This field does not include the wait time for those programs reclaimed from the Not-In-Use queue.

The DFHSTUP report expresses this time as days-hours:minutes:seconds.decimals.

 

Average Not In Use queue membership time is the average time between a program becoming eligible for removal from storage by the DPSC and the actual time of its removal from storage. This statistic is expressed in minutes:seconds.decimals.

 

Reclaims from Not In Use queue is the total 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).

 

Programs loaded but Not In Use is the total number of programs on the Not-In-Use (NIU) queue.

 

Related reference
Back to full list of statistics and DFHSTUP reports
Appendix A. CICS statistics tables
Interpreting these statistics
Interpreting loader statistics
DFH0STAT reports for these statistics
Loader and Program Storage Report
[[ Contents Previous Page | Next Page Index ]]