Messages and Codes - Return Codes

Introduction

This page describes the return codes produced by the different components that comprise Universal Agent. It is an integer value returned by the component to indicate success or failure of that component.

Note

Return code is referred to as exit code on some platforms.

Universal Certificate

z/OS, UNIX, and Windows Manager

Return Code

Description

1

General purpose return code indicating that a warning level condition occurred in processing. Refer to messages written to standard error for details.

2

General purpose return code indicating that an error level condition occurred in processing. Refer to messages written to standard error for details.

3

General purpose return code indicating that a fatal level condition occurred in processing. Refer to messages written to standard error for details.

20

Error in the configuration file or command options. Refer to the messages written to standard error for details.

21

Error initializing the message processing options.

22

External shutdown request was received.

23

Security-related error condition occurred. Refer to the messages written to standard error for details.

24

Network-related error condition occurred. Refer to the messages written to standard error for details.

25

Product license error condition occurred. Refer to the messages written to standard error for details.

Universal Command Manager

z/OS and Windows Manager

Return Code

Description

1004

General purpose return code indicating that a warning level condition occurred in processing. Refer to messages written to the SYSOUT ddname for details.

1008

General purpose return code indicating that an error level condition occurred in processing. Refer to messages written to the SYSOUT ddname for details.

1012

General purpose return code indicating that a fatal level condition occurred in processing. Refer to messages written to the SYSOUT ddname for details.

1020

Error in the configuration file or command options. Refer to the messages written to the SYSOUT ddname for details.

1021

Error initializing the message processing options.

1022

External shutdown request was received.

1023

Security-related error condition occurred. Refer to the messages written to the SYSOUT ddname for details.

1024

Network-related error condition occurred. Refer to the messages written to the SYSOUT ddname for details.

1025

Product license error condition occurred. Refer to the messages written to the SYSOUT ddname for details.

*

All other return codes are from the remote command.

UNIX, and IBM i Manager

Return Code

Description

201

General purpose return code indicating that a warning level condition occurred in processing. Refer to messages written to standard error for details.

202

General purpose return code indicating that an error level condition occurred in processing. Refer to messages written to standard error for details.

203

General purpose return code indicating that a fatal level condition occurred in processing. Refer to messages written to standard error for details.

220

Error in the configuration file or command options. Refer to the messages written to standard error for details.

221

Error initializing the message processing options.

222

External shutdown request was received.

223

Security-related error condition occurred. Refer to the messages written to standard error for details.

224

Network-related error condition occurred. Refer to the messages written to standard error for details.

225

Product license error condition occurred. Refer to the messages written to standard error for details.

*

All other return codes are from the remote command.

Universal Connector for PeopleSoft

Universal Connector for PeopleSoft exit codes depend on the command being issued. For a complete list of these command-specific codes, see Universal Connector for PeopleSoft Exit Codes.

Universal Connector for SAP

Universal Connector for SAP exit codes depend on the command being issued. For a complete list of these command-specific codes, see Universal Connector for SAP Exit Codes.

Universal Control Manager

z/OS, UNIX, Windows, and IBM i

Return Code

Description

1

General purpose return code indicating that a warning level condition occurred in processing. Refer to messages written to standard error for details.

2

General purpose return code indicating that an error level condition occurred in processing. Refer to messages written to standard error for details.

3

General purpose return code indicating that a fatal level condition occurred in processing. Refer to messages written to standard error for details.

20

Error in the configuration file or command options. Refer to the messages written to standard error for details.

21

Error initializing the message processing options.

22

External shutdown request was received.

23

Security-related error condition occurred. Refer to the messages written to standard error for details.

24

Network-related error condition occurred. Refer to the messages written to standard error for details.

25

Product license error condition occurred. Refer to the messages written to standard error for details.

Universal Data Mover

z/OS, UNIX, Windows, and IBM i

Return Code

Description

0

UDM executed and ended without any warnings or errors.

4

Warning condition occurred.

8

Error condition occurred.

16

Fatal error condition occurred and UDM was forced to terminate.

22

UDM was forced to terminate by the user and not because it finished processing the script with which it was invoked or because the user typed the exit command.

Universal Enterprise Controller Load Utility

UNIX and Windows

Return Code

Description

1

General purpose return code indicating that a warning level condition occurred in processing. Refer to messages written to standard error for details.

2

General purpose return code indicating that an error level condition occurred in processing. Refer to messages written to standard error for details.

3

General purpose return code indicating that a fatal level condition occurred in processing. Refer to messages written to standard error for details.

20

Error in the configuration file or command options. Refer to the messages written to standard error for details.

21

Error initializing the message processing options.

22

External shutdown request was received.

23

Security-related error condition occurred. Refer to the messages written to standard error for details.

24

Network-related error condition occurred. Refer to the messages written to standard error for details.

25

Product license error condition occurred. Refer to the messages written to standard error for details.

z/OS

Return Code

Description

4

General purpose return code indicating that a warning level condition occurred in processing. Refer to messages written to the SYSOUT ddname for details.

8

General purpose return code indicating that an error level condition occurred in processing. Refer to messages written to standard error for details.

12

General purpose return code indicating that a fatal level condition occurred in processing. Refer to messages written to standard error for details.

20

Error in the configuration file or command options. Refer to the messages written to standard error for details.

21

Error initializing the message processing options.

22

External shutdown request was received.

23

Security-related error condition occurred. Refer to the messages written to standard error for details.

24

Network-related error condition occurred. Refer to the messages written to standard error for details.

25

Product license error condition occurred. Refer to the messages written to standard error for details.

Universal Event Monitor Manager

z/OS, UNIX, and Windows

Return Code

Description

0

All occurrences of the requested event that were detected completed successfully and were triggered.

1

UEM detected multiple occurrences of the requested event. Some of the occurrences completed and were triggered, while others failed to complete before the specified inactive date/time and were rejected.

2

UEM detected one or more occurrences of the requested event, but none of those occurrences completed before the specified inactive date/time, so UEM rejected them.

3

UEM did not detect any occurrences of the requested event, so the event was expired.

8

One of the following occurred:

  1. There was an error with one or more of the event occurrences tracked by the Universal Event Monitor Server
  2. Universal Event Monitor application processed all requests successfully, but one or more processes executed on behalf of an event handler did not complete successfully.

12

Universal Event Monitor Server reported an application error. Check the Universal Broker message log for messages issued by the Server.

20

Error was detected in the configuration file or the command options.
 
z/OS users: Refer to the messages written to the SYSOUT ddname for details.

21

Error was encountered while the application error messaging options were being initialized.

22

External shutdown request was received.

23

Security-related error condition occurred.
 
z/OS users: Refer to messages written to the SYSOUT ddname for details.

24

Network-related error condition occurred.
 
z/OS users: Refer to messages written to the SYSOUT ddname for details.

25

Valid product license could not be found.
 
z/OS users: Refer to messages written to the SYSOUT ddname for details.

UEMLoad Utility

UNIX and Windows

Return Code

Description

0

All database operations completed successfully.

1

One or more requested database operations failed. This value also is a general purpose return code indicating that a warning level condition occurred during processing. Refer to messages written to standard error for details.

2

General purpose return code indicating that an error level condition occurred during processing. Refer to messages written to standard error for details.

3

General purpose return code indicating that a fatal level condition occurred in processing. Refer to messages written to standard error for details.

12

Universal Event Monitor Server reported an application error while processing the database request. Check the Universal Broker message log for messages issued by the Broker and/or Universal Event Monitor Server.

20

Error was detected in the configuration file or the command options.

21

Error was encountered while the application error messaging options were being initialized.

22

External shutdown request was received.

23

Security-related error condition occurred.

24

Network-related error condition occurred.

25

Valid product license could not be found.

Universal FTP Client

z/OS and Windows

Return Code

Description

1001

General purpose return code indicating that a warning level condition occurred in processing. Refer to messages written to stderr (Windows) or to the SYSOUT DD name (zOS) for details.

1002

General purpose return code indicating that an error level condition occurred in processing. Refer to messages written to stderr (Windows) or to the SYSOUT DD name (zOS) for details.

1003

General purpose return code indicating that a fatal level condition occurred in processing. Refer to messages written to stderr (Windows) or to the SYSOUT DD name (zOS) for details.

1020

Error in the configuration file or command options. Refer to messages written to stderr (Windows) or to the SYSOUT DD name (zOS) for details.

1022

External shutdown request was received.

1023

Security-related error condition occurred. Refer to messages written to stderr (Windows) or to the SYSOUT DD name (zOS) for details.

UNIX

Return Code

Description

201

General purpose return code indicating that a warning level condition occurred in processing. Refer to messages written to stderr for details.

202

General purpose return code indicating that an error level condition occurred in processing. Refer to messages written to stderr for details.

203

General purpose return code indicating that a fatal level condition occurred in processing. Refer to messages written to stderr for details.

220

Error in the configuration file or command options. Refer to messages written to stderr for details.

222

External shutdown request was received.

223

Security-related error condition occurred. Refer to messages written to stderr for details.

cURL Return Codes

Depending on the configured message level, the Universal FTP Client may also report a cURL return code in message UNV6674I. cURL is a dependent library the UFTP client uses to implement its supported file transfer protocols (for example: FTP, SFTP, FTPS).

UFTP extends the cURL return code values implemented by the library. Possible return codes are listed below.

Return Code

Description

0 thru 93, inclusive

Reserved by the cURL library implementation. Information on these values may be found at

https://curl.haxx.se/libcurl/c/libcurl-errors.html

CURLE_LOCAL_FILE_NOT_FOUND (101)

A file expected to reside on the client system does not exist.

CURLE_FILE_OPEN (102)

An error occurred opening a file on the client system.

CURLE_FILE_CLOSE (103)

An error occurred closing a file on the client system.

CURLE_FILE_DELETE (104)

An error occurred removing a file on the client system, most likely following a "move" operation to a remote server system.

CURLE_REGEX_ERROR (105)

An error occurred evaluating a regular expression specified as a file pattern.

CURLE_TFTP_MGET_REGEX (106)

An error occurred evaluating or applying a regular expression pattern to an MGET operation using the TFTP protocol.

CULRE_TFTP_MGET_WILDCARD (107)

An error occurred applying a wildcard pattern to an MGET operation using the TFTP protocol.

CURLE_LIST_STYLE_NOT_FOUND (108)

No entry was found in parser.txt or the set of default parsing rules that matches the file listing returned by the remote server.

CURLE_FILENAME_INVALID (109)

The file or dataset name contains unsupported characters.

CURLE_DIRECTORY_INVALID (110)

The directory name contains unsupported characters.

CURLE_REMOTE_DIRECTORY_NOT_FOUND (111)

No location on the remote server could be found that matches an expected directory specification in the UFTP command.

CURLE_NO_REMOTE_FILES_FOUND (112)

No files were found on the remote server in the specified location.

CURLE_NO_REMOTE_MATCHING_FILES_FOUND (113)

No files were found on the remote server matching the file name specified by UFTP.

Universal Query

z/OS, UNIX, Windows, and IBM i Manager

Return Code

Description

1

General purpose return code indicating that a warning level condition occurred in processing. Refer to messages written to standard error for details.

2

General purpose return code indicating that an error level condition occurred in processing. Refer to messages written to standard error for details.

3

General purpose return code indicating that a fatal level condition occurred in processing. Refer to messages written to standard error for details.

20

Error in the configuration file or command options. Refer to the messages written to standard error for details.

21

Error initializing the message processing options.

22

External shutdown request was received.

23

Security-related error condition occurred. Refer to the messages written to standard error for details.

24

Network-related error condition occurred. Refer to the messages written to standard error for details.

25

Product license error condition occurred. Refer to the messages written to standard error for details.