BASIS Function module Used the same way in S/4HANA

BP_JOB_MODIFY Modify Background Job

Changes the header, steps or start condition of an existing background job; with the operation code (OPCODE) it also releases or de-releases jobs. Administration tools that update job scheduling from a program use it. Only jobs that have not started yet can be changed; of its many exceptions handle at least JOB_NOT_MODIFIABLE_ANYMORE and NO_MODIFY_PRIVILEGE_GIVEN.

Function group
BTCH
Remote-enabled (RFC)
No
Type
Function module

Importing parameters

ParameterTypeDescriptionRequired
DIALOGBTCH0000-CHAR1Dialog modeYes
JOBNAMETBTCJOB-JOBNAMEJob name—
JOBCOUNTTBTCJOB-JOBCOUNTJob count—
OPCODEBTCH0000-INT4Operation code—
NEW_JOBHEADTBTCJOBNew job header—
RELEASE_STDTTBTCSTRTStart condition for release—
RELEASE_TARGETSERVERBTCTGTSRVR-SRVNAMETarget server—

Exporting parameters

ParameterTypeDescription
MODIFIED_JOBHEADTBTCJOBModified job header

Changing parameters

ParameterTypeDescriptionRequired
EMSGSYMSGError message—
RETIReturn code—

Tables parameters

ParameterTypeDescriptionRequired
NEW_STEPLISTTBTCSTEPNew step listYes

Exceptions

  • CANT_DERELEASE_JOB — Job could not be de-released
  • CANT_ENQ_JOB — Job could not be locked
  • CANT_READ_JOBDATA — Job data could not be read
  • CANT_RELEASE_JOB — Job could not be released
  • CANT_SET_JOBSTATUS_IN_DB — Job status could not be set in database
  • CANT_START_JOB_IMMEDIATELY — Job cannot start immediately
  • CANT_UPDATE_JOBDATA — Job data could not be updated
  • INVALID_DIALOG_TYPE — Invalid dialog type
  • INVALID_NEW_JOBDATA — Invalid new job data
  • INVALID_NEW_JOBSTATUS — Invalid new job status
  • INVALID_OPCODE — Invalid operation code
  • INVALID_STARTDATE — Invalid start date
  • JOB_EDIT_FAILED — Job edit failed
  • JOB_MODIFY_CANCELED — Modification canceled
  • JOB_NOT_MODIFIABLE_ANYMORE — Job can no longer be modified
  • NOTHING_TO_DO — Nothing to do
  • NO_MODIFY_PRIVILEGE_GIVEN — No modify authorization
  • NO_RELEASE_PRIVILEGE_GIVEN — No release authorization
  • NO_BATCH_SERVER_FOUND — No batch server found

Call template (ABAP)

A skeleton generated from the interface. It lists mandatory importing parameters, exporting parameters and tables; declare the variables with suitable types in your own program.

CALL FUNCTION 'BP_JOB_MODIFY'
  EXPORTING
    dialog = lv_dialog
  IMPORTING
    modified_jobhead = lv_modified_jobhead
  CHANGING
    emsg = lv_emsg
    ret = lv_ret
  TABLES
    new_steplist = lt_new_steplist
  EXCEPTIONS
    cant_derelease_job = 1
    cant_enq_job = 2
    cant_read_jobdata = 3
    cant_release_job = 4
    cant_set_jobstatus_in_db = 5
    cant_start_job_immediately = 6
    cant_update_jobdata = 7
    invalid_dialog_type = 8
    OTHERS = 9.

Related tables

Can't find the report you need?

We also build anything that is not in the catalog. Describe it briefly and we will suggest the right solution.

Request a custom report