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

R3_ACTIVATE_SESSIONS

Processes batch input sessions.

Transaction: SM35

Interface: AE

Syntax

R3_ACTIVATE_SESSION[S]

Syntax

Description/Format

NAME=

Selection of sessions by name (such as 'xxx*').
Format: script literal  

STATUS=

Selection of sessions by status.
Format: script literal  

Allowed Values: "" (default value) and "E"

"" - Session that should be processed.
"E" - Faulty session.

NOFOUND=

Action if no sessions have been selected.
Format: script literal  

Allowed values: "NORMAL" (default value) and "ABEND"

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

ERROR=

Action if  one of the selected sessions terminates abnormally.
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.

See:  ERROR/ERRORLEVEL with R3_ACTIVATE_SESSIONS

ERRORLEVEL=

Defines the number of erroneous transactions in percent (%).
Format: script literal  

Default value: "101"

The job ends abnormally if this number has been exceeded.

SELECT=

Single or permanent selection.
Format: script literal  

Allowed values: "ONCE" (default value) and "EVERY"

ONCE - The number of selected session is retrieved once.
EVERY - The number of selected sessions is retrieved after each session release. Therefore, released sessions can be parallelized.

JOBN[AME]=

Each session is processed with an SAP job.
Format: script literal  

Allowed values: "ATTRIBUTE" (default value) and "SESSION"

"ATTRIBUTE" - Contents of the "Job Name" text field in the host attributes. A standard AE job name is created if there is no text.
"SESSION" - Name of the session that should be processed.

ORDER[_BY]=

Criteria that can be used to sorting the selection of session. All field names of the SAP table APQI can be used. For example:  ORDER_BY=GROUPID

This parameter is supported for SAP version 4.6 and later ones.

R3_ACTIVATE_SESSION[S]  

Syntax

Description/Format

QID=

Queue ID that clearly identifies a batch input session.
Format: script literal  

This parameter can be used to start a single batch input session.

NOFOUND=

Action if no sessions have been selected.
Format: script literal  

Allowed values: "NORMAL" (default value) and "ABEND"

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

ERROR=

Action if  one of the selected sessions terminates abnormally.
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.

See:  ERROR/ERRORLEVEL with R3_ACTIVATE_SESSIONS

ERRORLEVEL=

Defines the the number of erroneous transactions in percent (%).
Format: script literal  

Default value: "101"

The job ends abnormally if this limit has been exceeded.

JOBN[AME]=

Each session is processed with an SAP job.
Format: script literal  

Allowed values: "ATTRIBUTE" (default value) and "SESSION"

"ATTRIBUTE" - Contents of the "Job Name" text field in the host attributes. A standard AE job name is created if there is no text.
"SESSION" - Name of the session to be processed.

Description

The batch input sessions that should be started can be retrieved using a selection. Use the parameter QID= to start a single batch input session. The selection results of R3_GET_SESSIONS that are stored in the activation report or in a file serve to locate the individual session by queue ID.

The parameter ORDER_BY can be used to define the order in which the batch input sessions should be processed. The selection is sorted according to the criteria that have specified in this parameter.

Examples

Processing all sessions called 'FI*'. The job will end abnormally if it contains invalid transactions.

R3_ACTIVATE_SESSIONS NAME='FI*',STATUS=,NOFOUND=NORMAL,ERROR=ABEND,ERRORLEVEL=0

In the second example, a single batch input session starts whose queue ID has been specified as a parameter.

R3_ACTIVATE_SESSION QID='20020318171302022315'

 

See also: