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:

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