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 SAPThe 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