CMDRC_THRESHOLD_USE_PRESET parameter (defines a threshold for the return code of a UNIX-compatible command)
- Organization of this page
Format
#-adsh_conf CMDRC_THRESHOLD_USE_PRESET {ENABLE|DISABLE}
Description
This parameter defines a return code threshold for assuming normal termination of all the UNIX-compatible commands listed below. You can specify only 0 or 1 for the value.
-
cmp command
-
diff command
-
egrep command
-
expr command
-
grep command
-
sort command
You must use the CMDRC_THRESHOLD_DEFINE parameter to define a different threshold for a specific command.
Command names defined in this parameter are registered with an extension in Windows. For example, the cmp command is registered by the OS as follows:
-
In Windows edition: cmp.exe
-
In UNIX edition: cmp
If you intend to use the CMDRC_THRESHOLD_DEFINE parameter to change a threshold, you must define the command name with an extension.
Operands
- ENABLE
-
Specifies 1 as the return code threshold. As a result, commands that terminate with a return code of 1 are also considered to have terminated normally.
A threshold of 1 is also set for commands with the same name as the targeted UNIX-compatible commands.
- DISABLE
-
Specifies 0 as the return code threshold.
Notes
-
This parameter is applied to a command name following variable substitution or alias resolution.
-
If this parameter is defined in both the system environment file and the job environment file, the definition in the job environment file takes effect.
-
The setting for the successRC attribute of the #-adsh_rc_ignore and #-adsh_step_start commands of the job definition script takes precedence for the command action based on the command threshold specified by the ENABLE specification and the return code of the executed command.
-
Regardless of their specification order, the CMDRC_THRESHOLD_USE_PRESET parameter is always processed first when both it and the CMDRC_THRESHOLD_DEFINE parameter are specified.
Example
-
In this example, normal termination is assumed even when the return code of the targeted UNIX-compatible commands is 1:
#-adsh_conf CMDRC_THRESHOLD_USE_PRESET ENABLE