Version 7.5.1
 —  Messages and Codes  —

Response Codes and Subcodes

Overview of Messages

RC 9 | RC 48 | RC 240 | RC 241 | RC 242 | RC 243

RC 9
Explanation

When Adabas Transaction Manager is in use, a response code 9 can be accompanied by one of the following subcodes in the Adabas control block Additions 2 field, in the low-order (rightmost) two bytes:

Subcode Explanation and Recommended Action
75

A commit operation involving an external transaction coordinator failed. ATM attempted to back out the transaction.

Check the external transaction coordinator for the reason. Check for error messages from ATM daemons or the ATM proxy of the failing job.

76

An error occurred while an ATM daemon was attempting to rebuild the transaction hierarchy of a user who has migrated from another ATM daemon’s domain as a result of dynamic transaction routing. ATM attempted to back out the transaction.

Check the status of the transaction using Online Services. Check for error messages from ATM daemons or the ATM proxy of the failing user.

77

This message indicates that the user had an open transaction and has been migrated from one node to another within a cluster (Sysplex), but ATM could not handle the transaction safely because no Migrated Transaction Record (MTR) file had been defined. The transaction was therefore backed out.

Define and create an MTR file, and restart the ATM daemons and clustered application environments in the COR group.

78

It was not possible to commit the user’s transaction because of a pending ET syncpoint on a target database. This could be because of a concurrent online save operation, database termination, or a SYNCC operator command. Backout of the incomplete transaction was attempted.

Restart the transaction when the pending ET syncpoint has been completed.

80

The user was not at ET status in the target database. Backout of the incomplete transaction was attempted.

Restart the transaction.

81

A memory shortage in the ATM daemon address space caused the current global transaction to be backed out.

Increase the amount of memory available to the ATM daemon, restart it, then restart the transaction.

82

A memory shortage occurred in the ATM daemon address space, and ATM attempted to back out the current global transaction.

Increase the amount of memory available to the ATM daemon, restart it, then restart the transaction.

83

An error occurred during a commit or backout operation for a global transaction. ATM attempted to back the transaction out.

If the cause of the error is not apparent from console messages, contact your Software AG technical support representative.

84

ATM reported conflicting use of the user’s ETID. This is possible, for example, if a user survives a restart of the ATM daemon. For an RE command, this subcode will be returned if the user is known to ATM but has no ETID.

The user must issue a CL command to each open database; then re-open.

85

The global transaction time limit (TMGTT) has been exceeded, and an attempt has been made to back out the global transaction.

Correct the cause of the timeout, then restart the transaction.

86

The global transaction time limit (TMGTT) has been exceeded, and the global transaction has been backed out.

Correct the cause of the timeout, then restart the transaction.

89

One of the following occurred:

  • An attempt was made to back out the global transaction because, after a period of inactivity, a new user session was started with the same ETID. In this case, close the user session.

  • A user who was executing under the CICS Resource Manager Interface had an incomplete transaction when the CICS system terminated, and the transaction was backed out during restart of the CICS system. In this case, repeat the transaction, if desired.

90

The ATM proxy detected either an inconsistency between its view of the user’s status and the ATM daemon’s view, or that the ATM daemon had restarted. It attempted to back out on all target databases.

Close the user’s sessions and start them again.

91

Transactions on a target database were being quiesced, or an administrator issued a stop request for the user via ATM Online Services or operator command, or there was a pending ET syncpoint on the database. Backout of the incomplete transaction was attempted.

Restart the transaction when all required target databases are available.

92

Transactions on a target database were being quiesced, or an administrator issued a stop request for the user via ATM Online Services or operator command, or there was a pending ET syncpoint on the database. The incomplete transaction was backed out.

Restart the transaction when all required target databases are available.

93

An error occurred while ATM was attempting either to start a new global transaction or to bring a new database into a transaction. The proxy backed out changes from all databases.

The next command issued returns details of the error that caused the backout. Check the meaning of the response code and act accordingly.

94

An error occurred while ATM was attempting either to start a new global transaction or to bring a new database into a transaction. The proxy attempted to back out changes from all databases.

The next command issued returns details of the error that caused the backout. Check the meaning of the response code and act accordingly.

95

The user’s transaction was controlled by an external transaction coordinator, which reported that the transaction has been backed out.

Restart the transaction.

96

The user’s transaction was controlled by an external transaction coordinator, which reported “backed out, outcome pending” for the transaction. This means that backout has begun for the transaction, and will be completed when all the resource managers involved in it are able to comply with the backout request.

Restart the transaction.

97

The CICS Resource Manager Interface is in use, and the ATM proxy detected that the user’s Task Interface Element (TIE) was being used by another user.

If this condition occurs when running Natural in such a way that two Adabas sessions are maintained for each user, ensure that Natural zaps NA44231 and NA45010 are applied (both are present in Natural v3.1.6). Further, if the user executes with TRANMODE=MESSAGE, ensure that Natural will issue an OP command for its system session; for example, supply a non-blank ETID, or use the Natural DBOPEN parameter. If the error persists, contact your Software AG support representative.

98

The user was executing in serial mode, and requested that changes be committed. Some of the changes were committed, and some were backed out.

Examine the results of the transaction. If necessary, correct the result by manual intervention.

99

The user incurred a security response code; ATM backed out the user’s changes.

If security permissions are not adequate, correct them and rerun the transaction.


RC 48
Explanation

When Adabas Transaction Manager is in use, a response code 48 can be accompanied by one of the following subcodes in the Adabas control block Additions 2 field, in the low-order (rightmost) two bytes:

Subcode Explanation and Recommended Action
25

The user has an open global transaction that could not be backed out because it is under the control of an external transaction coordinator and its status is “in doubt”.

Depending on the transaction coordinator, you may have a choice of actions:

  • Wait for the external transaction coordinator to complete or back out the existing transaction.

  • Use the coordinator’s facilities to force completion or removal of the transaction.

  • Restart the transaction coordinator to cause resynchronization of in-doubt transactions.

  • Use ATM Online Services to force backout of the local, Adabas-related part of the global transaction.

    Caution:
    Using ATM Online Services to force backout of the local, Adabas-related part of the global transaction could result in loss of transaction integrity.

26

The User ID specified in the OP command is already in use by another user.

Wait for the existing user’s session to time out, or force it using ATM Online Services.

Caution:
If the existing user has a global transaction in progress, the second option could result in loss of transaction integrity.


RC 240
Explanation

ATM encountered an error. The error code can be found in the Adabas control block Additions 2 field, in the low-order (rightmost) two bytes. A response code may occur in the first two bytes of the Additions 2 field.

Action

Check the meaning of the error code. If the cause of the problem is not apparent, contact your Software AG technical support representative.


RC 241
Explanation

ATM received an unexpected Adabas response code. The subcode and response code can be found, in that order, in the Adabas control block Additions 2 field. If a positive response code value appears in the Additions 2 field, the response code was detected by the ATM daemon. If a negative response code value appears in the Additions 2 field, take its complement: this is the response code received by the proxy’s attempt to communicate with the ATM daemon.

Action

Check the meaning of the Adabas response code and subcode. If the cause of the problem is not apparent, contact your Software AG technical support representative.


RC 242
Explanation

The ATM daemon or ATM proxy was unable to determine the status of the caller’s transaction. There might be an ATM error code in the Adabas control block Additions 2 field, in the low-order (rightmost) two bytes.

Action

Check the meaning of the error code , if one is present. Otherwise, determine the status of the global transaction using Online Services. If the required action is not apparent, contact your Software AG technical support representative.


RC 243
Explanation

The ATM daemon or ATM proxy received an unsolicited syncpoint request. The action taken or the status of the global transaction that was open is indicated by a subcode in the Adabas control block Additions 2 field, in the low-order (rightmost) two bytes.

Action

Review the ATM daemon’s TMSYNCMGR ADARUN parameter and the TRNCTL, LCLSYNC, and HSTSYNC job parameters for the failing job.

Subcode Explanation and Recommended Action
1

The unsolicited syncpoint request was accepted. The status of the current global transaction is not known.

Use Online Services to determine the status of the global transaction.

2

The unsolicited syncpoint request was accepted. The user’s global transaction has been committed.

3

The unsolicited syncpoint request was accepted. The user’s global transaction has been backed out.

4 The unsolicited syncpoint request was accepted. The user’s global transaction had mixed completion (partially backed out, partially committed).
5 The unsolicited syncpoint request was accepted. The user’s global transaction is in backout.
6 The unsolicited syncpoint request was accepted. The user’s global transaction is in commit.
7 The unsolicited syncpoint request was accepted. The user had no global transaction open.
12 The unsolicited syncpoint was attempted, but ATM returned response code 148 so the outcome is not known.
16 The unsolicited syncpoint request was rejected.

Top of page