Performance data in group DFHFILE

Descriptions of the performance data fields in the DFHFILE group, including the numeric identifier, type, and size of each field.

For a breakdown by individual file of some of the information provided in group DFHFILE, you can request transaction resource monitoring. See Transaction resource class data: Listing of data fields for details.

036 (TYPE-A, 'FCGETCT', 4 BYTES)
Number of file GET requests issued by the user task.
037 (TYPE-A, 'FCPUTCT', 4 BYTES)
Number of file PUT requests issued by the user task.
038 (TYPE-A, 'FCBRWCT', 4 BYTES)
Number of file browse requests issued by the user task. This number excludes the START and END browse requests.
039 (TYPE-A, 'FCADDCT', 4 BYTES)
Number of file ADD requests issued by the user task.
040 (TYPE-A, 'FCDELCT', 4 BYTES)
Number of file DELETE requests issued by the user task.
063 (TYPE-S, 'FCIOWTT', 12 BYTES)
Elapsed time in which the user task waited for file I/O. For more information, see Clocks and time stamps, and Transaction wait (suspend) times.
Note: This field is a component of the task suspend time, SUSPTIME (014) field.
070 (TYPE-A, 'FCAMCT', 4 BYTES)
Number of times the user task invoked file access-method interfaces. This number excludes requests for OPEN and CLOSE.
093 (TYPE-A, 'FCTOTCT', 4 BYTES)
Total number of file control requests issued by the user task. This number excludes any request for OPEN, CLOSE, ENABLE, or DISABLE of a file.

How EXEC CICS® file commands correspond to file control monitoring fields is shown in Table 1.

Table 1. EXEC CICS file commands related to file control monitoring fields
EXEC CICS command Monitoring fields
READ FCGETCT and FCTOTCT
READ UPDATE FCGETCT and FCTOTCT
DELETE (after READ UPDATE) FCDELCT and FCTOTCT
DELETE (with RIDFLD) FCDELCT and FCTOTCT
REWRITE FCPUTCT and FCTOTCT
WRITE FCADDCT and FCTOTCT
STARTBR FCTOTCT
READNEXT FCBRWCT and FCTOTCT
READNEXT UPDATE FCBRWCT and FCTOTCT
READPREV FCBRWCT and FCTOTCT
READPREV UPDATE FCBRWCT and FCTOTCT
ENDBR FCTOTCT
RESETBR FCTOTCT
UNLOCK FCTOTCT
Note: The number of STARTBR, ENDBR, RESETBR, and UNLOCK file control requests can be calculated by subtracting the file request counts, FCGETCT, FCPUTCT, FCBRWCT, FCADDCT, and FCDELCT from the total file request count, FCTOTCT.

174 (TYPE-S, 'RLSWAIT', 12 BYTES)
Elapsed time in which the user task waited for RLS file I/O. For more information, see Clocks and time stamps, and Transaction wait (suspend) times.
Note: This field is a component of the task suspend time, SUSPTIME (014) field.
175 (TYPE-S, 'RLSCPUT', 12 BYTES)
For RLS requests issued from the QR TCB:

The RLS File Request CPU (SRB) time field (RLSCPUT) is the SRB CPU time this transaction spent processing RLS file requests. This field should be added to the transaction CPU time field (USRCPUT) when considering the measurement of the total CPU time consumed by a transaction. Also, this field cannot be considered a subset of any other single CMF field (including RLSWAIT). This is because the RLS field requests execute asynchronously under an MVS™ SRB which can be running in parallel with the requesting transaction. It is also possible for the SRB to complete its processing before the requesting transaction waits for the RLS file request to complete.

For RLS requests issued from an open TCB:

There is no RLSCPUT field for applications that are running on an open TCB mode because the requests are completed on the same TCB on which the application is running . In this case, the CPU time for the request is already accumulated in the USRCPUT field.

Note that system initialization parameters FCQRONLY and FORCEQR can both influence the TCB under which the RLS requests are issued. See System initialization parameter descriptions and summary for details.

176 (TYPE-S, 'CFDTWAIT', 12 BYTES)
The elapsed time in which the user task waited for a data table access request to the Coupling Facility Data Table server to complete. For more information, see Clocks and time stamps, and Transaction wait (suspend) times.
Note: This field is a component of the task suspend time, SUSPTIME (014) field.
426 (TYPE-S, 'FCXCWTT', 12 BYTES)
The elapsed time in which the user task waited for exclusive control of a VSAM control interval. This field counts time spent waiting on resource type FCXCSUSP, FCXDSUSP, FCXCPROT, or FCXDPROT. For more information, see Clocks and time stamps, and Transaction wait (suspend) times.
Note: This field is a component of the task suspend time, SUSPTIME (014) field.
427 (TYPE-S, 'FCVSWTT', 12 BYTES)
The elapsed time in which the user task waited for a VSAM string. This field counts time spent waiting on resource type FCPSSUSP or FCSRSUSP. For more information, see Clocks and time stamps, and Transaction wait (suspend) times.
Note: This field is a component of the task suspend time, SUSPTIME (014) field.