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

R3_GET_APPLICATION_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:

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

 

See also: