Appendix B. ToolTalk Error Messages
Prev |  | Next

## Appendix B. ToolTalk Error Messages

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

## TT_OK

Message ID | TTERR-0
Catalog String | TT_OK Request successful.
Meaning | Your call was completed successfully.

## TT_WRN_NOTFOUND

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.

## TT_WRN_STALE_OID

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.

## TT_WRN_STOPPED

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.

## TT_WRN_SAME_OBJID

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.

## TT_WRN_START_MESSAGE

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.

## TT_WRN_APPFIRST

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.

## TT_WRN_LAST

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.

## TT_ERR_CLASS

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.

## TT_ERR_DBAVAIL

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.

## TT_ERR_DBEXIST

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.

## TT_ERR_FILE

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.

## TT_ERR_MODE

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.

## TT_ERR_ACCESS

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.

## TT_ERR_NOMP

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.

## TT_ERR_NOTHANDLER

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.

## TT_ERR_NUM

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. Simple out-of-range conditions, such as requesting the third value of a property that has only two values, return a null value.
Remedy | Check the integer you specified.

## TT_ERR_OBJID

Message ID | TTERR-1036
Catalog String | TT_ERR_OBJID The object id passed does not refer to any existing object spec.
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.

## TT_ERR_OP

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.

## TT_ERR_OTYPE

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>`

## TT_ERR_ADDRESS

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.

## TT_ERR_PATH

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.

## TT_ERR_POINTER

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.

## TT_ERR_PROCID

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().

## TT_ERR_PROPLEN

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.

## TT_ERR_PROPNAME

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.

## TT_ERR_PTYPE

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>`

## TT_ERR_DISPOSITION

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.

## TT_ERR_SCOPE

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.

## TT_ERR_SESSION

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.

## TT_ERR_VTYPE

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.

## TT_ERR_NO_VALUE

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.

## TT_ERR_INTERNAL

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.

## TT_ERR_READONLY

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.

## TT_ERR_NO_MATCH

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.

## TT_ERR_UNIMP

Message ID | TTERR-1054
Catalog String | TT_ERR_UNIMP Function not implemented.
Meaning | The ToolTalk function called is not implemented.

## TT_ERR_OVERFLOW

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.

## TT_ERR_PTYPE_START

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.

## TT_ERR_APPFIRST

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.

## TT_ERR_LAST

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.

## TT_STATUS_LAST

Message ID | TTERR-2048
Catalog String | TT_STATUS_LAST This code should be unused.
Meaning | This message id marks the last of the messages allocated for ToolTalk status.

Prev | Table of Contents | Next
Appendix A. Initialization Error Messages |  | Index