GLOBAL command keywords for FP 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 HFPSYSIN DD.

The following syntax diagram shows the GLOBAL command keywords for FP 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: FP 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.
*NO: FP 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, FP 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.
Requirement: 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.
NO: Does not activate DBRC. FP Stand-alone DB Sensor stores sensor data in the Sensor Data repository without using a RECON ID.
Exception: When DBRC=FORCE is set for IMS, DBRC is activated even if DBRC=NO is specified in DB Sensor JCL.
IGNORE: Does not activate DBRC. FP Stand-alone DB Sensor stores sensor data in the Sensor Data repository without using a RECON ID. Even when DBRC=FORCE is set for IMS, DBRC is not activated if DBRC=IGNORE is specified in DB Sensor JCL.

IMSCATACB_INPUT=

This keyword specifies whether to retrieve the currently active ACB definition or the pending ACB definition from the IMS directory. IMSCATACB_INPUT keyword is effective only when IMSCATHLQ=bsdshlq option is specified for the GLOBAL command. If you omit this keyword, IMSCATACB_INPUT=CURRENT is used as the default value.

CURRENT: FP Stand-alone DB Sensor retrieves the currently active ACB member from the IMS directory data sets.
PENDING: FP Stand-alone DB Sensor retrieves the pending ACB member from the staging data set.

IMSCATHLQ=

This keyword specifies the high-level qualifier of the IMS directory bootstrap data set, which is an extension of the IMS catalog. You must enable the IMS catalog and the IMS management of ACBs when you specify the high-level qualifier of the IMS directory bootstrap data set. If you omit this keyword, IMSCATHLQ=*NO is used as the default value.

bsdshlq: FP Stand-alone DB Sensor reads the ACB from the IMS directory instead of the ACB library by using the IMS Tools Catalog Interface. bsdshlq specifies the high-level qualifier of the IMS directory bootstrap data set.
*NO: FP Stand-alone DB Sensor reads the ACB from the ACB library.

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. This keyword is a required keyword, and you must supply an IMS Tools KB XCF group name.

MSTIMESTAMP=

This keyword specifies whether to include the timestamp with the messages. If you omit this keyword, MSTIMESTAMP=NO is used as the default value.

LOCAL: Includes a local timestamp in the messages.
NO: Does not include a timestamp in the messages.

SENSOR_DBREC=

This keyword specifies whether to collect the data elements that are related to database records and root segment distribution. If you omit this keyword, SENSOR_DBREC=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_MAX_DBREC_LENGTH
DB_MIN_DBREC_LENGTH
DB_PCT_NUM_DBREC_IOVF
DB_MAX_LEN_SYNONYM_CHAIN
DB_AVG_DBREC_IO
DB_MAX_DBREC_IO
DB_AVG_ROOT_IO
DB_MAX_ROOT_IO

NO

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

Considerations for SENSOR_DBREC and the policy evaluation process:

If you specify SENSOR_DBREC=NO, Policy Services and Autonomics Director cannot evaluate the factors that are collected when SENSOR_DBREC=YES is specified, and they might not provide adequate information about the state of the area and the actions that you must take. Consider specifying SENSOR_DBREC=YES unless you have performance concerns.

When you specify SENSOR_DBREC=YES, the CPU time and the elapsed time increase compared to when SENSOR_DBREC=NO is specified.

Even if you specify SENSOR_DBREC=NO, rough estimations of the number of I/Os that are required to read database records and root segments are calculated and stored in the Sensor Data repository. These values are stored as DB_ESTIMATED_DB_REC_IO and DB_ESTIMATED_ROOT_IO data elements, and are collected regardless of the SENSOR_DBREC keyword specification.

SENSOR_UOW=

This keyword specifies whether to store the data elements that are related to unit of work (UOW). If you omit this keyword, SENSOR_UOW=NO is used as the default value.

The data elements that will be stored differ by the HFPAUOWC DD specification as follows:

If you specify the HFPAUOWC DD statement, data elements are collected at the UOW group level (data elements that begin with DBUG.)
If you do not specify the HFPAUOWC DD statement, data elements are collected at the UOW level (data elements that begin with DBU.)

YES: Collects the data elements that are related to UOWs and stores them in the Sensor Data repository of IMS Tools KB. When you specify SENSOR_UOW=YES, you must also specify SENSOR_DBREC=YES.
Note: When you specify the HFPAUOWC DD statement, the data elements that begin with DBUG_ are collected. When you do not specify the HFPAUOWC DD statement, the data elements that begin with DBU_ are collected.
NO: Does not collect the data elements that are related to UOW.
Considerations for SENSOR_UOW and the policy evaluation process:: If you specify SENSOR_UOW=YES, FP Stand-alone DB Sensor collects data elements for each UOW or UOW group. When you process many UOWs or UOW groups, be aware that the number of data elements that will be stored in the IMS Tools KB Sensor Data repository can be large. Processing large number of data elements might increase elapsed time and require more storage space in the repository.

SENSOR_UOW_REPORT=

This keyword specifies whether to print the sensor data that is related to UOW in the HFPSPRT data set. If you omit this keyword, SENSOR_UOW_REPORT=NO is used as the default value.

YES: Prints the sensor data that is related to UOW in the HFPSPRT data set. When you specify SENSOR_UOW_REPORT=YES, you must also specify SENSOR_UOW=YES.
NO: Does not print the sensor data that is related to UOW in the HFPSPRT data set.
Considerations for SENSOR_UOW_REPORT:: When you specify the HFPAUOWC DD statement, the SENSOR_UOW=YES keyword, and the SENSOR_UOW_REPORT=YES keyword, the data elements that are related to UOW are collected at the UOW group level and are printed in the Sensor Data Statistics report.; When you specify the SENSOR_UOW=YES keyword and the SENSOR_UOW_REPORT=YES keyword without an HFPAUOWC DD statement, the data elements that are related to UOW are collected at the UOW level and are printed in the Sensor Data Statistics report; however, the amount of data can be large and might require additional time to print the Sensor Data Statistics report.

SORTOPT_FILSZ=

This keyword specifies that FP Stand-alone DB Sensor adds the FILSZ parameter to the SORT control statement.

AUTO: FP Stand-alone DB Sensor uses the size of the areas and segment definitions to estimate the number of records to sort and adds the FILSZ parameter (FILSZ=Ennnnnnnn) to the SORT control statement.
Specify SORTOPT_FILSZ=AUTO if you received message ICE046A when DFSORT sorted the internal records of FP Stand-alone DB Sensor.
NONE: FP Stand-alone DB Sensor does not add the FILSZ parameter to the SORT control statement.
Even if you specify SORTOPT_FILSZ=NONE, if FP Stand-alone DB Sensor can calculate the actual number of records to sort before the sort program is run, FP Stand-alone DB Sensor adds the FILSZ parameter to the SORT control statement.

TASKNUM=

This keyword specifies the number of tasks that can run in parallel to process the areas. You can specify an integer value in the range of 1 - 200. If the value is larger than the number of input areas, DB Sensor replaces this value with the number of input areas. If you omit this keyword, TASKNUM=4 is used as the default value.