CICSplex File Control Summary attribute group

The CICSplex File Control Summary attribute group provides a summary of the key attributes related to files. Using this data you can, for example, monitor the number of active strings and compare them with the number of available strings.

Note: The attributes within the CICSplex File Control Summary group are stored for historical retrieval within the Tivoli Data Warehouse. Selected attributes within this group are candidates for the Tivoli Data Warehouse summarization and pruning features.

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 operating system has a unique name. This name is an alphanumeric string, with a maximum of eight characters, and case-sensitive. CICS region names are always in uppercase characters.

Enable Status Specifies whether application programs can access the file. These are the values:

DISABLED: The file is not available for use by transactions except for those that are currently using it. If there are any such users, 'BEING DISABLED' is also displayed. The file can be re-enabled by a SET FILE ENABLED command. It is not possible to disable a remote file.
ENABLED: The file is available for use by transactions and, if closed, it is opened on the first request.
UNENABLED: The file is not available for use by transactions except for those that are currently using it. If there are any such users, 'BEING CLOSED' is also displayed. This status is the same as DISABLED except that it occurs implicitly when a SET FILE CLOSE is requested. The file is enabled implicitly by a SET FILE OPEN command.

File Access Method Returns a value identifying the access method used with this data set. These are the values:

BDAM: The access method is BDAM.
NOTAPPLIC: The data set has not been opened by the CICS region in which the command is issued.
VSAM: The access method is VSAM. Access to a data table (except while it is being loaded or, for a CICS-maintained data table, when the source data set is being updated or searched for a record that is not in the table), is through CICS data table services. Because this access is still based on VSAM keys, CICS returns VSAM as the access method for any kind of data table.
Data Table: This files represents a data table.
Remote: The file is defined as remote, and therefore the access method is not known to the local CICS system.

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 Record Format Is the format of the records on the file. These are the values:

FB: The records are of fixed length.
U: The format of records on the file is undefined. The Undefined value is possible for BDAM data sets only.
VB: The records are of variable length. If the file is associated with a user-maintained data table, the record format is always variable length, even if the source data set contains fixed-length records.

Number of String Waits Is the total number of waits for strings against the file.

Number of Strings Indicates the number of strings (concurrent operations) specified for the file in its FILE definition.

Open Status Returns a value identifying whether the file is open, closed, or in a transitional state. These are the values:

Close: The file is closed.
Close in progress: The file is in the process of being closed. Closing a file can require dynamic deallocation of data sets and deletion of shared resources, in which case close processing can last a significant length of time.
Notapplic: The OPENSTATUS value does not apply to this type of file. For example, it does not apply to a remote file.
Open: The file is open.
Open in progress: The file is in the process of being opened.

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 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 four-character name that uniquely identifies an active z/OS operating system within a given CICSplex. The value format is an alphanumeric string, maximum four characters, and case-sensitive. z/OS System IDs are always in uppercase characters.