Utility control statement specification

The utility control statements are used to direct the execution of the integrated auxiliary utilities.

The utility control statements can be specified by using either of these methods:

  • On the global UTILGBL() environmental control statement, either in the FRXDRFxx PROCLIB member or the //SYSIN DD input.
  • On the ADD command, by using the appropriate utility keyword, IB(), IC(), or PC().

Specifying the utility control statements on the UTILGBL() statement sets the default values that are used for any invocation of the utility. The values specified on the UTILGBL() statement are used by IMS Database Recovery Facility anytime any of the utilities are executed.

You can also specify most of the utility control statements on the ADD command by using the appropriate IB(), IC(), or PC() keyword. If multiple ADD commands are used, you must specify utility control statements that are specific to each ADD command. All databases that are specified on the ADD command use the same utility options that are specified on that command.

To invoke any of the integrated auxiliary utilities, the IB(), IC(), and PC() keyword must be specified on the ADD command. The utilities cannot be executed by only specifying utility control statements on the UTILGBL() statement, except the IMS Library Integrity Utilities which is invoked by using the LIU@GOPT keyword on the UTILGBL command.

If all the necessary parameters are already specified on the UTILGBL() statement, you can simply code the IB(), IC(), or PC() keyword without parameters. However, if you want to specify additional parameters or override a parameter that was specified on the UTILGBL() statement, you must use the appropriate utility keyword and specify the necessary parameters.

For example, to invoke all the utilities by using the default values, code the following ADD command:
ADD DB(HIDAM1) IC() IB() PC()
However, if you want to specify custom parameters for running IMS High Performance Image Copy, use the ADD IC() command with parameter specifications:
ADD DB(HIDAM1) DBATRB(DBDSL(101),DBDSN(101)), -
	     IC (ICHLQ(ichlq),SPACE(CYL,3,1),ICNMRULE(Y),ICCAT(Y), -
	     DSNTYPE(BASIC),COMP(N), -
	     STORCLAS(storcl),MGMTCLAS(mgmtcl),DATACLAS(datacl),UNIT(unit))