AEO Messages

#### Search Results

Search

# AEO Messages

This chapter lists the error messages of Adabas Extended Operation (AEO). The messages are accompanied by explanations and suggested actions to recover from these errors.

There are two formats of Adabas messages:

1. Adabas messages with a header
   These messages have the general format: %utility name-severity-message id text,
   for example: %ADANUC-I-STARTED, 24-NOV-2001 12:06:38, Version 3.2

2. Adabas messages without a header
   These messages have the general format: text
   for example, the output of adaopr dbid=<dbid>:
   Database dbid, startup at 24-NOV-2001 11:37:00
   ADANUC Version 3.2, PID 12107

Adabas messages with a header begin with the character "%".

An Adabas message can have one of the following severities:

I = Information, W = Warning, E = Error, F = Fatal Error

Messages without a header have the default severity I (Information). The Adabas message ID is a unique identifier for messages. There is no message ID for messages without a header. The text part of an Adabas error message is a short but descriptive formatted text.

%<utility>-I-AXACT, start action=<topic name>, ROUTINE=<action routine>
Explanation | Every time an Adabas action is started, the message AXACT is written to standard output and is logged. Example: %ADANUC-I-AXACT, start action=ADANUC_STARTED, ROUTINE=ada_nsta.
Action | None required

%ADANUC-<I | W | E | F >-CMDLOG1, FNR=<fnr>, RSP=<response code>, CMD=<command>, COP=<command options>, AD2=<additions 2>, AD2(HEX)=<additions 2 in hex format>
Explanation | The messages CMDLOG1 and CMDLOG2 log Adabas commands whose return code is neither 0 nor 3. The severity is variable and depends on the Adabas return code. This message is logged but not written to standard output. Refer to Response Codes that create a CMDLOG Message in Appendix A for more information. Example:
    %ADANUC-W-CMDLOG1,  FNR=999, RSP=17, CMD=L1, COP=  , AD2=...., AD2(HEX)=00000500
Action | None required

%ADANUC-< I | W | E | F >-CMDLOG2, ISN=<isn>, ISQ=<ISN quantity>, UID=<user id>, NID=<node id>, TID=<login id>, TH=<thread>
Explanation | The messages CMDLOG1 and CMDLOG2 log Adabas commands whose return code is neither 0 nor 3. The severity is variable and depends on the Adabas return code. This message is logged but not written to standard output. Refer to the section Response Codes that create a CMDLOG Message in Appendix A for more information. Example:
    %ADANUC-W-CMDLOG2,  ISN=1, ISQ=0, UID=        , NID=PCWO02  , TID=miller/3, TH=3
Notes: UID is the user ID specified in the corresponding OP command. If no Adabas session is active because no OP command was issued and option OPEN_REQUIRED is set, "********" is displayed. If a session is active, but no user ID was specified in Additions 1 of a corresponding OP command, blanks are displayed. TID contains the login ID of the client program. In the case of multi-threaded applications, this is valid only for the first thread of the application doing Adabas calls; in other threads, the last bytes of the field are overwritten by a thread counter, for example TID="miller/3". This can result in overwriting parts of the login ID. The values of NID and TID may have been set to different values if lnk_set_user_id was called in the client program. TH is the number of the Adabas worker thread that processed the Adabas command. Some Adabas commands are not transferred to the Adabas nucleus and the Adabas response code is generated directly in the ADALNK modules. For these Adabas commands, no messages CMDLOG1 and CMDLOG2 are generated.
Action | None required

%<utility>-< I | W | E | F >-CPBFREE, free entries in checkpoint block=<n>
Explanation | The message CPBFREE logs free entries in the checkpoint block (see: Offline Checkpoints). The severity is variable and depends on the definition of the item MESSAGE in the topic OFFLINE_CHECKPOINTS. This message is logged but not written to standard out. Example: If MESSAGE=(I=50,W=20,E=5,F=2) and the number of free entries=19: %ADAMUP-W-CPBFREE, free entries in checkpoint block = 19
Action | None required

%<utility>-I-CRIPC, TYPE=<IPC type>, NAME=<IPC name>, SIZE=<size>
Explanation | If a utility creates IPC (Interprocess communication) resources, the message CRIPC is logged. The severity is I (Information). This message is logged but not written to standard output. Possible IPC types are: M = shared memory S = semaphore Q = message queue Example: %ADANUC-I-CRIPC, TYPE=M, NAME=0xada0004d, SIZE=913416
Action | None required

%<utility>-< I | W | E | F >-DBFREE, TYPE=<container type>, EXTEND-COUNT=<count>, SIZE=<size in KB>, FREE=<free space in KB>, %FREE=<free space rate in %>
Explanation | Possible container types are ASSO and DATA. Every time a database file is extended, the remaining free space of ASSO and DATA is calculated. These values are compared with the MESSAGE definition of INCREASE_ASSO or INCREASE_DATA as appropriate. If the remaining free space ratio is less than or equal to one of these message values, the message DBFREE is logged with the associated severity. You can also use the function "adarep dbid=<dbid> free" to perform this calculation. This message is logged but not written to standard output. The extent count shows the number of allocated ASSO or DATA containers. Example: %ADANUC-I-DBFREE, TYPE=DATA, EXTENT-COUNT=3, SIZE=40000 KB, FREE=5320 KB, %FREE=13,30
Action | None required

% ADASTA-W- DBSTART, ADASTARTPORTNUMBER is missing in DBINI file, but it is strongly rec-ommended
Explanation | Adastart requires a port number to connect to the nucleus in order to receive the progress reportit takes the port number for the connection from the DBXXX.ini file under the `ADASTARTPORTNUMBER` parameter of the NUCPARMS topic. If this parameter is not set, adastart connects via the port number the operating systems provides.
Action | Set the `ADASTARTPORTNUMBER` in DBXXX.ini. Example: adaini dbid=$dbid add topic=NUCPARMS item=ADASTARTPORTNUMBER=XXXXX

%<utility>-I-DD, <logical file name>=<physical file name>
Explanation | Every time a container or sequential file is opened, a DD message logs this information. The severity is always I (Information). This message is logged but not written to standard output. Example (PC platforms): %ADANUC-I-DD, ASSO1 = %ADADATADIR%\db<nnn>\ASSO1.<dbid> Example (Linux): %ADANUC-I-DD, ASSO1 = /dev/rdsk/c13d0s2
Action | None required

%<utility>-I-FEXT, extend FNR=<fnr>, TYPE=<extent type>, COUNT=<extent count>, SIZE=<extent size in MB> (<number of blocks> * <blocksize>)
Explanation | If a database is extended, the message FEXT is logged. The severity is I (Information). This message is logged but not written to standard output. The extent count shows the number of allocated extents for this extent type (e.g. if the third DATA extent is allocated, COUNT=3). Possible extent types are AC, NI, UI and DATA. Example: %ADANUC-I-FEXT, EXTEND FNR=31, TYPE=DATA, COUNT=3, SIZE=6,63 MB (1697 * 4096 Bytes)
Action | None required

%<utility>-< I | W | E | F >-FIFREE, FNR=<fnr>, TOPISN=<topisn>, MAXISN=<maxisn>, NI=<number of NI extents>, UI=<number of UI extents>, AC=<number of AC extents>, DS=<number of DS extents>
Explanation | Every time an database file is extended, the number of extents is compared with the definition of the item MESSAGE of the topic REORDER_FILE. If the extent count is greater than or equal to one of these message values, the message FIFREE is logged with the associated severity. You may use also the function "adarep dbid=<dbid> content" to perform this calculation. This message is logged but not written to standard output. The format of this message is: Example: %ADAMUP-I-FIFREE, FNR=12, TOPISN=110807, MAXISN=500000, NI=5, UI=2, AC=2, DS=3
Action | None required

%<utility>-E-INVVAL, ADASTARTPORTNUMBER in DBINI file cannot be 0. Please provide correct Port number
Explanation | `ADASTARTPORTNUMBER` is set to value 0 in DBXXX.ini file, which is not accepted.
Action | Update the `ADASTARTPORTNUMBER` to a value not equal to zero. A valid value is 1024 – 65535, also the port must not be in use already.

%ADANUC-< I | W | E | F >-INCNUCP, nucleus parameter=<parameter name>, current size=<current size>
Explanation | If a nucleus parameter is too small and an Adabas command aborts, the message INCNUCP is logged. The severity is variable and depends on the definition of the item MESSAGE in the topic INCREASE_<nucleus parameter>. Remark: A value of 101% in one of the parameters of the item MESSAGE indicates that INCNUCP will only be logged if the parameter overflows. This message is logged but not written to standard output. Refer to the section Response Codes resulting from insufficient parameter size in Appendix B for more information. Example: for MESSAGE=(I=50,W=80,E=101): %ADANUC-E-INCNUCP, nucleus parameter=NU, current size=500
Action | None required

%<utility>-I-INP, <parser input>
Explanation | Every time a parameter is parsed by an Adabas utility, a INP message logs this information. The severity is always I (Information). This message is logged but not written to standard output. Example: %ADAINV-I-INP, reinvert = *
Action | None required

%<utility>-W-INVCTRL, invalid definition: TOP1=<topic name level 1>, TOP2=<topic name level 2>, ITEM=<item name>, VALUE=<item value>
Explanation | Every Adabas utility reads the ADABAS.INI initialization file when it is started. After the utility parameter `DBID` is parsed, the initialization file DBnnn.INI is also read, where nnn is the database number. If there is a configuration error in one of these files, the message INVCTRL is logged and the associated topic is disabled. This message is logged but not written to standard output. Example: %ADAOPR-W-INVCTRL, invalid definition: TOP1=DB_PARAMETER, TOP2=ADANUC_STARTED, ITEM=ACTION, VALUE=XYES
Action | None required

%<utility>-F-IPCERR, TYPE=<IPC type>, NAME=<IPC name>, SIZE=<size>, SYSFCT=<system function>, ERRNO=<error number>, ERRTXT=<error text>
Explanation | If an error occurs while a utility creates IPC (Interprocess communication) resources, the message IPCERR is logged. The severity is F (Fatal). This message is logged but not written to standard output. Possible IPC types are: M = shared memory S = semaphore Q = message queue SYSFCT shows the C system function which is used to create the resource. ERRNO shows the system error number and ERRTXT shows the associated system error text. Example: %ADANUC-F-IPCERR, TYPE=M, NAME=0xada0004d, SIZE=913416, SYSFCT=shmget, ERRNO=12, ERRTXT=Not enough core
Action | None required

%<utility>-E-SOCKERR, Error while performing Binding
Explanation | An error happen during binding, typically occurs when specified port is already in use. %<utility>-I-ERROR will provide the information of the error. Example: %ADASTA-I-ERROR, Port XXXX is already in use %ADASTA-E-SOCKERR, Error while performing Binding
Action | None required

%<utility>-E-SOCKERR, Invalid port number provided, Valid value- 1024 - 65535
Explanation | `ADASTARTPORTNUMBER` is set to invalid value in DBXXX.ini file, which is not accepted.
Action | Update the `ADASTARTPORTNUMBER` to a value not equal to zero. A valid value is 1024 – 65535, also the port must not be in use already.

%<utility>-W-CLURDLY, Cluster related configuration is partially present, Database started as readonly non-cluster node
Explanation | Cluster-related files are present when opening database.
Action | Either remove all of the files using the `adadbm` command to convert cluster nodes to standalone ones, or put cluster-related nucleus parameters to start nodes as cluster nodes. Note: Cluster nodes do not support the read-only option. For more information on generating a standalone database from a cluster node, see Setup Cluster Node as Single Database in the Adabas Clusterdocumentation.