Optional Parameters
- CATALOG(catname)
- names
the catalog in which the work files are to be defined. The work files
are defined and used by the BLDINDEX routine. When all alternate indexes
are built and the BLDINDEX routine no longer needs the work files,
they are deleted. See Catalog Selection Order for BLDINDEX for more information.
To use catalog names for SMS-managed data sets, you must have access to the RACF® STGADMIN.IGG.DIRCAT FACILITY class. See Storage Management Subsystem (SMS) Considerations for more information.
Abbreviation: CAT
- EXTERNALSORT|INTERNALSORT
- decides whether the key-pointer pairs are to be sorted entirely
within virtual storage.
- EXTERNALSORT
- specifies
that two external-sort work files are defined and built as entry-sequenced
clusters. You must provide two DD statements that describe the external-sort
work files to be defined by BLDINDEX. You can name the DD statements
IDCUT1 and IDCUT2. When you choose other names for the work file DD
statements, you must identify those DD statements with the WORKFILES
parameter.
Abbreviation: ESORT
- INTERNALSORT
- requires
access method services to sort the key-pointer pairs entirely within
the user-provided virtual storage, if possible. If you do not have
enough virtual storage available when you use INTERNALSORT, two external-sort
work files are built and the key-pointer pairs are sorted externally.
You must provide DD statements as for EXTERNALSORT. If the minimum
amount of virtual storage is not provided the BLDINDEX processing
ends with an error message. See z/OS DFSMS Using Data Sets for
more information about alternate indexes.
Abbreviation: ISORT
- {SORTCALL|NOSORTCALL}
- use this parameter to choose whether or not to call DFSORT to
sort the alternate index.
- SORTCALL
- specifies that you want DFSORT to sort the alternate index. EXTERNALSORT, INTERNALSORT, WORKFILES, CATALOG, IDCUT1, and IDCUT2 are ignored when DFSORT is called. If DFSORT is not available, BLDINDEX uses the IDCAMS internal sort. SORTCALL is the default.
- NOSORTCALL
- tells BLDINDEX to use the IDCAMS internal sort (or external sort if specified) instead of DFSORT to sort the alternate index. When the IDCAMS internal or external sort is used, SORTMESSAGELEVEL, SORTDEVICETYPE, SORTMESSAGEDD and SORTFILENUMBER specifications are prohibited.
- SORTDEVICETYPE(device type)
- specifies
the DASD device type passed to DFSORT in the DYNALLOC parameter in
the OPTION control statement. Use this parameter only if you wish
to override the default device type for DFSORT work data sets. See z/OS DFSORT Application Programming Guide for
further details on the DYNALLOC parameter. This parameter is not allowed
if you use NOSORTCALL.
Abbreviation: SORTDVT SDVT
- SORTFILENUMBER(number)
- the
maximum number of work data sets passed to DFSORT in the DYNALLOC
parameter in the OPTION control statement. Use this parameter to override
the number of work data sets that BLDINDEX determines are needed.
See z/OS DFSORT Application Programming Guide for
further details on the DYNALLOC parameter. This parameter is not allowed
if you use NOSORTCALL.
Abbreviation: SORTFN SFN
- SORTMESSAGEDD(ddname)
- is
the ddname that describes the DFSORT message data set. If there is
no DD statement for this ddname, a message data set with this ddname
is allocated dynamically as a SYSOUT=* data set. SYSOUT is the default
for ddname. Do not use any ddname reserved for use by IDCAMS (SYSPRINT
or SYSIN) or DFSORT. See z/OS DFSORT Application Programming Guide for
a list of reserved ddnames. This parameter is not allowed if you use
NOSORTCALL or SORTMESSAGELEVEL (NONE).
Abbreviation: SORTMDD SMDD
- SORTMESSAGELEVEL({ALL|CRITICAL|NONE})
- is
the level of DFSORT messages to print to the DFSORT message data set.
You cannot use this parameter with NOSORTCALL. Abbreviation: SORTML SML
- ALL
- Requires that all DFSORT messages and control statements are printed to the message data set.
- CRITICAL
- Allows only critical DFSORT messages to print to the message data set. No DFSORT control statements are printed. Critical is the default.
- NONE
- Allows no DFSORT messages or control statements to print to the message data set.
- WORKFILES(ddname[ ddname...])
- names the DD statements that describe the name and placement of
the work files you want BLDINDEX to define if you require an external
sort of the key-pointer pairs. See the CATALOG parameter for further
description of where the work files are defined. You can use DD statements
to describe two work files that are defined and opened before the
BLDINDEX routine begins processing the base-cluster's data records.
Exception: Do not use tape data sets as work data sets.
If one of the data sets is SMS-managed, the other must either be SMS-managed or a non-SMS-managed data set cataloged in the catalog determined by the catalog search order.
When you code the DD statements that describe the work files and identify them with the standard ddnames IDCUT1 and IDCUT2, you do not need to use the WORKFILES parameter.
Abbreviation: WFILE