IBM Tivoli OMEGAMON XE for CICS on z/OS, Version 5.1.0

CICSplex File Control Statistics attribute group

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 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.

Current Buffer Waits The number of attempts made to append to this file while the buffers were logically full.

Current String Waits 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 specify this attribute in the following instances:

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. These are the values:

The DISABLING status indicates that a request was received to disable the file but there are tasks executing.

The UNENABLING status indicates that a request to close the file has been received but tasks are executing that had previously been accessed by the file.

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

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).

Key Length The length of the key in the key-sequenced data set (KSDS) file.

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. These are the valid values:

Closing a file can require dynamic deallocation of data sets and deletion of shared resources. Close processing can last significant length of time.

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.

Relative Key Position The relative position of the key in a key-sequenced data set (KSDS) file. The valid values are n/a or a number in the range 0-255. The n/a value is returned if the file is not open, or not a keyed data set.

Remote File APPLID The APPLID of the CICS region in which a remote file is defined. These are the valid values, the APPLID, n/a or Unknown. The value format is an alphanumeric string, with a maximum eight characters.

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. The n/a value is 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). The n/a value is 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.

Time File Opened Is the time of day when the file was opened. This field contains a valid time, if the following situations occur:

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.

Total String Waits Is the total number of string waits.


[ Top of Page | Previous Page | Next Page ]