RESTART - USAP configuration option
Description
The RESTART option specifies whether or not this execution of Universal Connector is a restart of a previous client fault tolerant Universal Connector command.
See Client Fault Tolerance - Universal Connector for details on the client fault tolerant feature.
Usage
|
Method |
Syntax |
IBM i |
HP NonStop |
UNIX |
Windows |
z/OS |
|
Command Line, Short Form |
n/a |
|
|
|
|
|
|
Command Line, Long Form |
-restart option |
|
|
|
|
|
|
Environment Variable |
USAPRESTART=option |
|
|
|
|
|
|
Configuration File Keyword |
restart option |
|
|
|
|
|
Value
option is the specification for whether or not this execution of USAP is a restart.
Valid values for option are:
- yes
Universal Connector is restarting an existing unit of work represented by a command ID.- For jobs, the COMMAND_ID and Client Fault Tolerant (CFT) options configuration options are required.
- For process chains, the CHAIN_ID and LOG_ID configuration options are required.
- no
Universal Connector is not restarting. - auto
Universal Connector checks the SAP system to determine if a job associated with the COMMAND_ID option already exists.- If a matching command ID job is found, Universal Connector will work with the found job and take the appropriate actions to satisfy the command line - starting the job if necessary, monitoring, returning output, etc.
- If a matching command ID job is not found, Universal Connector does not perform a restart and executes the command line as a new unit of work.
The COMMAND_ID and Client Fault Tolerant (CFT) options are required.
Default is no.
Note
If you select the auto value, Universal Connector will not start a new instance of a job on the SAP system if a job matching the job name/command ID exists in the SAP system. Universal Connector will continue to reconnect to the existing SAP job. Without considering the behavior resulting from the use of auto, it may be possible for one to assume that a job has been run multiple times when, in fact, Universal Connector has been reconnecting to the same job instance. Informational messages are printed by Universal Connector to standard error to indicate the reconnected status but, if the message level is not set to info, the messages will not be seen.
Given the possibility for confusion surrounding the use of auto, the ALLOW_AUTO_RESTART option lets you control the use of auto.
Command Usage
The RESTART option is a CFT (Client Fault Tolerant) option.
CFT (Client Fault Tolerant) options are associated with program execution, not commands. They are used to configure a client fault tolerant job run.