SAP Function BP_JOB_COPY - Copy Background Request

Parameter Reference Type Length Default Optional Text
DIALOG BTCH0000-CHAR1 C 1 Mode: Dialog Yes/No
SOURCE_JOBCOUNT TBTCJOB-JOBCOUNT C 8 Job Count of the Job to be Copied
SOURCE_JOBNAME TBTCJOB-JOBNAME C 32 Job Name of the Job to be Copied
STEP_NUMBER TBTCJOB-STEPCOUNT I 4 0 X Job step ID number.
TARGET_JOBNAME TBTCJOB-JOBNAME C 32 SPACE X Job Name of the Job Copy (if not Online)

Parameter Reference Type Length Text
NEW_JOBHEAD TBTCJOB u 668 Job Count of the Job Copy

Parameter Reference Type Length Default Optional Text
RET I I 4 X Special Additional Error Code

Exception Text
CANT_CREATE_NEW_JOB Failed to Create New Job
CANT_ENQ_JOB Failed to Lock Source Job
CANT_READ_SOURCEDATA Failed to Read Source Job
INVALID_OPCODE Invalid Operation Code
JOBNAME_MISSING Name of Target Job Missing
JOB_COPY_CANCELED Copy was Canceled by the User
NO_COPY_PRIVILEGE_GIVEN No Authorization to Copy the Source Job
NO_PLAN_PRIVILEGE_GIVEN No Authorization to Schedule a Job

Functionality
Copies a background job. The copy of the job contains all job stepsand associated attributes, such as user authorization and print andarchiving specifications. However, the copy does not have any starttime specifications. You must enter this information yourself.
There are two different modes available to you for this functionmodule:

  • Interactive (DIALOG = BTC_YES): The user must specify the job name
    • and confirm or canel the copy process. Default names specified withTARGET_JOBNAME are ignored.
    • Non-interactive (DIALOG = BTC_NO): The job is copied without user
      • interaction. You must specify a new job name with TARGET_JOBNAME.

      Description
      Contains the data for the new job and is a structure of type TBTCJOB.

      Description
      Specifies whether the user is to be prompted in a dialog box to specifythe source and target jobs for copying.

      Value range
      The following values are permitted:

      • BTC_YES: Execute the function module in interactive mode and
        • query the user for specifications for source and target job.
        • BTC_NO: Do not execute the function module in interactive mode.
          • The specifications for source and target job must be available whenBP_JOB_COPY is called.
          These values are defined in the include program LBTCHDEF.

          Description
          ID number of the job to be copied.

          Description
          Enter the name of the job to be copied.

          Description
          Name of the target job; that is, the name of the job to be created bythis copy process.