Command Appendix C, 4D Internet Commands Error Codes

4D Internet Commands

Appendix C, 4D Internet Commands Error Codes

version 2004 (Modified)


All 4D Internet Commands (with the exception of IT_ErrorText & IT_Version) return an integer value as the result of the function. This integer contains any error number which the command needs to convey back to the 4D database. If a command is successful, a zero will be returned. The source of an error number can usually be determined by the range of values which the error falls within. The following table provides an index to the most likely creator of an error in any given range:

Error NumberGenerated by
Error < ZeroOperating System Error or WinSock network layer
ZeroNo Error
Error 1 -> 61BSD network layer
Error >= 100004D Internet Commands Error

4D Internet Commands Error Codes

If an error occurs during any operation, a numeric value from the following table will be returned:

10000user cancelled a dialog or progress.
10001unimplemented Internet command.
10002invalid array type.
10003no more (TCP,SMTP,POP3, etc. ) references available.
10004invalid reference.
10005need a "Host" for use in the "SMTP_Send" command.
10006need a "From" for use in the "SMTP_Send" command.
10007need a recipient for use in the "SMTP_Send" command.
10008already logged in.
10009error trying to make a POP3 connection.
10010error with POP3 USER.
10011error with POP3 PASS.
10012error with POP3 QUIT.
10013error with POP3 STAT.
10014error with POP3 LIST.
10015error with POP3 UIDL.
10016error with POP3 DELE.
10017error with POP3 RSET.
10018invalid message number.
10019invalid character offset.
10020invalid character length.
10021error with POP3 RETR.
10022field was not found in mail Header.
10023no attachments found.
10024error in processing BinHex.
10025BinHex checksum error.
10026Internet commands unavailable. Probably because MacTCP is not installed
10027Connection no longer exists
10028Exceeded 32k limit
10029Error with POP3 NOOP
10030POP3 session was closed by the server
10031Error with POP3 APOP
10032Unknown or invalid response.
10033SMTP 421 - Service not available, closing transmission channel.
10034SMTP 450 - Requested mail action not taken: mailbox unavailable.
10035SMTP 451 - Requested action aborted: local error in processing.
10036SMTP 452 - Requested action not taken: insufficient system storage.
10037SMTP 500 - Syntax error, command unrecognized.
10038SMTP 501 - Syntax error in parameters or arguments.
10039SMTP 502 - Command not implemented.
10040SMTP 503 - Bad sequence of commands.
10041SMTP 504 - Command parameter not implemented.
10042SMTP 550 - Requested action not taken: mailbox unavailable.
10043SMTP 551 - User not local; please try <forward-path>.
10044SMTP 552 - Requested mail action aborted: exceeded storage allocation.
10045SMTP 553 - Requested action not taken: mailbox name not allowed.
10046SMTP 554 - Transaction failed.
10047FTP 421 - Service not available, closing control connection.
10048FTP 425 - Can't open data connection.
10049FTP 426 - Connection closed; transfer aborted.
10050FTP 450 - Requested file action not taken. File unavailable (e.g.,file busy).
10051FTP 451 - Requested action aborted: local error in processing.
10052FTP 452 - Requested action not taken. Insufficient storage space in system.
10053FTP 500 - Syntax error, command unrecognized.
10054FTP 501 - Syntax error in parameters or arguments.
10055FTP 502 - Command not implemented.
10056FTP 503 - Bad sequence of commands.
10057FTP 504 - Command not implemented for that parameter.
10058FTP 530 - Not logged in.
10059FTP 532 - Need account for storing files.
10060FTP 550 - Requested action not taken. File unavailable (e.g., file not found, no access).
10061FTP 551 - Requested action aborted: page type unknown.
10062FTP 552 - Requested file action aborted. Exceeded storage allocation (for current directory
or dataset).
10063FTP 553 - Requested action not taken. File name not allowed.
10064No response has been received within the given timeout period.
10065Not an FTP file.
10066Error in processing Base64.
10067Error in processing AppleSingle.
10068Error in processing Quoted-Printable.
10069FTP session was closed by the server.
10070Not an FTP directory.
10071TCP session was closed by the server
10072Invalid encode kind
10073Invalid decode kind
10074An asynchronous DNR call did not complete
10075An asynchronous OpenTransport call did not complete
10076OpenTransport bind failed
10077OpenTransport connect failed
10078Maximum MacTCP streams reached
10079Error in processing uuencode
10080Cannot load ICMP library
10081Error in processing MacBinary
10082MacBinary checksum error
10083Could not open a file
10084No FTP information received
10085Unknown FTP information received
10086Proxy connection failed
10087Standard file I/O error
10088FTP reentrant error
10089SLI.DLL is not loaded
10091Error trying to make an IMAP connection
10092A maibox is not selected
10093Invalid message part
10094Error with IMAP LOGIN
10095Error with IMAP LOGOUT
10096Error with IMAP CAPABILITY
10097Error with IMAP SELECT
10098Error with IMAP FETCH
10099Error with IMAP PARTIAL
10100Error with IMAP STORE
10101Error with IMAP EXPUNGE
10102Error with IMAP SEARCH
10103Error with IMAP COPY
10104Error with IMAP CREATE
10105Error with IMAP DELETE
10106Error with IMAP RENAME
10107Error with IMAP SUBSCRIBE
10108Error with IMAP UNSUBSCRIBE
10109Error with IMAP LIST
10110Error with IMAP LSUB
10111Error with IMAP STATUS
10112Error with IMAP CLOSE
10113Error with AUTHENTICATION

BSD Error Codes

1Operation not permitted
4Interrupted system call
13Permission denied
14Bad address
22Invalid argument
24Too many open files
35Operation would block
36Operation now in progress
37Operation already in progress
38Socket operation on non-socket
39Destination address required
40Message too long
41Protocol wrong type for socket
42Protocol not available
43Protocol not supported
44Socket type not supported
45Operation not supported
46Protocol family not supported
47Address family not supported by protocol family
48Address already in use
49Can't assign requested address
50Network is down
51Network is unreachable
52Network dropped connection on reset
53Software caused connection abort
54Connection reset by peer
55No buffer space available
56Socket is already connected
57Socket is not connected
58Can't send after socket shutdown
60Operation timed out
61Connection refused

WinSock Error Codes

-10004Blocking call cancelled
-10013Permission denied
-10014Bad address
-10022Invalid argument
-10024No more sockets available
-10035Non-blocking socket would block
-10036Illegal WinSock function invoked while a blocking function is in progress
-10037An attempt was made to cancel an asynchronous operation that has already completed
-10038Specified socket descriptor is not valid for this application
-10039Destination address was required but none was supplied to the function
-10040Datagram too large for buffer
-10041Specified protocol does not match the other parameters in the call
-10042Protocol option is unknown or invalid
-10043Specified protocol is not supported by the Windows Sockets implementation
-10044Specified socket type is not supported by the specified address family
-10045Socket does not support the specified operation
-10046Protocol family not supported
-10047Specified address family is not supported by the Windows Sockets implementation or
cannot be used with the indicated socket
-10048Specified address is already in use
-10049Specified address is not available from the local machine
-10050Problem with the network subsystem
-10051Network cannot be reached from this host at this time
-10052Connection was dropped and must be reset
-10053Connection was aborted because of a timeout or other error condition
-10054Connection was reset by the remote host
-10055Windows Sockets implementation is out of buffer space or the space provided in an API
call by the application was too small to hold the requested information
-10056Specified socket is already connected
-10057Specified socket is not connected
-10058Socket has had the requested functionality shut down
-10060Connection attempt timed out before the connection could be established
-10061Connection attempt was forcefully rejected
-10091Network subsystem is not yet ready for communication
-10092Windows Sockets DLL does not support the requested Winsock protocol version
-10093Windows Sockets not initialized
-11001Requested database information does not exist; as confirmed by an authoritative host
-11002Requested information was not found but the answer was not authoritative
-11003Non-recoverable error occurred
-11004Name supplied was valid but no information of the requested type is in the database

SMTP RFC Values

The following items are not error codes returned by any of the external commands. These are response codes which the SMTP protocol has defined to communicate various states during client-server communication. Developers may find this list useful if they are writing their own mail communication procedures using low-level TCP commands.

211System status, or system help reply
214Help message [Information on how to use the receiver or the meaning of a particular
non-standard command; this reply is useful only to the human user]
220<domain> Service ready
221<domain> Service closing transmission channel
250Requested mail action okay, completed
251User not local; will forward to <forward-path>
354Start mail input; end with <CRLF>.<CRLF>
421<domain> Service not available, closing transmission channel [This may be a reply to
any command if the service knows it must shut down]
450Requested mail action not taken: mailbox unavailable [e.g., mailbox busy]
451Requested action aborted: local error in processing
452Requested action not taken: insufficient system storage
500Syntax error, command unrecognized [This may include errors such as command line
too long]
501Syntax error in parameters or arguments
502Command not implemented
503Bad sequence of commands
504Command parameter not implemented
550Requested action not taken: mailbox unavailable [e.g., mailbox not found, no access]
551User not local; please try <forward-path>
552Requested mail action aborted: exceeded storage allocation
553Requested action not taken: mailbox name not allowed [e.g., mailbox syntax incorrect]
554Transaction failed

FTP RFC Values

The following items are not error codes returned by any of the external commands. These are response codes which the FTP protocol has defined to communicate various states during client-server communication. Developers may find this list useful when writing their own file transfer procedures using low-level TCP commands.

110Restart marker reply. In this case, the text is exact and not left to the particular
implementation; it must read:
MARK yyyy = mmmm
Where yyyy is User-process data stream marker, and mmmm server's equivalent
marker (note the spaces between markers and "=").
120Service ready in nnn minutes.
125Data connection already open; transfer starting.
150File status okay; about to open data connection.
200Command okay.
202Command not implemented, superfluous at this site.
211System status, or system help reply.
212Directory status.
213File status.
214Help message on how to use the server or the meaning of a particular non-standard
command. This reply is useful only to the human user.
215NAME system type. Where NAME is an official system name from the list in the
Assigned Numbers document.
220Service ready for new user.
221Service closing control connection. Logged out if appropriate.
225Data connection open; no transfer in progress.
226Closing data connection. Requested file action successful (e.g., file transfer or file
abort).
227Entering Passive Mode (h1,h2,h3,h4,p1,p2).
230User logged in, proceed.
250Requested file action okay, completed.
257"PATHNAME" created.
331User name okay, need password.
332Need account for login.
350Requested file action pending further information.
421Service not available, closing control connection. This may be a reply to any command if
the service knows it must shut down.
425Can't open data connection.
426Connection closed; transfer aborted.
450Requested file action not taken. File unavailable (file busy).
451Requested action aborted: local error in processing.
452Requested action not taken. Insufficient storage space in system.
500Syntax error, command unrecognized. This may include errors such as command line
too long.
501Syntax error in parameters or arguments.
502Command not implemented.
503Bad sequence of commands.
504Command not implemented for that parameter.
530Not logged in.
532Need account for storing files.
550Requested action not taken. File unavailable (e.g., file not found, no access).
551Requested action aborted: page type unknown.
552Requested file action aborted. Exceeded storage allocation (for current directory or
dataset).
553Requested action not taken. File name not allowed.