Integrated auxiliary utility parameters for IMS HP Pointer Checker

The integrated auxiliary utility parameters for IMS High Performance Pointer Checker are described here.

Syntax diagram

This syntax diagram shows the parameters which are associated with the IMS High Performance Pointer Checker auxiliary utility.

Integrated auxiliary utility parameters for IMS High Performance Pointer Checker

Read syntax diagramSkip visual syntax diagramBITMAP(YESNO),DUMPFORM(FORMATUNFORMAT),FABASNAP(YESNO),FSEMAP(YESNO),INTERVAL(DATASETBITMAPBLOCK( nn)),INTFS(YESNO),INTST(YESNO),MAXFSD(YESNO),PCJOBNM( cccccccc),PCPREF(ccccccccc),PCPROCNM( cccccccc),PRINTDATA(NOYES),RUNTM(YESNO),SSPCHECK(NOYES),T2CHK(t2len,t2num)

Parameter reference

BITMAP(YES | NO)
Specifies whether you want to generate the Bit Map Display report for the HDAM, HIDAM, PHDAM, or PHIDAM database.

This option can be specified when TYPE=ALL or SCAN is also specified.

YES
The report is generated.

This is the default value.

NO
The report is not generated.
DUMPFORM(UNFORMAT | FORMAT)
Specifies the dump format that you want to print block dumps with.

This option can be specified when DIAGDUMP=FIRST100 in the OPTION is also specified.

This option can be specified with any TYPE= specification.
FORMAT
Specifies that the formatted dumps are to be printed.

This is the default value.

UNFORMAT
Specifies that the unformatted dumps are to be printed.
FABASNAP(YES | NO)
Indicates whether you request the FABASNAP report when using DEDB Pointer Checker.
YES
The report is generated.

This is the default value.

NO
The report is not generated.
FSEMAP(YES | NO)
Specifies whether you want to generate the Free Space Map report for the HDAM, HIDAM, PHDAM, or PHIDAM database.

This option can be specified when TYPE=ALL or SCAN is also specified.

YES
The report is generated.

This is the default value.

NO
The report is not generated.
INTERVAL(DATASET | BITMAP | BLOCK(nn))
Specifies whether you want to define the interval at which the Interval Statistics report and the Interval Free Space Summary report are produced.

This option can be specified when TYPE=ALL or SCAN is specified on the PROC statement, and when INTFS=YES or INTST=YES is specified on the REPORT statement.

It is effective only for HDAM, HIDAM, PHDAM, or PHIDAM databases.

DATASET
The reports are produced for the entire database data set only once.

This is the default value.

BITMAP
The reports are produced each time a bitmap block is processed.
BLOCK(nn)
The number represented by nn times 100, is the number of blocks that is processed between statistics intervals.

To code this field, you must include two integer digits. Use leading zeros, if necessary.

INTFS(YES | NO)
Specifies whether you want to generate the Interval Free Space Summary report for the HDAM, HIDAM, PHDAM, or PHIDAM database.

The report is produced each time an interval is processed and the information in the report is added to the next report. That is, the Nth report provides the total information of the 1st through Nth reports.

This option can be specified when TYPE=ALL or SCAN is also specified.

YES
The report is generated.

This is the default value.

NO
The report is not generated.
INTST(YES | NO)
Specifies whether you want to generate the Interval Statistics report for the HDAM, HIDAM, PHDAM, or PHIDAM database.

The report is produced each time an interval is processed; the information in the report is added to the next report. That is, the Nth report provides the total information of the 1st through Nth reports.

This option can be specified when TYPE=ALL or SCAN is specified.

YES
The report is generated.

This is the default value.

NO
The report is not generated.
MAXFSD(YES | NO)
Specifies whether you want to generate the Maximum Free Space Distribution report for the HDAM, HIDAM, PHDAM, or PHIDAM database.

This option can be specified when TYPE=ALL or SCAN is also specified.

YES
The report is generated.

This is the default value.

NO
The report is not generated.
PCJOBNM(cccccccc)
Use this optional parameter to specify a job name for the IMS HP Pointer Checker DMB Analyzer subordinate address space.

PCJOBNM() is mutually exclusive with PCPREF().

When specified, IMS HP Pointer Checker starts the address space with either the FABPATHZ procedure or, if specified, the PCPROCNM(cccccccc) procedure, and assign this to the job.

If not specified, IMS HP Pointer Checker starts the address space with the standard FABPATH0 procedure and FABPATH0 is the name of the job.

Start of changePCPREF(cccc | ccccc)End of change

Use this optional parameter to specify the prefix of the pointer checker started task name.

PCPREF() is mutually exclusive with PCJOBNM().

cccc
A 4-character alphanumeric prefix used to specify the pointer checker job name.

When a 4-character prefix is specified, the job name is constructed by using the format cccc0001.

Start of changecccccEnd of change
Start of changeA 5-character alphanumeric prefix used to specify the pointer checker job name.
When a 5-character prefix is specified, the job name is constructed by using the format ccccchhh, where:
ccccc
The specified prefix.
hhh
A number from 001 – FFF (hexadecimal), incremented with each new address space.
End of change
PCPROCNM(cccccccc)
Use this optional parameter to specify the procedure name to be used by IMS HP Pointer Checker to start the IMS HP Pointer Checker DMB Analyzer subordinate address space.

When specified, the procedure cccccccc is used. If PCJOBNM is specified in conjunctions with PCPROCNM, then PCJOBNM(cccccccc) is used as the JOBNAME for the address space.

If this parameter is not specified, then the procedure used depends upon the PCJOBNM specification and either FABPATH0 or FABPATHZ is used.

PRINTDATA(NO | YES)
Specifies whether you want to print the pointer data that is extracted by the program.

If you specify YES, you might get a large report that is of little use.

This option can be specified when TYPE=ALL or SCAN is also specified.

This option must be used for debugging purpose only.
NO
Any extracted pointer data is not printed.

This is the default.

YES
The extracted pointer data is printed.
RUNTM(YES | NO)
Specifies whether you want to generate the separator page for DB/DSG reports with Run Time Option.

This option can be specified when TYPE=ALL or SCAN is also specified.

YES
The report is generated.

This is the default value.

NO
The report is not generated.
SSPCHECK(YES | NO)
Specifies whether you want to perform subset pointer checking during the hash check process.
YES
Subset pointer checking is performed.
NO
Subset pointer checking is not performed.

This is the default value.

T2CHK(t2len,t2num)
Use the T2CHK parameter to ignore the short and known T2 errors that are not really errors in HISAM, HDAM, HIDAM, PHDAM, and PHIDAM databases.

This parameter requires the following values:

t2len
The minimum T2 record length to be reported (for HDAM, HIDAM, PHDAM, and PHIDAM).

The T2 records whose lengths are shorter than the specified minimum value are not to be reported.

This setting allows you to ignore short T2s that might not be actual errors.

t2num
The maximum number of T2 records not to be reported (for HISAM, HDAM, HIDAM, PHDAM, and PHIDAM).

By specifying a T2 record threshold value for this specification, the known T2 records are not reported.

This setting allows you to ignore known T2s that might not be actual errors, but are reported until the database is reorganized.