The CICSplex VSAM Analysis attributes report on VSAM data sets allocated to CICS regions. Use the CICSplex VSAM Analysis attributes to review data about data files for VSAM applications and CICS dumps, traces, transient data, and auxiliary temporary storage. This data resides in VSAM data sets. VSAM data sets experiencing string waits or excessive control interval (CI) or control area (CA) splits can adversely affect CICS performance.
These attributes provide data for the VSAM Analysis table view.
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.
Data CA Split Total Indicates the total number of data control area (CA) splits for this data set. Excessive CA splits adversely affect CICS performance. The value format is a positive integer, maximum 4 bytes.
Data CA Splits in Last Hour Indicates the number of Control Area (CA) splits incurred by the data component of the file over the past hour. The value format is a positive integer of maximum 4 bytes.
Data CI Split Total Indicates the total number of control interval (CI) splits for this data set. Excessive CI splits adversely affect CICS performance. The value format is a positive integer, maximum 4 bytes.
Data CI Splits in Last Hour Indicates the number of Control Interval (CI) splits incurred by the data component of the file over the past hour. The value format is a positive integer of maximum 4 bytes.
Data Extents in Last Hour Indicates the number of additional extents allocated for the data component of the file over the past hour. The value format is a positive integer of maximum 4 bytes.
Data Extents Total Indicates the total number of new data extents taken by this VSAM file. The value format is a positive integer, maximum 4 bytes.
Dataset Name Indicates the name of the VSAM data set allocated to the selected CICS region. The value format is an alphanumeric string, maximum 44 characters, and case-sensitive.
DDNAME Indicates the data definition name associated with this VSAM file. The value format is an alphanumeric string, maximum 8 characters, and case-sensitive.
File Access Indicates the mode of access that CICS uses to open this VSAM data set. CICS can access a VSAM file in three different modes: non-shared resources (NSR) mode, local shared resources (LSR) mode, and record-level sharing (RLS) mode. Values are: LSR, NSR, and RLS.
File Type Indicates the type of VSAM file. Values are:
Index CA Split Total Indicates the total number of index control area (CA) splits for this data set. Excessive CA splits adversely affect CICS performance. The value format is a positive integer, maximum 4 bytes.
Index CA Splits in Last Hour Indicates the number of Control Area (CA) splits incurred by the index component of the KSDS file over the past hour. The value format is a positive integer of maximum 4 bytes.
Index CI Split Total Indicates the total number of index control interval (CI) splits for this data set. Excessive CI splits adversely affect CICS performance. The value format is a positive integer, maximum 4 bytes.
Index CI Splits in Last Hour Indicates the number of Control Interval (CI) splits incurred by the index component of the KSDS file over the past hour. The value format is a positive integer of maximum 4 bytes.
Index Extents in Last Hour Indicates the number of additional extents allocated for the index component of the KSDS file over the past hour. The value format is a positive integer maximum 4 bytes.
Index Extents Total Indicates the total number of new index extents taken by this VSAM file. The value format is a positive integer, maximum 4 bytes.
Origin Node Is 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.
Percent Waits Versus I/O Indicates the percentage of I/O requests issued for a file that is waiting for strings to be available. This value is calculated by dividing the number of tasks that have waited for a string by the total number of I/O operations on the file. The value format is a percentage in the range of 0 - 100.
RLS Timeouts in Last Hour Indicates the number of Record Level Sharing (RLS) timeouts that have occurred over the past hour. The value format is a positive integer of maximum 4 bytes.
RLS Timeout Total Indicates the total number of time-outs from VSAM files in record-level sharing (RLS) mode. An RLS time-out occurs when a task issues a request for a record that is being held by another task. You can specify the RLS time-out interval in the DTIMEOUT task or the system FTIMEOUT parameters of CICS. The value format is a positive integer, maximum 4 bytes.
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.
Total String Waits Indicates the total number of string waits for the file. When all strings for a file are in use, new requests against it are queued until a string is released. String waits by many concurrent tasks can eventually lead to new tasks being forced to wait on the active max task limit. Some string waits for a file can be inevitable, but they should be monitored so as not to cause extreme situations in CICS. The value format is a positive integer of maximum 4 bytes.
VSAM Enable Status Indicates whether this VSAM file is enabled or disabled. Values are: Disabled, Enabled, and Unenabled.
VSAM High Water Strings in Use Indicates the highest number of strings in use concurrently to process I/O requests to this VSAM file since the file was opened. The value format is an integer, maximum 2 bytes, and in the range 0-32767.
VSAM Open Status Indicates the status of this VSAM file. Values are: Closed, Open, and No_FCT.
VSAM String Waits Indicates the number of string waits for each VSAM file. When all strings in a file are in use, new requests against it are queued until a string is released. String waits by many concurrent tasks can eventually lead to new tasks being forced to wait on the active max task limit. Too many string waits can degrade response time. The value format is an integer, maximum 2 bytes, and in the range 0-32767.
VSAM Strings Defined Indicates the number of strings defined to process I/O requests to this VSAM file. The value format is an integer, maximum 2 bytes, and in the range 0-32767.
VSAM Strings in Use Indicates the number of strings that are being used to process I/O requested to this VSAM file. The value format is an integer, maximum 2 bytes, and in the range 0-32767.
VSAM Strings Percent in Use Indicates the percentage of strings that are being used to process I/O requests to this VSAM file. The value format is a percentage in the range 0-100.