OPTION statement

Edit online

The OPTION statement for Space Monitor is an optional statement that specifies the threshold values for monitoring data sets.

This statement can be specified following a PROC statement or a DATABASE statement:

  • Explicitly specified keyword values and default option values in an OPTION statement that follows a PROC statement specify the options for the entire database.
  • Explicitly specified keyword values in an OPTION statement that follows a DATABASE statement override the previously specified option in the OPTION statement that follows a PROC statement. These override options affect only one database that is specified in the preceding DATABASE statement.
Subsections:

Syntax

The following syntax diagram shows the keyword for the OPTION statement.


1  OPTION THRESHOLDS=
2.1 keyword=value
2.1 (
2.2.1+ ,
2.2.1 keyword=value
2.1)

Keywords

The following keyword can be specified on the OPTION statement:

THRESHOLDS=
Specifies the threshold values for Space Monitor. You can specify the keyword and its value as a pair. Separate each pair with a comma and enclose the entire specification of the pairs with parentheses.

The following table shows the values you can specify to monitor each factor. The right column shows whether a HISTORY record is required to monitor the factor.

Table 1. Keywords and values for the THRESHOLDS parameter (Space Monitor)
Keyword Value Default value Description HISTORY is required?
EXTENTS= 0 - 99 or NO 10 Warning threshold value for the number of extents. No
FREESPC%= 0 - 100 or NO 10 Warning threshold value for the percentage of free space. Yes
AVAILEXT= 0 - 50 or NO 10 Warning threshold value for the number of available extents. No
LASTEXT= YES or NO YES If YES is specified and the data set uses the last extent, a warning message for this data set is shown in the Space Monitor Exception report. No
USEDSPC%= 0 - 100 or NO 90 Warning threshold value for the percentage of space used. Yes
VOLEXT= YES or NO YES If YES is specified and not enough space is left on the DASD volume for the data set to extend, a warning message for this data set is shown in the Space Monitor Exception report. No
CASPLIT%= 0 - 100 or NO 50 Warning threshold value for the percentage of CA splits. No
CISPLIT%= 0 - 100 or NO 50 Warning threshold value for the percentage of CI splits. No
REORGINTVL= 0 - 999 or NO NO Warning threshold value for the number of days that can pass without a database reorganization. Yes
DSSIZE%= 0 - 100 or NO 90 Warning threshold value for the percentage of the space used by data sets within the maximum size. Yes
DSSIZE= valueunit or NO
  • value is 0 - 9999
  • unit is M, G, or T
 NO Warning threshold value for the data set size in the units of MB, GB, or TB. If a unit is not specified, M (MB) is used. No
HDPCDAYS= 0 - 99 or NO NO Warning threshold value for the number of days that can pass without running HD Pointer Checker with the HISTORY=YES option. Yes

DEDB, Fast Path secondary index, and HALDB ILDS data sets are treated as VSAM data sets. The monitoring factors that require a HISTORY record, which is generated by the HD Pointer Checker utility, cannot be monitored for DEDBs, Fast Path secondary indexes, and HALDB ILDS data sets because such resources are not supported by the HD Pointer Checker utility.

Threshold values are meaningless for DEDBs for the following reasons:
  • Extents are allocated at DEDB initialization time by the IMS DEDB Initialization utility and no extents are dynamically obtained after the initialization.
  • The IMS DEDB Initialization utility initializes the entire space that is allocated, so there is no space that is referred to as free space by the OS file management system.