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

R3_GET_APPLICATION_RC

Checks the application return code of one or several job steps

Transaction: -

Interface: Standard (XBP 3.0)

Syntax

NAME=...
,JOBCOUNT=...
[,STEP=...]
[,MAX_APPL_RC=...]

Syntax	Description/Format
NAME=	Name of the SAP job Format of the value: script literal By default the SAP job specified in the script of one of the following script elements is used: R3_ACTIVATE_INTERCEPTED_JOBS R3_ACTIVATE_JOBS R3_ACTIVATE_REPORT R3_ACTIVATE_SESSION
JOBCOUNT=	Number of the SAP job Format: script literal In combination with NAME=, the SAP job is unique.
STEP=	Number of the SAP job step Format of the value: number Default value: "1" Specifying "0" has the effect that the application return codes of all the specified SAP job steps are checked.
MAX_APPL_RC=	Maximum number of allowed application return codes Format of the value: number Default value: "0" The AE job aborts if the application return code of a job step exceeds the value specified here.

Comments

This script element checks the application return codes of job steps and compares them with the maximum value allowed. If this value is exceeded, the AE job aborts. If not, job execution continues.

The application return code is also available in the report and can be read.

Example

The first example checks the application return code of step "2".

R3_MODIFY_JOB NAME="MYJOB",JOBCOUNT=13541601,STEP=2,MAX_APPL_RC=10

The second example illustrates how to check all application return codes of the job "MYJOB".

R3_MODIFY_JOB NAME="MYJOB",JOBCOUNT=13541601,STEP=0,MAX_APPL_RC=10