DFHFCST (file control statistics program)

Call mechanism

Kernel subroutine call. Automatic stack storage acquired as part of the call.

Entry address

DFHFCST. The entry point address is held in FC static storage in a field named FC_FCST_ADDRESS, which is set by DFHFCRP when it loads DFHFCST.

Purpose

The file control statistics program is part of the file control component.

This program is called to collect statistics for a single file, together with any data table statistics, or to collect statistics for the activity in a shared resources pool.

It is also called to return file statistics associated with a file’s use of a shared resources pool.

Called by

DFHSTFC
Collect file statistics
DFHSTLS
Collect pool statistics and also file-in-pool statistics.

Inputs

The FCST parameter list, as defined by the DFHFCSTA DSECT, is created as part of the subroutine call.

The input parameters are:

Request identifier
File name
FCTE token
Statistics record
Pool identifier
Browse token
Reset indicator

Outputs

Returned in the FCST parameter list:

Browse token
Response
Reason

Operation

  • Collect file statistics:

    The FCT entry token is validated if supplied; otherwise, the file name is used to locate the FCT entry.

    The file statistics, and any data table statistics, are collected from the FCTE and copied into the statistics record. The statistics in the FCTE are optionally reset according to the reset indicator.

    For data tables, a STATISTICS data table service request is issued to retrieve and reset those statistics that are maintained by data table services. These statistics are appended to the file statistics record.

    The FCT entry is unlocked and the statistics record returned to the caller.

  • Collect pool statistics:

    The SHRCTL block for the specified pool is addressed. The pool statistics are copied into the statistics record and are returned to the caller.

  • Start browse of files in pool:

    Storage is obtained from the general file control pool for the browse cursor. The browse token is returned to the caller.

  • Get statistics for next file in pool:

    DFHTMP is invoked to locate the FCT entry identified by the browse cursor. If the file uses the specified pool, the shared pool statistics for this file are retrieved and returned in the statistics record.

    The statistics contain the data and index buffer sizes, and the number of times buffer waits occurred.

    The browse cursor is updated before returning to the caller.

  • End browse of files in pool:

    The browse cursor storage is freed before returning to the caller.

How loaded

By DFHFCRP as part of file control initialization.



dfhs3g4.html | Timestamp icon Last updated: Monday, 5 June 2017