7.3.10 CMDRC_THRESHOLD_USE_PRESET parameter (defines a threshold for the return code of a UNIX-compatible command)
Syntax
#-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