Description

The MODIFY JOB command is used to modify an SAP job that already exists in an SAP system. A USAP job definition file is used to specify the modifications.

Job definition files are used to define new SAP jobs and to modify existing SAP jobs. The same syntactical rules apply to the job definition file in both cases with the following exceptions when modifying jobs:

SAP job identifier must be specified in order to identify the existing job to modify. The job identifier is specified in the job definition file using the JOBCOUNT keyword of the Job Header statement or the -jobid option of the MODIFY command. If both are used, the -jobid option overrides the JOBCOUNT value.
ABAP Step and External Step job definition statements must specify the step number of the existing job step to modify. The step number is specified using the STEP_NUMBER keyword of the ABAP Step and External Step job definition statements.

The parameter values specified in job definition file replace existing values in the SAP job definition. If a parameter is not specified in the job definition file, no change is made to the corresponding value in the existing SAP job definition.

See Universal Connector for SAP Job Definition Files for additional information on the job definition file.

Command Line Syntax

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

-modify filename/ddname
    [-jobid jobid]
    [-start 
        [-immediate]
        [-targetserver server]
        [-wait 
            [-poll seconds] 
            [-joblog {yes|no}]
            [-spoollist {yes|no}]
            [-rawspool {yes|no}]
            [-purge]
            [-waitchild {yes|no}]
            [-joblogchild {yes|no|error}]
            [-spoollistchild {yes|no}]
            [-purgechild {yes|no}]
        ]
    ]

Command Argument

The MODIFY JOB command can be expressed as either:

-M (Short form)
-modify (Long form)

The MODIFY JOB command argument, filename/ddname, specifies the name of the job definition file that contains the modification information.

See Universal Connector for SAP Job Definition Files for additional information on the variant definition file.

Configuration Options

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

Configuration Option Name	Command Line Long Form	Description
IMMEDIATE_JOB	-immediate	Causes the job to be started immediately.
JOB_ID	-jobid	Job ID of an existing SAP job to be modified.
JOB_LOG_CHILD	-joblogchild	Controls the printing of job logs for child jobs.
PURGE_CHILD_JOBS	-purgechild	Controls the purging of child jobs.
PURGE_JOB	-purge	Purge job that has completed processing from SAP system.
RAW_SPOOL	-rawspool	Specification for whether the SAP spool lists will be returned from the SAP system in raw or plain format.
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.
START	-start	Starts the newly defined job.
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.

Browser not supported