Previous Topic: BASE ParameterNext Topic: MSGLEVEL Optional Parameter


AIX Parameter

The AIX parameter specifies the name of the alternate index as defined in the catalog. An AIX parameter is required for each run of GVBLDIX. The alternate index must be:

Syntax

AIX

AIX parameter

Operands

The AIX parameter is specified with the following operands:

Operand

Explanation

aix.cluster.name

The 44-character entryname as defined in the catalog.

/password

The optional password for the cluster. If specified, the password must be delimited by a slash (/).

DROP=X' hex data '

DROP=C' character data '

(Optional.). DROP omits unwanted alternate index keys. GVBLDIX does not build alternate index records matching the DROP key. There is no limit on the number of DROP keys that can be specified. A dash (-) is the only continuation character permitted, and it must immediately follow the last character in the key. The DROP key must be the same length as the alternate index key; no generics or fillers are supported.

RESET

(Optional.). RESET indicates that the alternate index is opened with the MACRF=RST option. For RESET to be effective, the alternate index must be defined with REUSE. RESET eliminates the need to perform an IDCAMS DELETE and DEFINE before building the alternate index with GVBLDIX. The alternate index's high-used RBA is set to 0 when it is opened, emptying the file. The default is MACRF=NRS (no reset).

KEYS(length offset)

(Optional.). KEYS builds alternate index keys from discontiguous fields in the base record. The fields are concatenated in the order of the keys. Up to ten discontiguous keys can be specified. The sum of the lengths of the key segments must equal the length of the alternate key as specified in the alternate index definition.

To use alternate indexes built with discontiguous keys, use the GVPATH interface program. GVPATH allows access to the base cluster through the discontiguous key alternate index in sequential or direct processing mode.

NUNQLIMIT=n

(Optional.). NUNQLIMIT specifies an upper limit on the number of nonunique keys added to an alternate index record, limiting the number of base records represented by the alternate index. The default is no upper limit. NUNQLIMIT must be in decimal form. The number of nonunique keys in an alternate index record is limited ¢y the maximum record size as specified in the alternate index definition.