Executes previously scheduled jobs in SAP under the control of AE. The jobs that should start are taken from a selection.
Transaction: SM37
Interface: AE and standard
[AE] [standard]
R3_ACTIVATE_JOB[S]
NAME=...
[,JOBCOUNT=...]
[,GROUP=...]
[,USER=...]
[,NOFOUND=...]
[,ERROR=...]
[,SELECT=...]
[,START=...]
[,NEW_NAME=...]
[,START_D[ATE]=...]
[,START_T[IME]=...]
[,END_D[ATE]=...]
[,END_T[IME]=...]
[,NO_DATE=...]
[,TARGET_S[ERVER]=...]
[,BEG_LOGLINES=...]
[,END_LOGLINES=...]
[,GET_SPOOL=...]
Syntax | Description/Format |
---|---|
NAME= |
Selection of one or more jobs by name. Name and number clearly identify an individual SAP job. The wildcard character "*" can be used (such as 'xxx*') if several jobs are selected. |
Parameter |
Further selection criteria in the form of a keyword and an assignment. Non-specified parameters obtain default values. Formats are applied for the keyword assignment. |
JOBCOUNT= |
Number of the SAP job. Name and number clearly identify an individual SAP job. |
GROUP= |
Job selection by groups (such as "xxx*"). Default value: "*" |
USER= |
Job selection by users (such as "xxx*"). Default value: "*" |
NOFOUND= |
Action if no jobs are found. Allowed Values NORMAL (default value) and ABEND NORMAL - Script execution continues, the AE job ends normally. |
ERROR= |
Action if one of the selected jobs ends abnormally. Allowed values: ABEND (default value) and IGNORE ABEND - Script execution stops, the AE job ends abnormally. |
SELECT= |
Single or permanent selection. Allowed values: ONCE (default value) and EVERY ONCE - The number of selected jobs is retrieved once. |
START= |
Select whether the original job or a duplicate should start. Allowed values: "ORIGINAL" (default value) and "DUPLICATE" |
NEW_NAME= |
Name of the job that should start as a duplicate. Only used when START=DUPLICATE has been specified. This parameter is ignored if the original job should be started. |
START_D[ATE]= |
Start date of the selected scheduled jobs. Date format: YYYYMMDD |
START_T[IME]= |
End time of the selected scheduled jobs. Time format: HHMMSS |
END_D[ATE]= |
End date of the selected scheduled jobs. Date format: YYYYMMDD |
END_T[IME]= |
Start time of the selected scheduled jobs. Time format: HHMMSS |
NO_DATE= |
Jobs without start date. Allowed values: "" (default value) and "X" |
TARGET_S[ERVER]= |
Target system that should be used by a released SAP job. Allowed values: KEEP (default value) and ATTRIBUTE KEEP - The target system that is specified in the original job is kept. |
BEG_LOGLINES= | Determines the number of lines that should be assumed to the AE job report (starting with the SAP job log's beginning). |
END_LOGLINES= |
Number of lines that should be written to the AE job report (starting with the SAP job log's ending). By default, the complete job log is used if neither the parameter END_LOGLINES nor BEG_LOGLINES have been specified. If only one of these two parameters is specified, the corresponding job-log lines (either from the beginning or the end) are read. In both parameters, you can only use numeric values. |
GET_SPOOL= |
Requests the spool list of the started job.
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: NO = The spool list is not requested. |
Releasing all planned jobs of user 'NI':
R3_ACTIVATE_JOBS NAME='*',GROUP='*',USER='NI'
In the second example, all jobs scheduled between 7/1/2001 12:00:00am and 7/2/2001 11:59:59pm are selected and started.
R3_ACTIVATE_JOBS NAME='*',GROUP='*',USER='SUPPORT',START_DATE='20010701',END_DATE='20010702'
In this example, all jobs scheduled between 7/1/2001 12:30:00pm and 7/2/2001 12:30:00pm are selected and started.
R3_ACTIVATE_JOBS NAME='*',GROUP='*',USER='SUPPORT',START_DATE='20010701',END_DATE='20010702'
[AE] [standard]
R3_ACTIVATE_JOB[S]
NAME=...
[,JOBCOUNT=...]
[,NOFOUND=...]
[,ERROR=...]
[,SELECT=...]
[,START=...]
[,NEW_NAME=...]
[,START_D[ATE]=...]
[,START_T[IME]=...]
[,END_D[ATE]=...]
[,END_T[IME]=...]
[,TARGET_S[ERVER]=...]
[,MON[ITOR]=...]
[,WAIT=...]
[,ABORTED=...]
[,REPL[ICATE]=...]
[,BEG_LOGLINES=...]
[,END_LOGLINES=...]
[,GET_SPOOL=...]
Syntax | Description/Format |
---|---|
NAME= |
Selection of one or more jobs by name. Name and number clearly identify an individual SAP job. The wildcard character "*" can be used (such as 'xxx*') if several jobs are selected. |
Parameter |
Further selection criteria in the form of a keyword and an assignment. Non-specified parameters obtain default values. Formats are applied for the keyword assignment. |
JOBCOUNT= |
Number of the SAP job. Name and number clearly identify an individual SAP job. |
NOFOUND= |
Action when no jobs are found. Allowed Values "NORMAL" (default value) and "ABEND" "NORMAL" - Script execution continues, the AE job ends normally. |
ERROR= |
Action if one of the selected jobs ends abnormally. Allowed values: "ABEND" (default value) and "IGNORE" "ABEND" - Script execution stops, the AE job ends abnormally. |
SELECT= |
Single or permanent selection. Allowed values: "ONCE" (default value) and "EVERY" "ONCE" - The number of selected jobs is retrieved once. |
START= |
Selection whether the original job or a duplicate should start. Allowed values: "ORIGINAL" (default value) and "DUPLICATE" |
NEW_NAME= |
Name of the job that should start as a duplicate. Only used if START=DUPLICATE has been specified. This parameter is ignored if the original job should start. |
START_D[ATE]= |
Start date of the selected scheduled jobs. Date format: YYYYMMDD |
START_T[IME]= |
Start time of the selected scheduled jobs. Time format: HHMMSS |
END_D[ATE]= |
End date of the selected scheduled jobs. Date format: YYYYMMDD |
END_T[IME]= |
Start time of the selected scheduled jobs. Time format: HHMMSS |
TARGET_S[ERVER]= |
Target system that should be used by a released SAP job. Allowed values: "KEEP" (default value) and "ATTRIBUTE" "KEEP" - The target system specified in the original job is kept. |
MON[ITOR]= |
Status monitoring in the activation log. Allowed values: "YES" and "NO" (default value) |
WAIT= |
Wait for SAP job children to end. Allowed values: "YES" or "NO" (default value) "NO" - Do not wait for all children to end. |
ABORTED= |
Reaction to abnormal end of SAP job children. Allowed values: "YES" and "NO" (default value) "NO" - SAP job (parent) does not abort. The script continues
and the AE job ends normally. |
REPL[ICATE]= |
Handling of the children of intercepted jobs. Allowed values: "YES" and "NO" (default value) "YES" - The children of a job are replicated in the AE system.
They are displayed in the UserInterface's Activity Window and statistical
records and reports are generated in the AE system. |
BEG_LOGLINES= | Determines the number of lines that should be assumed to the AE job report (starting with the SAP job log's beginning). |
END_LOGLINES= |
Number of lines that should be written to the AE job report (starting with the SAP job log's ending). By default, the complete job log is used if neither the parameter END_LOGLINES nor BEG_LOGLINES have been specified. If only one of these two parameters has been specified, the corresponding job-log lines (either from the beginning or the end) are read. In both parameters, you can only use numeric values. |
GET_SPOOL= |
Queries the spool list of the started job.
Allowed values: "YES" or "NO" (default value) "YES" = Queries the spool list which is stored as a text file in the directory that you define in the SAP agent's INI file, parameter Download_dir= (Sektion [GLOBAL]). The name of this file is structured as follows: "NO" = The spool list is not requested. |
Releasing all planned jobs with job name 'REORG_SPOOL':
R3_ACTIVATE_JOBS NAME='REORG_SPOOL',NOFOUND='ABEND'
See also: