Working With Pre-defined SAP Jobs
- Stonebranch (Deactivated)
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 |
|---|---|
Remote user ID with which to execute the command. | |
Password for the user ID. | |
Defines a job to the SAP system. | |
Name of the SAP job. | |
Job ID of the SAP job. | |
Starts the newly defined job. | |
Wait for the SAP job to complete processing. | |
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. | |
In pre-XBP 2.0 CFT mode, the prefix command required for the operating system of the target host. | |
Identifier used to identify the unit of work represented by a USAP command and the associated SAP job. | |
Specification for whether or not this execution of Universal Connector is a restart of a previous client fault tolerant Universal Connector command. | |
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 |
|---|---|
Remote user ID with which to execute the command. | |
Password for the user ID. | |
Defines a job to the SAP system. | |
Name of the SAP job. | |
Job ID of the SAP job. | |
Starts the newly defined job. | |
Wait for the SAP job to complete processing. | |
Identifier used to identify the unit of work represented by a USAP command and the associated SAP job. | |
Specification for whether or not this execution of Universal Connector is a restart of a previous client fault tolerant Universal Connector command. | |
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 |
|---|---|
Remote user ID with which to execute the command. | |
Password for the user ID. | |
Defines a job to the SAP system. | |
Name of the SAP job. | |
Job ID of the SAP job. | |
Starts the newly defined job. | |
Wait for the SAP job to complete processing. | |
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. | |
In pre-XBP 2.0 CFT mode, the prefix command required for the operating system of the target host. | |
Identifier used to identify the unit of work represented by a USAP command and the associated SAP job. | |
Specification for whether or not this execution of Universal Connector is a restart of a previous client fault tolerant Universal Connector command. | |
Mode of client fault tolerance to be used for the command invocation. |