Control statements for the Index Builder task

The control statement block for the Index Builder task contains the user specifications for controlling the index building process.

The following table shows the control statements that you can specify for the Index Builder task. You cannot specify any control statements other than those listed in the following table.

For details about the control statements of IMS Index Builder and their default values, see the IMS Index Builder 3.1 User's Guide.

Table 1. Control statements for the Index Builder task
Keyword Acceptable values Corresponding control statement in IMS Index Builder Description
CLASS qualifier [.%TIME] CLASS qualifier [ .%TIME ]

Specifies the high-level qualifier of the stripe data sets that are generated by IMS Index Builder.

Without the %TIME parameter, the maximum length is 17 characters.

If you specify the %TIME parameter, the maximum length is 14 characters including .%TIME.

MAXTASKS nn [ ,PSORT ] MAXTASKS nn [ ,PSORT ]

Specifies the number of subordinate address spaces (SASs).

For non-HALDBs, you can specify only MAXTASKS=0. (See Note)

For HALDBs, specify a value for nn in the range of 2 - 36. You can also specify the PSORT keyword.

SIDXBUF nnn,nnn (nnn= 1 - 255) SIDXBUF nnn,nnn

Specifies the number of VSAM buffers that are used in the load process for each secondary index.

SORTFILSZ nnnnnnnnnn SORTOPT FILSZ=nnnnnnnnnn

Specifies the FILSZ parameter for the SORT OPTION statement.

SORTFSZ nnnnnnnnnn SORTFSZ=nnnnnnnnnn

Triggers striped sort mode. The value specifies the size of the sort stripes. This statement is valid only for HALDBs.

SORTMAINSIZE nnnnnnnnnn SORTOPT MAINSIZE=nnnnnnnnnn

Specifies the MAINSIZE parameter for the SORT OPTION statement.

SORTOPT (option1,option2,...) SORTOPT option1,option2,...

Specifies SORT parameters to be appended to the SORT OPTION statement.

Parameters must be separated by commas and enclosed in parentheses. The maximum length of the string inside the parentheses is 33 characters.

If SORTFILSZ or SORTMAINSIZE is specified with SORTOPT, the option strings are concatenated, and the total length must be 33 characters or fewer.

SVCDUMP YES or NO SVCDUMP YES or NO

Specifies whether IMS Index Builder requests an SVC dump file after a system abend or a user abend.

TMRWAIT nnnn (nnnn= 0 - 9999) TMRWAIT nnnn

Specifies the timeout value in seconds. If you specify 0, timeout does not occur.

Note: IMS Index Builder 3.1 (with APAR PM17738) or later supports MAXTASKS=0 control statement when all of the following conditions are met:
  • The database is a non-HALDB.
  • Type-A physical image copy is not requested for secondary indexes.
  • HASH pointer check is not requested in the Index Builder task.
Restriction: The following control statements, which were supported in IMS Index Builder 2.3, are not supported in IMS Index Builder 3.1:
  • ALTER
  • CATLG
  • EXEC
  • NDXIOBUF
  • SORTE35
  • SORTSTAT
  • SORTID
  • SORTOUT
  • STEPLIB
  • TRACE