Error Codes


Table 2 shows all the error codes and numbers that the SmartSockets IPC and Utilities API functions use.

Table 2 SmartSockets Errors
Number
Error Code
Description
1
T_ERR_C
A C error occurred. Call the function TutErrNumGetC to obtain the related C-specific error value.
2
T_ERR_OS
An operating system error occurred. Call the function TutErrNumGetOs to obtain the related error value specific to the operating system. On OpenVMS, if the error also has a C equivalent, call the function TutErrNumGetC to obtain the related C-specific error value. (TutErrNumGetC returns zero if there is no equivalent C error.)
3
T_ERR_NULL_PTR
Indicates that a null pointer was passed as a function argument in a case where NULL is not allowed.
4
T_ERR_VAL_TOO_SMALL
Indicates a range error where a value was too small to be valid.
5
T_ERR_VAL_TOO_LARGE
Indicates a range error where a value was too large to be valid.
6
T_ERR_ALREADY_EXISTS
The operation, usually creation or insertion, did not succeed because the object already exists.
7
T_ERR_VAL_INVALID
Indicates some kind of range error where a value was invalid. There is some overlap between T_ERR_VAL_INVALID versus T_ERR_VAL_TOO_SMALL and T_ERR_VAL_TOO_LARGE.
8
T_ERR_DOESNT_EXIST
The operation (usually looking up an object) did not occur because object does not exist.
9
T_ERR_TIMEOUT_REACHED
The operation did not complete within a certain user-specified amount of time.
10
T_ERR_EOF
Indicates an end of file condition.
11
T_ERR_VAL_SAME
The operation, usually setting a value, did not occur because the new value was the same as the current value.
12
T_ERR_VAL_UNKNOWN
The operation, usually getting a value, did not occur because the current value was unknown.
13
T_ERR_VAL_REQUIRED
The operation did not occur because a certain value was required to be set.
14
T_ERR_TYPE_INVALID
The operation did not occur because of an invalid type.
15
T_ERR_TYPE_MISMATCH
The operation did not occur because of a type mismatch between two operands.
16
T_ERR_INTERRUPTED
The operation did not occur because it was interrupted by a signal.
17
T_ERR_VERIFY_FAILED
The operation, usually setting a value, did not occur because verification of the new value failed. There is some overlap between T_ERR_VERIFY_FAILED versus T_ERR_VAL_INVALID.
18
T_ERR_END_OF_TRAVERSAL
Used to distinguish between a failed traversal and one that traversed all entries.
19
T_ERR_EMPTY
Used to distinguish between a failed traversal and one that traversed no entries.
20
T_ERR_VAL_MISMATCH
The operation did not occur because of a value mismatch between two operands.
21
T_ERR_TYPE_UNKNOWN
The operation did not occur because the type of the operand was unknown.
24
T_ERR_FILE_CORRUPT
The operation did not occur because a file was corrupt.
25
T_ERR_WOULD_BLOCK
The operation did not occur because the socket’s block mode is set to FALSE and the operation would have blocked the process from continuing.
28
T_ERR_READ_ONLY
The operation did not occur because the object was read-only and could not be modified.
29
T_ERR_SOCKET
A socket error occurred. Call the function TutErrNumGetSocket to obtain the related socket-specific error value.
31
T_ERR_UNSUPPORTED
The operation did not occur because the function is unsupported in the current context.
500
T_ERR_CONN_INIT_FAILED
Indicates that a connection was not created because of an incompatibility or error during the one-time connection initialization procedure. The most common reason for this error number is mixing incompatible versions of SmartSockets on your network.
502
T_ERR_SRV_NOT_CONNECTED
The operation did not occur because a connection to RTserver was not created or does not exist. Check the settings of the Server_* options.
503
T_ERR_SRV_ALREADY_CONNECTED
The operation did not occur because a connection to RTserver already exists.
504
T_ERR_SRV_ACCESS_DENIED
A connection to RTserver was not created because another RTclient or RTserver has the same value for the option Unique_Subject or RTserver reports that the maximum number of client connections was exceeded.
505
T_ERR_MSG_CORRUPT
The operation did not occur because the message was not in the proper format.
507
T_ERR_MSG_INVALID
The operation did not occur because the message was not a valid message. Messages have an internal fingerprint which ensures that only valid messages are allowed.
508
T_ERR_MSG_EOM
Indicates an end of message condition. The operation did not occur because the message does not have any more fields (the current field is at the end of the message).
509
T_ERR_FT_INVALID
The operation did not occur because the specified field type was not valid.
510
T_ERR_FT_MISMATCH
The operation did not occur because the current field is not of the proper type.
512
T_ERR_IN_PROGRESS
The operation did not occur because a similar operation is already in progress. This can happen when trying to read from a connection in a connection read callback.
514
T_ERR_FAILURE_DETECTED
A network failure was detected on a connection. The connection should be destroyed and then a new connection created if necessary.
515
T_ERR_LICENSE_DENIED
The operation did not occur because RTlm denied access to a license needed for the operation to complete.
517
T_ERR_IN_USE
The operation did not occur because some other object was already in use and the operation requires that the object not exist.
518
T_ERR_GMD_SENDER_TIMEOUT
GMD failed because the message was not acknowledged within time to meet the connection delivery timeout property. This error number is used only in GMD_FAILURE messages, not in the global SmartSockets error number accessible with TutErrNumGet. This error number is applicable for both TipcConn* GMD and TipcSrv* GMD.
519
T_ERR_GMD_RECEIVER_TIMEOUT
GMD failed because a receiving RTclient (with the option Server_Disconnect_Mode set to warm) disconnected from RTserver but did not reconnect within time to meet the RTserver option Client_Reconnect_Timeout. This error number is used only in GMD_FAILURE messages, not in the global SmartSockets error number accessible with TutErrNumGet. This error number is applicable only for TipcSrv* GMD.
520
T_ERR_GMD_RECEIVER_EXIT
GMD failed because a receiving RTclient (with the option Server_Disconnect_Mode set to gmd_failure) disconnected from RTserver. This error number is used only in GMD_FAILURE messages, not in the global SmartSockets error number accessible with TutErrNumGet. This error number is applicable only for TipcSrv* GMD.
521
T_ERR_GMD_NO_RECEIVERS
GMD failed because there were no receiving RTclients for the message and the RTserver option Zero_Recv_Gmd_Failure was set to TRUE. This error number is used only in GMD_FAILURE messages, not in the global SmartSockets error number accessible with TutErrNumGet. This error number is applicable only for TipcSrv* GMD.
522
T_ERR_PROTOCOL_MISMATCH
The operation did not occur because the feature is not supported in all the SmartSockets processes that are running. The most common reason for this error number is mixing incompatible versions of SmartSockets on your network.
525
T_ERR_SRV_CTLMSG_REJECTED
The operation did not occur because the control message was rejected.
4006
T_ERR_MAX_CLIENTS_EXCEEDED
The operation did not occur because the maximum allowed number of clients was exceeded.
4007
T_ERR_CONN_REQUEST_REJECTED
The operation did not occur because the connection request was rejected.
4009
T_ERR_DISCONNECT_MODE_INVALID
The operation did not occur because the disconnect mode was invalid.
4010
T_ERR_AUTHENTICATION_FAILED
The operation did not occur because authentication failed.
4011
T_ERR_CLIENT_NOT_LOCAL
The operation did not occur because the client is not local.
4012
T_ERR_MAX_CLIENT_LICENSES_EXCEEDED
The operation did not occur because the maximum allowed number of client licenses was exceeded.
4013
T_ERR_CLIENT_CREATE_REJECTED
The operation did not occur because the client creation was rejected.
4014
T_ERR_CLIENT_NAME_NOT_UNIQUE
The operation did not occur because the client name was not unique.
4015
T_ERR_CLIENT_UNIQUENESS_CHECK_IN_PROGRESS
A client uniqueness check is in progress.
4016
T_ERR_AUTHORIZATION_DENIED
The operation did not occur because authorization was denied.
4017
T_ERR_SUBJECT_INVALID
The operation did not occur because the subject was invalid.
4018
T_ERR_SUBJECT_ALREADY_SUBSCRIBED
The operation did not occur because subject was already subscribed to.
4019
T_ERR_SUBJECT_NOT_SUBSCRIBED
The operation did not occur because subject was not subscribed to.
4020
T_ERR_DUP_CLIENT_MID
The operation did not occur because a duplicate member ID was used.


TIBCO SmartSockets™ API Quick Reference
Software Release 6.8, July 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com