Universal Connector for SAP Exit Codes


Overview

The exit code of Universal Connector for SAP depends on the command being issued.

This page identifies the exit codes for the various Universal Connector for SAP commands.

Note

The default values listed for the exit codes are the installed (configuration file) values. These values may be different than the internal default values (see the EXIT options in Universal Connector for SAP Configuration Options).

WAIT for JOB Exit Codes

If the WAIT for JOB command is specified, Universal Connector for SAP will map the job's status upon completion to the user definable job exit code parameters.

The following table illustrates this mapping; Universal Connector for SAP default values are listed in parentheses.
 

Job Completion Status in SAP

Exit Code

Terminated

terminated_exit_code (8)

Finished

finished_exit_code (0)

Unknown

22

Error in USAP processing (see #All Other Command Exit Codes).

> 200

WAIT for FS JOB NETWORK Exit Codes

If the WAIT for FS JOB NETWORK command is specified, USAP will map the job network's return code pair to the user definable job network return code parameters. In this case, the exit codes are hard coded and the return code pairs used in the matching process are user definable.

The following table illustrates this mapping; Universal Connector for SAP default values are listed in parentheses.
 


Job network return code pairs used for matching

Exit Code

job_net_rc_00 (02,00;02,02)

0

job_net_rc_04 (02,02)

4

job_net_rc_08 (02,04)

8

job_net_rc_16 (07,00;04,00;02,08)

16

Error in USAP processing (see #All Other Command Exit Codes).

> 200

DISPLAY STATUS Exit Codes

If the DISPLAY STATUS command is specified, Universal Connector for SAP will map the job's current status to the user definable job exit code parameters.

The following table illustrates this mapping; Universal Connector for SAP default values are listed in parentheses.
 

Job Current Status in SAP

Exit Code

Active

active_exit_code (10)

Ready

ready_exit_code (12)

Scheduled

scheduled_exit_code (14)

Released

released_exit_code (16)

Terminated

terminated_exit_code (8)

Finished

finished_exit_code (0)

Unknown

22

Error in USAP processing (see #All Other Command Exit Codes).

> 200

DISPLAY QSTATE Exit Codes

If the DISPLAY QSTATE command is specified, Universal Connector for SAP will map the queue's current state to the user definable qstate exit code parameters.

The following table illustrates this mapping; Universal Connector for SAP default values are listed in parentheses.
 

Queue State

Exit Code

'C' to be created

qtobecreated_exit_code (14)

' ' unprocessed

qunprocessed_exit_code (12)

'S' in background

qinbackground_exit_code (10)

'E' error

qerror_exit_code (8)

'F' finished

qfinished_exit_code (0)

Undefined

20

Error in USAP processing (see #All Other Command Exit Codes).

> 200

All Other Command Exit Codes

If Universal Connector for SAP is not performing the WAIT for JOB, WAIT for FS JOB NETWORK, DISPLAY STATUS, or DISPLAY QSTATE command, the exit code indicates the success of the requested actions.

The following table lists the Universal Connector for SAP exit codes.
 

Description

Exit Code

Successfully completed all requested actions.

0

An error occurred processing the requested actions. Messages are printed providing details about the error.

201

An error with product configuration options or command line options.

210

An error occurred in the initialization phase of message processing. It is possible the error prohibited messages from printing.

211