Adabas Response Codes

After each Adabas command is processed, a response code is returned in bytes 11 and 12 of the ACB or in the ACBX. Some response codes also return a subcode in the rightmost two bytes of the ACB's Additions 2 field (offset 45-48) or in the ACBX's Error Subcode (ACBXERRC) field (offset 115-116). This section describes those response codes and subcodes.

Note:
Proprietary functions of Adabas may also return response codes and subcodes, some of which are not described here. Refer to the documentation for those functions for more information.

Response code 0 indicates that the Adabas command was processed successfully; any other response code is returned as a result of an error during command processing.

All Adabas commands resulting in a response code other than 0 (ADARSP000), 1 (ADARSP001), and 145 (ADARSP145) restore all Adabas control block fields except the response code field (see the Adabas Command Reference documentation) to the contents the fields held at the beginning of command execution.

For internal errors, contact your Adabas technical support representative.

Overview of Messages

Response 0 | Response 1 | Response 2 | Response 3 | Response 4 | Response 7 | Response 8 | Response 9 | Response 10 | Response 16 | Response 17 | Response 18 | Response 19 | Response 20 | Response 21 | Response 22 | Response 23 | Response 24 | Response 25 | Response 26 | Response 27 | Response 28 | Response 29 | Response 34 | Response 35 | Response 39 | Response 40 | Response 41 | Response 42 | Response 43 | Response 44 | Response 45 | Response 46 | Response 47 | Response 48 | Response 49 | Response 50 | Response 51 | Response 52 | Response 53 | Response 54 | Response 55 | Response 56 | Response 57 | Response 58 | Response 59 | Response 60 | Response 61 | Response 62 | Response 63 | Response 64 | Response 65 | Response 66 | Response 67 | Response 68 | Response 70 | Response 71 | Response 72 | Response 73 | Response 74 | Response 75 | Response 76 | Response 77 | Response 78 | Response 79 | Response 81 | Response 82 | Response 83 | Response 84 | Response 85 | Response 86 | Response 87 | Response 88 | Response 89 | Response 94 | Response 95 | Response 96 | Response 97 | Response 98 | Response 99 | Response 101 | Response 102 | Response 105 | Response 106 | Response 107 | Response 109 | Response 110 | Response 113 | Response 114 | Response 123 | Response 124 | Response 125 | Response 126 | Response 129 | Response 130 | Response 131 | Response 132 | Response 133 | Response 134 | Response 136 | Response 144 | Response 145 | Response 146 | Response 147 | Response 148 | Response 149 | Response 150 | Response 151 | Response 152 | Response 153 | Response 154 | Response 155 | Response 156 | Response 157 | Response 159 | Response 160 | Response 161 | Response 162 | Response 163 | Response 164 | Response 165 | Response 166 | Response 167 | Response 168 | Response 170 | Response 171 | Response 172 | Response 173 | Response 174 | Response 175 | Response 176 | Response 177 | Response 178 | Response 179 | Response 181 | Response 182 | Response 183 | Response 184 | Response 185 | Response 186 | Response 187 | Response 196 | Response 197 | Response 198 | Response 199 | Response 200 | Response 201 | Response 202 | Response 203 | Response 204 | Response 207 | Response 208 | Response 209 | Response 210 | Response 211 | Response 212 | Response 213 | Response 214 | Response 215 | Response 216 | Response 217 | Response 218 | Response 219 | Response 220 | Response 221 | Response 222 - 223 (reserved) | Response 224 | Response 225 | Response 226 - 227 (reserved) | Response 228 | Response 229 | Response 230 | Response 231-239 | Response 240 | Response 241 | Response 242 | Response 243 | Response 245 | Response 246 | Response 247 | Response 248 | Response 249 | Response 250 | Response 251 | Response 252 | Response 253 | Response 254 | Response 255

Response 0
Origin Mainframe and open systems
Explanation

The command was executed successfully.


Response 1
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

Depending on the subcode in the rightmost two bytes of the ACB's Additions 2 field or the ACBX's Error Subcode (ACBXERRC) field, one of the following has occurred:

Subcode Meaning
1 An online SAVE operation cannot be executed without the nucleus' PLOG.
2 The selected record is not allowed.
3 S2 command did not have enough space.
4 S2/S9 internal program error.
5 System was not in save status at the end of an online ADASAV.

Note:
When one of the subcodes 2-4 is present, the cause could be an Sx command using security-by-value that found at least one ISN.

Open Systems

An ISN list could not be sorted as a result of an excessive number of resulting ISNs, or because during a non-descriptor search a value larger than the corresponding field length in the FDT was found, or because the ISN quantity returned does not correspond with the actual number of records found.

For an S9 command, this response indicates that there is no space available for additional temporary working space. For an S2 command, this response is only a warning and the S2 becomes an S1.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

Increase the ADARUN LS parameter value.

Open Systems

Provide sufficient disk space for temporary working space or adapt the FDT to the real field length.


Response 2
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

This response code can only occur with a BT, ET or RI command. The BT, ET or RI command executes successfully. One of the following has occurred, depending on the subcode:

Subcode Meaning
1 Adabas attempted to hold an ISN already being held by another user.
2 The number of ISNs as specified in the ISN buffer was too large compared to the ISN buffer length (ET or BT command with the M option).
4 ISN is not on hold during multifetch ET/BT. ET/BT has successfully executed the ISNs so far released. The remaining ISNs are still on hold.
5 An RI command with ISN=0 could not release from hold status all records held by the user, as requested, because one or more records had been updated earlier in the same transaction. Updated records cannot be released from hold status prior to transaction end. All records that had not been updated have been released from hold status.

Open Systems

The required function has not been executed completely. For an OP command with command option 2 = E or for an RE command, the specified record buffer length was shorter than the length of the ET data read. The record buffer has been truncated.

For an A1//N1/N2 command, a descriptor value with the TR option is larger than 1144 bytes. In this case, only the first 1144 bytes are stored in the index. Search operations for truncated values may be inexact since only the first 1144 bytes are evaluated. The first 2 bytes of the Additions 2 field contain the number of descriptor values truncated, the third and fourth bytes contain the field name of the descriptor value that is truncated.

For an S1/S2/S4/S9 command, the resulting ISN list may not represent the exact result: this is because the search values and the values in the database were truncated after 1144 bytes during the search operation of an S1/S2/S4 command and during the sort operation of an S2/S9 command.

Subcode 5 is set if a RI command with ISN=0 could not release from hold status all records held by the user, as requested, because one or more records had been updated earlier in the same transaction. Updated records cannot be released from hold status prior to transaction end. All records that had not been updated have been released from hold status.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Open Systems

For an OP or RE command, increase the record buffer length or ignore the warning.

For an S1/S2/S4/S9 command, either perform a post-selection using the complete field values, perform your own sort operation using the complete field values, or ignore the warning.


Response 3
Origin Mainframe and open systems
Explanation

One of the following has occurred:

  • An end-of-file or end-of-list condition was detected.

  • A program tried to read or change a multiclient file's record using either a blank or incorrect-length owner ID, or an owner ID that is not allowed for the record.

The following are some possible subcodes:

Subcode Meaning
1 An end-of-file or end-of-list condition was detected (L3/L6 on a non-expanded file).
4 End of LOB value reached. An attempt was made to read a LOB value segment that begins after the end of the value. This response code/subcode is given to an L1/L4 command with Command Option 2 set to L if the ISN Lower Limit value is greater than or equal to the length of the LOB value being read.
66 A program tried to read or change a multiclient file's record using either a blank or incorrect-length owner ID, or an owner ID that is not allowed for the record.
249 Adabas Vista has determined that no data is available to satisfy this command due to one of the following reasons:
  • A partitioned file end-of-file or end-of-list condition was detected.

  • None of the partitions were available/online and all of them have the file parameter Critical set to NO.

Action: No action is required.


Response 4
Origin Mainframe systems
Explanation

The internal Adabas TRS storage directory is full.

Action

Free some of the active queries.


Response 7
Origin Mainframe systems only
Explanation

A complex search command was rejected because it was estimated that it would exceed the maximum search time TLSCMD.


Response 8
Origin Mainframe systems only
Explanation

The current user's command was interrupted to prevent a Work overflow because of a pending backout operation.

Action

The value specified for the LP parameter might have to be increased.


Response 9
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

A subcode indicating the specific cause and action for this response code appears in the low-order (rightmost) two bytes of the ACB's Additions 2 field or in the ACBX's Error Subcode (ACBXERRC) field. The following are the subcodes and their meanings:

Subcode Meaning
1 The user was backed out because the hold queue was full

Action: Set the number of hold queue elements (ADARUN NH parameter) higher, or tune the application to issue more frequent ET commands.

2 The transaction time limit (TT) has been exceeded, and the transaction was backed out.

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

3 One of the following is the case:
  • The transaction non-activity time limit (TNAE, TNAX, or TNAA) has been exceeded.

  • The user was stopped by the STOPF or STOPI operator, or an Adabas Online System command.

  • A security violation response code has been returned for an ET-logic user. Information about response codes for security violations is provided in the Adabas Security documentation.

  • When a new user issues an OP cmd with the same user ID (in ADD1) as an earlier user did and the earlier user was inactive for more than 60 seconds, the new user can, by issuing a second OP cmd again (the first OP cmd will get response code 9, subcode 64), take over the user ID of the earlier user. When the earlier user becomes active again, this subcode can be received.

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

15 The user was backed out because a pending Work area overflow occurred during the user's transaction. Adabas decides to back out a transaction when its start on Work is approximately 1/4th of ADARUN parameter LP away from the current position on Work.

Action: Either reduce the transaction length (number of updates) or duration (time between transaction start and end) to lessen the data protection area requirement, or increase the data protection area on Work (ADARUN parameter LP).

17 At the end of an online recovery process that was initiated after the failure of a peer nucleus in an Adabas cluster, the nucleus was unable to reacquire the ETID specified by the user in the Additions 1 field of the OP command.

Action: (In the application program:) Redo the OP command with the ETID specified in the Additions 1 field to reacquire the user ID. Contact your Software AG technical support representative.

18 The user's active transaction was interrupted and backed out because a peer nucleus in an Adabas cluster terminated abnormally.

Action: (In the application program:) Rerun the transaction.

19 The user's active command was interrupted and stopped because a peer nucleus in an Adabas cluster terminated abnormally. If the interrupted command was using a command ID (CID), the command ID is deleted.

Action: (In the application program:) Clean up and reacquire the current context pertaining to Adabas command IDs; rerun the transaction.

20 The Adabas cluster nucleus assigned to the user terminated while the user had an open transaction. The transaction has been or will be backed out.

Action: (In the application program:) If the user was defined with a user ID (ETID) in the Additions 1 field of the OP command, redo the OP command to reacquire the ETID; clean up and reacquire the current context pertaining to Adabas command IDs; rerun the transaction.

21 The user's active command was waiting for an ISN in hold status when the user was backed out and closed due to a timeout or a STOP command.
22 The user's active command was waiting for free space in the work pool when the user was backed out and closed due to a timeout or a STOP command.
23 The user's command was routed to a different cluster nucleus than the one used by previous commands. The user's open transaction has been backed out. It is also possible that the user had already been timed out earlier.

Action: Restart the transaction and any open read sequences.

24 The user's command was routed to a different cluster nucleus than the one used by previous commands. The user had owned EXU or EXF control over one or more files or had started the Adabas session with an OP command with R-option. As a consequence of creating a new session for the user with the new nucleus, the EXU/EXF control or file list specified in the OP command are no longer in effect.

Action: Restart the Adabas session with a new OP command.

25 The user's command was routed to a different cluster nucleus than the one used by previous commands. The user had started the Adabas session with an OP command with ETID. As a consequence of creating a new session for the user with the new nucleus, the user is no longer associated with that ETID.

Action: Restart the Adabas session with a new OP command.

26 The user's command was routed to a different cluster nucleus than the one used by previous commands. Some cluster nucleus terminated abnormally while the new nucleus was creating a new session for the user.

Action: Restart the Adabas session with a new OP command.

62 An OP (open) command was issued without a user/ET ID, which is required for this type of application or environment.

Action: Correct the program to specify a user/ET ID, and rerun the program.

63 An OP command was given for an ET user not in ET status. The user is backed out with an Adabas-generated BT command, and the operation is closed.

Action: Repeat the OP call.

64 An OP command was issued with an 8-byte ET ID that already exists.
66 An Adabas session with OPENRQ=YES was active and the user issued an Adabas command without having issued an OP command.

Action: Ensure that all users issue an OP command as the first Adabas command.

67 Insufficient Work part 1 space for open command with ETID definition when trying to read the user profile.
68 The user queue element has been deleted. Most likely the command was thrown back due to ISN contention or space shortage. The space shortage is normally workpool space; if this is the case, the LWP parameter setting should be increased.
73 This subcode is issued by Adabas Transaction Manager.

The client session had an externally-controlled transaction, the outcome of which was “in doubt”. ATM forcibly resolved the “in doubt” transaction. There is a possibility that ATM’s resolution of the transaction might be inconsistent with the intended outcome.

Check that the outcome of the session’s Adabas changes, in its previous transaction, was consistent with its changes to non-Adabas resources.

Check the external transaction coordinator for reasons why the original transaction might have been left in the “in doubt” state. If the external coordinator indicates that the transaction was completed, and if the relevant system logs give no indication of the cause of the problem, contact your Software AG support representative.

74 This subcode is issued by Adabas Transaction Manager.

The client’s database session has lost its ETID. If a transaction was in progress, ATM attempted to back it out from all affected databases and release all held records.

Issue a new OP command to the database.

75 This subcode is issued by Adabas Transaction Manager.

Either a commit operation involving an external transaction coordinator failed, or resynchronization with an external transaction coordinator caused the transaction to be backed out. In the first case, ATM attempted to back out the transaction.

For the first case, check the external transaction coordinator for the reason. Check for error messages from ATM transaction managers or the ATM client proxy of the failing job.

76 This subcode is issued by Adabas Transaction Manager.

An error occurred while an ATM transaction manager was attempting to rebuild the transaction hierarchy of a client session that has migrated from another ATM transaction manager’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 transaction manager or the ATM client proxy of the failing user.

77 This subcode is issued by Adabas Transaction Manager.

This message indicates that the client session 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 transaction managers and clustered application environments in the COR group.

78 This subcode is issued by Adabas Transaction Manager.

It was not possible to commit the client session’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.

79 Used by Adabas System Coordinator to signal the (optional) terminal timeout. Refer to the description of Generate RSP009/79 in the Adabas System Coordinator Parameters documentation for more information.
80 This subcode is issued by Adabas Transaction Manager.

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

Restart the transaction.

81 This subcode is issued by Adabas Transaction Manager.

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

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

82 This subcode is issued by Adabas Transaction Manager.

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

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

83 This subcode is issued by Adabas Transaction Manager.

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 This subcode is issued by Adabas Transaction Manager.

ATM reported conflicting use of an ETID. For an RE command, this subcode can be returned if the client is known to ATM but has no ETID.

The client should issue a CL command to each open database; then re-open.

85 This subcode is issued by Adabas Transaction Manager.

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 This subcode is issued by Adabas Transaction Manager.

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.

90 This subcode is issued by Adabas Transaction Manager.

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

Close the client’s sessions and start them again.

91 This subcode is issued by Adabas Transaction Manager.

Transactions on a target database were being quiesced, or an administrator issued a "stop" request for the session's transaction 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 This subcode is issued by Adabas Transaction Manager.

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 This subcode is issued by Adabas Transaction Manager.

An error occurred while ATM was attempting either to start a new global transaction or to bring a new database into a transaction. The client 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 This subcode is issued by Adabas Transaction Manager.

An error occurred while ATM was attempting either to start a new global transaction or to bring a new database into a transaction. The client 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 This subcode is issued by Adabas Transaction Manager.

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

Restart the transaction.

96 This subcode is issued by Adabas Transaction Manager.

The client session’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 This subcode is issued by Adabas Transaction Manager.

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

This can occur if all of the following are true:

  • Natural is being used, in such a way that two Adabas sessions are maintained for each client;

  • The client control Transaction Model is set to MESSAGE;

  • Natural parameters are set such that Natural might not generate OP commands for all database sessions.

You can make sure that Natural generates OP commands by using a non-blank ETID, or by means of Natural’s DBOPEN parameter.

The condition can also occur if all of the following are true:

  • Natural is being used, in such a way that two Adabas sessions are maintained for each client;

  • The Adabas System Coordinator has timed out Natural’s “system” session.

In this case, a new Natural LOGON might clear the condition. Otherwise terminate the session and start a new session.

If the error persists, contact your Software AG support representative.

98 This subcode is issued by Adabas Transaction Manager.

The client session 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 This subcode is issued by Adabas Transaction Manager.

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

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

249

In Adabas Vista, all transaction activity by the client has been backed out for one of the following reasons:

  • The client is using multiple (different) ETIDs which have collided against a particular database.

Action: Review the client’s use of ETIDs with respect to the current translation rules and/or partitioned files.

Open Systems

This response is caused by one of the following:

  • The last user transaction has been backed out by Adabas (ET logic users only) or an exclusive control user (non-ET user) or an access-only user exceeded the Non-Activity Time Limit;

  • The user session was abnormally terminated by the operator and the user issued a command;

  • The protection log area (= WORK container) was too small and an internal BT was executed.

The ADDITIONS 2 field in the control block contains additional information:

First two bytes Third and fourth bytes Explanation
0 TT

Transaction timeout

1 TN

Non-activity timeout

2 ST

STOP user

3 LP

WORK overflow

5 SE

Security

6 DL

Deadlock

8 OP

Open transaction

9 OR

Open required

10 RR

Replication recording failed

One of the internal Adabas commands issued for replication recording got an unexpected response code, for example 77. This response code is included in the control block in the field ACBXSUBR (only if you use the ACBX interface) and displayed in an RPLIRSP message in the nucleus log.

                                           First      Third+
                                            two       fourth
                                           bytes      bytes
                                          -------    -------
                  Transaction timeout :      0          TT
                  Non-activity timeout:      1          TN
                  STOP user           :      2          ST
                  WORK overflow       :      3          LP
                  Security            :      5          SE
                  Deadlock            :      6          DL
                  Open transaction    :      8          OP
                  Open required       :      9          OR

The information in the first two bytes is represented as an integer, and the third and fourth bytes are alphanumeric.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

User actions are described in the subcode list in the explanation.

Open Systems

Check the appropriate reason. If the Adabas nucleus was started without the option OPEN_REQUIRED, and the reason for response 9 was a non-activity timeout or a STOP user, users who started their sessions with an OP command must re-issue their OP command under the following circumstances:

  • if they set a User ID

  • if they specified restricted file lists

  • if they had user-specific timeout values

  • if they were not ET users.

If too many transactions are backed out because of a Work overflow, the size of the Work container should be increased.


Response 10
Origin Mainframe systems only
Explanation

Too many occurrences for a periodic group.


Response 16
Origin Open systems only
Explanation

An error occurred in an MC call during subcommand processing. The error code and additional information can be found in the control block of the subcommand. The first 2 bytes of the Additions 2 field contain the number of the subcommand in binary format. The third and fourth bytes of the Additions 2 field contain the offset of the subcommand's control block in the MC call's record buffer in binary format. All subcommands before the one that failed were executed.

Action

Correct the failed subcommand if necessary and re-issue the subcommands beginning with the one that had failed.


Response 17
Origin Mainframe and open systems
Explanation

A subcode indicating the specific cause and action for this response code appears in the low-order (rightmost) two bytes of the ACB's Additions 2 field or in the ACBX's Error Subcode (ACBXERRC) field. The following are the subcodes and their meanings:

Subcode Meaning
1 The program tried to access system file 1 or 2, and no OP command was issued.

Action: Restructure the program to begin with an OP command.

2 The program tried to access system file 1 or 2, and the user is not authorized.

Action: Change the program to avoid the access.

4 One of the following occurred:
  • The specified file number is invalid. The file number might be equal to "0" or greater than the maximum allowed.

  • When running with ADARUN DTP=RM or DTP=TM, an attempt was made by a non-Adabas Transaction Manager user to access/update an Adabas Transaction Manager system file.

5 The file is either not loaded, or has been locked by another user for privileged use.

On mainframe systems, for ADAORD and ADAINV utility operations, the write phase has started and use of the file is now blocked for the type of operation you requested.

6 On mainframe systems, an E1 (delete record) command was given without specifying a valid file number.

On open systems, the file to be created already exists.

7 The program tried to perform an LF command on system file 1 or 2.
8 On mainframe systems, the program tried to access a file that was not listed in the file list of an open (OP) executed with the R option.

On open systems, an ET user with a restricted file list and ACC = file number attempted to issue a UPD command, or a user with a restricted file list attempted to touch a file that is not in the file list

9 The file that the program attempted to access is completely locked. This is usually because the maximum number of logical file extents that can fit into the FCB have been used.

Action: Reorder, then unlock the file. Continue operation.

10 The program attempted to access a file which is locked with exclusive EXU status.
11 An LF command (read FDT) was run on a file that is not loaded; neither the FCB nor the FDT exists.
12 File has been locked with LOCKF.
13 A file is password-protected and the password was specified, but the corresponding security file is missing (not loaded).
14 A command was issued against a LOB file. Commands involving LB fields should be directed against the associated base file, not the LOB file.
15 A file is being loaded so its information is temporarily unavailable.
16 On mainframe systems, an attempt was made to perform an update (e.g. A1, E1, N1/2) against a file loaded with the attribute RPLUPDATEONLY=YES or READONLY=YES.

On open systems, the file was locked by ADAOPR.

17 An attempt was made to perform an update (e.g. A1, E1, N1/2) against a file loaded with the attribute READONLY=YES.
18 File has been locked with ALOCKF.
21 On mainframe systems, there was not enough space for encoding elements (ECSE).

On open systems, a two-byte file number was used against a lower version database that does not support large file numbers.

22 On mainframe systems, the required ECS objects needed for conversion between user and system data representation could not be loaded.

On open systems, the file control block (FCB) is invalid (corrupted).

23 ECS object could not be located. The following objects must be available in the encoding objects library: File Alpha, File Wide EDD, User Alpha, User Wide EDD, and the PTOs for the combinations between file/user alpha/wide encodings.

Action: Check that the required EDD and PTO objects are available.

24 ECS function get_attribute() failed.

Action: The function's return code is logged with the nucleus message ADAN7A.

25 One of the following occurred: - A required encoding attribute was missing in an ECS object (encoding type, class, and flags) - The default space character length was > 4 - Default space table allocation failed - If DBCS-only plane exists, wide space character was undefined, or the length > 4, or wide space table allocation failed
29 An Adabas Review communication error has occurred. Contact your Software AG support representative.
52 A non-Adabas target was called.
99 The file's FTD is corrupted.

Action: To resolve the problem, repair the file by running a restore/regenerate from a consistent state.

249 (0x00F9)

While attempting to satisfy a partitioned file command, Adabas Vista detected the unavailability of an FDT – this is invalid for one of the following reasons:

  • None of the partitions were available/online and at least one of them has the file parameter Critical set to YES.

  • None of the partitions were available/online and all of them have the file parameter Critical set to NO and the command can not be satisfied with a “no data” response such as RSP003.

An error occurred when Adabas Vista (open systems) tried to access a file that was not listed in the file list of an OP command executed with the R option.

Action: Ensure at least one of the file partitions is available/online or review the program logic.


Response 18
Origin Mainframe and open systems.
Explanation

Invalid file number usage. The file number was modified between successive L2/L5 calls or between successive Lx and Sx calls.

Action

Correct the file number.


Response 19
Origin Mainframe and open systems.
Explanation

An attempt was made to update a file which is either already open for read access or can only be opened for read access. The leftmost two bytes of ACB's Additions 2 field or the ACBX's File Number (ACBXFNR) field may contain the file number.

Action

Do not attempt to update a file with read-only access.


Response 20
Origin Mainframe and open systems.
Explanation

One of the following invalid values was used for a command ID value:

  • Binary zeros

  • Blanks

  • The high-order byte contains the hexadecimal value "FF", but there is no automatic command ID generation

  • The three high-order bytes contain the ASCII string "SYN".

Action

Correct the command ID and avoid using any of these invalid command ID values.


Response 21
Origin Mainframe and open systems
Explanation

An invalid command ID value was detected. One of the following explanations or subcodes is provided:

Subcode Meaning
1 The command ID value was not found in the sequential command table. This is not an initial call and there was no previous initial call, or the command ID was deleted or lost in a timeout or recovery action.
3 The command ID value specified for the L3/L6 command was assigned to another Lx command.
5 The command ID value specified for the L9 command was assigned to another Lx command.
6 Unexpected last file in chain.
7 The command ID value specified was assigned to a different file.
8 The command ID value specified for the Sx command is for a sorted ISN list; the ISN list was not in ISN sequence.
9 An application running with PREFETCH=YES or PREFETCH=OLD attempted to dynamically reverse the read direction of an L3/L6/L9 command. This is not allowed.
10 The master file number is not the same as it was in the initial call for this command ID.
12 ACB(X)Add1 altered after initial call.
13 S9 ISN list already sorted
14 Not a chained file as expected.
15 Not an L2 sequence as expected.
16 Chained file transformed ISNs not permitted.
17 CID does not exist for chained file.
18 File was not master file as expected.
19 Special L3 started on a valid file number and subsequent L3 issued with the API option.
20 Chained file ISNs not transformed.
21 Special L3 system area not as expected. System area changed.
22 The command ID value specified was assigned to a different file and FBL is not equal to zero.
23 Incorrect CID for sort function.
249 (0x00F9)

An invalid command ID value was detected by Adabas Vista (open systems):

  • The command ID value specified with the N option of an L1/L4 command was not found.

  • The command ID value specified with the N option of an L1/L4 command does not correspond to an ISN list.

  • One or both of the ISN lists referred to in the ADDITIONS 1 field of an S8 command do not exist.

Action: Review the program logic.

Action

Correct the command ID.


Response 22
Origin Mainframe and open systems
Explanation

The command or command option is invalid. A subcode indicating the specific cause and action for this response code appears in the low-order (rightmost) two bytes of the ACB's Additions 2 field or in the ACBX's Error Subcode (ACBXERRC) field.

When using the LNCSTUB module on mainframe systems, this response code may indicate problems with the initial call (IC) to the Adabas CICS command-level link component. If the Adabas control block shows a command code of "IC", the link routine being used may not be at the proper release level or may not be the command-level version.

The following are the subcodes and their meanings:

Subcode Meaning
1 The nucleus detected an invalid command code.
2 This command cannot be issued by an ACC (access only) user; and update command cannot be issued by an access-only user.
3 This command cannot be performed on a read-only nucleus; an update command cannot be issued for a read-only database session.
4 This privileged command was issued without a previous OP (open) command.
5 The command is not valid for a nonprivileged user.
6 The command was rejected by user exit 11.
7 Incorrect command options were specified for a privileged command.
8 The command is invalid for an ET user in preliminary ET status. First complete the transaction using Adabas Transaction Manager.
9 The current user is not authorized to issue an ET/BT command.
10 The C2 command is no longer permitted.
11 The C3 command can only be issued by EXU users.
12 The L1/4 command with the option "F" is not valid for expanded files.
13 The call issued is not permitted when the database is in a suspend state.
14 Invalid privileged command.
15 An L1/L4 command specified the multifetch option ("M" or "O") was not combined with either the "I" or "N" option.
16 The user does not have "privileged" command authorization.
17 A refresh file (E1 command with ISN zero) is not permitted during online save database or file.
18 Applications using the ADALNK X'48' call logic receive this response when the logic has been suppressed.
19 On mainframe systems, a special utility command was issued for an obsolete subfunction.

On open systems, an ET or BT with command option "S" was issued without subtransactions being enabled for the current Adabas user session by specifying command option "S" in the OP command.

21 One of the following occurred:
  • A BT command was issued by a non-ET logic user.

  • An ET command was issued for a distributed transaction managed by Adabas Transaction Manager; ET commands are invalid for a distributed transaction managed by Adabas Transaction Manager.

22 The current transaction has already been heuristically terminated or the command is not allowed within an MC sequence.
23 One of the following occurred:
  • The last MC subcommand is not ET.

  • A BT command was issued for a distributed transaction managed by Adabas Transaction Manager; BT commands are invalid for a distributed transaction managed by Adabas Transaction Manager.

24 One of the following occurred:
  • An ET or CL command with user data is not allowed for read-only access to a database.

  • CL is invalid because the user has a transaction in progress that is managed by Adabas Transaction Manager.

25 A command was sent from an Event Replicator Server to an Adabas nucleus, but the Adabas nucleus is not running with ADARUN REPLICATION=YES.
26 An attempt was made by an Adabas nucleus to connect to an Event Replicator Server when the target of the message is actually another Adabas nucleus, not an Event Replicator Server.
28 A replicated utility may not be executed for a replicated file when the Adabas nucleus is running in single-user mode.
29 An error occurred during a connection attempt by an Event Replicator Server database. Ensure that you are trying to connect to another Adabas nucleus and not an Event Replicator Server and try again.
31 API file delete not permitted: not API loaded.
32 An attempt was made to update a replicated file in single-user-mode. Replicated files can be updated only in multi-mode; replication is not supported in single-mode. However, a nucleus with replication support can be started in single-mode for maintenance purposes.
33 A shared hold status request (with command option 3 set to "C", "Q", or "S") is not allowed for a command with prefetch (command option 1 set to "P").

On open systems, the command option "S" is not allowed for an S9 command with a non-blank Additions 4 field.

34

On open systems, the command was rejected by user exit 11.

35 The command cannot be executed with the nucleus parameter NT=1.
36 The descending option "D" is not allowed for the command.
37 On mainframe systems, a shared hold status request (command option 3 is set to "C", "Q", or "S") is not allowed for a non-ET user.

On open systems, a shared hold status request (command option 3 is set to 'C', 'Q', or 'S') is not allowed for a non-ET user.

38 A shared hold status request for a sequential read command (command option 3 is set to "Q") is not allowed for an L4 command without the N-option, nor is it allowed for an S4 command without a command ID (CID) or with an ISN buffer length other than 4 bytes.
39 A shared hold status request for a sequential read command (command option 3 is set to "Q") is not allowed for a command with a multifetch (command option 1 is set to "M" or "O"). Also, a shared hold status request (with command option 3 set to "C", "Q", or "S") is not allowed for a read command with prefetch (command option 1 is set to "P").
40 A keep-in-shared-hold-status request (with command option 3 set to "H") is not allowed for an ET or BT command with multifetch or prefetch (command option 1 is set to "M" or "P").
41 A request to read the next portion of a LOB value (command option 2 is set to "L") is not allowed for an L1/L4 command with multifetch (command option 1 is set to "M" or "O") or prefetch (command option 1 is set to "P").
42 On open systems, for an A1 command with command option 2 = 'T', the current time is still the same as the value of the field with SY=TIME in the database.
48 An obsolete internal request to shut down Adabas, supposedly coming from Entire Net-Work, has been issued and rejected.
50 The Router (LCC) detected an invalid command code. This may also arise when a new ACBX-type call is presented to a back-level router.
51 A client call with the ADARUN parameter PREFETCH=OLD has multiple APLX buffers or the contents of APLX+4(chained APLX) is non-zero. To resolve this,. use the ADARUN parameter setting PREFETCH=YES.
52 A non-Adabas target was called.
53 Invalid file specified for an Adabas Online System function.
54 The user was stopped with STOPUR or STOPSUR.
55 The command is returned because the command queue timeout time specified by the DELCQ operator command or the AUTOCQTIME ADARUN parameter was reached or exceeded for the command.
1005 The command code is invalid.
1006 The ACBX is invalid (not first buffer).
1007 The ABD is invalid.
1008 The ABD type is invalid.
1009 More than one search buffer specified.
1010 More than one value buffer specified.
1011 More than one ISN buffer specified.
1012 The number of search and value buffers do not match.
1013 The number of format and record buffers do not match.
1015 A streaming logic error occurred.
Action

Correct the command code or command option or the previous OP command, and rerun the program.


Response 23
Origin Mainframe and open systems
Explanation

An invalid starting ISN was specified for an L2/L5 command sequence:

  • The ISN was not assigned to a record in the file; or

  • The ISN was greater than the MAXISN in effect for the file.

Open Systems

On open systems the following subcodes may occur:

Subcode Meaning
249 (0x00F9)

An invalid ISN was detected by Adabas Vista (open systems). The starting ISN specified for an L2/L5 command sequence is not consistent with the definitions for the partitioned file.

Action: Review the program logic.

Action

Correct the ISN.


Response 24
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

For an S9 command:

  • The ISN list in the ISN buffer was already sorted; or

  • The ISN list in the ISN buffer contained an invalid ISN; or

  • The "D" option was specified when trying to sort an ISN list by ISN.

Open Systems

An ISN is equal to "0" or is greater than or equal to the first free ISN found in the ISN buffer. The Additions 2 field contains the value of the invalid ISN in 4 byte binary format.

Action

Correct the ISN buffer.


Response 25
Origin Mainframe and open systems
Explanation

The ISN specified in ISN lower limit field for an S1/S4 or S2/S9 command was not found.

Open Systems

On open systems the following subcodes may occur:

Subcode Meaning
249 (0x00F9)

An invalid ISN was detected by Adabas Vista (open systems). The ISN specified in the ISN Lower Limit field for an S2 command when retrieving a group of ISNs from a saved ISN list was not found.

Action: Review the program logic.

Action

Correct the ISN lower limit.


Response 26
Origin Mainframe and open systems
Explanation

An invalid ISN buffer length for an S9 command was detected. The number of ISNs to be sorted as provided in ISN quantity is equal to "0".

Depending on the subcode in the rightmost two bytes of the ACB's Additions 2 field or the ACBX's Error Subcode (ACBXERRC) field, one of the following has occurred:

Subcode Meaning
2 An S9 command with an ISN buffer contains ISNs that are higher than the TOP-ISN of the file.
Action

Correct the ISN buffer length.


Response 27
Origin Mainframe systems only
Explanation

Sufficient work space was not available to accommodate the combined sizes of the search and value buffers as indicated in the search buffer length and value buffer length fields.

Subcode Meaning
1 Sufficient work space was not available to generate the format translation.

Response 28
Origin Mainframe and open systems
Explanation

The first two bytes of the Additions 1 field contained an invalid descriptor for an L3/L6 or S2/S9 command.

Depending on the subcode in the rightmost two bytes of the ACB's Additions 2 field or the ACBX's Error Subcode (ACBXERRC) field, one of the following has occurred:

Subcode Meaning
1 The field was not a descriptor.
2 The use of the descriptor is not supported (for example, phonetic descriptors or the descriptor is contained within a periodic group).
3 The descriptor was changed between successive calls.
4 There is a mismatch of the descriptor names in the Additions 1 field and the search buffer.
5 An initial L3 or L6 call contains no trailing blanks in the Additions 1 field.
7 ADAINV is inverting the file and using the descriptor.
8 The descriptor is missing in the file index.
9 An internal error occurred during SB interpretation.
Action

Correct the Additions 1 field.


Response 29
Origin Mainframe and open systems
Explanation

In an L3 or L6 command, a value repositioning was attempted (bytes 3-8 of the Additions 1 field contain spaces) and the Command Option 2 field did not contain the value "A", "D", or "V". The command ID is released.

Action

Correct the Additions 1 or Command Option 2 field.


Response 34
Origin Mainframe systems only
Explanation

An invalid command option has been detected.

Depending on the subcode in the rightmost two bytes of the ACB's Additions 2 field or the ACBX's Error Subcode (ACBXERRC) field, one of the following has occurred:

Subcode Meaning
1 An invalid command option has been specified in one of the command option fields.
2 The R option has been specified for the C5 command, but replication is not active.
9 A record buffer must be specified for this command but is missing (not specified of length zero).
Action

Either remove the invalid command option or replace it with a valid option.


Response 35
Origin Mainframe systems only
Explanation

The user/DBA attempted to perform a function for a noncluster Adabas nucleus that is available only for an Adabas cluster database.

Action

Either perform the function against a cluster database or change the function.


Response 39
Origin Mainframe systems only
Explanation

A logically deleted descriptor was used as a search criterion or was specified in the first two bytes of the Additions 1 field for an L3, L6, L9, S2, or S9 command.

Action

Remove the use of the logically deleted descriptor and inform your database administrator about the problem.


Response 40
Origin Mainframe and open systems
Explanation

A syntax error was detected in the format buffer.

Mainframe Systems

On mainframe systems, one of the following subcodes may be used:

Subcode Meaning
1 Syntax error in format buffer; possible premature end of buffer segment.
2 Syntax error in the format buffer -- bad first or second character of field name or missing "/".
3 Text literal has no ending quote or is too long (more than 255 characters).
4 Text literal is empty.
5 Expected delimiter missing.
6 Conditional format criterion has no closing parentheses ")".
7 The conditional format criterion is empty.
8 Invalid field name, format, or search operator.
9 One of the following occurred:
  • An invalid edit mask number (greater than 15) was specified.

  • A syntax error in the conditional format criteron was found.

  • Multiple format buffer segments are specified with conditional format criterion.

10 Invalid character following field name specification.
11 Invalid index specification for MU field in PE group.
12 Expected number missing or too large (>=231).
13 Syntax error in LOB segment specification.
14 Syntax error in L element specification.
15 Syntax error in D element specification (daylight savings time indicator).
16 Invalid Date-Time edit mask specification.
17 MU/PE index range specification invalid for LOB segment notation.

On mainframe systems, the following information is returned in the Additions 2 field of the control block:

  • The leftmost two bytes contain the two characters being inspected when the error was detected.

  • The rightmost two bytes contain the subcode.

Open Systems

One of the following format buffer errors occurred.

  • The terminating period was missing;

  • The first position contains a period, this only applies to N1 or N2 commands;

  • Length and/or format specified with a range definition;

  • An invalid element was detected;

  • A field segment notation was not correct: it must be specified either as (byte-number,length) or as (byte-number,length,length-2), where byte-number must be either "*" or a decimal number, and length and length-2 are decimal numbers. These numbers must be less than 2,147,483,648;

  • A field segment notation was specified for a range of MU fields or for a range of fields within a periodic group.

On open systems, the following information is returned in the Additions 2 field of the control block:

  • The leftmost two bytes contain the number of the byte (in binary format) relative to the beginning of the format buffer where the error was detected.

  • The rightmost two bytes contain the name of the field being processed when the error was detected.

Action

Correct the format buffer.


Response 41
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

One or more specification errors exist in the format buffer. When possible, the short name of the field for which the error occurred is stored at offset 2 of the ACB's Additions 2 field or in the ACBX's Error Character Field (ACBXERRB).

The following specification errors may have been made:

Note:
A collation descriptor (COLDE) can only be specified in the format buffer of the L9 command and only when the decode option has been specified in the user exit. The value returned is not the index value but the original field value.

Subcode Meaning
1 Spacing element nX with n=0 or n>255 not allowed.
2 An invalid sequence of format buffer elements was specified.
3 Miscellaneous types of specification errors were found in the format buffer.
4 A field name was undefined or not elementary.
5 Format without fields.
6 A group field cannot be specified if the group contains a LOB (LB) field.
7 A field name is undefined.
8 Invalid use of fldD, fldL, fld,* or E(date-time-mask) notation.
9 Elementary field in PE group: 1-N notation not permitted with LOB (LB) fields or fldD notations.
10 A LOB (LB) field, fldL (length indicator notation) or fld,* (asterisk notation) are not permitted with an L9 command.
11 A length indicator (fldL) or asterisk notation (fld,*) are only permitted for LA and LOB (LB) fields.
12 LA or LOB (LB) fields are not permitted with 1-N notation, flda-fldb (field series) notation or old MU syntax.
13 LA or LOB (LB) fields are not permitted with fldC,* (count indicator) or flda-fldb,* (field series notation).
14 Asterisk notation and length indicator notation combinations (fldL,*) are not permitted.
15 SQL significance indicator and asterisk notation combinations (fldS,*) are not permitted.
16 Length indicator (fldL), asterisk notation (fld,*) or daylight savings time indicator notation (fldD) are not permitted for a group field.
17 Daylight savings time indicator notation (fldD) cannot be combined with asterisk notation (fld,*) or a length indicator notation (fldL).
18 Daylight savings time indicator notation (fldD) is only permitted for fields defined with the TZ option.
20 Daylight savings time indicator notation (fldD) is not permitted with count indicator (fldC) or field series notation (flda-fldb).
21 Old MU syntax is not permitted with daylight savings time indicator notation (fldD).
22 An invalid length or format has been specified with daylight savings time indicator notation (fldD); if specified it must be 2,F.
23 An invalid length or format has been specified with length indicator notation (fldL); if specified it must have length 4 and format B.
24 A phonetic, collation, or hyperdescriptor was specified.
25 Date-time edit mask notation (E(date-time-mask)) is not permitted with daylight saving time indicator notation (fldD), asterisk notation (fld,*), or length indicator notation (fldL).
26 Date-time edit mask (E(date-time-mask)) notation requires format P, U, F, or B.
27 Date-time edit mask (E(date-time-mask)) notation and edit mask notation (E0-E15) are not permitted together.
28 Date-time edit mask (E(date-time-mask)) notation and count indicator notation(fldC) are not permitted together.
30 Date-time edit mask (E(date-time-mask)) notation is only permitted for a field defined with a date-time edit mask.
31 Daylight savings time indicator notation (fldD), length indicator notation (fldL), and asterisk notation (fld,*) are not permitted together with LOB segment notation.
32 LOB segment notation is permitted only for LOB (LB) fields.
33 More than one LOB segment with *-position not permitted.
34 Length/format override not permitted for LOB segment notation.
35 Invalid byte number and length parameters in LOB segment notation.
36 Invalid length-2 parameter in LOB segment notation; must be equal to length parameter.
37 Invalid syntax with daylight saving time indicator in format buffer.

Open Systems

An error was detected in the format buffer:

  • The field name specified is reserved for edit mask usage;

  • An index was equal to 0;

  • A length specified or taken from the FDT standard length is greater than the maximum length of the required format;

  • nnnX was specified with nnn greater than 253;

  • A literal with more than 253 characters was specified;

  • A subdescriptor, superdescriptor, phonetic descriptor, hyperdescriptor or a collation descriptor was specified;

  • A field specified was not present in the file;

  • A periodic group name appears without an index;

  • A length and/or format was used with a group notation;

  • A field in a periodic group was specified without an index;

  • A range notation with a group name or a multiple-value field as the first or last element was specified;

  • A reference was made to the count of a multiple-value field contained in a periodic group, and no index was included to indicate the periodic group occurrence for which the count was to be returned;

  • A collation descriptor with the option HE was specified for an L9 command.

  • A count specification was made for a field which was neither a multiple-value field nor was contained within a periodic group;

  • A count for a non-multiple value field within a periodic group was specified;

  • A length and/or format specification was used with a periodic group notation;

  • A (regular or periodic) group containing a multiple-value field was specified;

  • Invalid index usage;

  • A descending index range was specified;

  • A double index was used for a non-periodic field;

  • A multiple-value field with an index specification and a multiple-value field without an index specification were used;

  • A value cannot be converted to the required format (READ command) or converted to the FDT standard format (UPDATE command);

  • The S element was applied to a field that does not have the NC option;

  • A field with the NC option was used more than once together with its S element;

  • The add option is not compatible with the format/length;

  • The specification of a character set was invalid;

  • A field was specified with an edit mask not allowed for the field;

  • A field segment notation '(byte-number,length)' or '(byte-number,length,length-2)' was not correct: byte-number + length must be less than or equal to the maximum value length + 1, and length-2 must be equal to length. The maximum value for LB fields is 2,147,483,643, for LA fields 16381, an for other values 253 bytes;

  • Segment notation is only allowed for values with the format 'A'.

The following information is returned in the Additions 2 field of the control block:

  • The leftmost two bytes contain the number of the byte (in binary format) relative to the beginning of the format buffer where the error was detected.

  • The rightmost two bytes contain the name of the field being processed when the error was detected.

Action

Correct the specification error and reissue the command or job. For more information about syntax rules for multiple field and periodic group indexing, refer to the Adabas Command Reference documentation.


Response 42
Origin Mainframe systems only
Explanation

A space problem occurred. The following are the subcodes and their meanings:

Subcode Meaning
1 The Work pool was too small to store a user format.

Action: Increase the LWP specification and retry .

2 The internal format buffer was too small to store a user format (translated into internal structure).

Action: Increase LFP specification and retry.

Action

See the actions described in the subcodes.


Response 43
Origin Mainframe and open systems
Explanation

In an L9 command, the descriptor specified in the format buffer did not agree with the descriptor specified in the search buffer.

Action

Correct the format buffer or the search buffer.


Response 44
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

One of the following format buffer errors occurred (subcodes are shown in the leftmost column):

Subcode Meaning
1 The specified format is not allowed for an update operation. A possible reason for this is the presence of a conditional format buffer with an update operation.
2 The L9 command's format buffer format is not allowed for other commands.
3 The specified format is not allowed for an update operation. A possible reason for this is the presence of a conditional format buffer with an update operation.
4 The L9 command's format buffer format is not allowed for other commands.
5 Format used for L9 can only contain field and an optional daylight savings time indicator (fldD).
6 Fixed point format must have length 2, 4, or 8.
7 Conditional format and more than one format buffer was specified.
8 The current Adabas call provides a different number of format buffers than the format reference by CID.
9 Number of format buffer segments (ABDs) is zero.
10 AAS,AA,AA is invalid.
12 L option specified but the format has no LOB segment with *-position.

Open Systems

One of the following situations occurred:

Subcode Meaning
1
  • The format buffer is invalid for use with an UPDATE command (A1), ADD command (N1/N2):

    • Format buffer contains overlapping fields, e.g., GL1-3, GL2-4.;

    • Format buffer contains an 1-N element, e.g., GL1-N.;

    • There is not a 1:1 relation between an L element and the subsequent corresponding element with '*' length;

  • A READ command uses a format buffer from the format pool, which was previously used by update or add command, and which contains an invalid conversion.

12 L option is specified but the format has no LOB section with *-position.
13 The format buffer for an A1 commands with command option 2='T' did not contain a last-update-timestamp system generated field.

Note:
Subcodes associated with response 44 are stored in the first two bytes of the Additions 2 field (ACB) and in the error subcode field (ACBX).

Action

Correct the format buffer or use a different read or update command.


Response 45
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

The internal format buffer space has been exceeded. Either the LWP parameter setting is too small or the internal format buffer requires more than 2 G.

Open Systems

Multiple field or periodic group overflowed when using the N suffix in the format buffer for update.

The following information is returned in the Additions 2 field of the control block:

  • The first two bytes will contain the number of the byte (in binary format) relative to the beginning of the record where the error was detected;

  • The third and fourth bytes will contain the name of the field being processed when the error was detected.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

Increase the size of the LWP parameter and try again. If the problem persists, contact your Software AG technical support representative for assistance.

Open Systems

Because the multiple field or periodic group reached its absolute limit, the application must be redesigned.


Response 46
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

Subcode Meaning
1

Too many TBLES elements for this user.

2

The maximum value for the NQCID parameter was exceeded (the number of TBI and/or TBQ elements is greater than NQCID).

Open Systems

Mismatch of format buffer usage for the supplied command ID.

  • A command ID of global ID format buffer has been found in the format pool and has a different file number to the file supplied by the caller;

  • The file number was changed in subsequent Adabas calls with the same normal or global command ID.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

Adjust the size of the NQCID parameter and try again.

Open Systems

Check the command IDs used in the call and try again.


Response 47
Origin Mainframe and open systems
Explanation

The maximum value for the NISNHQ parameter was exceeded. The following subcodes appearing in the low-order (rightmost) two bytes of the ACB's Additions 2 field or in the ACBX's Error Subcode (ACBXERRC) field provide more detailed information.

Subcode Meaning
1 An attempt was made to put too many ISNs in hold. The maximum number of ISNs that can be put in hold is specified by the NISNHQ parameter and can be overridden via the Additions-4 field (bytes 3-4) of the user's OP command and via the user profile.

Action: Increase the value of the NISNHQ parameter or the maximum number of ISNs that the user can put in hold specified in the Additions-4 field (bytes 3-4) of the OP command or in the user profile. Alternatively, modify the application program to store fewer ISNs in hold at the same time.

2 The hold queue was full. If another user has put the maximum number of ISNs in hold, that other user is backed out and will next receive response code 9, subcode 1. The user who is given the response code 47 is not backed out; this user should issue an ET or BT command to release the ISNs from hold.

Action: Increase the value of the NH parameter. Alternatively, modify the application program to store fewer ISNs in hold at the same time.

Action

Increase the value of the NISNHQ parameter by modifying its ADARUN parameter value in the nucleus startup file, or (on open systems) using ADAOPR.


Response 48
Origin Mainframe and open systems
Explanation

An error occurred during the processing of a command such as OP or N1. Refer to the hexadecimal subcode that appears in the low-order (rightmost) two bytes of the ACB's Additions 2 field or in the ACBX's Error Subcode (ACBXERRC) field.

Subcode Meaning
  File(s) not available at open time. This is the default message displayed with this response code if another subcode is not provided.
1 A specified file is locked against the requested use.
2 A specified file is currently in conflicting use.
3 A utility cannot start because an online save operation is in progress.
4 A specified file is already locked or being used by an EXU/EXF or utility user. Use operator command DLOCKF to display file locks, DNFV to display a summary of the current file usage.
5 A utility requiring exclusive database control cannot start because an online save operation is in progress.
6 A utility that requires exclusive database control cannot start because the user queue is not empty.
7 The requested file lock cannot be granted because the file is being used. Use operator command DNFV to display a summary of the current file usage, DFILES to display current users of the file.
8 The user ID specified in the open (OP) command is already in use by another user.
9 An EXU/EXF/UTI lock was requested in the open command, but the file is currently in the file list of a user in UPD/EXU/EXF/UTI status.
10 An EXF/UTI lock was requested in the open command, but the file is currently in the file list of a user in ACC status.
11 A nonprivileged user issued an open (OP) command to a nucleus in UTIONLY (utilities only) status.
13 Online file save attempting to run on an advance-locked file.
14 UPD/ACC open attempted against advance-locked file.
15 A file requested for an online utility (Adabas Online System or ADADBS) or an E1 program refresh is currently being used.
16 ACODE or WCODE was specified in the record buffer on the command but the nucleus was not activated with UES support.
17 A specified file is locked against the requested use and is advance-locked. The data in the file is not accessible. This can happen if a utility aborts or an autorestart fails.
18 On mainframe systems, this means that a second command was issued by a user who is participating in a two-phase commit (preliminary ET completed; final ET outstanding) or whose transaction has been heuristically terminated.

On open systems, this means that the index of the specified file is not accessible. This can happen if a utility aborts or if the index has been disabled by ADAREC REGENERATE or an autorestart.

19 The file number is zero or is greater than the maximum number of files allowed for the database (based on the MAXFILES parameter setting when the database was defined using the ADADEF utility).
20 A regenerate/backout with exclusive database control is rejected because there are in-doubt transactions or heuristically terminated transactions on Work part 4.
21 File is locked for utility usage.
22 An attempt was made to release an advance-lock, but the lock was not set.
23 An advance-lock operation was attempted for a file that has not been loaded.
24 An advance-lock operation was attempted for a file that is already advance-locked.
25 This subcode is issued by Adabas Transaction Manager.

The client session 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 - 30 Reserved for Adabas Transaction Manager. These subcodes are given only when Adabas Transaction Manager is in use. Please read the Adabas Transaction Manager documentation for more information.
31 File locked for normal usage
32 A file is in use by an exclusive update (EXU) user. An update request from another user is not permitted.
33 A file is locked for exclusive file control (EXF) or utility update (UTI) usage. The request from a user with a different type is not permitted.
34 An advance-lock operation was performed on a read-only nucleus.
35 An advance-lock operation was performed during an online save.
36 Nucleus in REGENERATE/NOAUTOBACKOUT state.
257 - 260 Reserved for use by Event Replicator for Adabas on open systems.

On open systems, the corresponding file number is returned in the first two bytes of the Additions 2 field in binary format except for value 8 in the third and fourth byte. The value 0 means the whole database.

Action

The following user actions are possible:

  • Wait for the other user or utility to finish, then retry the command.

  • Make the file available for all users (on open systems, if value 16 occurred in bytes 3 and 4).

  • Restore or unlock the file (on open systems, if value 17 occurred in bytes 3 and 4).

  • Rebuild the file's index (on open systems, if value 18 occurred in bytes 3 and 4).

  • On open systems, if the value in bytes 3 and 4 of the Additions 2 field is 8, and the nucleus was started with the OPEN_REQUIRED option, you can reissue the OP command immediately. This will cause the other user with the same user ID to be stopped, unless that user is currently active.

  • On open systems, if a utility receives a response 48 because non-utility users are still active, you can lock the file with ADAOPR LOCK. This ADAOPR command stops all non-utility users from accessing the file and allows only utility users to access the file until it is unlocked again.

    On mainframe systems, if a utility receives a response 48 because non-utility users are still active, you can lock the file with ADADBS MODFCB FILEREADONLY. The FILEREADONLY command stops all non-utility users from accessing the file and allows only utility users to access the file until it is unlocked again.


Response 49
Origin Mainframe and open systems
Explanation

The compressed record was too long. It exceeds the maximum permitted compressed record length for the file.

On open systems, the first two bytes of the Additions 2 field contain the length of the compressed record in binary format.

On mainframe systems, the following subcodes may be indicated:

Note:
This response code always means that the compressed record is too long and there are duplicate meanings for subcodes but the subcode can help your Software AG technical support representative analyze where in the code we are giving the response. This can be useful for debugging purposes. Please always provide the subcode when communicating about this response code with your Software AG technical support representative.

Subcode Meaning
  File(s) not available at open time. This is the default message displayed with this response code if another subcode is not provided.
1 Multiple-value (MU) field.
2 Periodic (PE) group field.
3 MU field.
4 PE group.
5 PE group level.
6 Remaining fields.
7 Record too long for protection logging (internal error).
8 A compressed record exceeds the permitted length. The error was detected when updating a multiple field.
9 Exceeded segment length maximum.
10 Long alpha or wide field.
11 New compressed record too long
12 Old version MU update.
13 The MU field was defined with an index
14 An MU update caused the compressed record to become too long.
15 An MU update caused the compressed record to become too long.
16 An MU update caused the compressed record to become too long.
17 MU update, MU count > 1
18 An update to an LA field caused the compressed record to become too long.
19 LOB value too long. An attempt was made to update a LOB value segment that ends after the maximum allowed length of LOB valus. This response code/subcode combination is produced as a result of an L1/L4 command with Command Option 2 set to "L" but with the ISN Lower Limit value grater than or equal to the length of the LOB value being read.
20 Compressed Data Sorage record too long. A LOB update attempted to make a long LOB value (greater than 253 bytes) short (less than or equal to 253 bytes), but the base record was too long to embed the short LOB value. This condition was detected when the LOB value was being read from the LOB file.
21 Compressed Data Storage record too long. A LOB update attempted to make a long LOB value (greater than 253 bytes) short (less than or equal to 253 bytes), but the base record was too long to embed the short LOB value. This condition was detected when an attempt was made to insert the short LOB value into the base record.
90 Segment too long
96 Compressed record too long
99 Exceeded segment length maximum
Action

On open systems, add a new DATA extent with sufficient block size (block size >= compressed record size + 8). Alternatively you can start the nucleus with OPTIONS=AUTO_EXPAND; then the Adabas nucleus automatically creates a new DATA extent with sufficient block size.


Response 50
Origin Mainframe and open systems
Explanation

A syntax error in the record buffer was detected during processing of an OP command, an invalid character set was specified, an invalid time zone was specified, or an invalid file number (zero or greater than maxfiles) was specified.

On open systems, the first two bytes of the Additions 2 field contain the number of bytes (in binary format) relative to the beginning of the record buffer where the error was detected. If a time zone problem occurs, the two right-most bytes of the Additions 2 field in the ACB will contain a subcode; in an ACBX, the Error Subcode field will contain the subcode.

Subcode Meaning
31 Time zone not found in ADAZON directory. The specified time zone was not found in the ADAZON directory. Verify the time zone was specified correctly. If it was, contact your Software AG technical support representative for assistance.
32 Time zone pool full. No more time zone information could be loaded. Increase the size of the ADARUN LTZ parameter and restart the nucleus.
33 Open error on DD:TZINFO(MEMBER). Contact your Software AG technical support representative for assistance.
34 I/O error on DD:TZINFO(MEMBER). Contact your Software AG technical support representative for assistance.
35 Invalid data in TZ file. Contact your Software AG technical support representative for assistance.
36 Invalid transition time in TZ file. Contact your Software AG technical support representative for assistance.
Action

Correct the record buffer and try again.


Response 51
Origin Mainframe and open systems
Explanation

An error in the record buffer was detected during processing of an OP command.

One of the keywords EXU, UPD, ACC or WCHARSET is duplicated.

On open systems, the following information is returned in the Additions 2 field of the control block:

  • the first two bytes contain the number of bytes (in binary format) relative to the beginning of the record buffer where the error was detected;

  • the third and fourth bytes contain the open mode that failed (ACC =1, UPD = 2, EXU = 4, WCHARSET = 128)

Action

Correct the record buffer and try again.


Response 52
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

One of the following errors occurred while processing the record, value, or search buffer. In an ACB, the rightmost two bytes of the Additions 2 field contain the subcode; for subcodes 1-5, the leftmost two bytes contain the Adabas name of the field where the error occurred. In an ACBX, the subcode is stored in the Error Subcode (ACBXERRC) field; for subcodes 1-5, the Adabas field name where the error occurred is stored in the Error Character Field (ACBXERRB).

Subcode Meaning
1 Invalid packed or unpacked decimal value in record buffer.
2 Invalid length for variable-length field specified in record buffer.
3 Invalid null value or no value at all provided for field with NN option.
4 Invalid value for S element in record buffer.
5 Invalid value for S element in value buffer.
6 Encoding a collation descriptor value failed: the collation descriptor exit issued a return code.
7 Decoding a collation descriptor value failed: the collation descriptor exit issued a return code.
99 An invalid field length was specified.

Open Systems

  • The value of a G format field was not in floating point format;

  • The value of a P format field was not in packed decimal format;

  • The value of a U format field was not in unpacked decimal format;

  • A variable-length field was specified without a length parameter;

  • The SQL null value indicator (S element) has a value of less than -1;

  • A field with the NN option is forced to take the SQL null value;

  • The resulting value exceeds 4 bytes (longword) if the format is F, or exceeds the maximum (format dependant) length;

  • No record with the specified ADAM key was found.

The following information is returned in the Additions 2 field of the control block:

  • The first two bytes contain the number of the byte (in binary format) relative to the beginning of the record/value buffer where the error was detected. This value is -1 if a field with the NN option is forced to take the SQL null value.;

  • The third and fourth bytes contain the name of the field being processed when the error was detected.

Action

Correct the format, record, value, or search buffer and try again.


Response 53
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

One of the following errors occurred:

Subcode Meaning
0 The record buffer is too small.

Action: If the record buffer size:

  • conflicts with the lengths specified in the format buffer, change either the record buffer size or the format buffer specifications to resolve the conflict.

  • conflicts with the established global format ID (GFID), either release the GFID or change the record buffer size to match the GFID.

  • default is too small to hold the records in the file including the DVT when running the ADAULD utility, increase the size of the record buffer by setting the ADAULD LRECL parameter. See the Adabas Utilities documentation for more information.

1 The record buffer is too small. When locating a variable field in the input record, the required buffer length exceeded the given length.

Action: Verify that the record buffer content matches the given format and that sufficient space for variable fields is provided in the record buffer.

2 The ISN buffer is too small.

Action: Increase the size of the buffer.

3 The record buffer is too small. When locating a variable field within a group in the input record, the required record buffer length exceeded the given length.

Action: Verify that the record buffer content matches the given format and that sufficient space for variable fields is provided in the record buffer.

4 The record buffer is too small. When locating a field with A,* notation in the input record, the required record buffer length exceeded the given length.

Action: Verify that the record buffer content matches the given format and that sufficient space for variable fields is provided in the record buffer.

7 At least one of the record buffers was too small for the data defined in the corresponding format buffer.
8 The referenced existing format buffer requires more space than that given in one of the record buffers.

If this subcode occurs using ADACMP DECOMPRESS, the LRECL of the output record is too small.

249

In Adabas Vista, the record buffer provided for an L9 command with ‘I ‘ option against a partitioned file is not large enough to hold the full list of ISNs.

Action: Increase the size of the record buffer.

Open Systems

The record buffer was too small, or the ISN buffer was too small for a requested multifetch command. The following information is returned in the Additions 2 field of the control block:

  • The first two bytes contain the expected buffer size in binary format. This value is -1 if the command would have exceeded the maximum record size.

  • The third and fourth bytes contain the name of the buffer that was too small. ("RB" or "IB"). If the error occurred while using a hyperdescriptor exit, the name of the hyperdescriptor exit is stored here.

Action

Increase the record buffer or ISN buffer size, as appropriate.


Response 54
Origin Mainframe and open systems
Explanation

The record buffer for a C3, C5, or ET command is too long. The maximum allowed size is 2048 bytes. The following subcodes provide more information:

Subcode Meaning
1 The record buffer for the C3 command is too long.
2 The record buffer for the C5 command is too long.
3 The record buffer for the ET command is too long.
Action

Correct the record buffer specification, then reissue the C3, C5, or ET command.


Response 55
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

One of the following occurred:

  • During a read-type operation, a field defined with the SQL null (NC) option contained a null value, but the format buffer held no "S" (significant null) indicator for the field.

    In an ACB, the Additions 2 may contain the field name in the leftmost two bytes; the rightmost two bytes may contain the offset into the record buffer. In an ACBX, the Error Character Field (ACBXERRB) may contain the field name; the Error Offset in Buffer (ACBXERRA or ACBXERRG) fields may contain the offset into the record buffer.

  • Attempted format conversion was not possible due to incompatible data formats or other compatibility problems.

    In an ACB, the Additions 2 will contain the field name in the leftmost two bytes; the rightmost two bytes will contain the offset into the record buffer. In an ACBX, the Error Character Field (ACBXERRB) will contain the field name; the Error Subcode (ACBXERRC) field will contain the subcode.

    Subcode Meaning
    0 Conversion error on record decompression.
    1 Invalid conversion between formats.
    2 Invalid length for fixed encoding. For example, user encoding Unicode with code-point size of 2 bytes and no even length specified.
    4 Conversion error of a floating-point field (underflow) when converting to/from a non-IBM floating-point format.
    5 One of the following conditions exists:
    • Format conversion of a field with the NV option is not allowed.

    • In a read command (Lx, Sx), the format buffer of a field containing a null value is defined with the NC option, but without the NN option, and is missing the SQL significance indicator (S). For read-type commands, the S indicator is required when the NC fields are defined without the NN option. If the S indicator is not present when a read command detects an NC-specified field and the field actually contains a null value, this response code and subcode are returned.

    6 An invalid length was specified ( for example, a wide character field in Unicode encoding must have an even length).
    7 Invalid conversion between formats (different case than subcode 1).
    8 Conversion error of a floating-point field (overflow) when converting to/from a non-IBM floating-point format.
    9 A one-byte field was provided in the record buffer for the occurrence count of an MU field or PE group in a file with extended MU/PE limits. A two-byte occurrence count value is expected.
    10 A field using the NC field option has a null value and no S indicator was specified in the format buffer.
    20 Unsupported date-time conversion -- internal error.
    21 Date-time value outside valid range. The valid range depends on the date-time edit masks being used in the format or search buffer and the FDT.
    22 Invalid local time – (non-existing local time in the gap that occurs when switching from standard to daylight saving time or when the time zone advances GMT offset)
    23 Year outside range of 1-9999.
    24 Month outside range of 1-12.
    25 Day outside range of 1-n.
    26 Hours outside range of 0-24.
    27 Minutes outside range of 0-59.
    28 Seconds outside range of 0-59.
    30 Accessing a field defined with option TZ but no time zone was specified in the user session. Issue the OP command with TZ='timezone' parameter in the record buffer to set the time zone for the user session.
    31 Invalid daylight saving offset given (fldD) for date-time and time zone.
    n Data between user and system data representation could not be converted without error and 2-byte error code from ECS.
    254 Numeric field length in format shorter than the field length in the FDT.
    255 Field length exceeded maximum for variable fields.

    Entire Conversion Service (ECS) error codes are described in Entire Conversion Service (ECS) Errors, elsewhere in the Adabas Messages documentation.

Open Systems

A format, length conversion, or truncation error occurred while processing field values in the record buffer or value buffer.

  • The value for an FI field is too long;

  • The resulting value exceeds the border of the FI field;

  • Truncation error of numeric field;

  • Truncation of alphanumeric fields or truncation of numeric fields which are converted to alphanumeric, except when OPTIONS=TRUNCATION is enabled in ADANUC;

  • A value defined without LA or L4 option with variable length is larger than 253 bytes. This may happen for Unicode fields after conversion to another encoding.

  • The length specified for a Unicode field for a character set with fixed character length is not a multiple of the character length: in particular, the length for UTF-16 based character sets must be a multiple of 2, and the length for UTF-32 based character sets must be a multiple of 4;

  • The specified value is not a valid date/time value;

  • The field does not contain a valid date/time value. This can happen if the value was stored without a date/time edit mask;

  • A date/time field with option TZ was specified in the format or search buffer, but there was no time zone specified in an OP command for the current Adabas user session;

  • The attempted format conversion was not possible due to incompatible data formats or other compatibility problems.

The following information is returned in the first two bytes of the Additions 2 field, and in the case of an ACBX, also in the field ACBXERRC:

Subcode Meaning
0 Conversion error.
1 Truncation error.
2 Internal structure error.
5 Internal error.
20 Unsupported DATETIME conversion.
21 Date/time value outside valid range. The valid range depends on the date-time edit masks being used in the format or search buffer and the FDT.
22 Date/time value specified in gap when switching from standard time to daylight saving time.
24 Month not between 1 and 12.
25 Day not between 1 and n, where n is the number of days of the month specified.
26 Hours not between 0 and 24.
27 Minutes not between 0 and 59.
28 Seconds not between 0 and 59.
30 Internal error: missing time zone element for conversion with time zone.
31 Invalid daylight saving offset given (fldD) for date/time and time zone.

The field name is returned in the third and fourth byte of the Additions 2 field, and in the case of an ACBX in the field ACBXERRB.

In addition, the following information is returned in the case of an ACBX call:

  • The offset in the record or value buffer in ACBXERRA;

  • The type of buffer in ACBXERRD (‘R’ for error in record buffer, ‘V’for error in value buffer).

Action

Depending on the reason:

  • Correct the appropriate buffer and try again;

  • If the time zone specification in the OP command is missing, execute an appropriate OP command;

  • On open systems, if a record structure error is indicated, run ADAVFY FIELD against the corresponding file. If this produces errors, then the file must be unloaded, decompressed, recompressed and reloaded;

  • On open systems, subcodes 2 and 5 should never occur; you should, therefore, contact your nearest support center if you receive one of these subcodes. A copy of the command log and an export copy or backup of the files accessed will help us to analyze the problem.


Response 56
Origin Mainframe and open systems
Explanation

One of the following occurred:

Subcode Meaning
. The descriptor value was too large. Descriptor values are limited to 1144 bytes.
n The collation value exceeded the maximum 253 bytes. The subcode n is the collation descriptor exit number.
Action

Store a shorter descriptor value or collation value.

On open systems, you also can specify the TR option for the descriptor, which truncates larger descriptor values before they are stored in the index. Note that with the TR option, search results may be inaccurate: this is because values that are identical in the first 1144 bytes are considered to be equal to each other.


Response 57
Origin Mainframe and open systems
Explanation

In an L9 command, the descriptor specified in the format or search buffer or in the Additions 1 field was invalid or the descriptor was not specified:

  • The field name specified may not be the name of a descriptor.

  • The descriptor specified may be a phonetic descriptor or a hyperdescriptor, which are not allowed in an L9 command.

  • On open systems, the descriptor specified may be a collation descriptor with the option HE.

Action

Correct the descriptor in the format buffer, search buffer, or Additions 1 field and try again.


Response 58
Origin Mainframe systems only
Explanation

The format could not be found (as defined within format selection criteria).

Action

Adjust the format specification and try again.


Response 59
Origin Mainframe systems only
Explanation

Format conversion of a subfield is not possible. The source field has fixed point (F) or floating point (G) format.

Action

Correct the field for which you are attempting format conversion and try again.


Response 60
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

A syntax error was detected in the format or search buffer. Generally in an ACB, the first two bytes of the Additions 2 field contain the two characters under inspection when the error was detected and the rightmost two bytes of the Additions 2 field in the ACB contain one of the following subcodes. In an ACBX, the Error Character Field (ACBXERRB) contains the two characters under inspection when the error was detected and the Error Subcode (ACBXERRC) field contains one of the following subcodes.

Subcode Meaning
1 Premature end of search buffer.
2 Syntax error in search buffer; possibly a bad field name.
3 Text literal has no ending quote or is too long (more than 255 characters).
4 Text literal is empty.
5 Expected delimiter missing.
6 Soft coupling criterion has not closing parenthesis (")").
7 Soft coupling criterion is empty.
8 Invalid field name, format, or search operator.
9 Invalid edit mask number (greater than 15).
10 Invalid character following field name specification.
11 Invalid specification of MU field in PE group.
12 Expected number missing or too large (greater than 231).
13 Syntax error in LOB segment specification.
14 Syntax error in length indicator notation (L) specification.
15 Syntax error in daylight savings time notation (D) specification.
16 Invalid date-time edit mask specification.
17 MU/PE index range specification is invalid for LOB segment notation.

Open Systems

A syntax error was detected in the search buffer.

  The following information will be returned in the Additions 2 field of the control block:
  • The first two bytes will contain the number of the byte (in binary format) relative to the beginning of the search buffer where the error was detected;

  • The third and fourth bytes will contain the name of the field being processed when the error was detected.

Action

Correct the format or search buffer and try again.


Response 61
Origin Mainframe and open systems
Explanation

An error was detected in the search buffer, value buffer, or during an S8 command.

Mainframe Systems

On mainframe systems, one of the following subcodes may also be included with this response code:

Subcode Meaning
2 An invalid value operator was detected in the search buffer.
3 An invalid logical operator was specified for an S8 command - Command Option 2.
7 This subcode indicates that one of the following errors occurred:
  • The length of a descriptor value was greater than 253.

  • Invalid file number specification.

  • Invalid selection criteria for an Event Replicator for Adabas initial-state definition.

  • Invalid usage of the "S" or "N" operator.

  • The element order was invalid.

  • The specified field was not a descriptor.

  • The specified field has the "LA" option active.

  • A descriptor contained in a periodic group was specified without an index.

  • Invalid connection of partial criteria or different indices were used for a descriptor contained within a periodic group.

  • Invalid periodic group index.

  • Invalid or disallowed use of a phonetic descriptor.

  • A descriptor derived from or contained in a periodic group is not allowed.

  • The FROM-TO operator was specified with a phonetic descriptor.

  • Invalid FROM-TO range specification, or the FROM value was greater than the TO value.

  • The BUT-NOT value was outside the range of the preceding FROM-TO range.

  • An invalid command option was specified for ISN LIST processing (S8 command).

  • The search buffer "S" significant null indicator was specified with a value operator other than "EQ" (equals), which is not allowed.

8 An invalid FROM-TO range was specified. The BUT-NOT value was outside the range of the preceding FROM-TO value.
9 An invalid search criteria was specified.

Open Systems

On open systems, an error was detected in the search or value buffer, or during an S8 command:

  • Invalid command option 2 specified for ISN LIST processing (S8 command);

  • Invalid element or element order;

  • The specified field was neither a descriptor, subdescriptor, superdescriptor nor a phonetic descriptor;

  • Invalid connection of partial criteria and/or different indices used for a descriptor contained within a periodic group;

  • Invalid use of a phonetic descriptor;

  • Invalid periodic group index;

  • Invalid index usage;

  • The length of a descriptor value was greater than 253 or greater than the permitted length for the required format;

  • Invalid format type;

  • Invalid file number specification;

  • Invalid usage of the S operator - FROM value greater than TO value;

  • Invalid usage of the N operator - BUT NOT value was outside the range of the preceding FROM-TO range;

  • Invalid comparator;

  • The value in the value buffer cannot be converted into the field's FDT format;

  • The specified file name is not an ADAM key while using the V option with an A1 or E1 command;

  • Invalid value given in the value buffer while using the V option with the A1 or E1 command;

  • Invalid usage of the C option - only allowed for collation descriptors;

  • A field was specified with an edit mask that is not allowed for the field.

The following information is returned in the Additions 2 field of the control block (not for the S8 command):

  • The first two bytes will contain the number of the byte (in binary format) relative to the beginning of the search buffer where the error was detected;

  • If the third byte is zero, the fourth byte contains more information about the error:

    • Fourth byte 1: invalid length.

    Otherwise the third and fourth bytes will contain the name of the field being processed when the error was detected.

Action

Correct the search or value buffer or S8 command and try again.


Response 62
Origin Mainframe and open systems
Explanation

One of the following has occurred:

  • The length of the search or value buffers as specified in the search and value buffer length fields, respectively, was not sufficient to accommodate the search criteria specified.

  • The first character in the search buffer was a period (.).

  • The search buffer does not contain a period (.).

Action

Correct the search or value buffer and try again.


Response 63
Origin Mainframe and open systems
Explanation

The command ID value specified in the search buffer was invalid.

On open systems, the value in the first two bytes of the Additions 2 field indicates the reason (2 byte binary format):

Subcode Meaning
1 The command ID value specified in the search buffer was not found.
2 The associated ISN list is not sorted in ISN sequence (it has been generated by an S2/S9 command).
3 The command ID was not used in the previous FIND in which the SAVE ISN LIST option was used.
Action

Correct the command ID in the search buffer and try again.


Response 64
Origin Mainframe systems only
Explanation

This response code is used for communication with Adabas utilities and Adabas Online System (AOS), and was returned because the requested function could not be performed on the Adabas system (including checkpoint and security) files or because an error occurred in an AOS or utility function.

The following table shows some of the subcodes that may be returned:

Subcode Meaning
61 No or duplicate field(s) (see 'xx'); where xx is the first duplicate field encountered. If no field definitions were specified an FC is returned.
Action

Refer to the ADAREP output report for a list of the system files, or to the subcodes in the job output for more information. For AOS, a subcode is displayed in the error message, following the AOS module number. For utility functions, the subcodes may be described within the message text.

If you do not understand the action to take for a response code 64 or subcode, note the subcode and the function that caused the response code, and call your Software AG technical support representative for assistance.


Response 65
Origin Mainframe systems only
Explanation

An internal error occurred. The nucleus detected a space calculation error.

Action

Contact your Software AG technical support representative for assistance.


Response 66
Origin Mainframe systems only
Explanation

An incompatible owner ID was detected during an update operation on a multiclient file. The owner ID may be blank, or too long.

Action

Contact your Software AG technical support representative for assistance.


Response 67
Origin Mainframe systems only
Explanation

One of the following errors occurred:

Subcode Meaning
. An internal error occurred while executing an Sx command.
2 An error occurred during superfield generation.
Action

Retain all related information, and contact your Software AG technical support representative for assistance.


Response 68
Origin Mainframe systems only
Explanation

A nondescriptor field was used as a search criterion, and the non-descriptor search facility has been set OFF (the default for this facility is ON).

Action

The ADARUN parameter NONDES has been set to reject non-descriptor searches; either reset the NONDES parameter to its default value, or remove non-descriptor searches from your application. Natural provides a trace facility which locates such Natural application characteristics. Contact Software AG for details.


Response 70
Origin Mainframe systems only
Explanation

An overflow occurred in the table of sequential commands.

Action

The DBA may increase the value used for the LQ parameter or RC commands may be used.


Response 71
Origin Mainframe systems only
Explanation

An overflow occurred in the table of resulting ISN lists.

Action

The DBA may increase the value used for the LI parameter or RC commands may be used.


Response 72
Origin Mainframe and open systems
Explanation

One of the following errors occurred:

Subcode Meaning
6 The NU parameter is too small for the execution of a session autorestart. It is smaller than it was in the previous Adabas nucleus session that failed. In a cluster nucleus, the NU parameter is smaller than in the nucleus that had established the global lock structure.
7 An overflow occurred in the user queue.
8,9 An overflow occurred in the user queue file list pool.
Action

The DBA may increase the value used for the NU parameter.


Response 73
Origin Mainframe and open systems
Explanation

An overflow occurred in the section of the Work data set (mainframe systems) or the temporary working space (open systems) in which resulting ISN lists are stored.

On open systems, please note that for read-only databases, temporary working space is only created if a location for it is explicitly specified (environment variable TEMPLOCn or entries for TEMPORARY_LOCATION in the file DBnnn.INI); otherwise only some of the space in the Adabas buffer pool is used for storing the ISN lists.

Action

On mainframe systems, the DBA may increase the size of the Work data set and/or the number of saved ISN lists during an Adabas session may be decreased.

On open systems, provide enough temporary working space. For read-only databases, specify the location for the temporary working space explicitly or increase the size of the Adabas buffer pool (ADANUC parameter LBP).

Note:
The processing of ISN lists was changed for Adabas Version 5.1. If you get this error with an Adabas Version 3 database, please refer to the Adabas Version 3 documentation.


Response 74
Origin Mainframe and open systems
Explanation

No space was available on the Work data set for complex find commands.

Action

On open systems, increase the size of the Work data set.

On mainframe systems, increasing the size of the Work data set alone will not solve this problem. Instead, set the value of LWKP2 (WORK-PART-2) to a higher value than the calculated one (whatever that might be). Then increase the size of the Work data set to ensure there is sufficient space for WORK-PART-3.


Response 75
Origin Mainframe and open systems
Explanation

Attempts to allocate additional Associator or Data Storage extents for a file were issued, but the maximum number of extents that can be handled by the FCB have already been allocated.

On mainframe systems, BT (backout) or autorestart processing could cause the file to be locked because of inadequate extent space (see response code 48, ADARSP048).

On open systems, the last extent is allocated only for a command which is being backed out and for AUTORESTART and ADAREC REGENERATE. The first two bytes of the Additions 2 field contain the highest possible extent number (in binary format). The third and fourth bytes indicate where the overflow occurred. Possible values are: "DS" (Data Storage), "AC" (Address Converter), "NI" (Normal Index) and "UI" (Upper Index).

Action

On mainframe systems, ask your DBA for assistance; Associator or Data Storage extents may have to be reallocated.

On open systems, unload the file and reload it with appropriate initial allocations.


Response 76
Origin Mainframe and open systems
Explanation

An overflow occurred in an inverted list index (the maximum is 15 levels).

Action

Unload and reload the file with an appropriate padding factor for the Associator.


Response 77
Origin Mainframe and open systems
Explanation

Sufficient space was not available for a required Associator or Data Storage extent.

On mainframe systems, the following subcodes further define the error:

Subcode Meaning
1 FST empty.
2 AC START RABN not available.
3 AC END RABN not available.
4 FST will not fit into five ASSO blocks.
5 FST exhausted trying to allocate AC extent.
6 ASSO space allocation RABN not on device.
7 ASSO space on required device not available.
8 FROM RABN available, but contiguous space is not sufficient.
9 Data Storage space of the requested size is not available.
10 Data Storage space on the same device as the previous extent is not available.
11 FST is empty, or data storage for the current MAXRECL value is not available.
12 FST empty.

On open systems, the third and fourth bytes of the Additions 2 field contain either "AS" (Associator) or "DS" (Data Storage). You can also get the response 77 if you specified an explicit RABN for an Associator or Data Storage extent and the requested space is not available at the requested RABN. Please note that Adabas distinguishes between small (< 16KB) and large (>= 16KB) index blocks. This means that a response 77 can be returned even though there are enough free Associator blocks, but the free Associator blocks have the wrong size.

Action

On mainframe systems, ask your DBA for assistance; Associator or Data Storage extents may have to be reallocated.

On open systems, add a new Associator or Data Storage extent to the database using the ADADBM utility or specify a RABN where the requested space is available.

Note:
Response 77 can sometimes be prevented by enabling database autoexpand to execute in the online mode (specify the open systems nucleus parameter OPTIONS=AUTO_EXPAND).


Response 78
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

The cause of this response is indicated by one of the following subcodes:

Subcode Meaning
1 The AC file cannot be increased; only one file extent is permitted.
2 The file contains more than either 4 billion or 16 MB of ISNs, depending on the ISN length, or if ISNREUSE is in effect, the file has reached TOPISN and is very fragmented and too much effort would be needed to search for a free ISN.

Open Systems

An overflow occurred in the free space table (FST) as a result of Associator or Data Storage fragmentation, or the maximum number of DSST extents has already been allocated.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

If the file has reached the 16-MB limit, you might convert it to a file with the 4-byte ISN option or to an expanded file. If ISNREUSE is in effect, ADABAS ISNREUSE=ON, RESET can be used to reset the rotating ISN pointer or the file can be reloaded to eliminate the fragmentation.

If the file has NOACEXTENSION specified, look for alternatives to increase the file size such as adding an additional file to the expanded file chain. If the file is not part of an expanded file chain, you may want to reload the file to remove the restriction.

Open Systems

If it is an FST problem, reorder the database. If it is a DSST problem, which can only occur in the context of a utility, refer to the message DSSTALL for further information.


Response 79
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

A collation descriptor exit or hyperdescriptor exit error occurred. The following table describes the possible subcodes for this response code and their meanings:

Subcode Meaning
1 Either a collation descriptor exit (subcode CDXn where n is the one-byte binary collation descriptor exit number) or a hyperdescriptor exit ("hyperdescriptor exit") was not specified ADARUN.
5 The hyperdescriptor exit stub was called for an extended MU/PE file.
6 Improper use of the parameter list was detected by the Hyperdescriptor Exit Stub. The most likely reason is that a hyperdescriptor exit using the Adabas 8 parameter structures is linked to the Hyperdescriptor Exit Stub.
7 The Hyperdescriptor Exit Stub could not resolve the HEXOLD external reference.
8 Improper use of the parameter list was detected. The second word of the parameter list was modified.
9 A hyperdescriptor exit did not return an output parameter area address.
10 A hyperdescriptor exit rejected the call by setting a nonzero return code in the output parameter header.

Open Systems

A hyperdescriptor exit is not available to the nucleus. The following information is returned in the Additions 2 field of the control block:

  • The first two bytes contain the number of the hyperdescriptor exit,;

  • The third and fourth bytes contain the name of the hyperdescriptor.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

The following table describes the actions you should take for each possible subcode for this response code:

Subcode User Action
1 Reissue ADARUN with the CDXnn or HEXnn parameter. For more information about ADARUN parameters, read Adabas Initialization (ADARUN Statement), in Adabas Operations Manual; for more information about user exits and hyperdescriptor exits, read User Exits and Hyperdescriptor Exits, in Adabas User, Hyperdescriptor, and Collation Descriptor Exits Manual.
5 The Hyperdescriptor Exit Stub may not be used with extended MU/PE files. For more information about hyperdescriptor exits, read User Exits and Hyperdescriptor Exits, in Adabas User, Hyperdescriptor, and Collation Descriptor Exits Manual.
6,7 Investigate the Hyperdescriptor Exit Stub link job. For more information about hyperdescriptor exits, read User Exits and Hyperdescriptor Exits, in Adabas User, Hyperdescriptor, and Collation Descriptor Exits Manual.
8 A likely cause of the error is that a pre-Adabas 8 hyperdescriptor exit was called without a linked Hyperdescriptor Exit Stub. For more information about hyperdescriptor exits, read User Exits and Hyperdescriptor Exits, in Adabas User, Hyperdescriptor, and Collation Descriptor Exits Manual.
9 Hyperdescriptor exits must return an output parameter area address upon return. For more information about hyperdescriptor exits, read User Exits and Hyperdescriptor Exits, in Adabas User, Hyperdescriptor, and Collation Descriptor Exits Manual.
10 Investigate the hyperdescriptor exit to determine why the call was rejected.

Open Systems

Define the hyperdescriptor exit and restart the nucleus.


Response 81
Origin Mainframe systems only
Explanation

An MU or PE field error occurred, as described by the subcode:

Subcode Meaning
1 The PE index is greater than 191 (if the maximum number of PE field occurrences is 191).
2 The PE index is greater than 65534 (if the maximum number of PE field occurrences is 65534).
3 The MU index is greater than 65534 (if the maximum number of MU field occurrences is 65534).
4 The MU index is greater than 191 (if the maximum number of MU field occurrences is 191).
Action

Correct the MU or PE field problem and try again. If the problem persists, contact your Software AG technical support representative for assistance.


Response 82
Origin Mainframe systems only
Explanation

A hyperdescriptor exit routine returned an invalid ISN.

Action

Correct the hyperdescriptor exit routine logic and restart the nucleus.


Response 83
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

A hypertable overflow occurred.

Open Systems

A hyperdescriptor exit routine returned an invalid ISN.

The following information will be returned in the Additions 2 field of the control block:

  • The first two bytes contain the offset the invalid ISN in the specified ISN buffer in binary format;

  • The third and fourth bytes contain the name of the hyperdescriptor.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

Open Systems

Correct the hyperdescriptor exit routine and restart the nucleus.


Response 84
Origin Mainframe systems only
Explanation

Too many values were present for a subdescriptor or a superdescriptor.

Action

Reduce the number of subdescriptor or superdescriptor values and try again.


Response 85
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

Too many descriptor values were present for an update or add record command.

Open Systems

The descriptor value table space cannot be allocated from the buffer pool.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

Open Systems

Increase the size of the LBP parameter.


Response 86
Origin Mainframe and open systems
Explanation

A hyperdescriptor exit return error occurred for one of the following reasons:

  • An incorrect sign for a packed descriptor value was created.

  • A value with an incorrect length byte was returned.

  • The ISN was changed by an update command.

On open systems, the following information is returned in the Additions 2 field of the control block:

  • The first two bytes contain a value. This value can be:

    1 the hyperdescriptor pool exceeds the nucleus buffer pool
    2 the hyperdescriptor exit has returned an invalid pointer, length or count value
    3 an element in the user-defined format buffer is not a parent field of the hyperdescriptor
    4 - 255 Adabas response code
    >255 user-defined error return for hyperdescriptor exit routine
  • The third and fourth bytes contain the name of the hyperdescriptor or the name of the parent field.


Response 87
Origin Mainframe systems only
Explanation

The Adabas buffer pool is locked; it is too small to accommodate all blocks needed for (parallel) command execution.

Action

Check the length of the buffer pool (LBP) as follows:

Subcode User Action
1 Check the LBP value with DPARM.
2 Increase the ADARUN LBP parameter value.
3 Retry the operation. If the error recurs, call your Software AG support representative for assistance.

Response 88
Origin Mainframe and open systems
Explanation

This response code generally occurs when there is a workpool (LWP) shortage. Sufficient work pool space is not available or the sort work space is too small (even if only one user is active).

On mainframes systems, when this response code occurs, refer to the hexadecimal subcode that appears in the low-order (rightmost) two bytes of the ACB's Additions 2 field or in the ACBX's Error Subcode (ACBXERRC) field. This subcode describes what kind of operation encountered the error.

The following table describes the mainframe subcodes and provides recommended actions.

Subcode Operation Encountering the Workpool Shortage Action
1 Only active command is waiting for workpool space. Increase the ADARUN LWP setting and try again.
During session autorestart, insufficient workpool or user queue space was encountered. Increase ADARUN LWP and NU parameter settings and try again.
2 Only active command is waiting for workpool space. Increase the ADARUN LWP setting and try again.
3 A command waiting for workpool space was interrupted for transaction backout.
4 A1 command
5 E1 command
7 Superfield value generation
8 N1 command
9 OP command
10 Descriptor value generation
11 Hyperdescriptor value generation
12
13 Subdescriptor value generation
15 DTP=RM: A getmain error during Work-Part-4 initialization.
16 Hard-coupled file update processing encountered a workpool shortage.
17 A session autorestart encountered a workpool shortage.
22 Online reorder by descriptor
23 Online invert
24 Open one of the Work data sets in a cluster
25 Session autorestart in a cluster
79 Work pool shortage during release of advanced lock function.
80 Work pool shortage during insert (N1/N2-command) of spanned record
96 Internal command queue full
98 Cluster with DTP=RM: Recovery of distributed transactions encountered a workpool shortage.
99 ET command with P-option
Descriptor value generation for multi-client file
Single-user mode: Command initialization
Replication: Setup of initial-state process
DTP=RM: Insufficient user queue space during Work-part-4 initialization Increase the ADARUN NU setting and try again.
Action

For mainframe systems, review the actions described in the table above.

For open systems, verify the parameter values for the database that relate to the working storage allocation. Ask your DBA to increase the size of the LWP or LS parameter, as necessary.


Response 89
Origin Mainframe systems only
Explanation

The UQE was already in use, and an attempt was made to execute two commands at the same time for the same user.


Response 94
Origin Mainframe systems only
Explanation

An I/O error occurred on DDWORKR4.


Response 95
Origin Mainframe systems only
Explanation

An I/O error occurred on the Work LP area.


Response 96
Origin Mainframe systems only
Explanation

An error occurred during ADARES REPAIR utility execution.

Subcode Meaning
2 An I/O error occurred during nucleus termination; Additions 2 may contain RABN.

Response 97
Origin Mainframe systems only
Explanation

An I/O error occurred during buffer flush. Additions 2 may contain RABN.


Response 98
Origin Open systems only
Explanation

A uniqueness violation of a unique descriptor was detected during a store or update processing if subtransactions are not activated, or otherwise at end of a subtransaction. The third and fourth bytes of the Additions 2 field contain the name of the descriptor which caused the uniqueness conflict.

Action

Check the descriptor values.


Response 99
Origin Mainframe and open systems
Explanation

An I/O error occurred.

On open systems, the first 2 bytes of the Additions 2 field ( in binary format) contain the extent number. The third and fourth bytes contain the container type ("AS" for ASSO, or "DS" for DATA or "WO" for WORK).

Action

On open systems, check whether any disk devices have gone offline or check the error log for hardware errors.


Response 101
Origin Mainframe and open systems
Explanation

An error has occurred using one of the client-based Adabas add-on products such as Adabas System Coordinator or Adabas Fastpath.

Mainframe Systems

On mainframe systems, one of the following subcodes may also be included with this response code:

  • Subcodes of 20 or less are produced by Adabas Fastpath when an error occurs during the processing of an Adabas command..

  • Subcodes of 21 or greater are produced by Adabas System Coordinator.

Refer to the hexadecimal subcode that appears in the command's Adabas control block, Additions 2 field, low-order (rightmost) two bytes. The subcodes are described in the table below:

Subcode Meaning
2 L3/L9 direct optimization internal error. This is an Adabas Fastpath error. The hexadecimal representation for this subcode is "2".
6 L3 direction change error. This is an Adabas Fastpath error. The hexadecimal representation for this subcode is "6".
7 Direction change integrity check error.This is an Adabas Fastpath error. The hexadecimal representation for this subcode is "7".
8 Default response to internal service commands in the database. This is an Adabas Fastpath error. The hexadecimal representation for this subcode is "8".
9 Optional response for Read Ahead Update warning messages. This is an Adabas Fastpath error. The hexadecimal representation for this subcode is "9".
10 Error following a PLEX move. This is an Adabas Fastpath error. The hexadecimal representation for this subcode is "A".
21 Session cleanup error. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

22 You are using the CORS09 client component in a zIIP enabler for Natural environment and Natural zap NA97065 is not applied.

Action: Apply Natural zap NA97065.

23 Session create error. This is probably due to insufficient memory.

Action: Increase the job region size. If the problem persists, contact your Software AG technical support representative.

25 CAB: Allocation failed. Insufficient memory was available for CAB. This is an Adabas System Coordinator error.

Action: Increase the job region size.

Note:
This subcode is not subject to COR Debug.

26 Incorrect use of asynchronous Adabas calls.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

28 Internal thread concurrency error.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

29 Internal command error: Value buffer is not present.

Action: Contact your Software AG technical support representative.

30 Internal command error: Illegal function.

Action: Contact your Software AG technical support representative.

31 Error allocating the internal job-structure.

Action: Increase the job region size. If the problem persists, contact your Software AG technical support representative.

32 Internal command error: Insufficient record buffer.

Action: Contact your Software AG technical support representative.

33 Internal command error: Record buffer is not present.

Action: Contact your Software AG technical support representative.

34 Internal command error: Incorrect value buffer format.

Action: Contact your Software AG technical support representative.

35 Memory allocation failure. Insufficient memory was available for an internal area needed for NIM support. This is an Adabas System Coordinator error.

Action: Increase the job region size.

Note:
This subcode is not subject to COR Debug.

38 Internal command error: Unsupported memory function

Action: Contact your Software AG technical support representative.

43 Initialization Error. An error occurred during job initialization in Adabas System Coordinator.

Action: Ensure that correct runtime controls were defined for the job. If problem persists, contact Software AG Support.

46 CAS: No group header record. This error appears if Adabas System Coordinator fails to find a header record for the required System Coordinator group.

Action: First check that you have a valid CORCFG module pointing to the correct database and file number for your configuration file. Ensure that the load library containing CORCFG is included in the load library concatenation of the job. If CORCFG is present and correct, logon to SYSCOR and verify that you have valid Daemon Group parameters for the job you are running. If all parameters are correct, contact your Software AG technical support representative for assistance.

49 Internal eventing error: Illegal request.

Action: Contact your Software AG technical support representative.

50 Internal error processing add-on products.

Action: Contact your Software AG technical support representative.

53 This job is not defined to use the daemon.

Action: Review and correct the installation for this job.

54 Internal services error.

Action: Contact your Software AG technical support representative.

55 Latency processing error. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

56 Latency processing error. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

59 CORSnn: Critical products. One or more products have been defined as "Critical" in the Corrdinator configuration file, and one of the following errors was detected:
  • The Adabas System Coordinator Kernel module (CORKRN) was not found.

  • Adabas System Coordinator initialization has failed. There will be a Coordinator message indicating the cause of the initialization failure.

Action: Determine the cause of the concurrent command and modify the application to remove it.

Note:
This subcode is not subject to COR Debug.

60 CORKRN: Critical Products. One or more products have been defined as "Critical" in the Adabas System Coordinator configuration file, and the product has indicated a critical error during initialization.

Action: Determine the cause of the concurrent command and modify the application to remove it.

62 CORS02/CORS12: Subsystem storage protect facility not activated. Com-plete has been customised to operate with mixed thread keys, but the IBM subsystem Storage Protection override facility is not enabled. Adabas System Coordinator requires this facility to support mixed thread keys in Com-plete.

Action: Either activate the Subsystem Storage Protection override facility in this system OR change the Com-plete thread groups to operate in Com-plete's key only (see the description of the THREAD-GROUP parameter in the Com-plete documentation).

Note:
This subcode is not subject to COR Debug.

64 Net-Work Clustering: Node not member of Group. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

65 Net-Work Clustering: Message segment protocol error. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

66 Net-Work Clustering: Message sequence error. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

67 z/OS only: Invalid SVC is being used for the execution of an Adabas call.

Action: Review and correct the installation. If the problem persists, contact your Software AG technical support representative.

68 z/OS only: The batch Adabas System Coordinator client component (CORS01) is being incorrectly used for a Multi-TCB job.

Action: Refer to installation step "Add the System Coordinator to the Adabas Client" in the Installation Procedure section of the Adabas System Coordinator Installation documentation for information regarding the available CORS0n client components and their applicability to different job types.

If the problem persists, contact your Software AG technical support representative.

69 Insufficient memory to initialize runtime controls. There is insufficient memory for COR to initialize. This is an Adabas System Coordinator error.

Action: Increase the memory available to the job.

81 Internal UB Getmain error. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

82 Invalid session pointer. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

83 Internal session UB not found. This is an internal error.

Action: Contact your Software AG technical support representative.

84 Internal error in Adabas buffer analysis. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

85 Internal thread getmain error. This is an internal error in Adabas System Coordinator.

Action: Increase the job region size and rerun the job. If the problem persists, contact your Software AG technical support representative.

86 Invalid command block pointer. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

87 Client versioning has not been installed correctly.

Action: Check the job for any console messages and ensure that client versioning is installed correctly.

88 Adabas CICS link module and TRUE have not been installed correctly.

Action: Ensure that the Adabas CICS link module and TRUE are installed correctly. This must be done to enable Adabas System Coordinator to operate in a CICS job.

Note:
This subcode is not subject to COR Debug.

89 The NIM subtask is in the process of being detached.

Action: None, this subcode simply indicates that a NIM subtask was still issuing Adabas commands when it was terminated by the main NIM task.

Note:
This subcode is not subject to COR Debug.

90 Internal handshake token validation error.
91 Latency processing error (no facility). This is an internal error in Adabas System Coordinator. Action: Contact your Software AG technical support representative.

Action: Contact your Software AG technical support representative.

92 Asynchronous call with no CAB. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

93 Latency processing error (memory). This is an internal error in Adabas System Coordinator.

Action: Increase the job region size. If the problem persists, contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

94 Latency processing lock error. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

95 Daemon latency processing error. This is an internal error in Adabas System Coordinator.

Action: Ensure that the System Coordinator daemon is available.

If the client that receives this error is using the COLAT daemon latency disk file to manage their session-related information, then this subcode may be indicative that the disk file is full. If so, check the daemon job log for any accompanying error messages.

If the problem persists, contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

96 Latency processing error (facility deleted). This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

97 Latency processing lock error when using daemon latency.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

102 Latency processing unlock error. This is an internal error in Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

103 Latency processing error for IMS.

Action: Increase the size of the Daemon latency /pulse services shared memory area size in the COR daemon parameters.

Note:
This subcode is not subject to COR Debug.

200 When running Multi-system dynamic transaction routing (z/OS only), there was an error writing to the Coupling Facility Cache structure.

Action: Refer to the accompanying COR010S message in the daemon.

Note:
This subcode is not subject to COR Debug.

201 When running Multi-system dynamic transaction routing (z/OS only), there was an error reading from the Coupling Facility Cache structure.

Action: Refer to the accompanying COR009S message in the daemon.

Note:
This subcode is not subject to COR Debug.

202 When running Multi-system dynamic transaction routing (z/OS only), an incorrect record was read from the Coupling Facility Cache structure.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

203 When running Multi-system dynamic transaction routing (z/OS only), there was a memory shortage in the local daemon when attempting communications with a peer daemon.

Action: Increase the region size for the daemon. If the problem persists, contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

204 When running Multi-system dynamic transaction routing (z/OS only), there was a protocol error in the local daemon when attempting communications with a peer daemon.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

205 When running Multi-system dynamic transaction routing (z/OS only), a peer daemon returned an error when contacted by the local daemon.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

206 When running Multi-system dynamic transaction routing (z/OS only) and attempting to move a facility across the Sysplex, there was an internal problem identifying the correct facility.

Action: Contact your Software AG technical support representative. Note: This subcode is not subject to COR Debug.

Note:
This subcode is not subject to COR Debug.

207 When running Multi-system dynamic transaction routing (z/OS only) and attempting to move a facility across the Sysplex, there was a memory shortage in the local daemon.

Action: Increase the region size for the daemon. If the problem persists, contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

208 When running Multi-system dynamic transaction routing (z/OS only) and attempting to move a facility across the Sysplex, there was a protocol error in the local daemon when attempting communications with a peer daemon.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

209 When running Multi-system dynamic transaction routing (z/OS only) and attempting to move a facility across the Sysplex, a peer daemon returned an error.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

210 When running Multi-system dynamic transaction routing (z/OS only) and attempting to move a facility across the Sysplex, there was an internal error with the facility size.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

211 When running Multi-system dynamic transaction routing (z/OS only) and attempting to move a facility across the Sysplex, the facility could not be moved into daemon managed shared memory in the local daemon due to a lack of space.

Action: Refer to the daemon group member parameter Daemon latency/pulse services and increase the size of the dataspace. If the problem persists, contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

212 When running Multi-system dynamic transaction routing (z/OS only) and attempting to move a facility across the Sysplex, there was an internal error writing to daemon managed shared memory.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

213 When running Multi-system dynamic transaction routing (z/OS only) and attempting to move a facility across the Sysplex, there was a protocol error in the local daemon when attempting to remove the facility from a peer daemon.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

214 When running Multi-system dynamic transaction routing (z/OS only) and attempting to move a facility across the Sysplex, a peer daemon returned an error when instructed to remove a facility.

Action: Contact your Software AG technical support representative.

Note:
This subcode is not subject to COR Debug.

Open Systems

On open systems, one of the following Adabas System Coordinator subcodes may also be included with this response code:

Subcode Meaning
1 (0x0001) The standard Adabas or Entire Net-Work ADALNKX library could not be loaded.

Action: Check that the ADALNKX parameter in the Initialisation File (cor.cfg) is set correctly and that the library exists.

2 (0x0002) The standard Adabas or Entire Net-Work ADALNKX library could not be loaded.

Action: Contact your Software AG technical support representative.

3 (0x0003) The standard Adabas or Entire Net-Work ADALNKX library does not export all expected functions.

Action: Check that the ADALNKX parameter in the Initialisation File refers to an ADALNKX library and not an ADALNK or ADALNK32 library.

4 (0x0004) Adabas did not return the database architecture information in the ISN lower limit field when an OP command was issued to the Configuration File.

Action: Contact your Software AG technical support representative.

5 (0x0005) The path to the Initialisation File (cor.cfg) could not be determined.

Action: Check the HKLM\SOFTWARE\Software AG\Adabas System Coordinator registry key and ensure the Path value is set correctly (Windows).

Check that the $CORDIR and $CORVERS environment variables are set correctly (Unix).

6 (0x0006) The ADALNKX parameter could not be read from the Initialization File (cor.cfg).

Action: Check that the Initialization File exists and that the ADALNKX parameter is set correctly.

7 (0x0007) The LFILE parameter could not be read from the Initialization File.

Action: Check that the Initialization File (cor.cfg) exists and that the LFILE parameter is set correctly.

8 (0x0008) An incompatible version of an Adabas add-on product is installed.

Action: Contact your Software AG technical support representative.

9 (0x0009) An incompatible version of an Adabas add-on product is installed.

Action: Contact your Software AG technical support representative.

10 (0x000A) The library for an Adabas add-on product could not be loaded.

Action: Check that the Adabas add-on product is installed correctly.

11 (0x000B) The library for an Adabas add-on product could not be unloaded.

Action: Contact your Software AG technical support representative.

12 (0x000C) The address or length of the format, record, search, value or ISN buffer appears to be invalid.

Action: Check the buffer addresses passed to the adabas() function and the lengths specified for the buffers in the Adabas control block.

13 (0x000D) The CORADC load module could not be fetched (Mainframe).

Action: Check that $STEPLIB environment variable is correct and that the CORADC load module exists in the specified data set.

14 (0x000E) Port range exhausted (there are not enough allocated to this computer).

Action: Configure a larger port range for the Adabas System Coordinator Computer using System Management Hub.

15 (0x000F) Port conflict (the allocated port is in use by another application).

Action: Assign a different port to the Adabas System Coordinator daemon or change the port range for the Adabas System Coordinator computer using System Management Hub.

16 (0x0010) Computer name could not be generated.

Action: The Adabas System Coordinator Launch Control could not generate a unique computer name for the machine. Create an Adabas System Coordinator computer for this machine manually using System Management Hub.

17 (0x0011) The FDT of the Configuration File is not compatible with Adabas System Coordinator.

Action: Check that the database and file numbers are correct.

18 (0x0012) The version of Adabas is not compatible with Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

19 (0x0013) The SAGABS library could not be loaded.

Action: Check that the SAGABS library is installed.

20 (0x0014) The SAGABS library could not be unloaded.

Action: Contact your Software AG technical support representative.

21 (0x0015) The SAGABS library is not compatible with Adabas System Coordinator.

Action: Contact your Software AG technical support representative.

22 (0x0016) Port conflict (the allocated port is in use by another Adabas System Coordinator Group).

Action: Assign a different Group Services port to the Adabas System Coordinator Computer using System Management Hub.

23 (0x0017) Unable to spawn process (the command line parameters specified for the process are invalid).

Action: Contact your Software AG technical support representative.

24 (0x0018) Length of compressed record buffer length exceeds limit.

Action: Contact your Software AG technical support representative.

25 (0x0019) Length of compressed record buffer could not be determined.

Action: Contact your Software AG technical support representative.

26 (0x001A) Product not installed or not configured correctly.

Action: Check that the Adabas add-on product is installed correctly.

27 (0x001B) Configuration file version does not match the running version.

Action: Contact your Software AG technical support representative.

28 (0x001C) Configuration file layout is not as expected for a configuration file.

Action: Contact your Software AG technical support representative.

29 (0x001D) The installed Adabas version does not correctly process LF 'S' commands (Adabas 6.1.9 or earlier).

Action: Contact your Software AG technical support representative.

30 (0x001E) The installed Adabas version does not support LF 'I' commands (unzapped Adabas 8.2.2 or earlier).

Action: Contact your Software AG technical support representative.

31 (0x001F) Migration of the Configuration File was unsuccessful.

Action: Check the output of the migration process for erros. If the reason for an unsuccessful migration cannot be determined, contact your Software AG technical support representative.

52 (0x0034) Exception reading/writing pointer.

Action: Contact your Software AG technical support representative.

0000A001-FFFFA001 A TCP/IP error occurred.

Action: The left-hand side of the subcode contains the operating system error code.

0000A002-FFFFA002 A DNS error occurred.

Action: The left-hand side of the subcode contains the operating system error code.


Response 102
Origin Mainframe systems only
Explanation

Space calculation error.

Action

Retry the open operation.


Response 105
Origin Mainframe systems only
Explanation

An ADAECS error occurred. Please check for an accompanying ADAN7A message with further information.


Response 106
Origin Mainframe systems only
Explanation

The prefetch table record buffer specified in the UDB is too small.


Response 107
Origin Mainframe systems only
Explanation

Either a GETMAIN error occurred or there was insufficient space when performing prefetch. Prefetch is switched off.


Response 109
Origin Mainframe systems only
Explanation

The specified command ID is already active on another database for this user.


Response 110
Origin Mainframe systems only
Explanation

The command ID pool is full.

Action

Increase the size of either or both the ADARUN NQCID or NU parameters.


Response 113
Origin Mainframe and open systems
Explanation

The specified ISN was invalid for one of the following reasons:

  • An HI command was issued with ISN less than MINISN or with an ISN equal to zero (0).

  • An N2 command was issued with ISN equal to 0 or larger than the MAXISN in effect for the file.

  • An N2 command was issued and the specified ISN was assigned to another record in the file.

  • An A1, L1/L4, or S1/S2/S4 (with FB) command was issued for a nonexistent ISN, or an E1 command for a nonexistent ISN other than zero.

  • An L3/L6 command found an ISN in the index which did not exist in the address converter.

  • An N1/N2 command tried to access a file protected by security-by-value, but the command user is not authorized to access the file.

  • A read or update command tried to access a multiclient file's record using either a blank or incorrect-length owner ID, or an owner ID that does not apply to the record.

  • An RI command was issued for a record that has been updated earlier in the same transaction. The record cannot be released from hold status prior to transaction end. Subcode 5 is issued for this reason.

  • Subcode 19 is given when a base file record is not found in the address converter (AC). At the end of a LOB update in the LOBfile, the associated base file record no longer existed.

  • Subcode 249 is given only when Adabas Vista is in use. Refer to the Adabas Vista documentation for more information.

Open Systems

On open systems, the following subcodes may occur:

Subcode Meaning
249 (0x00F9)

An invalid ISN was detected by Adabas Vista (open systems). The ISN specified for an E1, HI or L1 command is not consistent with the definitions for the partitioned file.

Action: Review the program logic

Action

Correct the ISN problem and try again.


Response 114
Origin Mainframe and open systems
Explanation

A refresh file function using the E1 command was issued (E1 with ISN=0), and one of the following situations has occurred.

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

One of the following subcodes may be present:

Subcode Description
1 A file refresh is not permitted for the file because either
  • the file parameter setting is PGMREFRESH=NO (can be checked with ADAREP or via Adabas Online Services (AOS) Display File )

  • or the command ID field (ACBCID or ACBXCID) is not all blanks.

2 The user has not completed transactions to the file. Updates have been performed or records are still in hold, but the user has not issued an ET or BT command to commit or back out the updates.
3 Other users are accessing or updating the file. This is determined by the user access or update counts available internally to Adabas.
4 The file is a multiclient file and the user is not a superuser.

Open Systems

One of the following situations has occurred:

  • PGM_REFRESH is not specified for the file.

  • The user session is not at ET status.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

If you forgot to specify the ISN for the E1 command, the CID setting is incorrect, the command was not issued at ET status or the user is no superuser: correct your program accordingly.

If other users are accessing or updating the file STOP these users.

If PGMREFRESH=YES was not specified for the file in question, specify PGMREFRESH=YES for the file with ADADBS or Adabas Online Services (AOS) or load the file with the appropiate ADALOD parameter.

Open Systems

If you forgot to specify the ISN for the E1 command, or the command was not issued at ET status, correct your program. If PGM_REFRESH was not specified for the file in question, specify PGM_REFRESH for the file with ADADBM.


Response 123
Origin Mainframe systems only
Explanation

An error was reported by the Adabas cluster messaging service on the sender's side. The message was not sent. One of the following subcodes may be present:

Subcode Meaning
4 No valid destination(s)
8 Too many destinations
12 Invalid message type
16 Invalid environment
20 Send buffer length exceeded
24 Receive buffer length exceeded
28 No replies or acknowledgment(s) before the message timed out. For more information about the timeout value, refer to descriptions of the ADARUN MXMSG parameter.
32 Unable to allocate AXMCB
36 Timed out on originating system
40 Timed out on destination system
44 Canceled on destination system
48 Receive error on destination system
52 Unable to allocate buffer
56 Too many buffer elements
80 Messaging is inactive
96 Terminate member unsuccessful
128 Other Trans-port service error
Action

If you are unable to resolve the problem, contact your Software AG technical support representative.


Response 124
Origin Mainframe systems only
Explanation

An error was reported by the Adabas cluster messaging service on the receiver's side. The message was sent. One of the subcodes described for response code 123 (ADARSP123) may be present.

Action

If you are unable to resolve the problem, contact your Software AG technical support representative.


Response 125
Origin Mainframe systems only
Explanation

An internal error occurred when one cluster nucleus attempted to issue an internucleus command to one or more of the other cluster nuclei. This condition usually leads to abnormal termination.

Action

Contact your Software AG technical support representative.


Response 126
Origin Mainframe systems only
Explanation

A messaging error occurred during internucleus communication:

  • The nucleus did not respond within the allotted time (see the ADARUN MXMSG parameter); or

  • One or more problems occurred in what could be a broadcast; that is, a communication with multiple targets. In this case, each individual ACB contains either response code 0 (ADARSP000) or 123 (ADARSP123) or 124 (ADARSP124).

Action

If you are unable to resolve the problem, contact your Software AG technical support representative.


Response 129
Origin Mainframe systems only
Explanation

In an Adabas cluster environment, the user attempted to perform an Adabas function that is not yet supported by Adabas cluster nuclei.


Response 130
Origin Mainframe systems only
Explanation

An error identified by one of the following subcodes occurred in an Adabas cluster environment:

Subcode Description
1 A user table entry (UTE/PLXUSER) was not found in the MPM 8 call. This may indicate that a command was directed to an Adabas Cluster Services or Adabas Parallel Services nucleus ID (NUCID), not the DBID.
2 A user table entry (UTE/PLXUSER) was not found in the MPM 12 call.
9 The associated PLXUSER(UTE) was unsuitable at command initiation. One possibility is that the UQE of the user was deleted between the time the user's command was routed to one nucleus in the cluster and the time that nucleus selected the command for processing. Another possibility is that the PLXUSER and UQE UID string did not match because the PLXUSER may have been released and possibly reassigned to another user.
10 The associated PLXUSER(UTE) was unsuitable at command completion. The PLXUSER and UQE UID string did not match because the PLXUSER may have been released and possibly reassigned to another user.
11 No Work data set entry in active PPT block (bad PPT block).
12 Invalid internal NUCID (internal error).
13 Invalid external NUCID (bad PPT block, internal error).
14 Work data set already open for same internal NUCID, other external NUCID.
15 Work data set already open for same external NUCID, other internal NUCID.
16 Different Work data set already open for same peer nucleus.
17 Work data set of peer nucleus could not be opened.
18 I/O error when trying to read Work data set of peer nucleus.
19 Unexpected (invalid) data in Work data set of peer nucleus.
20 Mismatching DBID in Work data set.
21 Mismatching Adabas version indicator in Work data set.
22 Work data set written by non-cluster nucleus.
23 Partially written block in Work data set protection data extension area.
Action

For subcode 1, correct the application program attempting to issue commands using the NUCID. If that is not the case, or for other subcodes, contact your Software AG technical support representative for assistance.


Response 131
Origin Mainframe systems only
Explanation

In most cases this response code will be given to the user in the URBRRSP field of the URBR block with the subcode in the URBRSUB field. The subcode appears either in the low-order (rightmost) two bytes of the additions 2 field or in the URBRSUB field. It indicates the specific cause and action for this response code. The following are the subcodes and their meanings:

Subcode Meaning
1 The combination of URBD plus payload data does not fit in the output buffer.

Action: Change the subscription definition to make the record shorter.

2 The subscription user exit set a value in URBRERRC.

Action: Check the URBRERRC field and correct the error if appropriate.

3 There is insufficient space in the nucleus replication pool. In other words, the value specified by LRPL has been exceeded.

Action: Increase the LRPL size of the nucleus and try again.

4 There is insufficient space in the Event Replicator Server replication pool. In other words, the value specified by LRPL has been exceeded.

Action: Increase the size of the LRPL parameter and try again.

5 The subscription user exit modified data length (URBDLEND) to an invalid value.

Action: Check the subscription user exit.

6 The response destination (URBIRNAM) specified in a client request is undefined or not usable for sending the response.

Action: Correct the status request to specify the name of an existing destination definition.

7 Both the subscription (URBISNAM) and the destination (URBIDNAM) to be specified in a status request are missing. At least one of them must be specified.

Action: Correct the status request.

8 The subscription (URBISNAM) specified in a status request is undefined.

Action: Correct the status request.

9 The initial state name specified was not found.

Action: Correct the initial-state request.

10 The destination for response in URBI following URBI 1 is not equal to those of URBI 1.

Action: Correct the initial-state request.

11 The initial state name in URBI following URBI 1 is not equal to that of URBI 1.

Action: Correct the initial-state request.

12 The combination of DBID and file specified in the initial-state request is not found in the initial-state definition.

Action: Correct the initial-state request.

14 Not all combinations of DBID and file are specified in the initial-state request. A URBI must be sent for each DBID/file specified in the initial-state definition.

Action: Correct the initial-state request.

15 Field URBILEND is invalid.

Action: Correct the initial-state request.

16 The specified ISNLIST is invalid.

Action: Correct the initial-state request.

17 The initial-state process has been stopped by an operator request.

Action: No action is required.

18 Different request tokens have been specified in different URBI elements in the same message.

Action: Correct the initial-state request.

19 Selection data is not allowed for an initial-state definition for all records or for destination open/close client requests.

Action: Correct the initial-state or destination open/close client request.

20 Invalid input data for decompression was found during the subscription phase.

Action: Check the index of the replicated file.

22 The file/DBID supplied for the initial-state process is deactivated for replication.

Action: Check the cause of deactivation and repeat the request after reactivation.

23 Invalid UES parameter in URBI . URBIARC, URBIACOD, and URBIWCOD must contain invalid values and must not be all blanks.

Action: Verify that the URBIARC, URBIACOD, and URBIWCOD elements are not all blanks.

24 Invalid UES parameter in URBI.

URBIARC, URBIACOD and URBIWCOD must be zero for input requests where encoding and architecture is not evaluated -- that is, for status requests, destination open/close requests, "initial state all records" or "initial state ISN list" requests.

Action: The URBIARC, URBIACOD, and URBIWCOD elements must be zeros for "initial state all records" requests, "initial state ISN list" requests, status requests, or destination open/close requests. Verify that this is the case.

25 The unused URBIRES1 and URBIRES2 fields must contain binary zeros for all requests.

Action: Verify that these fields contain binary zeros.

26 The destination (URBIDNAM) specified in a client request is either undefined or not usable for sending the response.

Action: Correct the client request.

27 No active destinations for status request.

Action: No action is required.

28 An initial-state request was issued to an Event Replicator Server address space that was terminating as a result of an ADAEND or HALT command. An initial-state request may only be issued when the Event Replicator Server is active.

Action: Reissue the initial-state request when the Event Replicator Server has been restarted.

30 Unknown response destination name in URBIRNAM for a prior-transaction request.

Action: Correct the prior-transaction request.

31 Unknown destination name in URBIDNAM for a prior-transaction request.

Action: Correct the prior-transaction request.

32 Unknown or omitted subscription name in URBISNAM for a prior-transaction request.

Action: Correct the prior-transaction request.

33 Destination in URBIDNAM is not related to subscription in URBISNAM for a prior-transaction request.

Action: Correct the prior-transaction request.

34 Subscription in URBISNAM has no resend buffer defined for a prior-transaction request.

Action: Correct the prior-transaction request.

35 Transaction in URBITSNR for subscription in URBISNAM was not found in the resend buffer. The transaction may have been overwritten in the circular resend buffer.

Action: Check the source of the transaction number.

36 The subscription in URBISNAM is not active.

Action: No action is required.

37 An invalid transaction was found in the resend buffer. This is an internal error.

Action: Notify your Software AG technical support representative.

38 There are no active destinations for a prior-transaction request.

Action: No action is required.

39 URBILEND must be zero for prior-transaction requests.

Action: Correct the prior-transaction request.

40 URBIDBID and URBIFNR may not be specified for this type of client request.

Action: Correct the client request.

41 URBIINAM may not be specified for prior-transaction requests.

Action: Correct the prior-transaction request.

42 UES parameters URBIARC, URBIACOD and URBIWCOD may not be specified for prior-transaction requests.

Action: Correct the prior-transaction request.

43 Reserved fields URBIRES1 and URBIRES2 must be zero for prior-transaction requests.

Action: Correct the prior-transaction request.

44 Number of active concurrent initial-state requests exceeded IMAXREQ.

Action: Increase the IMAXREQ setting or reduce the number of active concurrent initial-state requests.

45 Input request URBH eyecatcher is invalid.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

46 Input request URBHLEN is invalid.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

47 Input request URBHBORD is invalid.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

48 Input request URBHVERS is invalid.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

49 Input request message truncated.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

50 Input request URBHLENT is invalid.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

51 Input request URBILENH is invalid.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

52 Input request URBILEND is invalid.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

53 Input request URBILEN is invalid.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

54 Input request reserved area is not zero.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

55 Input request more than one status received.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

56 Input request invalid URBI request received.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

57 Input request different interleaved requests received.

Action: Verify that you are submitting only one kind of request to the Event Replicator Server. Only one type can be submitted at a time (for example, you cannot request initial-state processing and transaction status information requests in the same message).

Correct the input information and try again. For more information, read Event Replicator Client Requests in Event Replicator for Adabas Application Programmer's Reference .

58 Invalid destination for response.

Action: Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference .

59 A replay request was issued for a database not defined to the Event Replicator Server.

Action: Correct the DBID in the replay request or define the database to the Event Replicator Server.

60 Invalid replay token. The replay token is not defined or is outdated.

Action: Specify a valid replay token.

61 Invalid request sent to Event Replicator Server. RBL is insufficient, no FB provided on Init handshake or other such errors.

Action: Notify your Software AG technical support representative.

62 After an Adabas failure and session autorestart, replication data was recovered for which a matching FDT was no longer available. The FDT had been changed or deleted by a utility operation. Adabas suppressed the record images of the replicated records, because without a matching FDT, the Event Replicator Server could not process them.

Action: Use application-specific means to bring the replicated data in sync again, if necessary.

63 The file specified in a C5 command with R-option is not replicated.

Action: Specify the file number of a replicated file.

64 The filter defines a comparison between two field types for which a comparison is invalid.

Action: Correct the filter definition.

65 The filter refers to a field that is not defined in the internal format buffer.

Action: Correct the filter definition or define the field in the database.

66 The filter defines a comparison against a field that is not selectable as it has no type (for example, a superdescriptor).

Action: Correct the filter definition.

67 The filter uses values in an FLIST specification that are invalid or out of range.

Action: Correct the filter definition.

69 Replay for same DBID/FNR already running.
71 Date/time format or value incorrect for replay.

Action: Check the syntax of the specified date and time values. Do not specify future date and time values.

72 Incorrect replay parameters.

Action: Check and correct the specified replay parameters.

73 A subscription involved in the replay was inactive at the beginning of replay processing or was deactivated while the replay was running.

Action: Reactivate the deactivated subscription and rerun the replay process for the subscription.

74 A destination involved in the replay was inactive at the beginning of replay processing or was deactivated while the replay was running.

Action: Reactivate the deactivated destination and rerun the replay process for the destination.

75 A replay destination that was defined without SLOG was closed at the beginning of replay processing or while the replay was running.

Action: Reopen the closed destination and rerun the replay process for the destination.

76 ADARPL terminated abnormally.

Action: Investigate the cause of the error, correct it, and run a new replay job.

77 Invalid replay status transition. Events that change the status of a replay process occurred in an unexpected order.

Action: Notify your Software AG technical support representative.

78 New transactions from Adabas could not be kept on hold during a replay in synchronized mode.

Action: Run a new replay process involving the same subscriptions and destinations as the previous replay process to recover the replication data that Adabas produced while the first replay was running.

79 A replay process was canceled by a user (RPLCLEANUP operator command).

Action: If appropriate, run another replay job with corrected parameters.

80 A timeout occurred while the Event Replicator Server was waiting for the end of a synchronization process after reactivating replication for a file in Adabas. The synchronization process ends when all transactions have finished that had updated the file before it was reactivated.

Action: Wait until the Event Replicator Server reports the activation of the file (ADAF2L message). Then run a new replay job.

81 A utility other than ADARPL specified a replay token when connecting to the Event Replicator Server.

Action: Notify your Software AG technical support representative.

82 The Event Replicator Server is not connected to Adabas at the start of a replay process with the TOKEN parameter.

Action: Start Adabas and let it connect to the Event Replicator Server. When running a replay with the TOKEN parameter, Adabas must be active.

83 Neither a subscription nor a destination was specified in a replay request.

Action: Specify at least one subscription or destination.

84 A replay in replay-only mode was requested, but replication data from Adabas would flow through an active subscription-destination pair involved in the replay. For a replay in replay-only mode, some subscriptions and destinations must be inactive such that no data from Adabas can flow through the same subscription-destination pairs as the replay data from ADARPL.

Action: Change the replay parameters or the activation status of the subscriptions or destinations involved in the replay.

85 A file involved in the replay was inactive at the beginning of the replay or deactivated while the replay was running.

Action: Reactivate the deactivated file and rerun the replay process for the subscriptions involved in the replay that get data from the file.

86 Invalid format buffer was specified for destination-type Adabas update commands.

Action: Correct the format buffer.

87 An unexpected message sequence number was encountered.

Action: Contact your Software AG support representative.

88 An unrecognized eye-catcher was encountered in control block following the URBH.

Action: Contact your Software AG support representative.

89 The same subscription name was specified more than once for an Adabas automated replay (defined using the Adabas Event Replicator Subsystem).

Action: Verify that a subscription is specified only once in an automated replay, and try again.

90 The same destination name was specified more than once for an Adabas automated replay (defined using the Adabas Event Replicator Subsystem).

Action: Verify that a destination is specified only once in an automated replay, and try again.

91 The replay start date and time were not supplied for an automated replay (defined using the Adabas Event Replicator Subsystem) or for multiple destination open/close client requests.

Action: Verify that a destination is specified only once in an automated replay or in multiple destination open/close client requests and try again.

92 The timeout parameter specified for an automated replay was too high.

Action: Reduce the timeout parameter value and try again.

93 PLOG information was not recorded in the Event Replicator Server system file.

Action: Contact your Software AG support representative.

94 The AI/BI format buffer was used also for the key. An attempt was made to decompress a key value, but the related format buffer is for data storage and not for a key.

Action: Contact your Software AG support representative.

95 An attempt to set user/Event Replicator Server encoding 01-RPEQU * failed. This might occur if you are using enhanced filtering logic and UES SACODE/SWCODE/SARC values are set for a subscription.

Action: Contact your Software AG support representative.

96 The Adabas nucleus that was the target of an initial-state request returned response code 148 (ADARSP148), indicating it is not available.

Action: Start the targeted Adabas nucleus and retry the initial-state request.

97 A format buffer was specified which contains a LOB field, which is not supported.

Action: Correct the format buffer.

99 The subscription name (URBISNAM) specified in the destination open/close client request contains a value other than spaces.

Action: Correct the destination open/close client request by setting this field to spaces.

100 The transaction sequence number (URBITSNR) specified in a destination open/close client request contains a value other than binary zeroes.

Action: Correct the destination open/close client request by setting this field to binary zeroes.

101 The destination open/close request failed on some tasks.

Action: Investigate the cause of the error.

102 The destination open/close request failed.

Action: Investigate the cause of the error.

103 The destination open/close request was not performed because the destination's status was already in the state being requested. In other words, the destination was already opened or closed.

Action: No action is required.

104 Begin byte in field filter is longer than the field length.

Action: Adjust the specifications for the beginning byte or length and try again.

105 Begin byte plus the portion length in the field filter is longer than the field length.

Action: Adust the specifications for the beginning byte or the portion length and try again.

106 Begin byte or length not supported for field with format U, P, F, G, or W.

Action: Specifying a beginning byte or length is only supported for alphanumeric and binary fields. Change the field on which you are working or abandon this attempt.

107 Length value invalid for field.

Action: Adjust the length specification and try again.

108 Input request URBI eyecatcher is invalid.

Action:Correct the input information and try again. For more information, read Event Replicator Client Requests in the Event Replicator for Adabas Application Programmer's Reference.

109 An Adabas security (ADASCR) function has been invalidly replicated to a subscription file defined with SFSECURITYFILE=NO.

Action: Ensure the subscription file definition used for the security file is defined with SFSECURITYFILE=YES.

110 An invalid Adabas security (ADASCR) pseudo transaction has been replicated to the Event Replicator Server.

Action: Contact your Software AG technical support representative for assistance.

111 A replicated record (e.g., delete, insert, refresh, or update) has been invalidly replicated to a subscription file defined with SFSECURITYFILE=YES.

Action: Ensure that the subscription file definitions for a file, other than a security file, is defined with SFSECURITYFILE=NO.

118 Replay-Only Replay is not allowed if one or more destinations involved are closed.

Action: Ensure that the destination(s) selected for replay-only mode replay processing are not closed.

Action

Perform the action provided for the appropriate subcode in the subcode table.


Response 132
Origin Mainframe and open system
Explanation

The exact meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

This response code indicates that an error occurred while Adabas was reading or updating a LOB file. The subcode indicates the kind of error.

If the subcode is less than 256, it is the same as the original response code that occurred during LOB file processing. The most likely subcodes are listed in the table below. For subcodes not listed, see the description of the Adabas response code with the same value.

If the subcode is greater than 256, it signals an error condition unique to the processing of LOB files. These subcodes are listed in the table below.

Subcode Description
8 A LOB file operation was aborted due to a pending backout of the user's command or transaction. One reason for this backout may be that the user's transaction occupied too much space on the protection area on the Work data set (see response code 9 (ADARSP009), subcode 15).
17 The LOB file is not loaded.
48 The LOB file is locked for exclusive read or update by another user.
65 An internal error in the work pool space calculation occurred for LOB file processing.
113 A LOB file segment record was not found in the Address Converter element referred to by the LOB file index. Either the LOB file is physically inconsistent or an illegal concurrent LOB file update occurred during the LOB file read operation.
145 An attempt failed to put a LOB file segment record on hold for a user, because it was already held by another user. This subcode indicates illegal update contention for the same large object field value. The base file-LOB file pair is possibly inconsistent.
165 The LOB file descriptor is not found in the index; The LOB file index is bad.
172 An ISN in the LOB file index is bad. The LOB file may be physically inconsistent.
175 The descriptor value in a LOB file segment record differs from the descriptor value in the LOB file index. Either the LOB file is physically inconsistent or an illegal concurrent LOB file update occurred during the LOB file read operation.
177 A LOB file segment record was not found in the Data Storage block referred to by the Address Converter. Either the LOB file is physically inconsistent or an illegal concurrent LOB file update occurred during the LOB read operation.
257 An error in the base file-LOB file linkage exists; a file with LB fields is not really the base file of the LOB group.
258 An error in the base file-LOB file linkage exists; the file linked to the base file of a LOB group is not really a LOB file.
259 An error in the base file-LOB file linkage exists; the LOB file linked to a base file of a LOB group refers back to a different base file (or none at all).
260 An error in the base file-LOB file linkage exists; either no LOB file was linked to a base file or the LOB file number is invalid.
261 The LOB file has been left in an inconsistent state by an aborted utility execution.
262 An LB field length element specification error occurred in the format buffer ('xxL,4,B' was expected).
263 An invalid LOB file segment descriptor was encountered. The set of LOB file segment records associated with one LB field value is inconsistent. Either the LOB file is bad or an illegal concurrent LOB file update occurred during the LOB file read operation.
264 An invalid LOB file segment record was encountered. The contents of a LOB file record are inconsistent. The LOB file is bad.
265 The length of an LB field value in the LOB file differs from the length stored in the associated base file record. Either the base file and the LOB file are out-of-sync or an illegal concurrent LOB file update occurred during the LOB file read operation.
266 A bad LB field value reference was encountered in a base file record. The base file is bad.
267 An LB field value referred to in a base file record is not present in the LOB file. Probably, the base file and the LOB file are out-of-sync.
268 Internal LOB update error. At the end of a LOB update in the LOB file, the LOB value reference or placeholder was not found in the associated base file record where it was expected. Possibly, the base file record was changed in parallel.
270 Internal LOB update error. At the end of a LOB update in the LOB file, the base record was not in exclusive hold status anymore.
297 A planned feature for large object (LB) fields (for example, character code conversion of LB field values) is not yet supported.
298 Too many (more than 32,767) LB field occurrences were specified in the format buffer.
299 An internal error occurred due to LOB file processing.

Open Systems

LOB data processing may fail because of concurrent updates. If a new attempt to process the LOB data also fails, this response code is returned. The subcode (field ACBXERRC in the ACBX) provides more information:

Subcode Description
297 A planned feature for large object (LB) fields (for example, character code conversion of LB field values) is not yet supported.
300 The referential integrity and uniqueness checks done by subtransactions are currently not compatible with commands that modify LOB values.
Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

Resolve the problem described in the subcode list in the explanation.

Open Systems

If one of the subcodes above occurs, you must change the program that is making the Adabas calls.

If the subcode (field ACBXERRC in the ACBX) is not one of the subcodes mentioned above, and if the response code 132 is reproducible even though the accessed LOB fields are not being updated, contact your Software AG technical support representative.


Response 133
Origin Mainframe systems only
Explanation

An error was detected when an attempt was made to replicate a compressed record. The subcode identifies the kind of error.

Subcode Description
1 The function is not permitted for this type of file. The file is a LOB-file.
2 The compressed input record length is invalid .
11 The record structure is invalid.
12 An invalid elementary empty field was encountered. The structure does not agree with the FDT definition.
13 An invalid multiple-field count was encountered.
14 An invalid periodic group count was encountered.
15 An invalid structure of an elementary field was encountered.
65 A space calculation error occurred.

Response 134
Origin Mainframe systems only
Explanation

An error was detected when creating system fields. The subcode identifies the kind of error.

Subcode Description
1 An invalid update parameter was encountered (logic error).
2 The field is not a system field.
4 The file does not support a setting of MUPEX=2 (number of MU occurrences greater than 191.

Response 136
Origin Mainframe systems only
Explanation

This response code is used for communication with Adabas utilities and Adabas Audit Administration (SYSALAA) or Adabas Online System (AOS). The system returns this error because the requested function could not be performed on the Adabas system and its files, or because an error occurred in a SYSALAA/AOS or utility function.

Action

For SYSALAA/AOS, a subcode is displayed in the error message or a descriptive message indicates the error that occurred. For utility functions, the subcodes may be described within the message text or a descriptive message indicates the error that occurred. If you do not understand the action to take, note the subcode and the function that caused the response code and call your Software AG technical support representative for assistance.


Response 144
Origin Mainframe and open systems
Explanation

One of the following occurred:

  • The ISN specified with an update (A1) command was not in hold status for the user and command option H was not specified.

  • An ET or BT command specifying the M (multifetch) option specified an ISN in the ISN buffer that is not in hold status for the user. All currently held ISNs are released from hold status.

    In this case on open systems, the first 2 bytes of the Additions 2 field (in binary format) contain the offset of that ISN in the ISN buffer.

Action

Put the ISN in hold status before using the A1 command or the multifetch ET or BT commands.

If Adabas Transaction Manager is in use, verify that the setting for the Transaction Model parameter is appropriate for the program that was executing and is also appropriate for the runtime environment in use.


Response 145
Origin Mainframe and open system
Explanation

The exact meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

On mainframe systems, one of the following situations occurred:

  • An N1/N2 command was issued, but no hold queue entry was available.

  • A command was issued with the return option specified that attempted to hold an ISN already in the hold queue for another user. The command is not placed in wait status.

Use the subcode associated with this response code to further clarify why this response occurred.

Subcode Meaning
0 N2 command for an existing ISN was issued.
1 Hold queue space problem detected. The user is the only active user and is running with the -R option.
2 The ISN was held by someone else. The read request is running with the -R option.
8 The hold status of a record could not be upgraded from shared to exclusive because another user was already waiting to do the same. The two users became deadlocked.
9 Two or more users became deadlocked while holding ISNs and attempting to put more ISNs in hold status.

Open Systems

On open systems, one of the following situations occurred:

  • An attempt was made to insert a record using an N2 command with an ISN that is in hold status.

  • An attempt was made to hold an ISN which was in hold status for another user and the R option is specified. In this case, the Additions 2 field contains the binary value 0;

  • Hold queue overflow. In this case, the Additions 2 field contains a value not equal to 0.

    Note:
    This hold queue overflow error can only occur with Adabas versions < 5.1.


Response 146
Origin Mainframe and open systems
Explanation

The exact meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

An invalid buffer length was detected by the Adabas interface routine. If the command uses a classic ACB, the buffer is larger than 32,767. If the command uses an ACBX, the buffer is greater than 2,147,483,647, or the send length in the ABD is greater than the buffer length. The subcode identifies the buffer type:

Subcode Buffer Type
1 Format buffer
2 Record buffer
3 Search buffer
4 Value buffer
5 ISN buffer
6 User information buffer
7 Performance buffer
8 Multifetch buffer

Open Systems

An invalid buffer length was detected by the Adabas interface routine, in an MC call, or one of the following errors occurred for a multifetch command:

  • the buffer header was invalid (both offsets are set)

  • at least one ISN buffer offset was not divisible by 4

  • the start offset was outside the multicall buffer range

  • the record buffer was not large enough to contain all subcommand control blocks.

The value in the Additions 2 field identifies the buffer: the first 2 bytes contain the buffer number in binary format, the last two bytes contain the buffer name, as shown in the following table:

                  Bytes 1-2        Bytes 3-4
                     1             FB (format buffer)
                     2             RB (record buffer)
                     3             SB (search buffer)
                     4             VB (value buffer)
                     5             IB (ISN buffer)
Action

Correct the buffer length and try again.


Response 147
Origin Mainframe and open systems
Explanation

The exact meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

The ISN was invalid. The ISN transformation resulted in a negative ISN or an ISN greater than the maximum ISN permitted for the file.

Open Systems

A user buffer is not accessible by the Adabas interface routine.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

Open Systems

Check whether the control block, format buffer, value buffer, record buffer and ISN buffer have valid addresses and lengths. Check whether the control block, ISN buffer and record buffer are write-protected.


Response 148
Origin Mainframe and open systems
Explanation

The Adabas nucleus was either not active or not accessible (a call could not be sent to the Adabas nucleus when the command was issued). In an ACB, refer to the hexadecimal subcode that appears in the low-order (rightmost) two bytes of the Additions 2 field; in an ACBX, refer to the binary subcode that appears in the Error Subcode (ACBXERRC) field.

Note:
If you are running with Entire Net-Work, the leftmost two bytes of the Additions 2 field (in the ACB) or the ACBXERRC field (in the ACBX) may contain the ID of the Entire Net-Work node that issued this response code.

The following are the decimal equivalents of the subcodes and their meanings:

Subcode Occurrence Location Description Action
0 open systems No active database server was found, either local or remote. Start the nucleus and reissue the command.
1 mainframe systems Exclusive database control requirement conflicts with read-only nucleus status. Remove the READONLY=YES parameter setting for the nucleus and restart it.
2 mainframe systems A nonprivileged call was made to the nucleus while it was in utility-only (UTI) mode. Remove the UTIONLY=YES parameter setting for the nucleus and restart it.
3 mainframe and open systems The nucleus is performing shutdown processing (an ADAEND operation) and will not accept new users or new transactions. Either a new user is attempting to begin operation or an existing user in ET status is trying to continue operation. Wait for the nucleus to shut down, restart it, and reissue the command.
4 mainframe systems A utility with exclusive database control is running. Either stop the utility or wait for its processing to complete (this is preferred) and try again.
5 mainframe systems A single-user nucleus could not start operation due to an error that could not be corrected. Verify that single-user mode has been set up correctly and restart the nucleus.
8 mainframe systems A user is performing a logical ADALNK call. The IDT for the call has not been allocated. On BS2000 systems, check the setting of the parameter accessed by the link name DDLNKPAR or DDCARD, or in the macro B2CONFIG of the module SSFB2C. Also check the IDTNAME parameter of the database to be accessed.
21 open systems Entire Net-Work access communication has failed. The first two bytes of the Additions 2 field contain an error number. Refer to your Entire Net-Work documentation for further information.
22 open systems There is a problem with the Adabas IPC (Interprocess communication) driver. The first two bytes of the Additions 2 field contain an error number. Shut down the nucleus, if it is still active, and restart it. If the error still occurs, try issuing the command showipc -kd <dbid>, then restart the nucleus and reissue the command.
23 Adabas open systems version 3.1 only There is a problem attaching the Adabas IPC (Interprocess communication) driver's shared memory Shut down the nucleus, if it is still active, and restart it. If the error still occurs, try issuing the command showipc -kd <dbid>, then restart the nucleus and reissue the command.
24 open systems The ADALNK shared library cannot be loaded correctly. Check the locations and permissions of the ADALNK shared library.
26 open systems An IPC (Interprocess communication) problem occurred during open processing, e.g. the shared memory could not be attached. One reason for these messages may be that someone has deleted an IPC resource. If this is the case, shut down the nucleus, if it is still active, and restart it. If the error still occurs, try issuing the command showipc -kd <dbid>, then restart the nucleus and reissue the command.

Another reason these messages may occur may be that the IPC resources are not sufficient. In this case, increase the IPC resources, or decrease the values of some nucleus parameters on which the required amount of IPC resources depends., or stop some other process that also consumes IPC resources. For more information about IPC resources, refer to the section Increasing System V IPC Resources in the Adabas open systems installation documentation.

27 open systems An IPC (Interprocess communication) problem occurred during a read in the message queue.
28 open systems An IPC (Interprocess communication) problem occurred during a write in the message queue.
29 UNIX platforms only IPC (Interprocess communication) resources exist, but the database server was not active. Issue the command showipc -kd <dbid>, restart the nucleus, and reissue the command.
50 mainframe systems At command completion RSP148 was set but without a subcode. This subcode is set to indicate the command was processed by the target. This often occurs in a Cluster or Parallel Services environment when one of the targets is no longer active. Contact your Software AG support representative for assistance.
51 mainframe systems The command router found no suitable target. The target was determined not to be an Adabas Cluster Services or Adabas Parallel Services database. Contact your Software AG support representative for assistance.
52 mainframe systems The command router found no suitable target. The target was determined to be an Adabas Cluster Services or Adabas Parallel Services database. Contact your Software AG support representative for assistance.
53 mainframe systems The command router found a suitable target but the target became inactive while queuing the command. Contact your Software AG support representative for assistance.
54 mainframe systems When the caller attempted to retrieve the results of a completed command the target was no longer active. Contact your Software AG support representative for assistance.
55 mainframe systems The target became inactive while the caller was attempting to retrieve the results of a completed command. Contact your Software AG support representative for assistance.
58 mainframe systems An error occurred while POSTing the Adabas nucleus ECB after queuing a command. This may be seen if the nucleus is terminating. Otherwise contact your Software AG support representative for assistance.
59 mainframe systems This subcode is set as a default in the first stage of command routing. Contact your Software AG support representative for assistance.
61 mainframe systems A command sent from a nucleus to another nucleus caused an ABEND while the caller was attempting to initiate the command. The target may have become inactive. The ABEND was intercepted and recovered. This may be seen if the target nucleus is terminating. Otherwise contact your Software AG support representative for assistance.
64 mainframe systems A command sent from a nucleus to another nucleus caused an ABEND while the caller was attempting to retrieve the results of a completed command. The target may have become inactive. The ABEND was recovered by ADAMPM. This may be seen if the target nucleus is terminating. Otherwise contact your Software AG support representative for assistance.
101/201 mainframe systems Set in SVCCLU when a specifically designated local nucleus is not available for a physical call. The 201 subcode appears when this subcode is set on a remote node. Contact your Software AG support representative for assistance.
102/202 mainframe systems Set in SVCCLU when a specifically designated remote nucleus is not available for a physical call. The 202 subcode appears when this subcode is set on a remote node. Contact your Software AG support representative for assistance.
103/203 mainframe systems Target ID disagreement between IDTE and PLXNUC. The 203 subcode appears when this subcode is set on a remote node. Contact your Software AG support representative for assistance.
104/204 mainframe systems Unable to find PLXMAP matching an existing PLXUSER. The 204 subcode appears when this subcode is set on a remote node. Contact your Software AG support representative for assistance.
105/205 mainframe systems Entire Net-Work unavailable, cannot route existing user to remote nucleus. The 205 subcode appears when this subcode is set on a remote node. Contact your Software AG support representative for assistance.
106/206 mainframe systems Entire Net-Work unavailable, cannot route new user to remote nucleus. The 206 subcode appears when this subcode is set on a remote node. Contact your Software AG support representative for assistance.
107/207 mainframe systems No nucleus available for remote user. The 207 subcode appears when this subcode is set on a remote node. Contact your Software AG support representative for assistance.
108/208 mainframe systems Incorrect PLXMAP update received by LOCAL=YES nucleus. The 208 subcode appears when this subcode is set on a remote node. Contact your Software AG support representative for assistance.
109/209 mainframe systems An internal command used to synchronize across multiple nodes was received for an Adabas Parallel Services database. Such databases may execute on only one node. Depending on intersystem communications timing this may occur as a database is changed from Adabas Cluster Services to Adabas Parallel Services. Otherwise this is a logic error. Contact your Software AG support representative for assistance.
110/210 mainframe systems Unable to assign specified nucleus to remote user. The physical command arrived via Entire Net-Work for a specific nucleus, but the specified nucleus is on another system. Only one Entire Net-Work transmission is allowed. The 210 subcode appears when this subcode is set on a remote node. Contact your Software AG support representative for assistance.
1019 open systems No active database found. Contact your Software AG support representative for assistance.
1020 open systems The Entire Net-Work relay failed. Contact your Software AG support representative for assistance.
1021 open systems EC: Not XTS directory information available. Contact your Software AG support representative for assistance.
1022 open systems No context found. Contact your Software AG support representative for assistance.
1023 open systems No local database found. Contact your Software AG support representative for assistance.
1024 open systems Invalid context found. Contact your Software AG support representative for assistance.
1025 open systems General logic error; no XTS found. Contact your Software AG support representative for assistance.
1026 open systems A server shutdown occurred. Contact your Software AG support representative for assistance.
1027 open systems A server overload occurred. Contact your Software AG support representative for assistance.
1028 open systems The server rejected a call. Contact your Software AG support representative for assistance.
1029 open systems No such DBID. Contact your Software AG support representative for assistance.
1030 open systems The database is inactive. Contact your Software AG support representative for assistance.
1031 open systems No response. Contact your Software AG support representative for assistance.
1032 open systems An invalid protocol was found. Contact your Software AG support representative for assistance.
1033 open systems An unknown response occurred. Contact your Software AG support representative for assistance.
1034 open systems Remote communication is not allowed. Contact your Software AG support representative for assistance.
Action

Review the user actions provided in the explanation above.


Response 149
Origin Open systems only
Explanation

A communication error was detected. The Additions 2 field contains the system service completion code which caused the error response.

Subcode Description
1035 Context allocation failed.
1036 Inconsistent architecture encountered.
1037 XTS error 149/224 occurred.
Action

Contact your Software AG technical support representative for assistance.


Response 150
Origin Open systems only
Explanation

Too many database nuclei have been used in parallel. The Additions 2 field contains the maximum number of nuclei allowed in parallel.

Action

Do not use more database IDs in a single program than the value given in the Additions 2 field.


Response 151
Origin Mainframe and open systems
Explanation

A command queue overflow occurred.

Note:
If you are running with Entire Net-Work, the leftmost two bytes of the Additions 2 field (in the ACB) or the ACBXERRC field (in the ACBX) may contain the ID of the Entire Net-Work node that issued this response code.

Action

The DBA may increase the value of the NC parameter or the command may be issued when there is a lower level of command activity.

If you are running Entire System Server and receive this response code, your database administrator should increase the size of the NCQE parameter. For more information, refer to the startup parameter documentation included in your Entire System Server administration documentation.


Response 152
Origin Mainframe and open systems
Explanation

The internal user buffer was not large enough to contain the user buffer areas.

Action

On mainframe systems, the DBA should increase the value of the LU parameter used by the Entire Net-Work nucleus.

If you are running Entire System Server and receive this response code, your database administrator should increase the size of the IUBL parameter. For more information, refer to the startup parameter documentation included in your Entire System Server administration documentation.

On open systems, contact your Software AG technical support representative.


Response 153
Origin Mainframe and open systems
Explanation

A second Adabas call was issued while the first one was still being processed.

Subcode Description
1050 A thread is pending.
1051 A user ID is pending.
Action

Issue only one call at a time.


Response 154
Origin Mainframe and open systems
Explanation

One of the following occurred:

  • The Adabas call was canceled by the user (open systems).

  • The command was rejected because it resulted in a trigger being fired, but the queue is full at this time. (mainframe)

Action

On open systems, no action is required for this informational message. On mainframe systems, retry the command.


Response 155
Origin Mainframe systems only
Explanation

A command resulted in a pre-command trigger being fired. The triggered procedure returned a nonzero command, so the command was not executed.

Action

Check the Additions 4 field for the error returned from the procedure.


Response 156
Origin Mainframe systems only
Explanation

A command resulted in a post-command trigger being fired. The triggered procedure returned a nonzero command, indicating an unsuccessful execution of the procedure.

Action

Check the Additions 4 field for the error returned from the procedure.


Response 157
Origin Mainframe systems only
Explanation

A command resulted in either a pre- or post-command trigger being fired; however, Adabas Triggers has been shut down with the option to reject all commands that result in a trigger being fired.

Action

Determine the cause of the shut-down and resolve the problem. If rejection of commands is not the required action in such a situation, then set the error action field in the Adabas Triggers profile to halt or ignore.


Response 159
Origin Mainframe systems only
Explanation

The Adabas link module is missing or invalid. One of the following occurred:

  • No Adabas link module is linked to the Natural nucleus and the Adabas link module specified in the Natural profile parameter ADANAME could not be loaded.

  • (CICS only) The loaded Adabas link module is macro-level in a command-level only environment.

Action

Check the setting of the Natural profile parameter ADANAME and/or provide the correct version of the Adabas link module in one of the current STEPLIBs.


Response 160
Origin Mainframe systems only
Explanation

Too many Associator and Data Storage blocks were marked as active in the buffer pool for a single command.


Response 161
Origin Mainframe systems only
Explanation

The RABN chain in the header list of the Adabas buffer pool is invalid.


Response 162
Origin Mainframe and open systems
Explanation

No additional space is available for the Adabas buffer pool.

Action

Increase the value of the ADARUN LBP parameter.

On open systems, because the buffer pool overflow is normally caused by too many blocks in the buffer pool waiting to be written to disk, specifying a low value for the WRITE_LIMIT parameter is recommended.


Response 163
Origin Mainframe systems only
Explanation

The RABN to be linked into the RABN header chain is already in the chain.

The following table shows some of the subcodes that may be returned:

Subcode Description
1 The RABN to be linked into the RABN header chain is already in the chain.
2 A file extent overlap exists such that the same data storage RABN has been assigned to two different files.
3 A supposedly unused data storage RABN is already in use.
4 A file extent overlap exists such that the same Associator RABN has been assigned to two different files.
5 A supposedly unused Associator RABN is already in use.
Action

Contact your Software AG technical support representative for assistance.


Response 164
Origin Mainframe systems only
Explanation

Too many work areas were allocated for the command.


Response 165
Origin Mainframe and open systems
Explanation

A descriptor name was either invalid or did not exist in the descriptor value table (DVT). For expanded files: the descriptor does not exist on all component files.

On open systems, this error may occur during ADAREC generate if one of the following occurs:

  • A file was loaded with an incorrect FDT.

  • ADAINV was not reexecuted following a stop at a SYNP checkpoint.

In an ACB, the leftmost two bytes of Additions 2 may contain the descriptor name; in an ACBX, the Error Character Field (ACBXERRB) may contain the descriptor name. If this occurred for an expanded file, check to see if there is an FDT mismatch between the components of the file.

On open systems, bytes 3 and 4 of the Additions 2 field contains the name of the descriptor that caused the error.

Action

On open systems, if the error is not a handling error, run the INDEX option of ADAVFY and contact your Software AG technical support representative.


Response 166
Origin Mainframe and open systems
Explanation

An error was detected in an inverted list index; a descriptor value was not found during a delete operation. The cause may be damage in the Associator.

On open systems, bytes 3 and 4 of the Additions 2 field contains the name of the descriptor that caused the error.

Action

On open systems perform the following steps:

  1. Locate the descriptor that caused the error in the Additions 2 field of the user control block;

  2. Run the VERIFY option of ADAINV for this descriptor and save the output;

  3. Reinvert the descriptor;

  4. If necessary, restart the database (if this is possible);

  5. Send the following information to your Software AG technical support representative:

    • The output of the VERIFY option of ADAINV;

    • All available PLOGs;

    • The FDT of the file containing the error;

    • If the nucleus crashed, the crash directory.


Response 167
Origin Mainframe and open systems
Explanation

The meaning of this response code varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

The field in a coupled file does not exist or the coupled list is invalid.

Open Systems

An error was detected in an inverted list index; a descriptor value was already present during an insert operation.

Bytes 3 and 4 of the Additions 2 field contains the name of the descriptor that caused the error.

Action

The method of resolving the error varies, depending on whether you are using Adabas on mainframe systems or Adabas on open systems.

Mainframe Systems

Open Systems

Complete the following steps:

  1. Locate the descriptor that caused the error in the Additions 2 field of the user control block;

  2. Run the VERIFY option of ADAINV for this descriptor and save the output;

  3. Reinvert the descriptor;

  4. If necessary, restart the database (if this is possible);

  5. Send the following information to your nearest support center:

    • The output of the VERIFY option of ADAINV;

    • All available PLOGs;

    • The FDT of the file containing the error;

    • If the nucleus crashed, the crash directory.


Response 168
Origin Mainframe systems only
Explanation

An internal command ID required during coupling processing was not found.


Response 170
Origin Mainframe and open systems
Explanation

The Adabas RABN required for the command could not be located for one of the following reasons:

  • The buffer segment was called with a RABN of zero.

  • The specified RABN does not belong to this database and is invalid.

On open systems, the Additions 2 field contains the invalid RABN in 4 byte binary format.

Action

On open systems, run the LOST, INDEX and DATA options of ADAVFY for the file in question and contact your Software AG technical support representative.


Response 171
Origin Mainframe systems only
Explanation

The constant set used by Adabas could not be located.


Response 172
Origin Mainframe and open systems
Explanation

On mainframe systems, an ISN was less than the MINISN or greater than the MAXISN setting in effect for the file.

On open systems, the maximum possible ISN of the file was reached and no more can be allocated.

Action

On open systems, if the file contains significantly less than 232 records, you should unload the file with ADAULD and reload it with ADAMUP without USERISN. However, you must be aware that problems may arise if the ISNs have semantics for you - if, for example, you use the ISNs to reference records in this file, additional reorganization of these references will be necessary. The alternative to unloading and reloading the data is to split up your data into more than one file, and to adapt your application accordingly.


Response 173
Origin Mainframe and open systems
Explanation

An invalid Data Storage RABN was detected.

On open systems, the Additions 2 field contains the invalid RABN in 4 byte binary format.

Action

On open systems, run the DATA option of ADAVFY for the file in question and contact your Software AG technical support representative.


Response 174
Origin Mainframe systems only
Explanation

For an L2/L5 command with start ISN, the Data Storage RABN stored in the address converter for the file is invalid.


Response 175
Origin Mainframe systems only
Explanation

An inconsistency was detected between the index and Data Storage.

This response code can be expected when reading a descriptor value for a ciphered file if an incorrect cipher code was used.

Subcode Meaning
99 On logical reads and simple searches without hold, the index value is compared with the value from the data record to ensure consistency. When the values do not match, the read or search is repeated in order to avoid the effects of a possible parallel update. If the values still do not match, response 175 is given.
Action

Run the ADACHK utility against the file, and contact your Software AG technical support representative.


Response 176
Origin Mainframe and open systems
Explanation

Either an inconsistency was detected in an inverted list or an internal error occurred during inverted list processing.

On open systems, the Additions 2 field contains the inconsistent RABN in 4-byte binary format.

On mainframe systems, the following possible subcodes are associated with this response code:

Subcode Meaning
2 Bad index
3 Invalid search request
4 Invalid format indicator or field not found in FDT/SDT
11 Invalid search request
12 Bad index block
13 Bad UI block
14 Mismatch block length
15 Bad MI block
16 Mismatching block length
17 Bad NI block
18 Bad ISN count
21 Bad index block
22 Mismatching block length
23 Invalid ISN count
29 Inactive index block
31 Bad index block
32 Mismatching block length
33 Invalid ISN count
39 Inactive index block
41 Bad index block
42 Mismatching block length
43 Bad MI block
44 Bad NI block