PROC control statement

The PROC control statement specifies the function to be run. One or more PROC control statements can be specified at a time.

In terms of TYPE=SUMMARY, ANALYSIS, and DELETE, each PROC control statement can be followed by one or more DATABASE control statements. TYPE=UPDATE needs to be followed by an OPTION statement. Each PROC control statement must have a matching ENDPROC control statement.

Subsections:

Syntax

The following syntax diagram shows the keywords for the PROC statement.

Read syntax diagramSkip visual syntax diagramPROC TYPE=LISTSUMMARYANALYSISDELETEREORGCREATEUPDATEATTRLIST ,,Optional keyword
Optional keywords
Read syntax diagramSkip visual syntax diagramKEYDATAFORM=FULLDATEONLYIMSID=*ALL(,imsid)

Keywords

The following keywords can be specified on the PROC statement:

TYPE=
Specifies the type of process to be performed.
LIST
Specifies to generate two types of reports: The HISTORY Data Set by DB-DS report and HISTORY Data Set by Key Date report.

A DATABASE control statement is not required (if coded, it is ignored).

SUMMARY
Specifies to generate the HD Pointer Checker Summary report.

This report summarizes the HD Pointer Checker run results for all the database data sets specified by the succeeding DATABASE control statements. The summary data for each database data set group is obtained from its last entry in the HISTORY data set, which is usually the result of the most recent HD Pointer Checker run for the database data set group.

When TYPE=SUMMARY is specified, FROM and/or TO parameters are not required for the associated DATABASE control statements (if coded, they are ignored). If DATABASE control statements are not specified, the report will contain information of all the database data sets that have entries in the HISTORY data set.

ANALYSIS
Specifies to generate the HD Analysis report for each database data set group specified by the succeeding DATABASE control statements. If DATABASE control statements are not specified, a report is printed for each database data set group that has entries in the HISTORY data set, using each of their latest entries.
DELETE
Specifies to delete entries from the HISTORY data set. At least one DATABASE control statement must follow.
REORG
Specifies to reorganize the HISTORY data set. A DATABASE control statement is not required (if coded, it is ignored).
CREATE
Specifies to initialize a new HISTORY data set. A DATABASE control statement is not required (if coded, it is ignored).
Notes:
  • The multiple entries option is inactive at initialization time. If you want to store multiple database data set entries per day, you need to run the FABGHIST program with the TYPE=UPDATE and OPTION MULTIENT=YES control statement.
  • The exportable option is inactive at initialization time. If you want to run Export Utility, you must run the FABGHIST program with the TYPE=UPDATE and OPTION EXPORTABLE=YES control statement.
  • The HISTORY lock option is set as GROUP at initialization. If you use more than one HISTORY data set among the HD Pointer Checker jobs, it is recommended that you change the HISTORY lock option by running the FABGHIST program with the TYPE=UPDATE and the OPTION HISTLOCK=DATASET control statement.
  • The Multiple-IMSID option is disabled at initialization time. If you want to use the IMSID parameter of the DBHDA PROC statement, you need to enable the Multiple-IMSID option by running the FABGHIST program with the TYPE=UPDATE and the OPTION MULTIIMSID=YES control statements.
UPDATE
Change the HISTORY data set option. The optional value is specified by the OPTION control statement.
ATTRLIST
Specifies to generate the HISTORY Attribute report. A DATABASE control statement is not required.
KEYDATAFORM=
Specifies the format of the data that will be printed in the KEYDATA fields of the HISTORY Data Set by Key Date report and the HISTORY Data Set by DB-DS report. This option is supported only for the TYPE=LIST process.
FULL
The data in the KEYDATA fields are shown with date and time. Each HISTORY data set record is shown in the report. This is the default.
DATEONLY
The data in the KEYDATA fields are shown with date only. When HISTORY data set records of the same DBNAME/DDNAME exist within the same day but with different time, they are shown as one entry in the report.
IMSID=
The report is sorted by IMSIDs. This parameter can be specified for TYPE=LIST, SUMMARY, ANALYSIS, or DELETE, and takes affect only when the Multiple-IMSID option is enabled. In case of TYPE=DELETE, you can specify the IMSIDs of the records in the HISTORY data set that are to be deleted.
(ims1,ims2,...)
Specifies IMSIDs to be reported or to be deleted. You can specify up to 10 IMSIDs.
*ALL
Records in the HISTORY data set of any IMSIDs are the target of the processing. This is the default when the Multiple-IMSID option is enabled.