Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

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



(tick)

(tick)

(tick)

Environment Variable

USAPRESTART=option



(tick)

(tick)


Configuration File Keyword

restart option



(tick)

(tick)

(tick)

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.
  • 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.

  • No labels