BeispieldokumentationProgrammbeispiel: Job-Step für ein externes Kommando oder Programm hinzufügen

 

Es gibt zwei Methoden zum Einplanen von externen Programmen und Kommandos in einem Job-Step. Dies sind:

  • Externe Kommandos: Vordefinierte symbolische Namen für Kommandos oder Programme auf Betriebssystemebene. Externe Kommandos sind für normale Benutzer gedacht. Da sie in SAP-System vordefiniert sind und einer Berechtigungsprüfung unterliegen, hat der Administrator die Kontrolle darüber, was Benutzer über Hintergrund-Jobs auf Betriebssystemebene tun können.

  • Externe Programme: Betriebssystemkommandos, die direkt in die Job-Step-Angaben eingegeben werden und für die im SAP-System keine spezielle Berechtigungsprüfung durchgeführt wird. Die Verwendung externer Programme ist Administratoren vorbehalten (spezielle Berechtigung erforderlich).

Sie können in einem Job-Step entweder ein externes Kommando oder ein externes Programm einplanen, aber nicht beides. Zur Einplanung eines externen Kommandos verwenden Sie die Parameter COMMANDNAME und OPERATING SYSTEM. Zur Einplanung eines externen Programms verwenden Sie den Parameter EXTPGM_NAME.

Sowohl externe Kommandos als auch externe Programme verwenden die EXTPGM-Parameter mit Ausnahme von EXTPGM_NAME.

Weitere Informationen finden Sie unter Externe Kommandos und externe Programme.

Syntax Syntax

  1. * 
* Add a job step: external program 
* 
  CALL FUNCTION 'JOB_SUBMIT'
   EXPORTING
     AUTHCKNAM      = SY-UNAME             “ User for runtime
                                           “ authorizations
     JOBCOUNT       = JOBNUMBER            “ From JOB_OPEN
     JOBNAME        = JOBNAME              “ From JOB_OPEN
     COMMANDNAME    = EXTERNAL_COMMAND     “ Name of a pre-defined
                                           “ external command.  
                                           “ COMMANDNAME and
                                           “ EXTPGM_NAME are
                                           “ mutually-exclusive
                                           “ alternatives.  Both
                                           “ use the EXTPGM
                                           “ parameters.  
     OPERATINGSYSTEM= 'AIX'                “ Operating system for
                                           “ choosing COMMANDNAME
                                           “ variant.   
     EXTPGM_NAME    = '/usr/exe/myexe'     “ Pathname of an
                                           “ external program;  
                                           “ an authorization
                                           “ for S_RZL_ADM (CC
                                           “ Control Center:  
                                           “ System Administration)
                                           “ is required.  
     EXTPGM_PARAM  =  '<Parameter String>' “ Program parameters
     EXTPGM_SYSTEM      = 'host01'         “ Host for execution
     EXTPGM_WAIT_FOR_TERMINATION = 'X'     “ Control flags for
     EXTPGM_STDOUT_IN_JOBLOG = 'X'         “ external programs:
     EXTPGM_SET_TRACE_ON     = 'X'         “ see RSXPGDEF
     EXTPGM_STDERR_IN_JOBLOG = 'X'         “ documentation for
                                           “ EXTPGM options
   EXCEPTIONS
     INVALID_JOBDATA         = 02
     JOBNAME_MISSING         = 03
     JOB_NOTEX               = 04
     JOB_SUBMIT_FAILED       = 05
     LOCK_FAILED             = 06
     PROGRAM_MISSING         = 07
     PROG_ABAP_AND_EXTPG_SET = 08
     BAD_XPGFLAGS            = 09
     OTHERS                  = 99.
 IF SY-SUBRC > 0.
   <Error processing> 
  ENDIF.
Ende des Codes