The CICSplex File Control Statistics attribute group collects data about the number of application requests against your data sets. They indicate the number of requests for each type of service that are processed against each file. If the number of requests is totalled daily or for every CICS execution, the activity for each file can be monitored for any changes that occur. Note that these file statistics can have been reset during the day; to obtain a figure of total activity against a particular file during the day. Other data pertaining to file statistics and special processing conditions are also collected.
Active Strings Is the current number of updates against the file.
CICS Region Name Indicates the job name or modify ID of the CICS region being monitored. Each CICS region in a z/OS image has a unique name. This name is an alphanumeric string, with a maximum of 8 characters, and case-sensitive. CICS region names are always in uppercase characters.
Current Buffer Waits Is the number of attempts made to append to this file while the buffers were logically full.
Current String Waits Is the number of attempts made to append to this file while there were no available strings.
Dataset Name Is the 44-character name defining the physical data set to the system.
You can have specified this in:
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.
Enable Status Specifies whether application programs can access the file. The values are:
File Access Method Returns a value identifying the access method used with this data set. Values are:
File Attributes Specifies whether the file is to be accessed in RLS mode. The file must be closed, and either disabled or unenabled, to change the access mode to RLS access or to non-RLS access. The non-RLS mode becomes either LSR or NSR, depending on the value specified for LSRPOOLID in the file resource definition.
File Name Is the name of the file.
File Format Is the file format for this file.
Highest Buffer Waits Is the number of times a request was queued because all buffers were allocated to other tasks. A buffer wait also occurs if the required control interval is already in a locked buffer, and therefore unavailable, even if there are other buffers available.
Highest Tasks Waited on String Is the highest number of tasks waiting for a VSAM string (such as a file name or file ID).
Number of Adds Is the number of PUT requests attempted against this file.
Number of Browses Is the number of GETNEXT and GETPREV requests attempted against this file.
Number of Data Buffers Is the number of VSAM data buffers defined for this file.
Number of Deletes Is the number of DELETE requests attempted against this file.
Number of Index Buffers Is the number of VSAM index buffers defined for this file.
Number of Read for Updates Is the number of browse READNEXT UPDATE and READPREV UPDATE requests issued against this file. Note that this field is only applicable to RLS accessed files.
Number of Reads Is the number of Read requests for this file.
Number of Strings Is the number of VSAM strings defined for this file.
Number of Updates Is the number of PUT UPDATE requests attempted against this file.
Open Status Returns a value identifying whether the file is open, closed, or in a transitional state. Valid values are:
Origin Node The combination of z/OS System ID (SMFID) and CICS region name. The value format is an alphanumeric string, maximum 32 bytes, and case-sensitive.
When a situation is true, the system compares the origin node name in the attribute to the names of managed systems assigned to the item. If the origin node name matches the name of a managed system, the status of the item changes accordingly. If the names of the origin node and the managed systems do not match, the status of the item remains unchanged.
Remote File Name Is the name by which the file is known in the CICS region named in the REMOTESYSTEM option of its FILE definition. Blanks are returned if the file is not remote.
Remote System Returns the name of the CICS region in which the file is defined (from the REMOTESYSTEM value in the FILE definition). Blanks are returned if the file is not remote.
System ID Indicates the 4-character name that uniquely identifies an active z/OS operating system within a given CICSplex. The value format is an alphanumeric string, maximum 4 characters, and case-sensitive. z/OS System IDs are always in uppercase characters.
Time File Opened Is the time when this file was opened. This field contains a valid time if:
Total Buffer Waits Is the total number of buffer waits for this file..
Total RLS Timeouts Is the number of RLS requests made to this file that were not serviced in the specified time limit, and therefore the requests were terminated.