Xbasic

Handling Errors

IN THIS PAGE

How to Structure an Error Handler
Other Error Messages

Description

An important part of writing any program is handling potential errors properly. You should do the same when writing an Xbasic script, making sure it can recover from some common run-time errors (e.g., when a file is not found, the disk is full, or the table is opened exclusively by another session or user).

To react appropriately to specific run-time errors, you can use the ERROR_CODE_GET() and ERROR_TEXT_GET() functions to obtain the error code and error message returned by the most recent run-time error. Use these functions in an error handling routine (established by an ON ERROR GOTO statement) to compare the error code against one or more of the possible error codes that might occur.

User-defined error messages should have a number in the range 20000 to 24999.

How to Structure an Error Handler

For example, the general format of your error handler might be as follows:

error_handler:
    err = error_code_get()
    select
        case err = 800
            resume next
        case err = 801
            resume next
        ...
        case else
            msg = error_text_get(err)
            ui_msg_box("Error", msg, UI_ATTENTION_SYMBOL)
            end
    end select
end

Each CASE of the SELECT statement is for a different error. If an error occurs for which you have not included a CASE, a default message box will display the error message and then end the script.

The following table displays run-time error codes and their corresponding error messages:

Error Code: Error Text
800: Expression is missing right parenthesis
801: Improper character
802: Missing operand
803: String constant is incomplete
804: Missing operator
805: Comma expected for function's next argument
806: Function is missing left parenthesis
807: Function is missing right parenthesis
808: Function returns incorrect type of data
809: Operand is of incorrect type
810: Invalid decimal point encountered
811: Invalid exponent encountered
812: Invalid sign encountered
814: Invalid operand
815: Missing function, name or value
816: Expression too complex - maximum RP length exceeded
817: Memory corrupt - please terminate program
818: Invalid date constant
819: Invalid logical constant (must be ".T." or ".F.")
820: Invalid field name
821: Invalid function
822: Invalid date/time format
900: RP corrupt - please terminate program
901: Operator can't be used with this data
902: Operation returns string which exceeds maximum length
903: Value of argument is out-of-range
904: Divide-by-zero error
905: Invalid number of arguments in CASE
906: Invalid lookup field specified
907: Invalid lookup type specified
908: <Eval Escape>
1000: The filename, directory name, or volume label syntax is incorrect. <NUL>.DDD
1001: Invalid AE error code
1002: No such table
1003: No such field
1004: Out of memory
1005: Invalid number of fields
1006: Maximum open tables exceeded
1007: Invalid table handle
1008: Invalid field handle
1009: Not an open table
1010: Not an open memo
1011: Record number is past end of table
1012: Alias name already in use
1013: Alias required
1014: Unable to generate alias
1015: Defined record is too long
1016: Environment is already initialized
1017: Environment has not been initialized
1018: Field isn't memo type
1019: Field contains invalid memo data
1020: Invalid memo type
1021: Invalid index type
1022: Not supported for this index type
1023: Maximum number of indexes attached
1024: Invalid key length
1025: Expression too long
1026: Missing required expression
1027: Not an open index
1028: Filter expression not logical
1029: One or more records not found
1030: Invalid block number
1031: Read past end of file
1032: Inexact match
1033: That range is not currently active
1034: Not a valid index handle
1035: Attached range uses that index
1036: That relation is not currently active
1037: Relation corrupt
1038: Table already has a parent relation
1039: Table has too many child relations
1040: Invalid relation type
1041: Table has active relation(s)
1042: Table out of memory for entries
1043: Not a valid entry handle
1044: Could not create temporary file
1045: Entry list corrupt
1046: Invalid entry type
1047: Default table not set correctly
1048: Invalid fetch mode
1049: Index corrupt
1050: Parent table restricted: refetching
1051: Active relation uses that index
1052: Sibling 1-to-many relation fulfilled
1053: Relation exhausted
1054: Reserved table handle
1055: ASX search can't match relation(s)
1056: Search list file corrupt
1057: Key search unsupported
1058: Fetch completed successfully
1059: Change already began
1060: Change must begin first
1061: For integrity, use parent field name
1062: For integrity, use child field name
1063: Integrity can't use mismatched types
1064: Integrity can't use mismatched widths
1065: Memory corrupt - terminate operations
1066: Field rule already exists
1067: Invalid field value
1068: Entry is not a display entry
1069: Data value cannot fit into a numeric field of size
1070: Reserved DBs are restricted
1071: Invalid field type
1072: Invalid rule type
1073: Invalid value (via field rule)
1074: Table has no records
1075: Table in use by another user or window
1076: Corrupt arena
1077: Heap lock failure
1078: No tags specified for compound index
1079: Unable to create compound index
1080: It is possible that your indexes have become corrupted. Try to update indexes by right-clicking on the table in the Control Panel and choose the Update Indexes command.
1081: Unable to drop key from tag
1082: Unable to open compound index
1083: Unable to update compound index
1084: Unable to resync on index
1085: Can't put to calculated field
1086: Non-unique key
1087: Enter already began
1088: Enter must begin first
1089: RI error: parent table is entering
1090: RI error: child table is entering
1091: Field types don't match
1092: Invalid byte count
1093: Invalid query specified
1094: Ordering child tables not permitted
1095: Invalid data-type for this operation
1096: Permission denied
1097: Can't add tag to compound index
1098: Can't drop tag from compound index
1099: Invalid summary field type
1100: Recursive recalculation occurred
1101: User break
1102: Invalid file name
1103: File not found
1104: File already exists
1105: Out of disk space
1106: Must be in CHANGE or ENTER mode
1107: Must specify a linking expression
1108: Can't update field in primary index
1109: Unable to find or open memo file
1111: ODBC deferred
1112: Property not found
1113: Member property does not exist
1114: Property is write only
1115: Property is read only
1116: Property cannot be enumerated
1117: Not supported for ODBC data source
1118: Internal error; cannot recover
1119: Variable not found
1120: Variable type mismatch: Cannot assign data of type 'C' to variable of type 'P'.
1121: Variable already typed
1122: Array index out of bounds
1123: Variable handle bad
1124: Variable frame bad
1125: Memory allocation error
1126: Memory free error
1127: Internal memory handler error
1128: Attempt to assign to constant
1129: Attempt to redefine constant to another value
1130: Property doesn't exist
1131: Property not found
1132: Property system not initialized
1133: Property type mismatch
1134: Table not in change or enter mode
1135: Cannot close the main table for the session
1136: Cannot close table because it was not opened by a script.
1137: A structure definition differs between the engine and its caller.
1138: Corrupt index detected - perform a rebuild.
1139: Registration key invalid.
1140: Tagname not found.
1141: Attempt Asynchronous execution from foreground.
1142: Attempting to access closed file.
1143: Table is encrypted using a different key.
1144: Change begin with invalid record number.
1145: Change on ODBC table via SQL required unique key field(s). None defined in driver.
1146: An unhandled exception was generated.
1147: Attempt to assign to typed property
1148: Attempt to redefine a typed property to another value
1149: Method provides as prototype only
1150: Attempt to execute UI from background thread
1151: Attempt to execute modal UI from background thread
1152: Array dimension out-of-bounds
1153: Array too big
1154: Invoke the table mapper
1155: Invoke the backend mapper
1156: Cause prop_get to get invoked again with the full path.
1157: Could not add record because auto-increment field has reached maximum value. Restructure table and increase field size.
1158: File use legacy OLE.
1159: File use file system library.
1160: Maximum variables exceeded.
1161: Flow call not done.
1162: Main call not done.
1163: Array need dimension.
1164: Not supported
1165: Maximum session open tables exceeded
1166: Call was canceled
1167: Method not found
1168: Null pointer
1169: File is not a recognized DBF format
1170: Field is not bound
1171: Error compressing
1172: Compression version not recognized
1173: Error decompressing - data is corrupt
1174: Enter is not allowed on this table
1175: Changes are not allowed on this table
1176: Deletes are not allowed on this table
1177: Timeout
1178: Index recycled
1179: Index argument missing for one or more array dimensions
1180: Index argument count exceeds the number of array dimensions
1181: Index argument provided, but variable is not an array
1182: Array indices must be integer numeric
1183: Excel file format not recognized
1184: Cannot access private member of class
1185: Cannot access protected member of class
1186: Function is not supported without a desktop user interface.
1187: Maximum number of sessions allowed would be exceeded
1188: Clone prohibited
1189: Clone must be done via method
1190: Shallow copy
1191: Variable is not an array
1192: You have passed a constant value to a function that takes the argument by reference, meaning that it might try to change the value.
1193: The offset into the memory block is either a negative number or greater than the length of the block.
1194: The length specified is either zero, negative or would include memory that is beyond the length of the block when combined with offsets specified.
1195: The memory block is not set (has a null pointer).
1196: The memory block is empty.
1197: No source file name was provided while copying a file section.
1198: No destination file name was provided while copying a file section.
1199: Source file not found while copying a file section.
1200: Offset is greater than the length of the file while copying a file section.
1201: UI is disabled
1202: Cannot create a new thread because of insufficient memory.
1203: Character data does not have valid UTF8 encoding.
1204: Application domain context is not initialized.
1209: File offset is to big.
1210: File is corrupt
1211: Expression is Empty
1212: Dynamic Errors are not available.
1213: Error processed in wrong context.
1214: Top thread state is unexpectedly null.
1215: Property RRequires Arguments.
1216: Expected Array.
1217: Type not found.
1500: Expected value.
1501: Bad expression character
1502: Extra right parentheses
1503: Missing right parenthesis
1504: Extra characters at end of expression
1505: Internal token space overflow
1506: Internal operand stack full
1507: Argument is incorrect data type
1508: Field is not recognized
1509: Function: 'htmlescape' was not recognized
1510: Binary operator is not recognized
1511: Unary operator is not recognized
1512: Invalid Date/ Time or GUID value
1513: Internal token memory corrupt
1514: Execution stack is full
1515: Too many parameters
1516: Too few parameters
1517: Too many installable token handlers
1518: Internal token handler stack underflow
1519: Argument is incorrect data type
1520: Result stack overflow
1521: Result stack underflow
1522: Expression too complex
1523: Recursive reference detected
1524: The number of arguments or the type of one or more arguments do not match any existing function.
1525: Parameter out of range
1526: Internal - nested use of non-nested parameter
1527: Cannot use function in this context
1528: Installed type is already defined
1529: Installed type not found
1530: Too many installed data types
1531: Empty expression
1532: Cannot assign value
1533: Argument is incorrect data type (NIL)
1534: Token array no args
1535: Token array prior args
1536: Argument is incorrect data type (EXTERNAL)
1537: Type not defined for type 'helper::AdbObject::GetDefault'
1538: Requested object is a name space and can not be created as an instance
1539: Result stack data overflow
1540: RP element IFERROR
1541: Internal error. Alpha Anywhere version not set.
1542: Array element type is not defined.
1543: Unexpected exception getting array element type from .Net type.
1544: Unexpected character chr(27192620) '¤' encountered
1601: SSH Tunnel - Unexpected error initializing SSH library.
1602: SSH Tunnel - Unexpected error initializing session object.
1603: SSH Tunnel - SSH2 library session error
1604: SSH Tunnel - SSH2 library shutdown error
1605: SSH Tunnel - Password authentication is not supported for this user and server.
1606: SSH Tunnel - Public key authentication is not supported for this user and server.
1607: SSH Tunnel - Unexpected exception accepting connection.
1608: SSH Tunnel - SSH2 library error accepting connection.
1609: SSH Tunnel - SSH2 library error sending data.
1610: SSH Tunnel - SSH2 library error listening for channel forwarding.
1611: SSH Tunnel - SSH2 library error writing to channel.
1612: SSH Tunnel - SSH2 library error reading from channel.
1613: SSH Tunnel - SSH2 library error authenticating using public key method.
1614: SSH Tunnel - SSH2 library error authenticating using password.
1615: SSH Tunnel - SSH2 library error during session handshake.
1616: SSH Tunnel - SSH2 library error opening channel to SSH2 server.
1617: SSH Tunnel - Cache entry not found.
1618: SSH Tunnel - Unable to start any threads.
1619: SSH Tunnel - Fingerprint does not match.
1701: Unable to read certificate file for Secure Sockets Layer. Certificate must be X.509 format.
1702: Unable to read private key file for Secure Sockets Layer.
1703: Unable to verify Certificate Authority Locations for Secure Sockets Layer.
1704: Cipher list is not a valid format while initializing Secure Sockets Layer context.
1705: Error setting context session id while initializing Secure Sockets Layer context.
1706: Error setting verification option while initializing Secure Sockets Layer context.
1707: Error setting DH parameters while initializing Secure Sockets Layer context.
1708: Error setting RSA Key while initializing Secure Sockets Layer context.
1709: Error opening certificate file while generating self signed server certificate.
1710: Error setting country code into certificate while generating self signed server certificate.
1711: Error setting common name into certificate while generating self signed server certificate.
1712: Error setting issuer name into certificate while generating self signed server certificate.
1713: Error signing certificate while generating self signed server certificate.
1714: Error creating certificate while generating self signed server certificate.
1715: Error opening private key file while generating self signed server certificate.
1716: Error reading private key file while generating self signed server certificate.
1717: Error setting version file while generating self signed server certificate.
1718: Error setting region/state into certificate while generating self signed server certificate.
1719: Error setting organization into certificate while generating self signed server certificate.
1720: Error setting organizational unit into certificate while generating self signed server certificate.
1721: Error allocating private key while generating self signed server certificate.
1722: Error opening request file while generating server certificate request.
1723: Error setting country code into request while generating server certificate request.
1724: Error setting common name into request while generating server certificate request.
1725: Error setting issuer name into request while generating server certificate request.
1726: Error signing request while generating server certificate request.
1727: Error creating request while generating server certificate request.
1728: Error opening private key file while generating server certificate request.
1729: Error reading private key file while generating server certificate request.
1730: Error setting version file while generating server certificate request.
1731: Error setting region/state into request while generating server certificate request.
1732: Error setting organization into request while generating server certificate request.
1733: Error setting organizational unit into request while generating server certificate request.
1734: Error allocating private key while generating server certificate request.
1735: Error allocating key structure while creating private key.
1736: Error generating key while creating private key.
1737: Error assigning key while creating private key.
1738: Error opening output file while creating private key.
1739: Error writing key to file while creating private key.
1740: Error opening private key file.
1741: Error allocating memory to load private key.
1742: Error reading private key file.
1743: Error creating private key. Key length must be 512, 1024 or 2048 bits.
1744: Error reading certificate chain file.
1745: Private key does not match certificate private key.
1746: Private key password does not match.
1747: Error decrypting string. Is your pass phrase correct?
1748: Error encrypting string.
1749: Error setting email into certificate while generating self signed server certificate.
1750: Error setting email into request while generating server certificate request.
1751: Secure Sockets Layer Context - Error disabling SSL compression.
1752: Secure Sockets Layer Context - Error setting cipher server preference.
1753: Secure Sockets Layer Context - Failed to get EC Curve.
1754: Secure Sockets Layer Context - Failed to get DH Params.
1755: Error setting subject alternate name while generating self signed server certificate.
1756: Error adding extensions while generating self signed certificate.
1757: Error setting subject alternate name while generating certificate request.
1758: Error adding extensions while generating certificate request.
1759: Error reading certificate file.
1760: Error writing certificate file.
1761: Secure Sockets Layer Context - Unexpected exception.
1762: Secure Sockets Layer Context - Error creating certificate file.
1763: Secure Sockets Layer Context - Unable to create PKCS12 object.
1764: Secure Sockets Layer Context - Unable to open PKCS12 file for writing.
1765: Secure Sockets Layer Context - Unable to write PKCS12 object to file.
1766: Secure Sockets Layer Context - Unable to allocate certificate stack for intermediate certificates.
1767: Secure Sockets Layer Context - The chain file is empty.
1768: Secure Sockets Layer Context - Unable to set alternate issuer name while generating self signed server certificate.
1801: Secure Sockets Layer was not able to verify certificate.
1802: Secure Sockets Layer host name does not match certificate host name.
1803: Secure Sockets Layer connect error.
1804: Secure Sockets Layer shutdown error.
1805: Secure Sockets Layer not connected.
1806: Secure Sockets Layer write error.
1807: Secure Sockets Layer read error.
1808: Secure Sockets Layer flush data error.
1809: Secure Sockets Layer accept error.
1810: Secure Sockets Layer the connection was closed prematurely.
1811: Secure Sockets Layer timeout waiting to read data.
1812: Secure Sockets Layer internal error - NULL pointer.
1813: Secure Sockets Layer OpenSSL Error
1814: Secure Sockets Layer OpenSSL Error - WANT_READ
1815: Secure Sockets Layer OpenSSL Error - WANT_WRITE
1816: Secure Sockets Layer OpenSSL Error - WANT_X509_LOOKUP
1817: Secure Sockets Layer OpenSSL Error - SYSCALL
1818: Secure Sockets Layer OpenSSL Error - ZERO_RETURN
1819: Secure Sockets Layer OpenSSL Error - WANT_CONNECT
1820: Secure Sockets Layer OpenSSL Error - WANT_ACCEPT
1821: Secure Sockets Layer OpenSSL Error - Unrecognized OpenSSL return code
1822: Secure Sockets Layer OpenSSL Error - Exception during SSL shutdown
1823: Secure Sockets Layer OpenSSL Error - Exception during IO BIO free
1824: Secure Sockets Layer OpenSSL Error - Exception during SSL BIO free
1825: Secure Sockets Layer OpenSSL Error - Exception during SSL free
1826: Secure Sockets Layer OpenSSL Error - Exception during socket close
1827: Secure Sockets Layer OpenSSL Error - Exception during accept
1828: Secure Sockets Layer OpenSSL Error - Timeout waiting for handshake data
1901: Error calling select for readable sockets
1902: Error calling select for writable sockets
1903: Error calling select for error sockets
1904: Unexpected socket implementation error
1905: Unexpected sockets error
1906: Socket error connecting
1907: Socket error getting host name
1908: Timeout getting host name
1909: Thread error getting host name
1910: Accept called for socket that is not listening
1911: Invalid handle opening socket
1912: Socket is not open
1913: Wrong version while initializing sockets
1914: Can't get TCP Table
1915: Socket is not writable
1916: Socket timeout connecting to host
1917: Socket file not found in SendFile
1918: Socket timeout reading data. No data was available to read within the timeout interval.
1919: Socket timeout reading data. Some data was available, but the read was incomplete within the timeout interval.
1920: Socket error reading chunked data length. The value read is not a valid hexadecimal string.
1921: WSAETIMEDOUT - Socket error accepting new connection. Accept timed out.
2000: DOS error
2001: Invalid AL error code
2002: Out of memory
2003: Unable to change DS to CS
2004: Unable to lock down global memory
2005: External memory manager arena corrupt
2006: External memory manager gave bad head
2007: Invalid variable name
2008: Variable/array-variable mismatch
2009: Array index out-of-bounds
2010: Invalid array size
2011: Invalid variable type
2012: Variable session already underway
2013: (null)
2014: Variable session wasn't initialized
2015: Array variable was identified
2016: Internal memory corrupt
2017: Missing variable pointer
2018: Source module too long
2019: Couldn't create executable that long
2020: Command-table corrupt
2021: Left-side value can't be function
2022: Invalid left-side value
2023: Left-side value can't be constant
2024: Variable defined with different type
2025: Can't assign value to reserved DB
2026: Variable type mismatch: attempt to pass data of type 'P' to argument 'path_name ' is of type 'C'.
2027: Conflicting expression data types
2028: Missing variable or field-name
2029: Missing expression
2030: Missing or invalid keyword
2031: Missing or invalid symbol
2032: Can't locate that symbol
2033: Fixup address out-of-range
2034: Symbol address out-of-range
2035: Symbol multiply defined
2036: Invalid command, function, expression
2037: Can't use command in loop or if-block
2038: Mismatched end of loop or if-block
2039: Max loop or if-block nesting exceeded
2040: Command is meaningless or redundant
2041: Missing NEXT command
2042: Missing END IF command
2043: Missing END SELECT command
2044: Missing END WHILE command
2045: Missing END FUNCTION command
2046: Missing END WITH command.
2047: Missing END TYPE command.
2048: Missing END CLASS command.
2049: Missing END ENUM command.
2050: (null)
2051: Illegal SUB or FUNCTION definition
2052: Executable file is too large
2053: Executable file has been truncated
2054: Not an executable file
2055: Executable file has wrong version
2056: <Go>
2057: <Trace>
2058: <Step>
2059: <Breakpoint>
2060: Invalid file handle
2061: Too many files open in session
2062: Can't read that many bytes
2063: Can't write that many bytes
2064: Too many tables open in session
2065: No primary table for this session
2066: ZAP safety set to '.F.'
2067: Invalid number of DB_CREATE fields
2068: Invalid DB_CREATE field name
2069: Invalid DB_CREATE field width
2070: Invalid DB_CREATE field decimal-places
2071: Invalid DB_CREATE field type
2072: Specified index isn't attached
2073: <IMM escape>
2074: Not valid in immediate mode
2075: Function can not have subscript
2076: Argument can not have subscript
2077: Maximum number of arguments exceeded
2078: Maximum number of UDFs exceeded
2079: Maximum number of functions exceeded
2080: <UDF escape>
2081: Maximum stack depth exceeded
2082: Stack underflow occurred
2083: Can't exec memory with NULL buffer
2084: Use DB_CREATE_BEGIN first
2085: Create underway, use DB_CREATE_END
2086: Invalid field name
2087: Create underway, use INDEX_CREATE_END
2088: Use INDEX_CREATE_BEGIN first
2089: Invalid tag name
2090: Invalid tag qualifier (use <C><D><U><N><X><M>)
2091: Can't define another breakpoint
2092: No such script in data-dictionary
2093: Table structures not equivalent
2094: <CRD escape>
2095: Script hasn't finished executing yet
2096: Structure element missing
2097: Structure element is wrong type
2098: Must specify something to search for
2099: Not found
2100: Can't open that database
2101: ERASE safety set to '.F.'
2102: Invalid argument
2103: Maximum evaluation recursion exceeded
2104: Maximum evaluation reentry exceeded
2105: Invalid operation specified
2106: Structure element has no value
2107: Invalid match case
2108: Linking keys' types must match
2109: Field- and expression-types must match
2110: Could not load that saved setting
2111: Could not load that saved layout
2112: Invalid INCLUDE directive arguments
2113: (null)
2114: Maximum INCLUDE nesting exceeded
2115: Failed INCLUDE operation
2116: Failed SUMMARY operation
2117: Couldn't find/load external library
2118: Couldn't find external function
2119: Can't assign to read-only variable
2120: Program stopped
2121: <Yield>
2122: Index doesn't belong to specified table.
2123: Command does not work in change or enter mode.
2124: Alpha Anywhere is unable to reset the current table from within a card. A Table reset may be done from a script that is run using the new script_spawn() command.
2125: This layout does not allow data to be changed
2126: Named modeless dialog not found
2127: Form or Browse not in View mode. Cannot resynchronize.
2128: Missing tagged string end construct.
2129: Declared record length is smaller that the last field offset + width.
2130: Execution on command not permitted at execution level.
2131: <Switch Threads>
2132: <Return Thread>
2133: AEX already open
2134: Table open mode not allowed
2135: Cannot open in specified mode
2136: Switch the parent's thread
2137: <BREAKOUT>
2138: No open MYSQL connection.
2139: No open MYSQL result_set.
2140: Table row has not been completed.
2141: Exception executing Xbasic instruction.
2142: Maximum XDialogs exceeded.
2143: Maximums handle references exceeded
2144: Exit script.
2145: Value is write only (may be a password).
2146: The specified thread name is already in use.
2147: The specified thread was not found.
2148: The specified dialog was not found.
2149: Attempt to write to a read-only table.
2150: Expecting 'AS'.
2151: Mismatched '['.
2152: Table open canceled.
2153: Script execution was terminated by calling <thread>.requesttermination().
2154: Script execution was terminated it ran beyond the designated timeout.
2155: Too many arguments in function call.
2156: Not enough arguments to function call
2157: Argument to function call is the wrong type
2158: Maximum threads allowed has been exceeded.
2160: Attempting to change argument value but the argument indexed is not by reference.
2161: Attempting to change argument value but the type of the argument indexed indicates it was not passed by reference.
2162: An exception was thrown executing a .NET request.
2163: No event implementation was provided.
2164: The function was not found in the event implementation provided.
2165: The event function returned false.
2166: The named resource requested was not found.
2167: The RegEx pattern did not match.
2168: Debugger stop.
2169: Error remapping mapped table.
2170: Error parsing XML document.
2171: Office::Font object has not been assigned to yet.
2172: Office::Format object has not been assigned to yet.
2173: Office::Spreadsheet object has not been assigned to yet.
2174: Office::Font An error occurred setting the name.
2175: Office::Spreadsheet Types that can be written to a cell include string, date, number, logical, time or shorttime.
2176: Office::ExcelDocument An error occurred getting attempting to create a spreadsheet.
2177: Office::ExcelDocument An error occurred getting a spreadsheet.
2178: Office::ExcelDocument An error occurred attempting to add a font.
2179: Office::ExcelDocument An error occurred attempting to add a format.
2180: Office::ExcelDocument An error occurred attempting to get a font.
2181: Office::ExcelDocument An error occurred attempting to get a format.
2182: Application timed out.
2183: Office::ExcelDocument An error occurred creating a new document.
2184: An instance is required to call this function.
2185: Minidump DLL not found
2186: Minidump procedure not found
2187: Legacy format array syntax '()' only supports 1 dimension.
2188: Legacy format '()' array must already exist in context
2189: .Net Initialization error. Unable to load A5DotNet.dll.
2190: .Net Initialization error. Unable to find loader procedure in A5DotNet.dll.
2191: Invalid processor index or no processor was selected.
2192: Invalid data for creating a geography object.
2193: Invalid data for creating a geometry object.
2194: Invalid data for creating a hierarchy Id object.
2195: Attempt to define an Xbasic variable that is too long. Limit is 1024 characters.
2196: Error waiting for Xbasic object instance lock.
2197: Canceled
2198: Imaging::FileTransformer Input file not valid
2199: Imaging::FileTransformer Output file not valid
2200: Imaging::FileTransformer Can't load image
2201: Imaging::FileTransformer Output size is too small
2202: Imaging::FileTransformer Can't get image type
2203: Imaging::FileTransformer Ratio too large
2204: Imaging::FileTransformer GenericError
2205: Imaging::FileTransformer InvalidParameter
2206: Imaging::FileTransformer OutOfMemory
2207: Imaging::FileTransformer ObjectBusy
2208: Imaging::FileTransformer InsufficientBuffer
2209: Imaging::FileTransformer NotImplemented
2210: Imaging::FileTransformer WrongState
2211: Imaging::FileTransformer Aborted
2212: Imaging::FileTransformer FileNotFound
2213: Imaging::FileTransformer ValueOverflow
2214: Imaging::FileTransformer AccessDenied
2215: Imaging::FileTransformer UnknownImageFormat
2216: Imaging::FileTransformer FontFamilyNotFound
2217: Imaging::FileTransformer FontStyleNotFound
2218: Imaging::FileTransformer NotTrueTypeFont
2219: Imaging::FileTransformer UnsupportedGdiplusVersion
2220: Imaging::FileTransformer GdiplusNotInitialized
2221: Imaging::FileTransformer PropertyNotFound
2222: Imaging::FileTransformer PropertyNotSupported
2223: Imaging::FileTransformer Save error
2224: Office::ExcelDocument The named range was not found
2225: Office::ExcelDocument The named range has more than one value. This is not currently supported for reading and writing
2228: Curl: Handle not initialized, assign from Extension::Curl::Init().
2231: A5W: Complete Request - End page processing returning current response.
2232: MiniDumps have been disabled for this process.
2233: Exception executing Xbasic LOOP instruction
2234: Unexpected exception unregistering thread for Xbasic
2235: A5W: The client is no longer connected.
2236: A5W: Request processing was canceled. Request processing was running too long.
2237: lanexe not available for stack allocation.
2238: lanexe not available for stack free.
3000: Cardsystem failure.
3001: Hardcard not found.
3002: Cannot edit card
3003: Cardsystem copy failed
3004: Cannot add card
3005: No cardsystem exists for this session
3006: Cannot create card window
3007: A popup card may not call another card
3008: A popup card may not goto another card
3009: Cannot create popup card window
3010: Card not found
3011: Cannot load specified card
3012: (Not used)
3013: Bad Windows display context
3014: Duplicate Hardcard name
3015: Control does not exist
3016: Cannot register the form system
3017: Control table corrupt
3018: Control table full
3019: Bad control handle
3020: Cardsystem parameter error
3021: Control will not give up focus
3022: Bad session handle
3023: Bad object handle
3024: Cannot find specified object
3025: No more object blocks
3026: Bad block handle
3027: Bad block handle
3028: Cannot create another object
3029: No more display contexts
3030: Object cannot get focus
3031: Cannot find specified card
3032: Cannot add script to card stack
3033: Card stack is not open
3034: Card state information overflow
3035: No card stack name specified
3036: Cannot find specified form
3037: 'Change begin' must precede 'change end'
3038: Nested block notification
3039: Selected object name already in use -- Object name will not be changed
3040: Script has been changed
3041: Label not found
3042: Cancel selected
3043: Label template not found
3044: No editor found
3045: Fatal card stack error. Session must be terminated
3046: Default form full. Not all fields will be displayed
3047: Hardcard cannot be run from a card stack
3048: The selected layout is locked by another session
3049: The specified table is not open for this session
3050: No such object property
3051: Internal: last object on tab page inaccessible
3052: Internal: first object on tab page inaccessible
3053: Text editor error.
3054: Session editor window not found.
4100: Web Application Security - Unexpected error
4101: Web Application Security - Error creating user
4102: Web Application Security - No user provided and none is current
4200: Common Logging: Log file format cannot be empty
4201: Common Logging: Invalid log record format
4202: Common Logging: Invalid logging type
4203: Common Logging: Logging type cannot be empty
5000, 5025 - 5250: Unknown error
5001: The mask expects a capital letter
5002: The mask expects a letter
5003: The mask expects a number
5004: The mask expects a letter or number
5005: Bad object handle
5006: Bad session handle
5007: The specified object does not exist
5008: Listbox offset error
5009: Editbox text length error
5010: The specified file does not exist
5011: The specified file already exists
5012: The equation must return a character string
5013: The equation must return a number
5014: The equation must return a date
5015: The equation must return a logical value
5016: Too many fonts have been used
5017: Cannot create the specified font
5018: No more timers available
5019: Timer error
5020: Bad parameter passed to function
5021: Menu error
5022: Cannot access menu
5023: The specified menu item has no associated help
5024: This file name is not valid
5500: No printer configured
5501: Error loading page
5503: Error communicating with printer
5504: Invalid print parameter
5505: User cancelled
7000: Text editor error.
7001: Unmatched if, endif pair in text editor.
7002: Attempt to read empty text editor data.
7003: Error saving text editor data.
7004: Error loading text editor data.
7005, 9000: DDE/OLE error
8021: Numeric value to large for field
9001: DDE/OLE: bad parameter
9002: Bad executable file
9003: DDE connection broken
9004: DDE timeout
9005: Empty ole object
9006: Cancelled
9007: OLE server not found
9008: Cannot edit a static text
9009: No printer configured
10000: User cancelled
10001: Bad print layout (margins or paper size)
10002: Print layout exceeds page size
10003: Backward access during sequential database processing
10004: Internal report error
11000: Internal report error
11001: Report file format bad
11002: Internal summary function parameter error
11003: Infinitely recursive summary reference
11004: Internal summary field doesn't exist error
11005: Internal bad parameter error
11006: Internal attempt to use disabled summary error
11007: Internal summary rp bad error
11008: Group not found
11009: Internal group def bad error
11010: Internal attempt to operate without a record context
11011: Internal attempt to perform single pass with non-local references
11012: Expression is too long
11013: Field is too big
11014: Break on summary not supported
11015: Break on layout not supported
11016: Summarization is only available in reports, letters and forms.
11017: Bad argument to summary function
11018: Subexpression is blank
11019: Internal error:- Record not in memory
11020: Too many subreports across or groups deep
11021: Too many groups defined
11022: Summary context stack overflow
11023: Internal error: Summary context stack underflow
11024: Internal error: Object is not a subreport
11025: Group + existing range order exceeds queries key length limit. Set current index to <record number> or restrict ordering on some groups.
11026: Summary range error
11027: Precalc was not initialized for expression.
11028: Cannot process a report order based on a summary.
11029: DOS error
11111: Too many whiskers
12000: Table row has not been completed.
12001: Common dialog failure
13000: Common dialog failure
13001: Common dialog internal - bad STRUCTSIZE
13002: Common dialog initialization
13003: Common dialog no template
13004: Common dialog internal - no HINSTANCE
13005: Common dialog internal - load string resource
13006: Common dialog internal - find resource
13007: Common dialog internal - load resource
13008: Common dialog internal - lock resource
13009: Common dialog memory allocation failure
13010: Common dialog memory lock failure
13011: Common dialog internal - no hook
13012: Common dialog internal - register MSG failed
13013: Print dialog setup failure
13014: Print dialog parse failure
13015: Print dialog return default failure
13016: Print dialog load driver failure
13017: Print dialog get device mode failure
13018: Print dialog initialize failure
13019: Print dialog no print devices
13020: Print dialog no default printer
13021: Print dialog internal - DNDM mismatch
13022: Print dialog internal - create IC failure
13023: Print dialog printer not found
13024: Print dialog default printer is different
13025: Font dialog no fonts
13026: Font dialog maximum is less than minimum
13027: Filename dialog internal - subclass failure
13028: Filename dialog invalid filename
13029: Filename dialog filename buffer is too small
13030: Search/replace dialog buffer is zero length
13031, 15000: Internal error
15001: Not initialized
15002: Invalid find structure specified
15003: Unable to create store handle
15004: Invalid store handle specified
15005: Internal error: Store Table bad
15006: Invalid structured store image
15007: Internal error: StoreCreate
15008: Internal error: StoreOpen
15009: Internal error: StoreCopy
15010: Internal error: StoreUnload
15011: Invalid store type specified
15012: Invalid store database definition specified
15013: No match found
15014: Internal error: StreamCreate
15015: Internal error: StreamOpen
15016: Invalid stream passed in
15017: Internal error: StreamRead
15018: Internal error: StreamWrite
15019: Internal error: StreamSeek
15020: Internal error: StreamRelease
15021: Internal error: StreamSetSize
15022: Internal error: StreamClone
15023, 17760: Object does not support requested interface.
16000, 16002 - 16007, 16014 - 16019, 16021 - 16026, 16028 - 16033, 16036, 16038 - 16043, 16045 - 16050, 16052 - 16057, 16059 - 16063: Not found ___ not found.
16001, 16013, 16020, 16027, 16037, 16044, 16051, 16058: Not found html_editor___untitled_ not found.
16008, 16034: Not found topparent not found.
16009, 16035: NULL table does not support 'db_index_open' method.
16010, 16011: Property not found pg.flag_nested subelement not found.
16012: Not found CodeEditor1 not found.
16064 - 16127: Unexpected internal Alpha Five error. Please send the following information to technical support at Alpha Software. Source code (not on your machine) c:\dev\a5v12\src\engine\GENERIC\sysofeq.cpp at line 1067.
17761: Internal error: Invalid parameter specified
17762: Cannot open specified form as a dialog box
17763: Object method error. A parameter may be incorrect or misspelled
17764: Bad object handle.
18000: Xbasic Parser Error
19000: System Addin - Generated File
19001: System Addin - Generated script not found.
19002: System Addin - Generated function not found.
19500: Xbasic Code Generator
19501: Xbasic Code Generator - Error loading XML parse tree.
19502: Xbasic Code Generator - Error saving XML parse tree.
19751: SSPI QuerySecurityPackage failed.
19752: SSPI Allocate memory error.
19753: SSPI Query context attributes error.
19754: SSPI Impersonate failed.
19755: SSPI Get user name failed.
19756: SSPI RevertSecurityContext failed.
19757: SSPI AcquireCredentials handle failed.
19758: SSPI AcceptSecurityContext failed.
19759: SSPI CompleteAuthToken failed.
19760: SSPI InitializeSecurityContext failed.
20000: User Error Code Start
20001 - 24998: Reserved for User-defined error codes.
24999: User Error Code End
30001: The Session_Folder property is no longer supported. Use Session.SaveDataAsFile() to safely store file-based data in the Session instead of attempting to write directly to disk. See https://documentation.alphasoftware.com/documentation/index?search=storing%20files%20in%20sessions for additional information.
30002: The Session_Url property is no longer supported. Use Session.FormatFileDataURL() to link to any resources that have been stored in the Session. See https://documentation.alphasoftware.com/documentation/index?search=storing%20files%20in%20sessions for additional information.
30010: Response.Add_Cookie() is no longer supported. Use Response.Cookies.Add() instead. See https://documentation.alphasoftware.com/documentation/index?search=server%20replacing%20responseaddcookie%20function for more information.
30011: Response.Add_Header() is no longer supported. Use Response.Headers.Add() instead. See https://documentation.alphasoftware.com/documentation/index?search=replacing%20response.add_header%20function for more information.
30012: Response.Message_Body is a read-only property. Use Response.Write() to add data to the outgoing Response.
30020: a5w_load_aex() is no longer supported. See https://documentation.alphasoftware.com/documentation/index?search=server%20xb%20change%20in%20way%20aex%20files%20are%20used%20in%20a%20web%20application for more information.
30021: a5w_unload_aex() is no longer supported. See https://documentation.alphasoftware.com/documentation/index?search=server%20xb%20change%20in%20way%20aex%20files%20are%20used%20in%20a%20web%20application for more information.
30022: a5_count_websessions() is no longer supported.
30030: Application.Path() is no longer supported. Use Request.ApplicationRoot as a replacement.
30040: Server.ClearA5ICache() is no longer supported. The A5I cache now automatically monitors the filesystem and does not need to be manually cleared. Use Server.ClearAEXCache() to clear the AEX cache if desired.
30041: Server.ClearGzipCache() is no longer supported. The Gzip cache now automatically monitors the filesystem and does not need to be manually cleared.
30042: Server.Reset() is no longer supported.
30050: Request.Script_Name is no longer supported. Use Request.ScriptName instead.
30051: Unsafe Session variable syntax. Session variables cannot be created or assigned from either the Query String or POST body.
30052: Bad Request
30060: Error loading server macros.
30061: Error processing a5_application.a5i.
30070: Maximum licensed web sessions exceeded.
30518: ValidateCallerIdentity() failed with the following exception:
33001: The Application Server cannot be used in this product.
33002: The Application Server cannot be used in this Runtime edition.
33003: The Application Server cannot be used in the Home edition.
33004: The Application Server is already running.
33005: The specified port is already in use and cannot be used by the Application Server.
33006: The server cannot be started because the specified Document Root does not exist and cannot be created. Create the Document Root folder or modify the server configuration.
33007: The server cannot be started because of an insecure configuration. The SSL certificate, chain file, and private key are sensitive files and must not be located within the webroot. These must be moved to a directory that is not web-accessible before the server will run.
33008: The server cannot be started because the specified connection string for Session Storage cannot be opened or the specified location cannot be written to. Modify the server configuration to use a valid Session Storage connection string.
35001: The maximum number of activations has been exceeded.
35002: The license number provided is not recognized.
35003: There was a database error.
35004: Activation information was not found.
35005: The request was rejected.
35006: The activation was not allowed.
35007: This host is already activated.
35008: This host is not activated.
35009: The license has not been activated.
35010: Internal error (packet creation).
35011: Customer not found.
35012: Invalid credentials.
35013: License is not active.
35014: Failed to validate caller identity in GeneratePayload().
35015: GeneratePayload() failed with the following exception:
35016: Failed to validate caller identity in ReadPayload().
35017: ReadPayload() failed with the following exception:
35019: ValidateCallerIdentity() failed because the passphrase does not match.
35020: ValidateCallerIdentity() failed because the time taken was too long.
35021: Required files are missing or corrupt. Please reinstall this software.
35022: Error getting latest activation library build number from server.
35023: Activation library was downloaded from server but could not be saved to disk. It is being loaded from memory.
35024: Exception retrieving the latest build number from the server.
35025: Error downloading the latest activation library from server.
35026: Exception downloading the latest activation library from server.
35027: Exception trying to access the activation client library on disk.
35028: Exception loading activation library from memory.
35029: Unable to save downloaded activation library to any location.
35030: Exception saving activation library to disk.
35031: Exception setting ACL on activation library file.
35032: No access to activation server
35099: UnexpectedError
36001: DNS Management: Connection string cannot be empty.
37001: Database Manager: Connection string cannot be empty.
38001: Alpha Cloud: Unable to load Alpha Cloud client library. If this problem continues contact support.
38002: Alpha Cloud: Unable to generate security information for cloud publication.
38003: Alpha Cloud: Unable to publish application to the Alpha Cloud.
38004: Alpha Cloud: Publish settings were not provided while attempting to publish an application to the Alpha Cloud.
38005: Alpha Cloud: Invalid settings were provided while attempting to publish an application to the Alpha Cloud.
38006: Alpha Cloud: Alpha Cloud client library publish function returned an error.
38007: Alpha Cloud: Errors were found in project users and passwords while publishing to Alpha Cloud.
38099: Alpha Cloud: Unexpected error attempting to publish an application to the Alpha Cloud.
39001: Queueing: Connection string cannot be empty.
39002: No Queue Items Found
40001: INET: Unrecognized document format
40002: INET: Multipart document, but no boundary defined.
40003: INET: Unable to find starting position in a multipart document.
40004: INET: Boundary header not define in multipart document.
40005: INET: Can't find boundary marker in multipart document.
40006: INET: Unrecognized header line format in multipart document.
40007: INET: Unrecognized format for header argument.
40008: INET: Invalid HTTP 1.1 header name - has trailing whitespace.
40009: INET: Invalid HTTP 1.1 request - has trailing whitespace.
40010: INET: Invalid HTTP 1.1 request - invalid characters in request line.
40011: INET: Invalid HTTP 1.1 request - has whitespace between request line and first header.
40501: INET: HTTP - Unrecognized format for request header.
40502: INET: HTTP - Unrecognized request method.
40503: INET: HTTP - Unrecognized format for URL.
40504: INET: HTTP - Unrecognized protocol.
40505: INET: HTTP - content-disposition header is form-data, but there is no value for the name argument.
40506: INET: HTTP - Must parse headers before calling ReadAndParseBody.
40507: INET: HTTP - The maximum size of a POST has been exceeded.
40508: INET: HTTP - DOS error mapping POST body temporary file.
40509: INET: HTTP - Content length for POST body is not valid.
40751: INET: EMAIL - Invalid recipient index.
40752: INET: EMAIL - Invalid carbon copy index.
40753: INET: EMAIL - Invalid e-mail address.
42001: Scheduler: Task must have a name.
42002: Scheduler: CodeToExecute cannot be blank.
42003: Scheduler Recurrence: Weekly value must be between 0 (Sunday) and 6 (Saturday)
42004: Scheduler: Invalid Date
42005: Scheduler: Task not found
42006: Scheduler: Unable to access Scheduler
42007: Scheduler: Lock timeout in Scheduler
42008: Scheduler: Lock timeout in Task
42009: Scheduler: Lock timeout in Occurrence
42010: Scheduler: Lock timeout in Data Store
42011: Scheduler: Months collection is empty
42012: Scheduler: Unable to load the schema XML resource while initializing the database
43001: Enumerated type - invalid element
43002: Element already exists
43003: Error adding element
44001: The specified assembly is already loaded
45001: .NET: Type was not found.
45002: .NET: Assembly DLL was not found.
45003: .NET: Type was not found in assembly DLL.
45004: .NET: RegisterAssembly indexing error.
45005: .NET: Assembly name is required.
46001: Data Transfer Chunked: Cannot set DataTransferChunked. Data has already been written.
46002: Data Transfer Chunked: Cannot set DataTransferChunked. Already set.
46011: Data Transfer Chunked: Cannot set DataTransferDeferComplete. DataTransferChunked has not been set.
46012: Data Transfer Chunked: Cannot set DataTransferDeferComplete. DataTransferComplete has already been set.
46021: Data Transfer Chunked: Cannot unset DataTransferComplete. DataTransferComplete has already been set.
46022: Data Transfer Chunked: Cannot set DataTransferComplete. DataTransferChunked has not been set.
46023: Data Transfer Chunked: Cannot set DataTransferComplete. DataTransferComplete has already been set.
50001: WebSecurity: The security settings for this application are missing or incomplete
50002: WebSecurity: The page security settings for this application are missing
50003: WebSecurity: The security data tables for this application are missing or incomplete
50004: WebSecurity: User is not found
50005: WebSecurity: Required data is missing
50006: WebSecurity: Security is not active
50007: WebSecurity: Security Role(s) not found or invalid
50008: WebSecurity: Login failed
50009: WebSecurity: Option not available in Active Directory
50010: WebSecurity: Unable to connect to Active Directory Server
50011: WebSecurity: User is locked out
50012: WebSecurity: Security system error
50013: WebSecurity: Invalid email address
50014: WebSecurity: Save security data failed
50015: WebSecurity: No tenant
50016: WebSecurity: Tenant not found
50017: WebSecurity: Federated authentication requires the site's cookie SameSite value be set to "none".
51001: OAuth: Access Token Not Found
52000: SQL Server Reporting: Report not found

Other Error Messages

In addition to the error codes above, the following error messages may occur in Xbasic scripts. Text in all caps represents parts of the message that are populated at run-time with script-specific details.

Error Message ID

Error Message

printdrivernotfound

Driver for NAME not found

importfielderror

error importing field FIELD record RECORD text TEXT: ERROR_MESSAGE

exprkeylengthtoobig

Expression result is too large to index

keys are limited to KEYLENGTH characters

You can use the LEFT() function to trim the expressions result to a length that the index can handle.

erroronrestructure

Error restructuring table.

Record: RECORD, Field: FIELD data value: TEXT

ERROR_MESSAGE

utilvartypemismatch

Type Mismatch: variable NAME is of type SUPPLIED_TYPE variable, expected type EXPECTED_TYPE.

utilvarnotfound

Required variable NAME was not defined.

utilvarmissingoption

Variable NAME is missing an option.

utilvarmissingexpression

Required expression variable NAME is blank.

utilvarempty

Required variable NAME is blank.

utilvarbadvalue

Variable NAME has an invalid value VALUE.

utilvarnotdef

Required variable NAME was not defined.

utilvarexprtypemismatch

Variable NAME is an SUPPLIED_TYPE expression, a EXPECTED_TYPE expression was expected.

utilvartablenotfound

Variable NAME references a non-existent table TABLE.

utilvarfieldnotfound

Variable NAME references a non-existent field FIELD.

utilvartablecontext

Variable NAME table - ERROR_MESSAGE.

utilvarfieldcontext

Variable NAME field - ERROR_MESSAGE.

utilvarexprcontext

Variable NAME expression - ERROR_MESSAGE.

reqvarnotdef

Required variable NAME was not defined.

uidrawbitmapnotfound

ui_bitmap_draw: bitmap 'NAME' not found

structblobtoosmall

Structure requires REQUIRED bytes, only DEFINED bytes defined in blob.

structnotdefined

Structure NAME is not defined.

structblobhaspointers

Pointers inside a blob unsupported for version VERSION

structarrayblobtoosmall

Array requires REQUIRED bytes, only DEFINED bytes defined in blob.

languagelineerror

line:LINENUMBER ERROR_MESSAGE