Files: Resource statistics - resource information

The file resource information statistics provide information about files.

Table 1. Files: Resource statistics - resource information
DFHSTUP name Field name Description
File name A17FNAM The name you specified in the DEFINE FILE command of resource definition online.

Reset characteristic: not reset

 
Data set name A17DSNAM The 44-character name that defines the physical data set to the system. This name can be specified as follows:
  • The DSNAME operand specified in the DEFINE FILE command of resource definition online
  • The operand specified in the DD DSN= operand of the CICS® JCL
  • Dynamic allocation of a data set to a file through the use of CEMT SET FILE DSNAME or EXEC CICS SET FILE DSNAME commands.
If no data set is currently allocated to the file, this field is blank.

If the file is remote, no data set name is printed, but the word remote is substituted for the data set name.

Reset characteristic: not reset

 
Base data set name (if applicable) A17BDSNM If the file is a VSAM PATH, this field gives the base data set name.

Reset characteristic: not reset.

 
Data set type A17DSTYP The data set type, which can be BDAM, standard ESDS, extended ESDS, KSDS, RRDS, VRRDS, or PATH. If the file is remote or not open, this field is blank.
Key
Statistics type
B
BDAM
E
Standard ESDS
K
KSDS
P
PATH
R
RRDS
V
VRRDS
X
Extended ESDS

Reset characteristic: not reset.

 
RLS A17DSRLS Indicates whether the file is RLS.
  • 'R' =RLS accessed file
  • ' ' =Non-RLS
These values are shown as Yes and No, respectively, in the DFHSTUP report.

Reset characteristic: not reset.

 
DataTable indicator A17DT A 1-byte field that contains the value R, S T, L K, or X, if data table statistics fields are present in the record.
  • R indicates that this is a remote file for which table read and source read statistics are present.
  • S indicates that the resource was not opened as a table but was able to access data from a table associated with the same data set.
  • T indicates that the resource is a shared data table.
  • L indicates that the resource is a coupling facility data table (locking model).
  • K indicates that the resource is a coupling facility data table (contention model).
  • X indicates that the resource has been opened with a source data set which has an associated CICS maintained data table and the resource has been updated which has caused the data table to also be updated.

Reset characteristic: not reset

 
Time opened A17LOPNT The time at which this file was opened. If this field is not set, A17LOPNT contains the hexadecimal value X'00000000 00000000', shown in the report as CLOSED. If the field is set, it contains a time expressed as a store clock (STCK) value in local time.
This field contains a valid time if:
  • The file was open at the time the statistics were taken.
  • This is an unsolicited statistics request due to the file being closed.

Reset characteristic: not reset

 
Time closed A17LCLST The local time at which this file was closed. This field will always contain hexadecimal value X'00000000 00000000' except in the Unsolicited Statistics record written when the file is closed. In that Unsolicited Statistics record, the field contains a time expressed as a store clock (STCK) value in local time.

Reset characteristic: not reset

 
Remote Name A17RNAME The name by which this file is known in the system or region in which it is resident.

Reset characteristic: not reset.

 
Remote Sysid A17RSYS When operating in an IPIC, ISC, or MRO environment, and the file is held by a remote system, this field specifies the system upon which the file is resident.

Reset characteristic: not reset.

 
LSR A17POOL
The identity of the local shared resource pool. This value is that specified by:
  • The LSRPOOLNUM operand of the resource definition online DEFINE FILE command.

"N" means that it is not defined in an LSR pool. Reset characteristic: not reset.

 
CFDT PoolName A17DTCFP The name of the coupling facility data table pool defined for the data table associated with the file

Reset characteristic: not reset

 
NOT IN THE DFHSTUP REPORT A17FLOC States whether the file is defined as being local to this CICS system, or resides on a remote CICS system. The field is one byte long, and is set to R if remote.

Reset characteristic: not reset

 
Not in DFHSTUP report A17_FILE_DEFINE_SOURCE

The source of the resource definition. Its value depends on the change agent. For more information, see Summary of the resource signature field values.

Reset characteristic: not reset

 
Not in DFHSTUP report A17_FILE_CHANGE_TIME

The time stamp (STCK) in local time of CSD record change.

Reset characteristic: not reset

 
Not in DFHSTUP report A17_FILE_CHANGE_USERID

The user ID that ran the change agent.

Reset characteristic: not reset

 
Not in DFHSTUP report A17_FILE_CHANGE_AGENT

The agent that made the last change.

Reset characteristic: not reset

 
Not in DFHSTUP report A17_FILE_INSTALL_AGENT

The agent that installed the resource.

Reset characteristic: not reset

 
Not in DFHSTUP report A17_FILE_INSTALL_TIME

The time stamp (STCK) in local time when the resource was installed.

Reset characteristic: not reset

 
Not in DFHSTUP report A17_FILE_INSTALL_USERID

The user ID that installed the resource.

Reset characteristic: not reset

 
Note: When the source data set of a user-maintained table is closed, the time opened is reset to the time at which the source was closed.

The resource statistics fields for the resource signature

The resource signature captures details about when the resource is defined, installed, and last changed. The resource statistics field names for the resource signature end in CHANGE_AGENT, CHANGE_TIME, CHANGE_USERID, DEFINE_SOURCE, INSTALL_AGENT, INSTALL_TIME, and INSTALL_USERID. For detailed information about the content of the resource signature fields, see Summary of the resource signature field values.