SUBMIT JOB - USAP Command
Description
The SUBMIT JOB command defines a new SAP job.
Command Line Syntax
The following figure illustrates the command line syntax of the SUBMIT JOB command, using the command line, long form of its configuration options.
-sub {filename/ddname | -jobname jobname [-jobid jobid]}
[-target_jobname jobname]
[-model_status option]
[-resolve_multi_model option]
[-start
[-immediate]
[-targetserver server]
[-target_variant job step,variant name;job step,variant name;...]
[-wait
[-poll seconds]
[-joblog {yes|no}]
[-spoollist {yes|no}]
[-rawspool {yes|no}]
[-purge]
[-waitchild {yes|no}]
[-max_child_depth depth]
[-joblogchild {yes|no}|error}]
[-spoollistchild {yes|no}]
[-purgechild {yes|no}]
]
]
Command Argument
The SUBMIT JOB command can be expressed as either:
- -U (Short form)
- -sub (Long form)
The SUBMIT JOB command argument, filename/ddname, specifies the name of the file that contains the job definition.
See Universal Connector for SAP Job Definition Files for additional information on the job definition file.
Configuration Options
The following table describes all SUBMIT JOB configuration options and provides the command line, long form of each option illustrated in the SUBMIT JOB command line syntax, above.
Configuration | Command Line | Description |
|---|---|---|
-immediate | Causes the job to be started immediately. | |
-jobid | Job ID of an existing SAP job to use as a model for the new job definition. | |
-joblogchild | Controls the printing of job logs for child jobs. | |
-jobname | Name of an existing SAP job to use as a model for the new job definition. | |
-max_child_depth | Controls the maximum relationship depth that will be monitored by USAP. | |
-model_status | For operations that work with model jobs without providing a job ID to explicitly target a specific job on the SAP system, restricts the model job candidates to the specified job status. | |
-purgechild | Controls the purging of child jobs. | |
-purge | Purge job that has completed processing from SAP system. | |
-rawspool | Specification for whether the SAP spool lists will be returned from the SAP system in raw or plain format. | |
-resolve_multi_model | For operations that work with model jobs without providing a job ID to explicitly target a specific job on the SAP system, controls the behavior when multiple candidate jobs are found. | |
-joblog | Specification for whether or not the job's joblog is returned. | |
-spoollist | Specification for whether or not the spoollists of all job steps are returned. | |
-spoollistchild | Controls the printing of spoollists for child jobs. | |
-start | Starts the newly defined job. | |
-target_jobname | Name to give the newly created job. | |
-target_variant | One or more replacement variants for ABAP program job steps in an SAP job. | |
-wait | Wait for the SAP job to complete processing. | |
-waitchild | Controls the monitoring of child jobs. |