CTVGICHK Parameters

Input parameters are supplied to the CTVGICHK utility using a SYSIN DD statement.

All input parameters have a key format, and can be specified in random order. Each parameter (except for the PATH parameter) can be specified only once.

There are two groups of input parameters:

parameters that define actions for the utility are listed in Table 296.

parameters that define the reports’ selection criteria are listed in Table 297.

Table 296 CTVGICHK action definition parameters

Parameter	Description
MODE	Indicates whether the utility should recognize only the reports that have not been loaded into the Global Index database at all, or in addition recognize the reports that have not been loaded completely. Optional. Valid values are: BASE – The utility checks whether the selected reports appear in the Global Index database, without comparing number of loaded Index values with number of values in the Index file. Default. EXTENDED – The utility checks whether the selected reports appear in the Global Index database and if the number of loaded values for each report is the same as the number of values for this report in the Control-V Index file.
PRINT	Indicates which information is included in the output report issued by the utility. Optional. Valid values are: ERROR – Only problematic selected reports are included in the output list. Default. ALL – All selected reports are included in the output list. The problematic reports are marked with an asterisk (*) on the right.
PRINT	Note: A report is recognized as problematic in following cases: It is marked as loaded but does not appear in the Global Index database. It is not marked as loaded but appears in the Global Index database In extended mode, the number of loaded Index values is not the same as number of values in the Index file.
TRACE	Indicates whether to issue trace messages to the DATRACE DD file. Optional. Valid values are: NO – Do not issue trace messages. Default. YES – Issue trace messages.

Table 297 CTVGICHK selection parameters

Parameter	Description
MIGRATE	Indicates whether the Control-V migrated reports should be processed. Optional. Valid values are: NO – Do not process reports from the Migration User file, but only from the Active User file. Default. YES – Process reports from the Migration User file as well as from the Active User file. ONLY – Process reports only from the Migration User file, and not from the Active User file.
MIGRATE	Note: Reports can be processed from the Migrated User file in EXTENDED mode only if the Index files are resident (the original index files are located on DASD).
LOADED	Indicates whether the new reports which have not been loaded to Global Index database yet should be selected by the utility. Optional. Valid values are: YES – select only the reports that are marked as loaded to the Global Index database. Default. ALL – select the reports that are marked as loaded to the Global Index database as well as the new reports. NO – Select only the new reports that are not marked as loaded to the Global Index database.
USER	The name of the recipients or mask patterns for which the indexes are checked. Mandatory. Up to 15 users or masks can be specified using the format *USER=(USERA,M,D??45)**.
FODATE	From ODATE of the report. This is the earliest order date from which indexes are checked. Optional. The date should be specified in the format dd/mm/yy, mm/dd/yy, or yy/mm/dd, depending on the site standard defined in the IOAPARM member. This parameter can also be specified in the format -N, where N is number of days (0 -99999) preceding to the current date.
TODATE	To ODATE of the report. This is the latest order date until which indexes are checked. Optional. The date should be specified in the format dd/mm/yy, mm/dd/yy, or yy/mm/dd, depending on the site standard defined in the IOAPARM member. This parameter can also be specified in the format -N, where N is number of days (0 -99999) preceding to the current date.
JOBNAME	The job name for which the reports are selected. This can be a specific value or a mask pattern. Optional.
REPNAME	The report name for which the reports are selected. This can be a specific value or a mask pattern. Optional. If the report name contains embedded spaces, place the report name between apostrophes.
JOBID	The Job ID of the job producing the report. Format depends on JES definitions; either JOBn..n, where n..n is the job number containing 5 digits or Jn..n, where n..n is the job number containing 7 digits. Optional.
PATH	The name of the index path that should be checked. optional. The index path should include all index levels loaded to the DB2 table. Locations should be separated by a slash, using the following syntax: main-ixname/sub-index1/sub-index2... This parameter can be specified several times in order to check the integrity of several index paths during a single utility run. If this parameter is omitted, all index paths that are described in the CTDGIDB2 member are checked for the selected reports.

Parent Topic

CTVGICHK – Global Index database integrity check