GLOBAL command keywords for FF Stand-alone DB Sensor

The GLOBAL command keywords control the behavior of the job. You must specify the GLOBAL command and its keywords in the BBESIN DD.

The following syntax diagram shows the GLOBAL command keywords for FF Stand-alone DB Sensor.

ADXCFGRP=

This keyword specifies whether to send notification to Autonomics Director. The notification is used as a trigger by Autonomics Director to schedule a policy evaluation. If you omit this keyword, ADXCFGRP=*NO is used as the default value.

Important: If you want Autonomics Director to schedule a policy evaluation, you must specify the name of the Autonomics Director XCF group with this keyword.

Autonomics_Director_XCF_group_name: FF Stand-alone DB Sensor sends sensor data notification to Autonomics Director after storing sensor data in the Sensor Data repository of IMS Tools KB.; If you specify the Autonomics Director XCF group, you must specify DBRC=YES and ITKBSRVR=IMS_Tools_KB_XCF_group_name.
*NO: FF Stand-alone DB Sensor does not send sensor data notification to Autonomics Director.

DBRC=

This keyword specifies whether to activate DBRC. If you omit this keyword, DBRC=NO is used as the default value.

YES

Activates DBRC. When you specify DBRC=YES, FF Stand-alone DB Sensor stores sensor data in the Sensor Data repository by using the RECON ID (locale) that is associated with the RECONx data set names.

Requirements:

To specify DBRC=YES, you must specify the RECONx DD statements or specify a DFSMDA member in the STEPLIB or IMSDALIB data set. For more information about specifying a DFSMDA member, see the topic about the DFSMDA macro in IMS System Definition.
If the database is a HALDB, you must specify DBRC=YES.

NO

Does not activate DBRC. FF Stand-alone DB Sensor stores sensor data in the Sensor Data repository without using a RECON ID.

HPIO=

This keyword specifies whether to use the High Performance I/O (HPIO) technique to scan the database data set. If you omit this keyword, HPIO=YES is used as the default value.

YES: Uses the HPIO technique.
NO: Does not use the HPIO technique.

IMSCATHLQ=

This keyword specifies whether to obtain the information about the database structure (DBD) from the IMS directory instead of from the DBD library. If you specify the IMS bootstrap data set HLQ (IMS system data set HLQ) for this keyword, FF Stand-alone DB Sensor obtains the DBD from the IMS directory. This keyword is an optional keyword. If you omit this keyword, IMSCATHLQ=*NO is used as the default value.

IMS_bootstrap_data_set_HLQ: Specify the high-level qualifier (HLQ) of the IMS bootstrap data set.
*NO: FF Stand-alone DB Sensor obtains the DB structure information from the DBD library that is specified in the IMS DD statement. In this case, IMS DD is required.

ITKBSRVR=

This keyword specifies the IMS Tools KB XCF group name (IMS Tools KB server name). The sensor data and the DB Sensor reports are stored in the IMS Tools Knowledge Base repositories that are managed by this IMS Tools KB server. If you omit this keyword, ITKBSRVR=*NO is used as the default value.

Important: If you want to analyze sensor charts on Management Console or schedule a policy evaluation by using Autonomics Director, you must specify the name of the IMS Tools KB XCF group with this keyword.

IMS_Tools_KB_XCF_group_name: FF Stand-alone DB Sensor stores sensor data and reports in the IMS Tools Knowledge Base repositories.
*NO: FF Stand-alone DB Sensor does not store sensor data or reports in the IMS Tools Knowledge Base repositories. If you specify ITKBSRVR=*NO, sensor data is available only through the Sensor Data Statistics report that is generated in the BBESPRT data set.

SENSOR_HOME=

This keyword specifies whether to collect the data elements that are related to root segment distribution. If you omit this keyword, SENSOR_HOME=YES is used as the default value.

YES

Collects the following data elements and stores them in the Sensor Data repository of IMS Tools KB:

DB_NUM_ROOT_NOHOME
DB_PCT_NUM_ROOT_NOHOME
DB_AVG_LEN_SYNONYM_CHAIN

Restrictions:

If the key compression option of the Segment Edit/Compression exit routine is specified for the root segment, these data elements are not collected even when SENSOR_HOME=YES is specified.
If you specified RMNAME=(rand,rap,0,bytes) or if you omitted the third operand of the RMNAME parameter in the DBD macro, the number of root addressable area (RAA) blocks is defined as zero in the HDAM or PHDAM DBD. In this case, these data elements are not collected even if SENSOR_HOME=YES is specified.

NO

Does not collect the data elements that are related to root segment distribution.

Considerations for SENSOR_HOME and the policy evaluation process:

The data elements that are additionally collected when SENSOR_HOME=YES are useful factors for determining the need of database reorganization.

DB_NUM_ROOT_NOHOME and DB_PCT_NUM_ROOT_NOHOME show how many root segments are placed in the different block from the blocks in which their RAP (Root Anchor Points) are placed. If the number of DB_PCT_NUM_ROOT_NOHOME is large, extra I/O operations can occur for reading root segments. If the number of DB_PCT_NUM_ROOT_NOHOME is large and if you reorganize the database, the amount of I/O might be decreased because the root segments will be moved into the home blocks.

DB_AVG_LEN_SYNONYM_CHAIN shows how many roots segments are assigned to the same RAP by a randomizer. If the number of DB_AVG_LEN_SYNONYM_CHAIN is large, extra I/O operations can occur for reading root segments. To improve this situation, change the randomizing parameters, such as increasing RAA blocks or the number of RAPs, or changing the randomizer, and then reconstruct the database.

If you specify SENSOR_HOME=NO, Policy Services and Autonomics Director cannot evaluate these factors, and they might not provide adequate information about the state of the database and the actions that you must take. Consider specifying SENSOR_HOME=YES unless you have performance concerns.

When you specify SENSOR_HOME=YES, a randomizer is called to collect data for these data elements. Consequently, when SENSOR_HOME=YES is specified, the CPU time and the elapsed time increase compared to when SENSOR_HOME=NO is specified.

TOSIXCFGRP=

This keyword specifies whether to retrieve the latest VSAM statistics of the online database. If you specify the IMS Tools Online System Interface XCF group name, FF Stand-alone DB Sensor requests IMS Tools Online System Interface to retrieve the latest VSAM statistics of the IMS online database.

This keyword is an optional keyword. If you omit this keyword, TOSIXCFGRP=*NO is used as the default value. Because this keyword is effective for online databases, you can omit this keyword when you process offline databases.

Important: If you want to collect the most recent sensor data for an online database, you must specify the name of the IMS Tools Online System Interface XCF group with this keyword.

IMS_Tools_Online_System_Interface_XCF_group_name: Specify the IMS Tools Online System Interface XCF group name in TOIxxxxx format.; See Considerations for collecting sensor data from full-function databases for considerations that apply when collecting sensor data from a database that is being updated.
*NO: Does not retrieve the latest VSAM statistics of IMS online database.