Description

The START JOB command starts a currently defined SAP job.

Command Line Syntax

The following figure illustrates the command line syntax of the START JOB command, using the command line, long form of its configuration options.

-start -jobname jobname [-jobid jobid]
    [-immediate]
    [-targetserver server]
    [-resolve_multi_model option]
    [-wait 
        [-poll seconds] 
        [-joblog {yes|no}]
        [-spoollist {yes|no}]
        [-rawspool {yes|no}]
        [-purge]
        [-waitchild {yes|no}]
        [-joblogchild {yes|no}]
        [-spoollistchild {yes|no}]
        [-purgechild {yes|no}]
        [-terminatedec exitcode]
        [-finishedec exitcode]
    ]
    [-bdcwait        [-bdcjobnameptrn pattern]
        [-bdcjobidptrn pattern]
        [-bdcqidptrn pattern]
        [-qtobecreatedec exitcode]
        [-qunprocessedec exitcode]
        [-qinbackgroundec exitcode]
        [-qfinishedec exitcode]
        [-qerrorec exitcode]
    ]

Configuration Options

The following table describes all START JOB configuration options and provides the command line, long form of each option illustrated in the START JOB command line syntax, above.

Configuration Option Name	Command Line Long Form	Description
BATCH_MONITOR	-bdcwait	Causes USAP to perform batch input monitoring for the job being started.
EXIT_JOB_FINISHED	-finishedec	USAP exit code for the SAP job finished status.
EXIT_JOB_TERMINATED	-terminatedec	USAP exit code for the SAP job terminated status.
EXIT_QUEUE_BACKGROUND	-qinbackgroundec	USAP exit code for the SAP queue state 'S' (in background).
EXIT_QUEUE_CREATED	-qtobecreatedec	USAP exit code for the SAP queue state 'C' (to be created).
EXIT_QUEUE_ERROR	-qerrorec	USAP exit code for the SAP queue state 'E' (error).
EXIT_QUEUE_FINISHED	-qfinishedec	USAP exit code for the SAP queue state 'F' (finished).
EXIT_QUEUE_UNPROCESSED	-qunprocessedec	USAP exit code for the SAP queue state ' ' (unprocessed).
IMMEDIATE_JOB	-immediate	Causes the job to be started immediately.
JOB_ID	-jobid	Job ID of an existing SAP job to use as a model for the new job definition.
JOB_LOG_CHILD	-joblogchild	Controls the printing of job logs for child jobs.
JOB_NAME	-jobname	Name of an existing SAP job to use as a model for the new job definition.
JOB_ID_PATTERN	-bdcjobidptrn	Locates the header record and determines the offset of the job ID in the RSBDCSUB batch input processing report.
JOB_NAME_PATTERN	-bdcjobnameptrn	Locates the header record and determines the offset of the job name in the RSBDCSUB batch input processing report.
PURGE_CHILD_JOBS	-purgechild	Controls the purging of child jobs.
PURGE_JOB	-purge	Purge job that has completed processing from SAP system.
QUEUE_ID_PATTERN	-bdcqidptrn	Locates the header record and determines the offset of the queue ID in the RSBDCSUB batch input processing report.
RAW_SPOOL	-rawspool	Specification for whether the SAP spool lists will be returned from the SAP system in raw or plain format.
RESOLVE_MULTI_ MODEL	-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.
RETURN_JOB_LOG	-joblog	Specification for whether or not the job's joblog is returned.
RETURN_SPOOL_LIST	-spoollist	Specification for whether or not the spoollists of all job steps are returned.
SPOOL_LIST_CHILD	-spoollistchild	Controls the printing of spoollists for child jobs.
TARGET_SERVER	-targetserver	Server on which the job will run.
USAP_POLL	-poll	Length of time to wait between job status calls to the SAP system.
WAIT	-wait	Wait for the SAP job to complete processing.
WAIT_FOR_CHILD_JOBS	-waitchild	Controls the monitoring of child jobs.

Universal Agent 7.4.x

START JOB - USAP Command

Description

Command Line Syntax

Configuration Options