Abend Codes

The abend completion codes used by ConnecX SQL Gateway have the format ppnn, where pp is the prefix of the abend code and nn is a unique identifier for the abend code. The prefix of the abend codes is configurable, via the ABCODE parameter of the CXGMCONN and CXGMINST macros. The default prefix value is UQ.

Abend Code Description
AEY9 ConnecX Attachment Facility is not available / has not been enabled
UQ09 Invalid UERTFGP
UQ0A Invalid UERTFID
UQ0E CSB invalid
UQ0F SETUP TIE failed
UQ0F TIE not available
UQ76 Connect error
UQ78 Reject CXGCICS is currently not active (disabled)
UQ79 Reject shutdown in progress
UQ7A Unexpected error
UQ7B Create session
UQ7C Invalid TCB
UQ7D Create CSB failed
UQ7E Credentials failed
UQ80 Resource ID failed
UQ8D RECOVERY setup failed
UQD0 Invalid UEPTAA
UQD4 Start failed
UQD7 Public key invalid
UQDC CXGOPT invalid
UQX1 Fatal error
UQY9 Connect error – not connected

Each abend code is described in more detail in the rest of this document.

AEY9
Explanation

The ConnecX Attachment Facility is not available or has not been enabled. The SQL request is terminated abnormally

Action

Contact your systems programmer.
UQ09
Explanation

A fatal internal error condition has occurred – an invalid or unexpected UERTFGP value was encountered.

The requested function is terminated abnormally. The ConnecX Attachment Facility remains operational.

Action

Contact your Software AG support representative and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQ0A
Explanation

A fatal internal error condition has occurred – an invalid or unexpected UERTFID value was encountered.

The requested function is terminated abnormally. The ConnecX Attachment Facility remains operational.

Action

Contact your Software AG support representative and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQ0E
Explanation

A fatal internal error condition has occurred – a create CSB failed.

The requested function is terminated abnormally. The ConnecX Attachment Facility remains operational.

Action

Contact your Software AG support representative and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQ0F
Explanation

A fatal internal error condition has occurred – the TIE is not available.

The requested function is terminated abnormally. The ConnecX Attachment Facility remains operational.

Action

Contact your Software AG support representative and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQ78
Explanation

The processing request has been rejected by the ConnecX Attachment Facility , while the Attachment Facility has been disabled.

The requested function is terminated abnormally. The ConnecX Attachment Facility is not operational.

Action

Contact your systems programmer. Determine why the system has been disabled. Consider the following information when analyzing the problem:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQ79
Explanation

The processing request has been rejected by the TRUE, while the ConnecX Attachment Facility is shutting down.

The requested function is terminated abnormally. The ConnecX Attachment Facility is not operational.

Action

Contact your systems programmer. Determine why the system has been disabled. Consider the following information when analyzing the problem:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQ7A
Explanation

A fatal internal error condition has occurred – an unexpected error occurred during error handling.

The requested function is terminated abnormally. The ConnecX Attachment Facility remains operational.

Action

Contact your Software AG support representative and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQ7B
Explanation

The “create session” request failed. The following table lists probable causes:

Cause Explanation
Unable to connect to the CXG-server The server is not accessible or the SERVER-definition (Type=CXG) for the SYSID is invalid.
Unable to connect to the JDBC-server The JDBC-Server is not accessible or the SERVER-definition (Type=CXX) for the SYSID is invalid.
The CONNECT statement received a nonzero SQLCODE One of the following occurred:

  • The DSN of the TRANSACTION definition is invalid.

  • The user/password-schema values for the TRANSACTION-definition are invalid. For example, the user is not defined or the password is invalid.

  • The user ID or password of the ACF-definition are invalid. For example, the user is not defined or the password is invalid.

The requested function is terminated abnormally. The ConnecX Attachment Facility remains operational.

Action

Determine the cause of the connection failure. Contact your systems programmer and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQ7C
Explanation

A fatal error condition has occurred – an invalid TCB was encountered. The ConnecX Attachment Facility expects to be called with an OPENAPI. The task-related user exit has been called on the QR TCB with the UEPTUTCB bit set.

The function requested is terminated abnormally. The ConnecX Attachment Facility is not operational.

Action

Review the product installation and configuration. Contact your systems programmer for assistance. Examine the following:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQ7D
Explanation

A fatal internal error condition has occurred – an attempt to create CSB has failed.

The requested function is terminated abnormally. The ConnecX Attachment Facility remains operational.

Action

Contact your Software AG support representative and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQ7E
Explanation

A configuration error condition has occurred - unable to initialize credentials for CONNECT.

The requested function is terminated abnormally. The ConnecX Attachment Facility remains operational.

Action

Determine the cause of the connection failure. Contact your systems programmer and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQ80
Explanation

A fatal internal error condition has occurred – an error occurred creating a resource ID.

The requested function is terminated abnormally. The ConnecX Attachment Facility remains operational

Action

Contact your Software AG support representative and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQD4
Explanation

An error condition has occurred during PLT initialization.

The ConnecX Attachment Facility is not operational.

Action

Contact your systems programmer and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump;

  • Runtime option settings.
UQD7
Explanation

An error condition has occurred during CONNECT processing. The public key defined in the runtime options is invalid.

The requested function is terminated abnormally. The ConnecX Attachment Facility remains operational.

Action

Contact your systems programmer and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump;

  • Runtime option settings.
UQDC
Explanation

An error condition has occurred during PLT initialization. The layout of the runtime options (CXGCIOPT) is invalid.

The ConnecX Attachment Facility is not operational.

Action

Contact your systems programmer and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump;

  • Runtime option settings.
UQX1
Explanation

A fatal internal error condition has occurred in the table manager.

The function requested is terminated abnormally. The ConnecX Attachment Facility remains operational and will retry to recover.

Action

Contact your Software AG support representative and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump.
UQY9
Explanation

An error condition has occurred during CONNECT statement processing and the ConnecX Attachment Facility is configured to abend on a CONNECT error. The processing on a connection error is controlled by the CONNECTERROR parameter of the CXGMCONN-macro. ABEND is the default setting.

The SQL request is terminated abnormally. The ConnecX Attachment Facility remains operational.

Action

Contact your systems programmer and provide the following information:

  • Exception trace;

  • Transaction dump;

  • System dump;

  • Runtime option settings.