DSNU182I csect-name utility-name MUST BE THE ONLY UTILITY IN SYSIN

Explanation

Utilities must process certain objects alone or in a small logically related group in a single utility control statement. Also, some utility control statements must be the only control statement in the job step. This message indicates that one of these restrictions was violated.

The following list gives examples of these restrictions:

  • A CATMAINT utility control statement with the UPDATE UTILX option must be the only control statement in the job step.
  • A BACKUP SYSTEM utility control statement must be the only control statement in the job step.
  • The CHECK DATA utility must process DSNDB01.SYSUTILX alone. No other objects can be specified in the same CHECK DATA control statement, and no other control statements can be in the job step.
  • The CHECK INDEX utility must process DSNDB01.SYSUTILX indexes alone. No other objects can be specified in the same CHECK INDEX control statement, and no other control statements can be in the job step.
  • The COPY utility must process DSNDB01.SYSUTILX and its indexes alone. No other objects can be specified in the same COPY control statement, and no other control statements can be in the job step.
  • The QUIESCE utility must process DSNDB01.SYSUTILX alone. No other objects can be specified in the same COPY control statement, and no other control statements can be in the job step.
  • The RECOVER utility must process DSNDB01.SYSUTILX and its indexes alone. No other objects can be specified in the same RECOVER control statement, and no other control statements can be in the job step.
  • The RECOVER utility must process DSNDB01.DBD01 and its indexes alone. No other objects can be specified in the same RECOVER control statement, and no other control statements can be in the job step.
  • A REORG INDEX utility control statement for DSNDB01.SYSUTILX indexes must be the only control statement in the job step.
  • The REPAIR utility must process DSNDB01.SYSUTILX and its indexes alone. No other objects can be specified in the same REPAIR control statement, and no other control statements can be in the job step.
  • A RESTORE SYSTEM utility control statement must be the only control statement in the job step.

In most cases, these utilities tolerate the presence of DIAGNOSE, LISTDEF, OPTIONS, and TEMPLATE control statements, if those statements are required for processing.

csect-name
The name of the control section that issued the message.
utility-name
The name of the Db2 utility.

System action

If any work was performed by utilities in the same utility job step before the identified utility, that work persists. However, the utility that is identified in this message and any subsequent utilities are not executed, and the utility job step is placed in the stopped state.

User response

See the information about the failing utility for specific restrictions, which vary by utility.

Then, make the failing job step and control statement small enough to avoid the error. Remove other control statements and other objects from the failing statement until the error goes away. Remove the control statements that follow the failing statement and run them in a separate job step. If the error still occurs, remove the control statements that precede the failing statement, except those statements that are required to run the statement, such as TEMPLATE statements. If the error still occurs and the control statement lists multiple objects, put each object in separate control statements. Some grouping of objects might be possible in some cases, such as DSNDB01.SYSUTILX with its indexes.

Severity

8 (error)