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.