The predefined situations in this category monitor the status of VSAM data sets.
Use LSR pools so that strings and buffers are shared for all files. LSR can greatly reduce the total I/O and CPU usage in your system. If there are no evident problems, increase the number of strings in the FCT.
Formula
If the value of VSAM_Strings_Percent_in_Use is greater than 85 and the value of VSAM_Strings_Percent_in_Use is less than or equal to 100 then situation CICSplex_VSAMStrUse_Warning is true.
Use LSR pools so that strings and buffers are shared for all files. LSR can greatly reduce the total I/O and CPU usage in your system. If there are no evident problems, increase the number of strings in the FCT.
Formula
If the value of VSAM_Strings_Percent_in_Use is greater than 100 then situation CICSplex_VSAMStrUse_Critical is true.
Consider using LSR pools so that strings and buffers are shared by files. LSR can greatly reduce the total I/O and CPU usage in your CICS region. Use the Transaction Analysis workspace to determine whether there is a problem that is preventing tasks from completing in a timely manner. For example, tasks can be waiting for an enqueue or CICS can be short-on-storage. If you determine that there is no bottleneck and the problem persists, increase the number of VSAM strings.
Formula
If the value of VSAM_String_Waits is greater than 3 and the value of VSAM_String_Waits is less than or equal to 7 then situation CICSplex_VSAMStrWait_Warning is true.
Consider using LSR pools so that strings and buffers are shared by files. LSR can greatly reduce the total I/O and CPU usage in your CICS region. Use the Transaction Analysis report to determine whether there is a problem that is preventing tasks from completing in a timely manner. For example, tasks can be waiting for an enqueue or CICS can be short- on-storage. If you determine that there is no bottleneck and the problem persists, consider increasing the number of VSAM strings.
Formula
If the value of VSAM_String_Waits is greater than 7 then situation CICSplex_VSAMStrWait_Critical is true.
If a higher level of activity against the data set has increased string waits, increase the number of strings that are defined for the named data set. Use LSR pools so that files share buffers and strings. LSR can reduce the total I/O and CPU usage in your CICS system. If a data set is defined in an LSR pool, the demand for strings can be reduced as a result of a successful buffer lookaside.
Formula
If the value of Percent_Waits_Versus_I/O is greater than 3 and the value of Percent_Waits_Versus_I/O is less than or equal to 5 then situation CICSplex_VSAMWaitvIO_Warning is true.
If a higher level of activity against the data set has increased string waits, increase the number of strings that are defined for the named data set. Use LSR pools so that files share buffers and strings. LSR can reduce the total I/O and CPU usage in your CICS system. If a data set is defined in an LSR pool, demand for strings can be reduced as a result of a successful buffer lookaside.
Formula
If the value of Percent_Waits_Versus_I/O is greater than 5 then situation CICSplex_VSAMWaitvIO_Critical is true.
Reorganize the file as soon as possible. If splits continue to occur at a frequent rate, redefine the FREESPACE options to reduce split activity.
Formula
If the value of Data_CA_Splits_in_Last_Hour is greater than 1 and the value of Data_CA_Splits_in_Last_Hour is less than or equal to 2 then situation CICSplex_VSAMDataCA_Warning is true.
Reorganize the file as soon as possible. If splits continue to occur at a frequent rate, redefine the FREESPACE options to reduce split activity.
Formula
If the value of Data_CA_Splits_in_Last_Hour is greater than 2 then situation CICSplex_VSAMDataCA_Critical is true.
Continuing CI splits indicate that a CA split can occur soon. CA splits can take a long time to complete; reorganize the file before the CA split occurs. Large numbers of CI splits can indicate that FREESPACE option might have to be adjusted.
Formula
If the value of Data_CI_Splits_in_Last_Hour is greater than 4 and the value of Data_CI_Splits_in_Last_Hour is less than or equal to 10 then situation CICSplex_VSAMDataCA_Critical is true.
Continuing CI splits indicate that a CA split can occur soon. CA splits can take a long time to complete; reorganize the file before the CA split occurs. Large numbers of CI splits can indicate that FREESPACE option might have to be adjusted.
Formula
If the value of Data_CI_Splits_in_Last_Hour is greater than 10 then situation CICSplex_VSAMDataCI_Critical is true.
Increase the primary allocation for the data component of the file.
Formula
If the value of Data_Extents_in_Last_Hour is greater than 1 and the value of Data_Extents_in_Last_Hour is less than or equal to 2 then situation CICSplex_VSAMDataExt_Warning is true.
Increase the primary allocation for the data component of the file.
Formula
If the value of Data_Extents_in_Last_Hour is greater than 2 then situation CICSplex_VSAMDataExt_Critical is true.
Reorganize the file as soon as possible. If splits continue to occur at a frequent rate, redefine the FREESPACE options to reduce split activity.
Formula
If the value of Index_CA_Splits_in_Last_Hour is greater than or equal to 1 then situation CICSplex_VSAMNdxCA_Warning is true.
Reorganize the file as soon as possible. If splits continue to occur at a frequent rate, redefine the FREESPACE options to reduce split activity.
Formula
If the value of Index_CA_Splits_in_Last_Hour is greater than or equal to 1 then situation CICSplex_VSAMNdxCA_Critical is true.
Continued CI splits indicate that a CA split can occur soon. CA splits can take a long time to complete, so try to reorganize the file before the CA split occurs. Large numbers of CI splits can indicate that the FREESPACE option might have to be adjusted.
Formula
If the value of Index_CI_Splits_in_Last_Hour is greater than or equal to 1 then situation CICSplex_VSAMNdxCI_Warning is true.
Continued CI splits indicate that a CA split can occur soon. CA splits can take a long time to complete, so try to reorganize the file before the CA split occurs. Large numbers of CI splits can indicate that the FREESPACE option might have to be adjusted.
Formula
If the value of Index_CI_Splits_in_Last_Hour is greater than or equal to 1 then situation CICSplex_VSAMNdxCI_Critical is true.
Consider increasing the primary allocation for the index component of the file.
Formula
If the value of Index_Extents_in_Last_Hour is greater than or equal to 1 then situation CICSplex_VSAMNdxExt_Warning is true.
Consider increasing the primary allocation for the index component of the file.
Formula
If the value of Index_Extents_in_Last_Hour is greater than or equal to 1 then situation CICSplex_VSAMNdxExt_Critical is true.
Investigate tasks that can be holding an RLS lock for an excessive a mount of time. The online history component of OMEGAMON XE for CICS on z/OS can be used to identify transactions that have been abnormally terminated by CICS because of VSAM timeout conditions (abend code AFCV). If the lock activity is determined to be normal, consider increasing the DTIMOUT value for transactions that use the file, or the FTIMEOUT value defined to CICS.
Formula
If the value of RLS_Timeouts_in_Last_Hour is greater than 1 and the value of RLS_Timeouts_in_Last_Hour is less than or equal to 20 then situation CICSplex_VSAMRLSTimeout_Warning is true.
Investigate tasks that can be holding an RLS lock for an excessive a mount of time. The online history component of OMEGAMON XE for CICS on z/OS can be used to identify transactions that have been abnormally terminated by CICS because of VSAM timeout conditions (abend code AFCV). If the lock activity is determined to be normal, consider increasing the DTIMOUT value for transactions that use the file, or the FTIMEOUT value defined to CICS.
Formula
If the value of RLS_Timeouts_in_Last_Hour is greater than 20 then situation CICSplex_VSAMRLSTimeout_Critical is true.
See also the CICSplex VSAM Analysis attribute group.