Altierr
altierr#
About altierr#
altierr searches for and displays detailed descriptions of Altibase server errors. Errors can be looked up using the error number, or a character string can be used as a search term and sought for within the error messages.
altierr {-w keyword pattern | [-n] error number}
Syntax#
Parameters#
| Parameter | Description |
|---|---|
| -w | Searches for error messages containing the specified search term. All error messages that contain the search term will be displayed. |
| -n | Searches for an error corresponding to the specified error code number. The error code number can be a hexadecimal number, a positive integer, or a negative integer. Only the record that matches the error code number, if any, will be displayed. When searching for an error using the error code number, the numeric parameter indicator (-n) can be safely omitted. |
Description#
altierr searches the Altibase errors for strings that contain the specified error message or that match the specified error code number and displays the detailed description of any error that is found. The detailed description of the error includes the error code number, the error code string, the description, the cause of the error, and the action that the user must take in order to remedy the error. When an error occurs, the Altibase server writes the corresponding error code to altibase_boot.log in the following format:
ERR-error code
altierr can be used to search for the detailed description using either a hexadecimal or decimal error code, as shown below:
For 'ERR-00015'
$ altierr 0x00015
$ altierr -w 00015
$ altierr 21
When SQL-related errors occur in applications written using the C/C++ precompiler or applications that use ODBC, the error code will be set in the SQLCODE variable, or will be returned by the ODBC function. In these cases, the error code will be a negative integer. To search for the description of the corresponding error, use altierr as follows:
For -266286
$ altierr -266286
$ altierr 266286
$ altierr 0x4102E
altierr can be used to search the text of error messages for a search term. In this case, multiple records may be returned. Use a character string as a search term for searching the text of error message descriptions as follows:
$ altierr -w connect
$ altierr -w "does not"
References#
Please refer to the Altibase Error Message Reference.