The ToolTalk error and warning message identifiers are allocated as follows.
MESSAGE or GROUP | RANGE |
---|---|
TT_OK | 0 |
TT_WRN_* | 1- 511 |
APP_WRN_* | 512 - 1023 |
TT_WRN_LAST | 1024 |
TT_ERR_* | 1025 - 1535 |
APP_ERR_* | 1536 - 2046 |
TT_ERR_LAST | 2047 |
Message ID | TTERR-0 |
Catalog String | TT_OK Request successful. |
Meaning | Your call was completed successfully. |
Message ID | TTERR-1 |
Catalog String | TT_WRN_NOTFOUND The object was not removed because it was not found. |
Meaning | When the ToolTalk service could not find the specified object in the ToolTalk database. The destroy operation did not succeed. |
Message ID | TTERR-2 |
Catalog String | TT_WRN_STALE_OID The object attribute in the message has been replaced with a newer one. Update the place from which the object id was obtained. |
Meaning | When the ToolTalk service looked up the specified object in the ToolTalk database, it found a forwarding pointer to the object. |
Remedy | The ToolTalk service automatically puts the new objid in the message. Use tt_message_object() to retrieve the new objid. Update any internal application references to the new objid. |
Message ID | TTERR-3 |
Catalog String | TT_WRN_STOPPED The query was halted by the filter procedure. |
Meaning | The query operation being performed was halted by Tt_filter_function. |
Message ID | TTERR-4 |
Catalog String | TT_WRN_SAME_OBJID The moved object retains the same objid. |
Meaning | The object you moved stayed within the same file system. The ToolTalk service will retain the same objid and update the location. |
Message ID | TTERR-5 |
Catalog String | TT_WRN_START_MESSAGE This message caused this process to be started. This message should be replied to even if it is a notice. |
Meaning | When the ToolTalk service starts your application to deliver a message, you must reply, even if the message is a notice. |
Remedy | Use tt_message_reply() to reply to the message you received after the process was started by the ToolTalk service. |
Message ID | TTERR-512 |
Catalog String | TT_WRN_APPFIRST This code should be unused. |
Meaning | This message id marks the beginning of the messages allocated for ToolTalk application warnings. |
Message ID | TTERR-1024 |
Catalog String | TT_WRN_LAST This code should be unused. |
Meaning | This message id marks the last of the messages allocated for ToolTalk warnings. |
Message ID | TTERR-1025 |
Catalog String | TT_ERR_CLASS The Tt_class value passed is invalid. |
Meaning | The ToolTalk service does not recognize the class value you specified. |
Remedy | The Tt_class values are TT_NOTICE and TT_REQUEST. Retry the call with one of these values. |
Message ID | TTERR-1026 |
Catalog String | TT_ERR_DBAVAIL A required database is not available. The condition may be temporary, trying again later may work. |
Meaning | The ToolTalk service could not access the ToolTalk database needed for this operation. |
Remedy | Try the operation again later. Check if the file server or workstation that contains the database is available. |
Message ID | TTERR-1027 |
Catalog String | TT_ERR_DBEXIST A required database does not exist. The database must be created before this action will work. |
Meaning | The ToolTalk service did not find the specified ToolTalk database in the expected place. |
Remedy | Install the rpc.ttdbserverd program on the machine that stores the file or object involved in this operation. |
Message ID | TTERR-1028 |
Catalog String | TT_ERR_FILE File object could not be found. |
Meaning | The file specified does not exist or is not accessible. |
Remedy | Check your file path name and retry the operation. Check if the machine where the file is stored is accessible. |
Message ID | TTERR-1031 |
Catalog String | TT_ERR_MODE The Tt_mode value is not valid. |
Meaning | The ToolTalk service does not recognize the specified mode value. |
Remedy | The Tt_mode values are TT_IN, TT_OUT, and TT_INOUT. Retry the call with one of these values. |
Message ID | TTERR-1032 |
Catalog String | TT_ERR_ACCESS An attempt was made to access a ToolTalk object in a way forbidden by the protection system. |
Meaning | The user does not have the necessary access to the object and the process, and therefore, cannot perform the operation. For example, the user may not have permission to destroy an object spec. |
Remedy | The user needs to gain proper access to the object before the application can perform the operation. |
Message ID | TTERR-1033 |
Catalog String | TT_ERR_NOMP No ttsession process is running, probably because tt_open() has not been called yet. If this code is returned from tt_open() it means ttsession could not be started, which generally means ToolTalk is not installed on this system. |
Meaning | The ttsession process is not available. The ToolTalk service tries to restart ttsession if it is not running; this error indicates that the ToolTalk service is either not installed or not installed correctly. |
Remedy | Verify that ttsession is installed on the machine in use. |
Message ID | TTERR-1034 |
Catalog String | TT_ERR_NOTHANDLER Only the handler of the message can do this. |
Meaning | Only the handler of a message can perform this operation. Your application is not the handler for this message. |
Message ID | TTERR-1035 |
Catalog String | TT_ERR_NUM The integer value passed is not valid. |
Meaning | An invalid integer value that was very
out-of-range was passed to the ToolTalk service. |
Remedy | Check the integer you specified. |
Message ID | TTERR-1036 |
Catalog String | TT_ERR_OBJID |
Meaning | The ToolTalk service found the objid in the ToolTalk database but it does not reference an existing object. |
Remedy | Clean up the ToolTalk database with the ttdbck utility. |
Message ID | TTERR-1037 |
Catalog String | TT_ERR_OP The operation name passed is not syntactically valid. |
Meaning | The specified operation name is null or contains non-alphanumeric characters. |
Remedy | Remove any non-alphanumeric characters and retry the operation. |
Message ID | TTERR-1038 |
Catalog String | TT_ERR_OTYPE The object type passed is not the name of an installed object type. |
Meaning | The ToolTalk service could not locate the specified otype. |
Remedy | Check the type of the object with tt_spec_type(). If the application was recently installed and the ToolTalk service has not re-read the types database, locate the process id for the ttsession, and force the re-read with the USR2 signal. % ps -elf | grep ttsession% kill -USR2 <ttsession pid> |
Message ID | TTERR-1039 |
Catalog String | TT_ERR_ADDRESS The Tt_address value passed is not valid. |
Meaning | The ToolTalk service does not recognize the address value you specified. |
Remedy | The Tt_address values are TT_PROCEDURE, TT_OBJECT, TT_HANDLER, and TT_OTYPE. Retry the call with one of these values. |
Message ID | TTERR-1040 |
Catalog String | TT_ERR_PATH One of the directories in the file path passed does not exist or cannot be read. |
Meaning | The ToolTalk service was not able to read a directory in the specified file path name. |
Remedy | Check the pathname to ensure that the current user has access to the specified directories. Check the machine where the file resides to make sure it is accessible. |
Message ID | TTERR-1041 |
Catalog String | TT_ERR_POINTER The opaque pointer (handle) passed does not indicate an object of the proper type. |
Meaning | The pointer you passed does not point at an object of the correct type for this operation. For example, the pointer may point to an integer when a character string is needed. |
Remedy | Check the arguments for the ToolTalk function to find what arguments the function expects. Retry the operation with a pointer for a valid object. |
Message ID | TTERR-1042 |
Catalog String | TT_ERR_PROCID The process id passed is not valid. |
Meaning | The process identifier you specified is out of date or invalid. |
Remedy | Retrieve the default procid with tt_default_procid(). |
Message ID | TTERR-1043 |
Catalog String | TT_ERR_PROPLEN The property value passed is too long. |
Meaning | The ToolTalk service accepts property values of up to 64 characters. |
Remedy | Shorten the property value to less than 64 characters. |
Message ID | TTERR-1044 |
Catalog String | TT_ERR_PROPNAME The property name passed is syntactically invalid. |
Meaning | The property name is too long, contains non-alphanumeric characters, or is null. |
Remedy | Check the property name, modify if necessary, and retry the operation. |
Message ID | TTERR-1045 |
Catalog String | TT_ERR_PTYPE The process type passed is not the name of an installed process type. |
Meaning | The ToolTalk service could not locate the specified ptype. |
Remedy | If the application was recently installed and the ToolTalk service has not re–read the types database, locate the process id for the ttsession, and force the re-read with the USR2 signal. % ps -elf | grep ttsession% kill -USR2 <ttsession pid> |
Message ID | TTERR-1046 |
Catalog String | TT_ERR_DISPOSITION The Tt_disposition value passed is not valid. |
Meaning | The disposition you passed is not recognized by the ToolTalk service. |
Remedy | The Tt_disposition values are TT_DISCARD, TT_QUEUE, and TT_START. Retry the call with one of these values. |
Message ID | TTERR-1047 |
Catalog String | TT_ERR_SCOPE The Tt_scope value passed is not valid. |
Meaning | The scope you passed is not recognized by the ToolTalk service. |
Remedy | The Tt_scope values are TT_SESSION and TT_FILE. Retry the call with one of these values. |
Message ID | TTERR-1048 |
Catalog String | TT_ERR_SESSION The session id passed is not the name of an active session. |
Meaning | You specified an out of date or invalid ToolTalk session. |
Remedy | Use tt_default_session() to obtain the sessid of the current default session or use tt_initial_session() to obtain the sessid of the initial session your application was started in. |
Message ID | TTERR-1049 |
Catalog String | TT_ERR_VTYPE The value type name passed is not valid. |
Meaning | The specified property exists in the ToolTalk database but the type of value does not match the specified type; or the value type is not one that the ToolTalk service recognizes. The ToolTalk service supports types of int and string. |
Remedy | Change the type of the value to either int or string and retry the operation. |
Message ID | TTERR-1050 |
Catalog String | TT_ERR_NO_VALUE No property value with the given name and number exists. |
Meaning | The ToolTalk service could not locate the specified property value you specified in the ToolTalk database. |
Remedy | Retrieve the current list of properties to find the property you want. |
Message ID | TTERR-1051 |
Catalog String | TT_ERR_INTERNAL Internal error (bug) |
Meaning | The ToolTalk service has suffered an internal error. |
Remedy | Restart all applications that are using the ToolTalk service. Report the error to SGI Customer Support. |
Message ID | TTERR-1052 |
Catalog String | TT_ERR_READONLY The attribute cannot be changed. |
Meaning | The attribute your application is trying to change is not owned or writable by the current user. |
Message ID | TTERR-1053 |
Catalog String | TT_ERR_NO_MATCH No handler could be found for this message, and the disposition was not queue or start. |
Meaning | The message your application sent could not be delivered. No applications that are running have registered interest in this type of message. |
Remedy | Use tt_disposition_set() to change the disposition to TT_QUEUE or TT_START and resend the message. If no recipients are found, no application has registered interest in this type of message. |
Message ID | TTERR-1054 |
Catalog String | TT_ERR_UNIMP Function not implemented. |
Meaning | The ToolTalk function called is not implemented. |
Message ID | TTERR-1055 |
Catalog String | TT_ERR_OVERFLOW Too many active messages (try again later). |
Meaning | The ToolTalk service has received the maximum amount of active messages (2000) it can handle properly. |
Remedy | Retrieve any messages that the ToolTalk service may be queueing for your application. Send your message again later. |
| ttsession can also be started with the -A option; specify the maximum number of messages in progress before a TT_ERR_OVERFLOW condition is returned. The default is 2000 messages. |
Message ID | TTERR-1056 |
Catalog String | TT_ERR_PTYPE_START Attempt to launch instance of ptype failed. |
Meaning | The ToolTalk service could not start the type of process specified. |
Remedy | Check to see that the application that the ptype represents is properly installed. |
Message ID | TTERR-1536 |
Catalog String | TT_ERR_APPFIRST This code should be unused. |
Meaning | This message id marks the beginning of the messages allocated for ToolTalk application errors. |
Message ID | TTERR-2047 |
Catalog String | TT_ERR_LAST This code should be unused. |
Meaning | This message id marks the last of the messages allocated for ToolTalk errors. |