Working With Pre-defined SAP Jobs

Initial Run of a Command ID Job

The following examples will submit, start, and wait for the command ID job defined in the pre-existing SAP job with job name 'JOB_A' and job ID 19561301. 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.

Note that the Client Fault Tolerance Command ID Prefix is set up for a Windows host. In many user environments, the Client Fault Tolerance Command ID Prefix parameter can be specified in the configuration file and will never need to be specified on the command line. The same may be true for the Client Fault Tolerance Target Host parameter.

Pre-XBP 2.0 CFT Mode

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


Note

The Client Fault Tolerance Command ID Prefix is set up for a Windows host. In many user environments, the Client Fault Tolerance Command ID Prefix parameter can be specified in the configuration file and will never need to be specified on the command line. The same may be true for the Client Fault Tolerance Target Host parameter.

Secure CFT Mode

usap -userid bob -pwd secret -submit -jobname JOB_A -jobid 19561301 -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.

-jobname

Name of the SAP job.

-jobid

Job ID of the SAP job.

-start

Starts the newly defined job.

-wait

Wait for the SAP job to complete processing.

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

-cft_secure_cft

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

Restart of a Command ID Job

In the following example, Universal Connector is requested to restart command ID job E8E8E80001. Universal Connector will 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 hasn't 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 -jobname JOB_A -jobid 19561301 -start -wait 
     -cmdid E8E8E80001 -restart yes -cft_secure_cft no 

Secure CFT Mode

usap -userid bob -pwd secret -submit -jobname JOB_A -jobid 19561301 -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.

-jobname

Name of the SAP job.

-jobid

Job ID of the SAP job.

-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 -jobname JOB_A -jobid 19561301 -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 -jobname JOB_A -jobid 19561301 -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.

-jobname

Name of the SAP job.

-jobid

Job ID of the SAP job.

-start

Starts the newly defined job.

-wait

Wait for the SAP job to complete processing.

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

-cft_secure_cft

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