Files: Summary statistics - requests information

File requests summary statistics are not available online.

Table 1. Files: Summary statistics - requests information
DFHSTUP name Description
File name is the name you specified in:
  • The DEFINE FILE command of resource definition online
  • (for BDAM files only) The TYPE=FILE, FILE operand of the DFHFCT macro.

 

Get requests is the total number of GET requests issued against this file.

 

Get upd requests is the total number of GET UPDATE requests issued against this file.

 

Browse requests is the total number of GETNEXT and GETPREV requests issued against this file.

 

Update requests is the total number of PUT UPDATE requests issued against this file.

 

Add requests is the total number of PUT requests issued against this file.

 

Delete requests is the total number of DELETE requests issued against this file.

 

Brws upd requests is the total number of READNEXT UPDATE and READPREV UPDATE requests issued against this file (RLS only).

 

VSAM EXCP request: Data A value is printed if the file has been opened and used as a VSAM KSDS during the CICS® run. See notes 1, 2 and 3.

 

VSAM EXCP request: Index See notes 1, 2 and 3.

 

VSAM EXCP request: RLS req timeouts is the total number of RLS requests made to this file that were not serviced in the specified time limit, and therefore the requests were terminated.

 

Notes: The “VSAM EXCP requests” fields indicate the number of I/O operations on the file for data and index records respectively. Also, note the following points:
  1. The values printed for both items relate to the file. If dynamic allocation has been used to change the physical data sets associated with a file, the value shown is an accumulation for all the data sets.
  2. Take care when using these values for files participating in data set name sharing, because VSAM maintains only one count of EXCPs for all access method control blocks (ACBs) thus connected. In this situation, the value reported against each file represents the total accesses for all sharing ACBs during the period for which the file was open. Therefore, if all files in the data set name sharing group were open for the same period, each file would have the same EXCP values reported against it, which would be the total for all the files in the group. When the count of EXCPs rises above x'80000000', the count is no longer reliable, and you should consider redefining the file.
  3. For RLS, this value is a count of the number of calls to the system buffer manager. It includes calls that result in either a coupling facility cache access or an I/O.
  4. The EXCP count for RLS files is the count of all EXCPs for all tasks accessing the RLS file within that CICS region. It should be noted as stated in note 2, EXCP counts are stored in the file's corresponding ACB within that CICS region.