Working With Job Definition Files

Initial Run of a Command ID Job

The following examples will submit, start, and wait for the command ID job defined in job definition file jobdef. Because the RESTART option is set to no, Universal Connector will scan the SAP system to ensure that a command ID job with the same job name/command ID pair does not already exist on the system.

If a matching command ID job is found on the SAP system, Universal Connector will exit with an error code before performing the job submission.

Pre-XBP 2.0 CFT Mode

usap -userid bob -pwd secret -submit jobdef -start -wait -cft_secure_cft no 
     -cft_target_host pwdf0196 -cft_cmd_prefix "cmd /C" -cmdid E8E8E80001 -restart no


Note

The Client Fault Tolerance Command ID Prefix (-cft_cmd_prefix) is set up for a Windows host. In many user environments, the Client Fault Tolerance Command ID Prefix option can be specified in the configuration file and will never need to be specified on the command line. The same is true for the Client Fault Tolerance Target Host option (-cft_target_host). The secure CFT option (-cft_secure_cft) also would be set in the configuration file in most cases.

Secure CFT Mode

usap -userid bob -pwd secret -submit jobdef -start -wait -cft_secure_cft yes 
     -cft_abap BTCTEST -cmdid E8E8E80001 -restart no

Note

In secure CFT mode, the (-cft_secure_cft) and (-cft_abap) parameters would most likely be specified in the Universal Connector configuration file.

Command Line Options

Command line options used in these examples are:

Command Options

Description

-userid

Remote user ID with which to execute the command.

-pwd

Password for the user ID.

-submit

Defines a job to the SAP system.

-start

Starts the newly defined job.

-wait

Wait for the SAP job to complete processing.

-cft_secure_cft

Mode of client fault tolerance to be used for the command invocation.

-cft_target_host

In pre-XBP 2.0 CFT mode, the target host to use for the command ID job step when the command ID option is used.

-cft_cmd_prefix

In pre-XBP 2.0 CFT mode, the prefix command required for the operating system of the target host.

-cft_abap

ABAP program to use for the command ID job step.

-cmdid

Identifier used to identify the unit of work represented by a USAP command and the associated SAP job.

-restart

Specification for whether or not this execution of Universal Connector is a restart of a previous client fault tolerant Universal Connector command.

Restart of a Command ID Job

In the following examples, Universal Connector is requested to restart command ID job E8E8E80001. Universal Connector will first parse the jobdef file to determine the jobname, and then scan the SAP system for a matching command ID job.

If a matching command ID job is found, Universal Connector reconnects to that job and satisfies the command line requirements. In this case, that means that if the job has not yet been started, it will be started, Universal Connector will wait for the job to complete (if it has not already), and the output will be returned.

If no matching command ID job is found, Universal Connector will terminate with an error code. Appropriate informational messages will be printed to standard error.

Pre-XBP 2.0 CFT Mode

usap -userid bob -pwd secret -submit jobdef -start -wait -cmdid E8E8E80001 -restart yes
     -cft_secure_cft no 

Secure CFT Mode

usap -userid bob -pwd secret -submit jobdef -start -wait -cmdid E8E8E80001 -restart yes
     -cft_secure_cft yes 

Command Line Options

Command line options used in these examples are:

Command Options

Description

-userid

Remote user ID with which to execute the command.

-pwd

Password for the user ID.

-submit

Defines a job to the SAP system.

-start

Starts the newly defined job.

-wait

Wait for the SAP job to complete processing.

-cmdid

Identifier used to identify the unit of work represented by a USAP command and the associated SAP job.

-restart

Specification for whether or not this execution of Universal Connector is a restart of a previous client fault tolerant Universal Connector command.

-cft_secure_cft

Mode of client fault tolerance to be used for the command invocation.

Run a Command ID Job Using Restart AUTO

In the following examples, Universal Connector will first scan the SAP system to determine if a matching command ID job exists.

If no matching command ID job is found, Universal Connector considers this to be the initial instance of this command ID job and defines the new command ID job to the SAP system. If a matching command ID job is found, Universal Connector reconnects with the existing SAP job.

After determining if the command ID job is initial or a restart, Universal Connector satisfies the command line requirements.

Pre-XBP 2.0 CFT Mode

usap -userid bob -pwd secret -submit jobdef -start -wait -cft_target_host pwdf0196 
     -cft_cmd_prefix "cmd /C" -cmdid E8E8E80001 -restart auto -cft_secure_cft no

Secure CFT Mode

usap -userid bob -pwd secret -submit jobdef -start -wait -cmdid E8E8E80001 -restart auto
     -cft_secure_cft yes

Command Line Options

Command line options used in these examples are:

Command Options

Description

-userid

Remote user ID with which to execute the command.

-pwd

Password for the user ID.

-submit

Defines a job to the SAP system.

-start

Starts the newly defined job.

-wait

Wait for the SAP job to complete processing.

-cft_secure_cft

Mode of client fault tolerance to be used for the command invocation.

-cft_target_host

In pre-XBP 2.0 CFT mode, the target host to use for the command ID job step when the command ID option is used.

-cft_cmd_prefix

In pre-XBP 2.0 CFT mode, the prefix command required for the operating system of the target host.

-cmdid

Identifier used to identify the unit of work represented by a USAP command and the associated SAP job.

-restart

Specification for whether or not this execution of Universal Connector is a restart of a previous client fault tolerant Universal Connector command.