The SET function allows you to change environment processing of options.
One common ability is to use ON-ERROR to establish how you want DBUTLTY to support error handling of functions within a specific execution, and for other special needs.
Two error handling issues of concern exist and each are enhanced with this function. The first is that if a function fails for any reason, each remaining function in the step is syntax edited and ignored. The second is that at the end of the last function, DBUTLTY ends with an abend 4 in z/OS or CANCEL in z/VSE and never a return code other than zero. These actions remain the default and cannot be globally changed.
The STOP and CONTINUE options indicate the execution option for future functions in the same utility step. The ABEND and RCn options indicate the actions taken to terminate the utility step back to the operating system. The STOP/CONTINUE options are completely independent from the ABEND/RCn options.
The SET function does not open any CA Datacom/DB tables.
A SET function can generate an error condition only for a syntax error. If syntax is correct, it always executes except if the EDIT function was previously specified.
The different types of SET options are used to do the following:
No SET option communicates with MUF. All are local to this DBUTLTY execution.
Some SET options are NEVER allowed to occur when done as part of the DBIN1PR additional SYSIN processing. These are the following:
Some SET option can ONLY occur when done as part of the DBIN1PR additional SYSIN processing. Remember that DBIN1PR SET statements are required to have SET in columns 1-3 with one blank then the value. These are the following:
Some SET options can occur at either input stream but must occur before functions other than SET, because they must occur before DBUTLTY configures itself for execution. These are the following:
SET options not the listed just given work through either input stream. They can be changed during execution to change the method of execution for the functions that follow them, remaining in place until or unless a later SET option changes the setting or condition.
The SET function at either input stream supports stacking of options. This reduces console messages. They must be separated by a semicolon (;) as in this example: SET OPTION1=DATANO=999;DATALN=4096;DXXNO=999;IXXLN=4096. DBUTLTY supports no form of continuation of an individual keyword value.
The SET function having a value starting with an asterisk (*) is accepted and printed but then ignored.
The following console-like options are not specifically SET options. They are allowed to be used as a SET option through the SYSIN but not through DBIN1PR. They are individually documented with the console-like commands in the CA Datacom/DB Database and System Administration Guide.
|
Copyright © 2014 CA.
All rights reserved.
|
|