Automation Engine Script Guide > AE JCL for Applications > SAP > R3_ACTIVATE_INTERCEPTED_JOBS

R3_ACTIVATE_INTERCEPTED_JOBS

Processes intercepted jobs under AE's control. Intercepted jobs that should be started are taken from a selection list.

Transaction: SM37

Interface: Standard (XBP 2.0)

Syntax

R3_ACTIVATE_INTERC[EPTED_JOBS]

Syntax

Description/Format

GROUP=

Selection of Intercepted jobs by group (such as "xxx*").
Value format: script literal

Default value: "*"

USER=

Selection of Intercepted jobs by user (such as "xxx*").
Value format: script literal

Default value: "*"

NOFOUND=

Action if no intercepted jobs are selected.
Value format: script literal

Allowed Values NORMAL (default value) and ABEND 

NORMAL - Execution of the script is continued, the AE job ends normally.
ABEND - Execution of the script is stopped, the AE job ends abnormally.

ERROR=

Action if one of the selected Intercepted jobs ends abnormally
Value format: script literal

Allowed Values: ABEND (default value) and IGNORE 

ABEND - Script execution stops, the AE job ends abnormally.
IGNORE - Script execution continues, the AE job ends normally.

SEL[ECT]=

Single or permanent selection.
Value format: script literal

Allowed values: ONCE (default value) and EVERY 

ONCE - The number of selected jobs are calculated once.
EVERY - The number of selected jobs are calculated after each job release. In doing so, scheduled jobs can be paralleled.

START_D[ATE]=

Start date of Intercepted job selection
Value format: script literal

Date format: YYYYMMDD
Default value: 20000101

If this parameter is used without the  parameter END_DATE=, all scheduled jobs will be selected and start commencing as of the specified start date .

START_T[IME]=

Start time of Intercepted job selection.
Value format: script literal

Time format: HHMMSS
Default value: 000000

If this parameter is used without the parameter END_TIME=, all scheduled jobs will be selected and start commencing as of the specified start time. 11:59pm is the valid end time.

END_D[ATE]=

End date of Intercepted job selection.
Value format: script literal

Date format: YYYYMMDD
Default value: current date

In order to select all jobs scheduled in one day, this parameter must be entered and the same date be used as with the parameter START_DATE=.

END_T[IME]=

End time of Intercepted job selection.
Value format: script literal

Time format: HHMMSS
Default value: 235959

JOBCOUNT=

Number of the Intercepted job.
Value format: script literal

Default value: "*"

In connection with the NAME (SAP job name), a unique SAP job can be identified.

NAME=

Selection of one or more Intercepted jobs by name.
Value format: script literal

In connection with the JOBCOUNT (SAP job number), a unique SAP job can be identified.
For the selection of several jobs, the "*" wildcard character can be used (such as 'xxx*').

TARGET_S[ERVER]=

Target system that should be used by an Intercepted job.
Value format: script literal

Allowed values: KEEP (default value) and ATTRIBUTE

KEEP - The target system that is defined in the original job is kept.
ATTRIBUTE - The target system of the job's host attributes is used.

WAIT=

Waits for an Intercepted job's children to end.
Value format: script literal

Allowed values: YES and NO (default value)

NO = Do not wait for all children to end.
YES = Wait for all children to end.

REPL[ICATE]=

Handling the children of intercepted jobs.
Format of the value: script literal

Allowed values: YES and NO (default value)

YES - The children of a job are replicated in the AE system. They are displayed in the Activity Window of the UserInterface. Statistical records and reports are also generated in the AE system.
NO - There is no replication in the AE system.

ABORTED=

Reaction to the abnormal end of an Intercepted job's children.
Value format: script literal

Allowed values: YES (default value) and NO

YES - The script stops, AE job ends abnormally.
NO - The script continues, AE job ends normally.

GET_SPOOL=

Requests the spool list of the started job.
Format of the value: script literal

Allowed values: YES or NO (default)

YES = The spool list is requested. It is stored as a text file in the directory that has been defined in the SAP agent's INI file with the parameter Download_dir= (Sektion [GLOBAL]). The name of this 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.

NO = The spool list is not requested.

Comments

This script element determines all Intercepted jobs according to specified selection criteria. The SAP client specified in the AE job's Login object is used for the selection.

Examples

All Intercepted jobs of the following example should be started. The AE job should not abort if no Intercepted jobs can be found.

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

  

See also: