OPTIONS

The OPTIONS online utility control statement specifies processing options that are applicable across many utility executions in a job step.

By specifying various options, you can:

  • Preview utility control statements
  • Preview LISTDEF or TEMPLATE definitions
  • Override library names for LISTDEF lists or TEMPLATE definitions
  • Specify how to handle errors during list processing
  • Alter the return code for warning messages
  • Restore all default options

You can repeat an OPTIONS control statement within the SYSIN DD statement. If you repeat the control statement, it entirely replaces any prior OPTIONS control statement.

Output

The OPTIONS control statement sets the specified processing options for the duration of the job step, or until replaced by another OPTIONS control statement within the same job step.

Authorization required

The OPTIONS control statement performs setup for subsequent control statements. The OPTIONS statement itself requires no privileges to execute.

Execution phases of OPTIONS

The OPTIONS control statement executes entirely in the UTILINIT phase, in which it performs setup for the subsequent utility.