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 listShows entities in a grid view.

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=...]

Syntax

Description/Format

GROUP=

Selection of Intercepted jobs by groupAn Automation Engine object type that integrates tasks so that they can be processed together. (such as "xxx*").
Value format: scriptA particular Automation Engine object type. literal

Default value: "*"

USER=

Selection of Intercepted jobs by userIn the Automation Engine, a user is an instance of a User object, and generally the user is a specific person who works with Automic products. The User object is assigned a user ID and then a set of access rights to various parts of the Automation Engine system and product suite. These access rights come in the form of Automation Engine authorizations and privileges, Decision user roles and EventBase rights and ARA web application object rights. You can manage all these centrally in the ECC user management functions. See also, Unified user management. (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 jobAn Automation Engine object type for a process that runs on a target system. 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 releaseReleases combine a set of activities and a set of packages as well as other release artifacts under a timeline (a plan including milestones and phases), which can be planned, baselined and tracked.. 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 attributesPlatform-independent attributes of the Job object. 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 UserInterfaceThis is the Automation Engine's graphical user interface. [Formerly called the "Rich Client", "RichGUI" and "Dialog Client."]. 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 registeredThis is the status of a task that runs within a group and is waiting for its start. 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 clientA closed environment within an Automation Engine system where you can create and run objects. A client name consists of a 4-digit number that must be indicated when a user logs on to the Automation Engine system. Users and their rights are also defined in clients. A particular Automation Engine object type. specified in the AE job's Login objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task 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:

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH