Adabas Console Messages

The Adabas nucleus at release level "v.r.s" has been initiated successfully. Multi- or single-user mode is indicated, and whether the nucleus is running with or without the Adabas Recovery Aid (ADARAI) log.

The Adabas nucleus session has been initiated and database protection logging either has or has not been specified. The subsequent execution of the REGENERATE and BACKOUT functions of the ADARES utility for any updates applied during the session is only possible when protection logging has been specified. However, transaction recovery for ET logic users is not affected by PLOG specification since data protection information for such users is still maintained on the Adabas Work file.

Adabas session initialization is in progress.

Initialization is in progress for the specified external nucleus ID (nnnnn) with the specified internal nucleus ID (xx). This message is useful for determining the internal system-assigned nucleus ID associated with the external user-assigned NUCID.

The Adabas nucleus detected an overflow condition on the Work dataset that could not be rectified by normal Adabas backout processing. The Adabas session was therefore terminated abnormally.

Notify the DBA immediately.

Adabas has begun to write data protection log data to the dataset identified by DD/PLOGRn. This means that the dataset can no longer be copied to tape for subsequent use as input to the REGENERATE or BACKOUT functions of the ADARES utility. A user exit 2 (dual log processing) or a user exit 12 (multiple log processing) call either was not made or did not successfully copy the DD/PLOGRn dataset with the ADARES utility.

An I/O error occurred on the dual or multiple protection log datasets. Processing continues without protection logging.

This message is displayed in response to the operator command DNH. The number of ISNs currently in the Adabas hold queue is represented by "nnn".

An I/O error occurred on sequential protection log SIBA. If the nucleus runs with PLOGRQ=YES, the nucleus terminate with user abend 22; otherwise, the SIBA is set to dummy and processing continues without protection logging.

This message is displayed in response to the operator commands DHQ or DHQA in the event that the hold queue is empty.

This message may follow an ADAN06 message.

This message is displayed in response to the operator command DHQ or DHQA. For each ISN in the hold queue, the file number, ISN, and Adabas-assigned ID of the user for whom the ISN is being held is given.

The LP parameter specifies the number of blocks to allocate to the data protection area, which is part 1 of the Work dataset. This area must be large enough to accommodate the data protection information for the current transaction for all ET Logic users.

This message is displayed in response to the operator command DNU. "nnn" indicates the number of user queue elements currently active.

This message is displayed in response to the operator command DUQ in the event that there are no users currently active and/or the current UQ does not contain utility UQEs (response to DUUQE).

This message, a response to a DUQ, DUQA, or DUUQE operator command, provides the following information about each user:

The terminal ID is the contents of the UQE.

This message is displayed in response to the operator command DUQE. The following information is given for each user queue element:

This message is displayed in response to the DNC operator command. "nnn" indicates the number of posted command queue elements.

This message is displayed in response to the DCQ operator command. Unless the command queue (CQ) is empty, the message displays the following for each commange queue element (CQE):

The specified or available buffer pool space may not be large enough for the number of threads specified by the ADARUN NT parameter. This message is a warning. Adabas allocates 50 kilobytes per thread and processing continues.

Either increase the buffer pool size (specified by the ADARUN LBP parameter) or decrease the thread count (with the ADARUN NT parameter). Restart Adabas. If the error occurs again, allocate more address space for the Adabas nucleus and check the session I/O statistics for buffer efficiency.

This message is displayed on the console in response to the operator command DPARM. The current setting for each ADARUN parameter specified for an Adabas nucleus is given using this message number.

No action is required for this informational message.

This message is displayed in response to the operator command DSTAT.

Except for the first optional message line, the messages display the following information:

The special nucleus status indicators that can occur in the first message are as follows:

In response to the operator command DTH, shows the following information for each thread:

This message and the asynchronous buffer flush occur when the ADARUN LFIOP parameter specifies a nonzero value.

Online execution of the ADASAV utility's SAVE database function has started. The message shown above occurs for both database and file SAVEs and specifies the following:

Save this session/RABN information and the related PLOG and other SAVE output for later ADASAV restore activity.

Adabas is now ready to begin writing data protection information to the dual or multiple data protection log identified by DD/PLOGRn.

Execute the PLCOPY function of the ADARES utility at this time.

The online ADASAV SAVE FILE execution has begun. The SAVE operation begins with session "session-number", using the SYN4 start point indicated by RABN "block-number".

Save this session/RABN information and the related PLOG and SAVE output for later ADASAV RESTORE activity.

An online process has started, is ongoing or has completed, terminated due to an error, or was stopped. The type of process is displayed, as well as the file number and details about the process as appropriate.

In response to operator command DPPT (Display PPT), this and subsequent messages show the contents of the Participating Plex-ID Table (PPT).

In response to operator command DDIB (display DIB block), this message either indicates an empty DIB block or provides the following DIB information:

In response to the DDIB operator command, this message displays the "file-number" of a file that is locked because it is being used by an Adabas utility.

The Release Descriptor function at the end of an aborted online invert process has released the descriptor shown for the file shown.

The Release Descriptor function at the end of an aborted online invert process has failed with the response code shown. The file is locked.

The Release Descriptor function at the end of an aborted online invert process has finished. If the online invert was processing an expanded file, the Release Descriptor function has been executed on all component files of the expanded file.

In response to the DRES operator command, this message displays the pool/queue allocated record court, current value, and highest value reached ("high water mark") for the current session. The second line of the message occurs once for each of the following pool or queue items:

In response to the STOPI operator command, this message displays either as "users stopped" or "no users stopped", depending on the action performed by the STOPI command.

There are already 32 entries in the parallel participant table. The nucleus ID entry specified was inactive and is being overwritten.

A Work dataset was specified that is different from the one used in the previous session. This message is displayed only when the previously used Work dataset contains a pending autorestart.

A Work dataset was specified that is different from the one used in the previous session. An attempt to read the Work dataset used in the previous session to search for a pending autorestart failed.

A Work dataset was specified that is different from the one used in the previous session. The previously used Work dataset was read and contains a pending autorestart. The ADAI63 message identifies the previous Work dataset.

The protection log (PLOG) datasets have changed from the previous session and the previous PLOG datasets have not been copied. Because FORCE=YES was not specified, the parallel participant table (PPT) entry for these datasets has been overwritten.

Software AG recommends that you use the ADARES PLCOPY NOPPT function to copy the PLOGs from the previous session.

In response to the operator command DLOCKF, this message displays the files that have been locked by LOCKF or LOCKU.

In response to the operator command DFILES, this message displays the number of users currently active for the specified file.

In response to the operator command DFILUSE, this message displays the number of active commands (USAGE=n) for the specified file (FILE=n), or that the specified file does not exist in the database.

In response to operator command STOPF, this message indicates that no users were active when the command was issued.

In response to the operator command DONLSTAT, this message lists all online processes present in the nucleus session, the kind of process, the file number, the current RABN or ISN (depending on the function), the ID of the process, and whether the process is active or suspended.

The command or function issued was completed successfully.

The command issued was accepted by Adabas.

Either the request "request" was invalid or it was not correctly entered.

Check the request/command syntax and validity, then retry the request.

• A request to end a nucleus session with DUMP is invalid, and should not be retried.

• An operator command to change the cache space parameters for a file (CFILE) that has an existing cache space is invalid. It is necessary to first delete the existing cache space and then add a new one with different parameters.

Adabas could not perform the function because of

• space restrictions;

• a conflict between the requested command/function and the systemstatus.

Check for other related messages, correct any previously indicated errors, then retry the operation. Otherwise, contact your DBA, system support personnel, or Software AG technical support.

The user specified in the request/command is either not active or not known to the system.

Check for the validity of the user ID or possible errors when the specified user ID was entered.

The requested function/command was valid but could not be executed. This message may occur alone or preceded by one of the following ADAN46 messages, which provide reasons why the current nucleus status does not allow the requested function:

In addition, if User Exit 2 is attempting to switch from one dual log to another and if the data set to be overwritten is full, this error will be issued.

Wait a minute or two, then retry the command. If the message recurs, advise your system support personnel. If the message recurs while trying to issue a command in response to a previous error, make a note of that error and the related information for future reference.

A SYNCC, ADAEND, HALT, or CANCEL operator command was issued, but is not permitted during the current online save operation.

Wait until the online save has ended, then retry the command.

In Entire Net-wWrk, target node IDs must be unique across all connected systems. If an attempt is made to connect to a target node ID that is not unique, the system terminates abnormally (ADAEND).

Identify the conflicting node IDs and determine which one is to be active under the specified ID number.

A LOCKF, LOCKU, or LOCKX operator command was issued but the file specified is currently in use.

Wait until the file is no longer in use, then retry the command.

The file specified in the ALOCKF function is not loaded.

The last, incomplete transaction of the specified user (or job, if the user is not displayable) has been backed out during Adabas session autorestart or at the end of REGENERATE processing. The user ID (or job name) and communication ID are shown.

The user ID is the user's ET-ID. For users without an ET-ID, "ADAEND" is displayed as their user ID.

The field following UID= is the last 8 bytes of the 28-byte communication ID of the user in hexadecimal format; that is, the terminal ID for an online user or a STCK time stamp for a batch or TSO user.

None required. This is an information message only. The transaction status of the specified users may need to be checked.

ET-SYNC has occurred for the TRANSACTIONS SUSPEND process. This message is followed by the ADAN4E message.

All verifications in the nucleus are complete and the SUSPEND process has started. TT indicates when the transactions will time out. The TT value is derived either from the TTSYN parameter in the ADADBS TRANSACTIONS SUSPEND TTSYN=nn job or the nucleus default ADARUN TT setting.

TPC is in effect and there are transactions on PET status. This is followed by the ADAN4B message displaying the original TT value.

The timer specified by TRESUME in the ADADBS TRANSACTIONS SUSPEND process has been exceeded. The database returns to normal processing. This message is followed by the ADAN4F message.

ET-SYNC has occurred for the SUSPEND function and updates are discontinued until either the RESUME function is issued or the timer specified by TRESUME expires.

The database once again accepts and processes update commands as a result of either the RESUME function or a timeout.

This message documents the files that were excluded from autorestart due to the ADARUN AREXCLUDE parameter. These files remain unavailable for normal users and must be recovered (restore - regenerate).

Adabas repeats the operator command "command" before continuing. The second message is written for an operator command issued by an Adabas Online System user.

During session start, the nucleus detected the specified descriptor of the file `fnr' left over from an incomplete online invert operation. If the previous session terminated abnormally, the nucleus automatically releases the incomplete descriptor.

If the nucleus did not release the descriptor and no regenerate on the file in question is to follow, release the incomplete descriptor using the AOS or ADADBS RELEASE function.

The nucleus is trying to perform an action that only one nucleus or utility can do at a time. Another nucleus or utility is performing a similar action at the moment, so this nucleus must wait. `rrrddddd' identifies the logical resource used for serialization. The resource name comprises three letters followed by five digits representing the database ID. Possible resource names include:

• SSEddddd for serializing nucleus session start and end.

• DIBddddd for serializing DIB updates.

• FSTddddd for serializing FST updates.

None required. This message is for information only.

If the nucleus hangs after displaying this message, another nucleus or utility is blocking the logical resource specified in the message. Identify the other job and either allow it to continue or terminate it.

An attempt to lock or unlock a logical resource failed. The ADAIOR function number was 'ff' (in hexadecimal), its response code 'cc' (in hexadecimal). Depending on the circumstances, the nucleus terminates abnormally or ignores the error.

This is an unexpected error. Contact your Software AG technical support representative.

During session start (or, with Adabas nucleus clusters, during online recovery), the Adabas nucleus found recovery data on the Work dataset (or Work datasets, in the case of nucleus clusters) that is needed to recover the database from a previous failure. The nucleus performs session autorestart logic.

These messages are printed in series when different phases of the session autorestart have been completed successfully. Session autorestart repairs physical inconsistencies in the database, redoing updates belonging to completed transactions and backing out updates belonging to incomplete transactions.

Various message texts can appear for this message number. The explanation and action for each is given in the following table.

An autorestart operation found that a buffer flush was being performed when the action that caused the autorestart occurred; the buffer flush was therefore incomplete. The nucleus completes autorestart processing before terminating.

• If the cause of the autorestart was a power failure, the database may be inconsistent in a way that cannot be repaired by autorestart.

• If the cause of the autorestart was not a power failure, the database has already been made consistent and needs only to be restarted.

If a power failure caused the autorestart and your storage subsystem does not guarantee that no block is partially written, perform the following utility operations to ensure database consistency:

• ADASAV RESTORE (database)

• ADARES REGENERATE

If your storage subsystem technology does guarantee that no block is partially written, even in the case of power failure, there is no need to restore/regenerate after this message is received: simply restart the nucleus.

You may restrict the RESTORE - REGENERATE to the files modified by autorestart (see the ADAN5A message) but be sure to run the REGENERATE FILE with transaction logic (autobackout at the end of the regenerate) by specifying the ADARES parameter CONTINUE.

If the autorestart operation was not caused by a power failure, do not perform the utility operations described above. Simply restart the nucleus.

An internal error occurred that caused the nucleus to terminate abnormally. The message shows the abend code and the address, if possible also the module and offset, where the error was detected, as well as the contents of the general registers at that time.

Contact your Software AG technical support representative.

During nucleus startup, an autorestart was performed that modified the files listed in the message text.

The ARMELEMENTNAME parameter has been specified and the nucleus has successfully registered or deregistered this element with the Automatic Restart Manager (ARM).

The ARMELEMENTNAME parameter has been specified, but registering or deregistering with the Automatic Restart Manager (ARM) has failed. ARM has returned the reason code shown. The possible reason codes are described in the IBM manual MVS Programming: Sysplex Services Reference, Chapter IXCARM Macro, Section Return and Reason Codes. Common reason codes include:

• X`002C' The ARMELEMENTNAME parameter value is invalid.

• X`013C' The Adabas nucleus has improper SAF authorization to register with ARM.

• X`0150' ARMELEMENTNAME is not unique across the sysplex.

• X`0004' The system does not support ARM.

The nucleus ignores the error and continues processing.

Look up the meaning of the reason code. If this explains the error, correct it. Otherwise, contact your systems programmer or your Software AG technical support representative.

This message is displayed in response to the DNFV operator command.

• "FNR" gives the file number

• "A" can be either "Y", indicating that the file is being used by access-only users, or blank, indicating that it is not being used by access-only users.

• "U" is used in the same way as for "A", but indicates usage by update users.

• "ID" is the ID of the database which has exclusive control over the file

• "CA" is the count of how many access-only users are using the file.

• "CU" is the count of how many update users are using the file.

The triggers and stored procedures facility has been activated for the current session. However, subsystem number "nn", batch Natural nucleus "name", terminated abnormally and will not restart.

Determine the cause of the abend and correct the problem.

The nucleus is retrying the attempt to switch PLOGs or CLOGs. The retry is performed when the FEOFPL/CL attempt is made and there is currently no free PLOG or CLOG.

Submit an ADARES PLCOPY or CLCOPY to copy the appropriate datasets.

The Adabas nucleus detected an internal I/O error.

Contact your Software AG technical support representative.

User "user-id" attempted to use a file for which that user is not authorized. The active job is "job-name".

Refer to the command log entry for the failed command to determine if any corrective action is needed.

The function INCREASE or ADD for an Associator or Data Storage extent has been performed by the nucleus. The nucleus terminates and permits the newly added part of the Associator to be allocated and formatted, which is necessary before another Adabas session can be started and the new extent can be used.

Perform the necessary allocation/reformatting utility operations, and then restart the nucleus.

An I/O error occurred during asynchronous buffer flush operation. The nucleus ends operation.

Correct the cause of the I/O error.

ECS is the Entire Conversion Services, a subsystem of the Adabas universal encoding support (UES) system. This message is written after a function of the subsystem has failed.

Error codes produced by the ECS component are described in Universal Encoding System (UES) Component Error Codes.

The following ECS functions may return errors:

Resolve the problem and try again.

The specified version of Entire Conversion Services was successfully initialized.

The specified collation descriptor user exit was successfully initialized.

Adabas Caching Facility was successfully initialized.

Adabas Caching Facility determined that 64-bit virtual storage is available for use.

In an Adabas nucleus cluster environment prior to version 7.2, caching is available only for Work parts 2 and 3.

The highest RABN of an ASSO or DATA extent, as defined in the GCB, is not readable. Most likely, an Adabas Online System or ADADBS INCREASE function was performed without allocating and formatting the new database area. The nucleus continues. Any attempt to access an unallocated area of the database causes an I/O error.

Ensure that the defined extents are completely allocated and formatted.

An attempt was made to change cache space parameters for a file without first deleting its existing cache space.

Delete the existing cache space for the file; then add a new cache space with the changed parameters.

This message displays the output of the CSTAT, CFSTAT, and CSUM operator commands of the Adabas Caching Facility. See the Adabas Caching Facility documentation for more information.

The CSTAT command is used to display the current cache space statistics. A sample report display is shown below:

+--------------------------------------------------------+
+ 005 DATA SPACE, DATA, RABNS 81 THRU 135                +
+--------------------------------------------------------+
+ ALLOCATED, LA=17:04:26                                 +
+--------------------------------------------------------+
+        253 CACHE WRITES  +            47 BLKS IN CACHE +
+         47 READ EXCPS    +       172,032 DATA SPC SIZE +
+        408 CACHE READS   +            55 BLKS/DATA SPC +
+        455 TOTAL READS   +          1320 INDXSPCE SIZE +
+       89.6 DSP EFFICIENCY+       167,936 MAX DSP USED  +
+   0.071810 MAX NIOT (SEC)+      0.698682 MAX EXCPT(SEC)+
+   0.000080 MIN NIOT (SEC)+      0.009600 MIN EXCPT(SEC)+
+   0.000245 AVE NIOT (SEC)+      0.167286 AVE EXCPT(SEC)+
+--------------------------------------------------------+

The CFSTAT command is used for file-level caching to display the current cache space statistics for one or more files. When file-level caching is active, a report is produced for each RABN range associated with the file request. A sample report display is shown below:

+--------------------------------------------------------+
+ FNR 00001 AC CL1 EXT RABNS 91 THRU 93
+--------------------------------------------------------+
+   ALLOCATED, LA=09:55:36           
+--------------------------------------------------------+
+         60 CACHE WRITES  +             0 BLKS IN CACHE +
+          2 READ EXCPS    +    32,767,404 EXTM  SIZE    +
+         52 CACHE READS   +        16,351 BLKS/EXTM     +
+         54 TOTAL READS   +            28 RABN TAB SIZE +
+       96.2 ESP EFFICIENCY+         4,008 MAX ESP USED  +
+   0.001503 MAX NIOT (SEC)+      0.092800 MAX EXCPT(SEC)+
+   0.000018 MIN NIOT (SEC)+      0.092071 MIN EXCPT(SEC)+
+   0.000062 AVE NIOT (SEC)+      0.092435 AVE EXCPT(SEC)+
+--------------------------------------------------------+

The CSUM command is used to display, for a session, the accumulated cache summary for all active and inactive cache spaces, including statistics from previously deleted cache spaces. A sample report display is shown below:

+--------------------------------------------------------+
+ A D A B A S DYNAMIC CACHING SESSION SUMMARY            +
+        52.5 CURRENT ADABAS BUFFER EFFICIENCY           +
+         7.2 PROJECTED NON-CACHE BUFFER EFFICIENCY      +
+           3 ACTIVE CACHE SPACES                        +
+           4 CACHE SPACES DEFINED                       +
+ ------------ -----ASSO---- -----DATA---- -----WORK---- +
+ CACHE WRITES        27,367         6,674           212 +
+   READ EXCPS            78           444             0 +
+  CACHE READS        27,288         6,203         4,865 +
+  TOTAL READS        27,366         6,647         4,865 +
+   EFFICIENCY          99.7          93.3         100.0 +
+--------------------------------------------------------+

The READONLY status of the nucleus has been switched. This message occurs as a response to the operator command or Adabas Online System function READONLY.

The "utility use only" (UTIONLY) status of the nucleus has been switched. This message occurs as a response to the operator command or Adabas Online System function UTIONLY.

The ADARUN LP parameter was increased in the current Adabas session. Therefore, additional Work part 1 RABNs had to be formatted.

None required. Consider increasing the Work dataset to ensure that sufficient Work part 3 space is available.

Various message texts can appear for this message number. The explanation and action for each is given in the following table.

Examine error ADAN86 for the cause of the error.

Various message texts can appear for this message number. The explanation and action for each is given in the following table.

User actions are given in the explanation.

Various message texts can appear for this message number. The explanation and action for each is given in the following table.

User actions are given in the explanation.

During initialization of a nucleus defined with DTP=RM, a logic error was detected while executing DTP functions.

The nucleus terminates abnormally with abend 19. The registers at entry to the abend and the load addresses of ADANC0-ADANCB are printed.

Contact your local Software AG technical support representative.

Various message texts can appear for this message number. The explanation and action for each is given in the following table.

User actions are given in the explanation.

The file specified for caching is already being cached by Adabas Caching Facility. This error can occur if you use operator or Adabas Online System commands in an attempt to define different types of memory to cache Associator and Data Storage RABNs of the same file.

It is possible at startup using ADARUN CFILE parameters to specify different types of memory to cache Associator and Data Storage RABNs of the same file. However, once a memory type is set for caching any RABNs of a file, Adabas Online System and operator commands do not allow you to specify any other memory type for the same file. If you want to change the memory type for the file, you must delete the existing cache space and then add a new one with different parameters.

ADACSH could not acquire space for its working areas. Adabas Caching Facility is not started and the associated message ADAN8H is displayed.

Increase the region, partition, or address space size.

A RABN range has been activated. This generally occurs when Adabas writes a RABN from its buffer pool to cache storage.

Adabas Caching Facility could not allocate storage for the track or hiperspace I/O buffer, or for RABNINDX blocks. When the track I/O buffer is not available, a RABN I/O request being considered for read-ahead caching is issued normally. When the hiperspace I/O buffer is not available, caching using hiperspaces is not possible. When the RABNINDXes for a cache space area are not available, the attempt to allocate the associated cache space area fails and is not attempted again until at least CRETRY seconds have elapsed.

Increase the region, partition, or address space size.

Adabas Caching Facility was not activated due to a previous parameter specification or error condition.

Depending on the utility, Adabas Caching Facility acted to maintain database integrity by releasing an entire cache space or a number of cache blocks because of a parallel utility operation.

A cache storage area was released after it was inactive for a continuous elapsed time period of CCTIMEOUT seconds.

This message is displayed whenever a RABN range is activated. This generally occurs when Adabas writes a RABN from its buffer pool to cache storage.

An attempt was made to add an additional cache storage area for a cache space.

When the request is successful, the additional storage is available for the cache space and "yyy" reflects the size of the new area which is equal to the current CASSOMAXS or CDATAMAXS setting.

If unsuccessful, the system simply uses the storage areas already allocated for the cache space until CRETRY seconds pass. Then another attempt is made to add a new storage area for the cache space if this is still required.

Check with the system programmer; the extension failure may be due to insufficient ESA capabilities (memory or page datasets), or too many data spaces or hiperspaces allocated at one time.

An Adabas Online System (AOS) operator issued a command to change one of the Adabas Caching Facility system parameters.

Demand caching is in effect and a RABN range or file has been inactive for a period longer than the CCTIMEOUT specification.

An error occurred during the processing of a hiperspace cache request.

Generally speaking, this error causes a request to write to or read from a hiperspace cache to fail. In most cases, the system can continue by reading the RABN from disk or writing, ignoring the request from the nucleus.

However, where Work parts 1 or 2 are being cached 100%, the failure of a request to return a cached RABN may have more serious consequences because there is no copy of the RABN on disk and therefore the I/O cannot be satisfied.

Determine if the error was caused by some event or problem in the system that could impact on hiperspaces used by Adabas Caching Facility. If there is nothing evident, report the error and the circumstances surrounding the error to your Software AG technical support representative.

An attempt to allocate dynamic storage in extended memory failed due to a shortage of space in extended memory.

Review your storage estimates to insure that there is sufficient storage available for the parameters specified.

The write to hiperspace operation returned a nonzero condition code. The requested RABN is not written to hiperspace and is flagged as unused.

No operator intervention is required.

An attempt to allocate the first storage block for a cache area failed.

No storage is available for caching the RABNs for which the cache storage allocation was attempted. The situation continues at least until CRETRY seconds have elapsed and another attempt to allocate the storage is made, if required.

Check with the system programmer; the allocation failure may be due to insufficient memory or page datasets or too many data spaces and/or hiperspaces allocated at one time.

An operator command was received and was either successfully completed or not.

If the command was unsuccessful, check DDPRINT for warning messages to determine why the command failed. Alternately, insure that the syntax used for the command is correct.

This message is displayed for each inactive RABN range or file that is enabled when the Adabas buffer efficiency drops below the specified CDEMAND threshold level.

This message is displayed in response to the CPARM operator command. The parameters displayed are:

When Adabas Caching Facility first accesses a RABN belonging to a file to be cached, it learns about the extents and RABNs associated with the file and synchronizes its view of the file with the file's FCB.

If ADASCR detects that the structure of the file has changed (e.g., a new extent is added), ADASCR resynchronizes its view of the file at the next possible opportunity and issues this message.

File-level caching is active for the current nucleus.

A logic error occurred during Adabas Caching Facility processing.

Report the error and the hexadecimal offset to your Software AG technical support representative.

The Adabas trigger driver was unable to obtain enough storage within the region or address space to set up its I/O buffers.

Determine the source of the problem and correct it. Try increasing the region size for the MPM.

The Adabas trigger driver was unable to obtain enough storage within the region or address space to set up its I/O buffers.

Increase the region size for the MPM.

The triggers and stored procedures facility was initialized successfully. Commands for detecting triggers are now processed.

A request to refresh the trigger table buffer was made and the Adabas system is being quiesced in order to perform this function.

The ADARUN parameter SPT=YES was specified; however, because the database administrator has overridden this using the Adabas triggers subsystem, triggers will not be activated.

To reactivate triggers, access the Adabas triggers subsystem function "modify profile information" (located on the Miscellaneous Functions Menu), and change the triggers status field in the profile to "active".

The Adabas nucleus has been started with SPT=YES and MODE=SINGLE. This is not allowed.

Start the nucleus with MODE=MULTI in the ADARUN parameters (DDCARD), or specify SPT=NO.

During the start-up of the Adabas trigger driver, certain communication must occur with Adabas Parallel Services if it is active. The Adabas trigger driver was unable to complete the communication.

After obtaining a dump, contact your Software AG technical support representative and report the error.

The trigger table buffer was refreshed. The triggers have been reloaded and the Adabas nucleus will continue to run normally.

During the refresh of the trigger table buffer, an error occurred. This error was identified by a previous console message. The error causes an inconsistent state in the triggers subsystem that necessitates a shut-down as indicated in the error action option setting in the profile.

Review previous console messages to determine the error. Correct it and, if necessary, restart the nucleus to restart the triggers subsystem.

During the triggers initialization process, Adabas needs to read the trigger file FDT; however, the FDT could not be found. As a result, triggers will not be activated.

Determine the reason why the FDT could not be found and correct the problem. Ensure that the file was correctly loaded as a system file.

During the triggers initialization process, Adabas needs to read the trigger file FCB; however, the FCB could not be found. As a result, triggers will not be activated.

Determine the reason why the FCB could not be found and correct the problem. Ensure that the file was correctly loaded as a system file.

During the triggers initialization process, Adabas needs to read the entries from the trigger file; however, a nonzero response code was received. As a result, triggers will not be activated.

Determine the source of the problem; that is, analyze the response code and take the necessary action to resolve the problem.

The nucleus terminates with a dump due to failure of the internal autorestart.

During the triggers initialization process, Adabas needs to read the entries from the trigger file; however, no valid trigger entries were found in the file. As a result, triggers will not be activated.

Verify that there are triggers defined on the trigger file and that the trigger file is set up correctly; that is, the file is loaded on the database where the error occurred.

During the triggers initialization process, Adabas needs to load the entries from the trigger file into its buffer; however, the size calculated for the buffer is incorrect. The cause could be one of the following:

• triggers were added by some means other than the Adabas triggers subsystem, or

• the buffer size was not calculated or was specified incorrectly. As a result, triggers will not be activated.

Recalculate the size required for the buffer. Issue the NUMBER or CHECK command from the Modify Profile screen to verify that the number is recorded correctly by Adabas Online System. Also check the buffer size specified in the "trigger table size" field in the Adabas triggers and stored procedures profile.

An attempt was made to process triggers that are assigned to file numbers greater than the maximum acceptable file number; that is, the highest loaded file plus 10.

This message is a warning. Triggers should not be assigned to file numbers greater than the maximum file number allowed.

During the triggers initialization process, Adabas needs to read the profile definition from the trigger file; however, the profile definition could not be found. As a result, triggers will not be activated.

Using the Adabas triggers subsystem, add a profile for the subsystem.

During the triggers initialization process, Adabas needs to read the profile definition from the trigger file. However, an internal error occurred during the read. As a result, triggers will not be activated.

Determine the cause of the error and correct it using the Adabas triggers subsystem. Possibly modify the profile again to ensure that it is correct.

During the triggers initialization process, Adabas needs to acquire space for its buffer, but insufficient space was found. This can occur if the value specified for the LWP ADARUN parameter is too small. As a result, triggers will not be activated.

Check the value specified for the LWP ADARUN parameter and increase it as appropriate.

The Adabas nucleus started with SPT=YES; however, no trigger file exists for this database. As a result, triggers will not be activated.

Either set SPT=NO or load a trigger file that contains at least one trigger definition onto the database.

During the triggers initialization process, Adabas needs to start the subsystems for the execution of procedures; however, the name specified was invalid. As a result, triggers has been deactivated.

Check the batch Natural name setting in the Adabas triggers and stored procedures profile. Also ensure that the Natural nucleus module is concatenated in the JCS/JCL startup and is a loadable module.

A serious or fatal error occurred that created an inconsistent state in the system. The nucleus has been shut down.

Review previous console messages to determine the error. Correct it and restart the nucleus to restart the triggers subsystem.

Triggers incurred one or more errors and has been deactivated. The error action taken depends on the error action setting in the Adabas triggers and stored procedures profile.

Review previous console messages to determine the cause of the errors and correct the problem.

"nn" is the unique number and "name" is the name of the Natural nucleus subsystem. The specified subsystem incurred an error and terminated abnormally. The Adabas trigger driver will try three times to restart it. A subsequent message will inform the user of the type of abend.

Determine the cause and resolve the problem. The return code "code" given should provide additional information.

"nn" is the unique number and "name" is the name of the Natural nucleus subsystem. Either a request was made to shut down the specified subsystem or three consecutive abends have occurred and the Adabas trigger driver has decided to deactivate the subsystem.

Determine the cause and resolve the problem. The return code given should provide additional information.

"nn" is the unique number and "name" is the name of the Natural nucleus subsystem. During the processing of a trigger, it was detected that the originating command had timed out. The trigger will not be processed successfully.

Retry the command.

"nn" is the unique number and "name" is the name of the Natural nucleus subsystem. The specified subsystem was cancelled when a timeout occurred for a procedure that was executing in the subsystem. The subsystem will be restarted. A previous message gives specifics about the cancellation.

Determine the cause and resolve the problem. The reason code given should provide additional information.

"nn" is the unique number and "name" is the name of the Natural nucleus subsystem. During the triggers initialization process, a specified number of Natural subsystems will be started for the execution of procedures. This message informs the user of the successful initialization of each subsystem.

No action is required. The subsystem will wait for work.

The Error Action field in the Adabas triggers and stored procedures profile is set to "halt", and either a fatal error occurred or Adabas Online System requested a shut-down of the Adabas triggers subsystem.

Review previous messages to determine whether a problem occurred and, if so, correct the problem.

The Adabas trigger driver determined that a triggered procedure exceeded the specified time limit. The procedure was cancelled so that processing can continue with another procedure and queueing can be prevented. UID is the last 8 bytes of the user ID in hexadecimal, as specified in the UQE.

Check the procedure. Determine if it was looping, is doing too much work, or if the time-out parameter is too low. Correct the problem for the next time.

"nn" is the unique number and "name" is the name of the Natural nucleus subsystem. The shut-down of triggers has completed successfully. This message is shown for each subsystem.

The Adabas trigger driver determined that a particular stored procedure exceeded the specified time limit. The procedure has been cancelled so that processing may continue with another procedure and queueing may be prevented. UID is the last 8 bytes of the user ID in hexadecimal, as specified in the UQE.

Check the procedure. Determine if it was looping, is doing too much work, or if the time-out parameter is too low. Correct the problem for the next time.

Triggers is shutting down and must queue the subsystems. However, a procedure is still running. The user ID (UID) is provided to help the database administrator investigate a potential problem.

No action is necessary. However, the database administrator may not want the Adabas trigger driver to wait; therefore, the user's procedure may be stopped.

"nn" is the unique number and "name" is the name of the Natural nucleus subsystem. Subsequent to ADAN9N, the Adabas trigger driver decided not to wait for the specified subsystem to complete processing; therefore, the subsystem was cancelled.

This message is for information only. No action is required.

Either the nucleus is terminating (ADAEND or HALT) or the triggers and stored procedures facility has requested a halt, probably due to an error, and the Adabas trigger driver has also been requested to shut down.

No action is required. The user is informed that this is in progress.

A display command is about to be processed with (ON) or without (OFF) a formatted dump.

Indicates whether the error handling and message buffering facility is active in the nucleus.

Indicates whether the error handling and message buffering facility's abnormal termination handler is active.

The error handling and message buffering facility has not encountered any of the errors it is looking for.

Indicates the date (yyyy-mm-dd) and time (hh:mm:ss) of the most recent error handled by the error handling and message buffering facility.

Identifies the abnormal termination that has occurred or the response code that has been received and indicates the location (if any) of the most recent error handled by the error handling and message buffering facility. Explanations of MVS abnormal termination codes can be accessed from the System Codes Manual on the IBM web site at http://ppdbooks.pok.ibm.com:80/cgi-bin/bookmgr/bookmgr.cmd/ BOOKS/IEA1H706/CCONTENTS

Indicates the number of times an error or abend code is trapped and actually handled by the error handling and message buffering facility.

Indicates the number of times a response code is actually handled (that is, a PIN routine is invoked) by the error handling and message buffering facility.

Indicates the total number of times the error handling and message buffering facility is invoked to handle a condition (response code or abend code).

Indicates the PIN routine invoked by the error handling and message buffering facility to handle the most recent error encountered.

Indicates the number of condition-handling PIN routines invoked and the number of errors they recovered.

Indicates the number of location-only PIN routines invoked and the number of errors they recovered.

Indicates the number of response-code PIN routines invoked and the number of errors they recovered.

Indicates the total number of PIN routines invoked and the number of errors they recovered.

Indicates whether message buffering in the error handling and message buffering facility is active.

Indicates the number of messages currently in the message buffer and the date (yyyy-mm-dd) and time (hh:mm:ss) of the oldest message.

Provides information about an active (PIN) or inactive (*PIN) routine: the number of times used, the condition it handles (the abnormal termination that occurred or the response code that was returned), and the location(s) for which it is valid. Explanations of MVS abnormal termination codes can be accessed from the System Codes Manual on the IBM web site at http://ppdbooks.pok.ibm.com:80/cgi-bin/bookmgr/bookmgr.cmd/ BOOKS/IEA1H706/CCONTENTS

The DISPLAY=EXITS command was issued but no exits are currently in use.

Indicates whether the specified exit is active, active and critical, or inactive.

Adabas Online System internal error.

Contact your Software AG technical support representative.

A load module for the error handling and message buffering facility could not be loaded. Adabas runs without the facility.

Ensure that all modules for the error handling and message buffering facility installed with Adabas are still in the distributed library. If modules are missing, restore a copy of the module from a backup and apply any maintenance.

Indicates that the abnormal termination handler of the error handling and message buffering facility is active.

Not enough memory is available to run the error handling and message buffering facility. Adabas runs without the facility.

Increase the region size available to the Adabas nucleus.

Not enough memory is available to run the error handling and message buffering facility. Adabas runs without the facility.

Increase the region size available to the Adabas nucleus.

The operands on an SMGT command were invalid.

Correct the operands and reissue the command.

The error handling and message buffering facility finished processing a command.

The error handling facility must be active (SMGT=ON) before the command can be issued. The command issued can be found in the ADANO1 message immediately following the ADANO5 message.

Activate the error handling facility and reissue the command.

The error handling facility has been invoked for the specified condition. Note that explanations of MVS abnormal termination codes can be accessed from the System Codes Manual on the IBM web site at http://ppdbooks.pok.ibm.com:80/cgi-bin/bookmgr/bookmgr.cmd/ BOOKS/IEA1H706/CCONTENTS

An error occurred in the specified, noncritical exit. The exit is not invoked until the error is corrected.

Consult diagnostic messages; correct the exit; reload the exit using the SGMT,XLOAD command; then reactivate the exit using the SGMT,XACT command.

Displays the PSW when the error was encountered.

Displays the registers when the error was encountered.

The error handling facility is handling an error of the specified type.

The nucleus start-up JCL did not define a dataset to hold a formatted hexadecimal dump of an area in memory, either an address space or a data space.

To use the error handling and message buffering facility's SMGT,DUMP={ON| OFF } or SMGT,SNAP[=(start,end)] command successfully, the dataset ADASNAP must be defined in the Adabas start-up JCL.

Stop the Adabas session; add the required statement to the start-up JCL, and start a new session.

Indicates a change of status in the error handling and message buffering facility.

Indicates a change of status in message buffering.

Indicates a change of status in the abnormal termination handling or the error handling and message buffering facility.

Not enough memory was available to add new PINs. Adabas runs without the PIN module.

Increase the size of the region available to the Adabas nucleus.

Unable to load the specified module. The error handling and message buffering facility runs without the module.

Ensure that the module is available to the error handling facility by placing it in the Adabas program library.

The exit-code indicated in the message is not a valid code, or is not in the correct state for the command requested. Adabas rejects the command.

Ensure that the exit-code is correct. If it is, ensure that the exit is in a state that allows the requested command.

The exit-code specified in the message indicates an active exit. Adabas rejects the command.

Ensure that the exit-code is correct. If it is, ensure that the exit is in a state that allows the requested command.

Adabas cannot load the exit without the name of the module. Adabas rejects the command.

Retype the SGMT,XLOAD command and include a member name for the exit.

A command that requires an exit cannot be processed because the exit is not loaded. Adabas rejects the command.

Ensure that the exit-code is correct. If it is, load the exit.

The status (active, not active, loaded, critical, or not critical) of an exit changed as a result of an operator command, and this messages provides the details.

The parameters provided for a SNAP command are invalid. Adabas rejects the command.

Ensure that the addresses provided to the SNAP command are correct.

The specified PIN routine has been disabled.

The PIN routine for the previous command was not found. Adabas rejects the command.

Ensure that the PIN routine is correct and reissue the command.

The specified PIN routine has been enabled.

The specified PIN module has been loaded.

The specified PIN module has been removed from memory.

The PIN module for the previous command is not available. Adabas rejects the command.

Ensure that the PIN module name is correct, and that the PIN module is in the Adabas library; then reissue the command.

Indicates whether a full dump or a snap dump is taken.

Message buffering cannot be activated.

Add the MSGBUF= parameter to the initial ADARUN parameters.

Format of the diagnostic information produced by the Adabas PINRSP or PINUES routine. The PINRSP routine will produce only the cmd, hex-cid, rsp-code, and rsp-subcode information.

The PIN ADAMXY detected a S047 abend.

Run Adabas from an authorized load library.

The PIN ADAMXY determined that the particular error is in the identified routine.

Refer to the appropriate operating system documentation for a description of the system abend that occurred.

Adabas is in the process of termination, and the error handling and message buffer facility functions have been terminated.

The essential module PABNKERN found in the internal product APS (porting platform) is not available to Adabas.

Add the APSvrsLOAD library to your job's STEPLIB.

One of the parameters passed within the URL was incorrect.

Ensure that the URL includes valid values for all required elements: the API name (protocol), stack ID, and port number. Correct the URL and try again.

The port that was specified in the URL was not valid.

The port number can be 1-5 bytes; it cannot be zero (0) or greater than 65535.

Either the URL is already opened (ACTIVE) or already closed (CLOSED).

Ensure that the URL includes valid values for all required elements: the API name (protocol), stack ID, and port number. Correct the URL and try again.

The URL itself was not found.

Ensure that the URL includes valid values for all required elements: the API name (protocol), stack ID, and port number. Correct the URL and try again.

The URL was successfully closed or opened.

ADATCP cannot be started because the network is not active.

Check that the stack specified in the URL is active. If it is, contact your systems administrator.

No buffer space is available to ADATCP to allocate its control blocks.

Ensure that sufficient storage is available on the system.

An error caused TCP/IP or ADATCP to terminate.

This message is issued along with another message that explains the reason for the termination. Refer to the other message.

The TCP/IP stack specified in the URL is not installed or not active.

Check that the specified URL is the one intended. If so, either install the specified stack or start it.

The maximum number of socket descriptors has been reached: no more sockets can be created.

Increase the maximum number of sockets that can be created.

Unless this message is accompanied by an error message, TCP/IP has terminated normally.

If an error message accompanies this message, refer to that message. Otherwise, this message is for information only.

The stack specified in the URL is not valid: TCP/IP cannot initialize.

Ensure that the stack is available on the system and that it is active.

The TCP/IP name specified in the URL is not valid.

Check that the URL contains the correct stack name. If so, ensure that the stack is available on the system and that it is active.

The TCP/IP stack specified in the URL cannot be initialized.

Ensure that the TCP/IP stack specified is correct and that it is active. If it is correct and active, contact the systems administrator.

ADATCP is unable to allocate the necessary storage.

Ensure that adequate storage is available on the system.

The operating system specified in the URL is incorrect.

The only operating systems currently supported are OE, Interlink, and HPS.

The TCP/IP stack specified in either the URL or the protocol that was used is invalid.

Check that the URL or protocol contains the correct stack name. If so, ensure that the stack is available on the system and that it is active.

The system is unable to create a new socket. This may be caused by an incorrect stack. If an error number accompanies this message, it will inform you if the problem is inadequate system resources (ENOBUFS) or access denied (EACCES).

Ensure that the correct stack is being used. If the problem is inadequate system resources, contact your systems administrator. Contact your security administrator for system access problems.

ADATCP was unable to bind the socket to the local system. Another application may be using the port specified in the URL.

Use the "Tso netstat" command to check current use of the specified port. If something else is using the port, terminate ADATCP and change the port in the URL.

ADATCP is unable to accept connections from client applications. This may indicate a shortage of buffer space or that the maximum number of socket descriptors have already been created/opened.

Ensure that adequate buffer space is available to the system. If necessary, increase the maximum number of sockets available to the system.

ADATCP is unable to listen for new connections. This usually indicates that the system resources available to complete the call are inadequate. If an error number is supplied with this message, it will help to identify the problem.

If system resources are inadequate, contact your systems administrator.

An attempt to allow currently used local addresses to be bound failed. This may indicate inadequate system resources. If an error number is supplied with this message, it will help to identify the problem.

If system resources are inadequate, contact your systems administrator.

ADATCP was unable to give control of a socket to a different process. This error occurs only if there is a problem with the socket itself. If an error number is supplied with this message, it will help to identify the problem.

The system was unable to create a new thread. This indicates inadequate system resources or memory to create the thread.

Contact your systems administrator.

ADATCP attempted to close a socket that was being used by another thread in the same process. This occurs only when the system is terminating due to some other error.

Check the console for other messages.

ADATCP was unable to allocate storage. This may indicate that inadequate storage is available on the system.

Contact your systems administrator.

ADATCP cannot receive data from a client. This may indicate that the connection between ADATCP and the client has been severed during a transaction or that system resources are inadequate to complete the call. The error number supplied with this message will identify the problem.

Contact your systems administrator.

The process that send requests to and from Adabas was unable to take control of the socket that was passed to it by the listening task.

Check the error number and the return code that accompany this message.

The main request task is unable to set the cancel type for the thread that is currently running.

Check the error number and the return code that accompany this message.

ADATCP is unable to send data from a client. The error number issued with this message indicates whether the problem is a severed connection between ADATCP and the client or insufficient system resources to complete the call.

Check the error number issued with this message.

ADATCP attempted to close a socket while it was being used by another thread in the same process. This occurs if the system has tried to terminate due to another error.

Check for other messages issued to the console.

The number of connections has reached a predefined limit; no entries can be added to the user context table.

Increase the ADARUN NU parameter value to the required number of entries and restart ADATCP.