Fonction SAP BAPI_XBP_JOB_EXT_STEP_MODIFY - Assign an External Program to a Particular Job Step

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
EXTERNAL_USER_NAME BAPIXMLOGR-EXTUSER C 16 Name of the SAP-External User
EXT_PROGRAM_NAME BAPIXMSTEP-PROGRAM C 128 ABAP Program Name
EXT_PROGRAM_PARAMETERS BAPIXMSTEP-PARAMETER C 255 SPACE X ABAP Variant Name
JOBCOUNT BAPIXMJOB-JOBCOUNT C 8 Job Count
JOBNAME BAPIXMJOB-JOBNAME C 32 Job Name
SAP_USER_NAME BAPIXMSTEP-AUTHCKNAM C 12 SY-UNAME X SAP User Name
STEP_NUMBER BAPIXMJOB-STEPCOUNT I 4 Number of the Job Step to be Modified
TARGET_HOST BAPIXMSTEP-XPGTGTSYS C 32 Executing Host for External Program
WAIT_FOR_TERMINATION BAPIXMAUX-CHAR1 C 1 'X' X Job Waiting (Yes / No)

Paramètre Reférence Type Long. Description
RETURN BAPIRET2 u 548

Functionality
With this method you can change a job step that you created with themethod BackgroundJob.AddExternalStep. All job step attributes can bechanged.
Here you can only modify job steps that are to execute externalprograms or external commands.

Further information
XBP documentation (SAPnet/CCMS)

Description
INCLUDE BAPI_TABLE

Value range
MSG_JOBID_MISSING: You have not identified the job to which the jobstep is to be added. Either the job name or the job count is missing,or both.
MSG_JOB_DOES_NOT_EXIST: The job that you specified by job name and jobcount does not exist in the R/3 System.
MSG_STEP_COUNT_MISSING: You have not specified the ID number of the jobstep to be modified.
MSG_INVALID_STEP_COUNT: The ID number of the job step to be modified isinvalid, that is, no job step exists with that number.
MSG_PROGRAM_NAME_MISSING: You have not specified the ABAP program thatis to be executed.
MSG_PROBLEM_DETECTED: the backgroud processing system detected anerror. For a detailed description of the problem, see the R/3 Systemlog.
MSG_CANT_LOG: The method call was terminated because of an error in theR/3 System XMI logging system.
MSG_EXT_USER_MISSING: The name of the external user was not specifiedin the call. This name specifies which user transmitted the call in theexternal system.
MSG_NOT_LOGGED_ON: The external system administration tool has notlogged onto the CCMS XMI interface. The method call was terminated as aresult.

Default
INCLUDE BAPI_XBP_EXTERNAL_USER_NAME ID TX
INCLUDE BAPI_XBP_EXT_PROGRAM_NAME_A ID TX
INCLUDE BAPI_XBP_EXT_PROGRAM_PARM_A ID TX
INCLUDE BAPI_XBP_JOBCOUNT ID TX
INCLUDE BAPI_XBP_JOBNAME ID TX
INCLUDE BAPI_XBP_SAP_USER_NAME ID TX
INCLUDE BAPI_XBP_STEP_NUMBER_REFER ID TX
INCLUDE BAPI_XBP_TARGET_SERVER_A ID TX

Description
With this parameter, you can have the background job wait for theexternal program to complete before processing the next job step(synchronous job step processing). This option is active by default.
This setting may be useful in the following cases:

  • You want to include the return code of the external program in the job
  • log.
    • You are using the options to divert the standard output to the job log.