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 COLLECT STATISTICS PROGRAM SPI command, and are mapped by the DFHLDGDS DSECT.

Table 1. Loader domain: Global statistics — All Areas
DFHSTUP name Field name Description
Library load requests LDGLLR 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. Start of changeThe value includes both program load requests that ran on open TCBs, and program load requests that used the RO (resource-owning) TCB.End of change

Reset characteristic: reset to zero

 

Start of changeLibrary load requests on the RO TCBEnd of change Start of changeLDGLLRROEnd of change Start of changeThe 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 LDGLLR. To calculate the number of program load requests that ran on open TCBs, subtract this value from the value shown by LDGLLR.

Reset characteristic: reset to zero

 

End of change
Total loading time LDGLLT The time taken for the number of library loads shown by LDGLLR. Start of changeThe value includes both program load requests that ran on open TCBs, and program load requests that used the RO (resource-owning) TCB.End of change

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

 

Start of changeTotal loading time on the RO TCBEnd of change Start of changeLDGLLTROEnd of change Start of changeThe time taken for the number of library loads shown by LDGLLRRO. This value is a subset of the time shown by LDGLLT. To calculate the time taken for program load requests that ran on open TCBs, subtract this value from the value shown by LDGLLT.

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

 

End of change
Average loading time   The average time taken to load a program. Start of changeThe 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.End of change 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

 

Start of changeAverage loading time on the RO TCBEnd of change Start of change End of change Start of changeThe average time taken to complete only those program load requests that used the RO (resource-owning) TCB. 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

 

End of change
Program uses LDGPUSES The number of uses of any program by the CICS system.

Reset characteristic: not reset

 

Waiting requests LDGWLR 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:
  • Start of changeThe program is being loaded by another task that is running on an open TCB.End of change
  • The loader domain is searching the link pack area (LPA) for the program.
  • A NEWCOPY request or physical load is in progress for the program.

Reset characteristic: not reset

 

Requests that waited LDGWTDLR 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 (LDGWLR). Program load requests might wait for the following reasons:
  • Start of changeThe program is being loaded by another task that is running on an open TCB.End of change
  • The loader domain is searching the link pack area (LPA) for the program.
  • A NEWCOPY request or physical load is in progress for the program.

Reset characteristic: reset to zero

 

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

Reset characteristic: reset to current value (LDGWLR)

 

Times at peak LDGHWMT The number of times the high-water mark 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 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 The number of times the loader received an end-of-extent condition during a load operation, and successfully closed and re-opened the DFHRPL or dynamic LIBRARY concatenation and retried the load operation.

Reset characteristic: reset to zero

 

Loader domain: Global statistics — CDSA
DFHSTUP name Field name Description
Programs removed by compression LDGDPSCR 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 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   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 LDGRECNIU 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 LDGPROGNIU The number of programs on the Not-In-Use (NIU) queue.

Reset characteristic: not reset

 

Amount of DSA occupied by Not In Use programs LDGSTGNIU 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 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 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   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 LDGRECNIU 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 LDGPROGNIU The number of programs on the Not-In-Use (NIU) queue.

Reset characteristic: not reset

 

Amount of DSA occupied by Not In Use programs LDGSTGNIU 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 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 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   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 LDGRECNIU 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 LDGPROGNIU The number of programs on the Not-In-Use (NIU) queue.

Reset characteristic: not reset

 

Amount of DSA occupied by Not In Use programs LDGSTGNIU 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 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 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   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 LDGRECNIU 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 LDGPROGNIU The number of programs on the Not-In-Use (NIU) queue.

Reset characteristic: not reset

 

Amount of DSA occupied by Not In Use programs LDGSTGNIU 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 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 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   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 LDGRECNIU 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 LDGPROGNIU 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 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 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   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 LDGRECNIU 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 LDGPROGNIU The number of programs on the Not-In-Use (NIU) queue.

Reset characteristic: not reset

 

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

Reset characteristic: not reset

 



dfht3_stats_loader_global.html | Timestamp icon Last updated: Thursday, 27 June 2019