R3_GET_APPLICATION_RC

Use the R3_GET_APPLICATION_RC script element to verify the application return code of one or several job steps. You can compare them with the maximum value that is allowed. If this value is exceeded, the AE job aborts, if not job execution continues.

Tip: The application return code is also available in the report and can be read. For more information, see Evaluating the Application Return Code of SAP Steps

Transaction: -
Interface: Standard (XBP 3.0)

Syntax

R3_GET_APPLICATION_RC

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

Parameters

• R3_GET_APPLICATION_RC
  Verifies the application return code of one or several job steps

• NAME=
  Name of the SAP job
  Format: script literal
  Default value: The system uses the SAP job that is defined in the script of one of the following script elements:

• R3_ACTIVATE_INTERCEPTED_JOBS
• R3_ACTIVATE_JOBS
• R3_ACTIVATE_REPORT
• R3_ACTIVATE_SESSIONS

• JOBCOUNT=
  Number of the SAP job.
  Format: script literal'
  Tip: Use this parameter together with NAME= to clearly identify the SAP job.

• STEP=
  (Optional) Number of the SAP job step
  Format: number
  Default value: 1
  Tip: Use 0 to have the application return codes of all the specified SAP job steps verified.

• MAX_APPL_RC=
  (Optional) Maximum number of allowed application return codes
  Format: number
  Default value: 0
  Note: The AE job aborts if the application return code of a job step exceeds the value that is specified here.
  

Examples

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 you can verify all application return codes of the job MYJOB.

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

See also: