R3_ACTIVATE_INTERCEPTED_JOBS

Use the R3_ACTIVATE_INTERCEPTED_JOBS script element to retrieve and process intercepted jobs under the control of your AE system. Intercepted jobs that should be started are selected from a list. The SAP client that is specified in the Login object of the AE job is used for the selection.

Transaction: SM37
Interface: Standard (XBP 2.0)

Syntax

R3_ACTIVATE_INTERC[EPTED_JOBS]

    NAME=...
    [,GROUP=...]
    [,USER=...]
    [,NOFOUND=...]
    [,ERROR=...]
    [,SELECT=...]
    [,START_DATE=...]
    [,START_TIME=...]
    [,END_DATE=...]
    [,END_TIME=...]
    [,JOBCOUNT=...]
    [,TARGET_SERVER=...]
    [,WAIT=...]
    [,REPLICATE=...]
    [,ABORTED=...]
    [,GET_SPOOL=...]

Parameters

  • R3_ACTIVATE_INTERC[EPTED_JOBS]
    Retrieves and processes intercepted jobs under the control of your AE system

  • NAME=
    Selects one or several intercepted jobs on the basis of their names. Name and number clearly identify an individual SAP job. To select several jobs, you can use the * wildcard character, such as xxx*, for example.
    Format:     script literal

  • GROUP=
    (Optional) Selects intercepted jobs on the basis of groups such as xxx*, for example.
    Format: script literal
    Default value: "*"

  • USER=
    (Optional) Selects intercepted jobs on the basis of a user such as xxx*, for example.
    Format: script literal
    Default value: "*"

  • NOFOUND=
    (Optional) Action that should be taken if no intercepted jobs are selected
    Format: script literal
    Allowed values:

    • NORMAL (default)
      Script execution continues, the AE job ends normally

    • ABEND
      Script execution stops, the AE job ends abnormally

  • ERROR=
    (Optional) Action that should be taken if one of the selected Intercepted jobs ends abnormally
    Format: script literal
    Allowed values:

    • ABEND (default)
      Script execution stops, the AE job ends abnormally

    • IGNORE
      Script execution continues, the AE job ends normally

  • SEL[ECT]=
    (Optional) The selection applies once or permanently
    Format: script literal
    Allowed values:

    • ONCE (default)
      The number of selected jobs is calculated once

    • EVERY
      The number of selected jobs is recalculated whenever a job is released. Therefore, scheduled jobs can run in parallel.

  • START_D[ATE]=
    (Optional) Start date for the selected intercepted jobs. If you use this parameter without the END_DATE= parameter, all scheduled jobs are selected and start with the start date you specify here.
    Format: script literal
    Date format: YYYYMMDD
    Default value: 20000101

  • START_T[IME]=
    (Optional) Start time for the selected intercepted jobs. If you use this parameter without the END_TIME= parameter, all scheduled jobs are selected and start with the specified start time. 11:59 PM is the applied end time in this case.
    Format: script literal
    Time format: HHMMSS
    Default value: 000000

  • END_D[ATE]=
    (Optional) End date for the selected intercepted jobs. Use the same date for this parameter AND the START_DATE= parameter if you want to select all jobs that are scheduled on this day.
    Format: script literal
    Date format: YYYYMMDD
    Default value: current date

  • END_T[IME]=
    (Optional) End time for the selected intercepted jobs.
    Format: script literal
    Time format: HHMMSS
    Default value: 235959

  • JOBCOUNT=
    (Optional) Number of the intercepted job. Use this parameter together with the NAME (SAP job name) parameter to define a unique SAP job.
    Format: script literal
    Default value: "*"

  • TARGET_S[ERVER]=
    (Optional) Target system that the intercepted job should use.
    Format: script literal
    Allowed values:

    • KEEP (default)
      The target system that is defined in the original job is kept

    • ATTRIBUTE
      The target system that is defined in the host attributes of the job is used.

  • WAIT=
    (Optional) Waits until the children of an intercepted job end
    Format: script literal
    Allowed values:

    • NO (default)
      The system does not wait until the children have ended

    • YES
      The system waits until all children have ended

  • REPL[ICATE]=
    (Optional) Defines how the children of intercepted jobs are handled
    Format: script literal
    Allowed values:

    • NO (default)
      The children of intercepted jobs are not replicated in the AE system.

    • YES
      The children of a job are replicated in the AE system. They are displayed in the Process Monitoring perspective. Statistical records and reports are also generated in the AE system.

  • ABORTED=
    (Optional) Defines the reaction to an abnormal end of the children of an intercepted job
    Format: script literal
    Allowed values:

    • YES (default)
      The script stops, AE job ends abnormally

    • NO
      The script continues, AE job ends normally

  • GET_SPOOL=
    (Optional) Requests the spool list of the started job
    Format: script literal
    Allowed values:

    • NO (default)
      The spool list is not requested

    • YES
      The spool list is requested. It is stored as a text file in the directory that is defined in the INI file of the SAP Agent with the parameter Download_dir= ([GLOBAL] section). For more information, see Agent SAP

      The name of the text file is structured as follows:
      <SAP job count>_<step number>_<spool number>.txt
      This file is also registered as job output in the AE job. For more information, see Registered Job Output.

Examples

According to the following example, all intercepted jobs should start. The AE job shall continue if no intercepted jobs can be found.

R3_ACTIVATE_INTERCEPTED_JOBS NAME='*',GROUP='*',USER='*',NOFOUND='NORMAL'

See also:

seealso

About SAP JCL