ToolTalk Reference Manual
この本のみを検索
PDF 文書ファイルをダウンロードする

ToolTalk Error Messages

7

The ToolTalk error and warning identifiers are allocated as follows:
TT_OKTT_WRN_*APP_WRN_*TT_WRN_LASTTT_ERR_*APP_ERR_*TT_ERR_LAST
01512
1024102515362047
Table 7-1 is an alphabetical listing of the ToolTalk error messages and their corresponding message ids.
Table 7-1
Error MessageMessage ID
TT_ERR_ACCESSTTERR-1032
TT_ERR_ADDRESSTTERR-1039
TT_ERR_APPFIRSTTTERR-1536
TT_ERR_CATEGORYTTERR-1057
TT_ERR_CLASSTTERR-1025
TT_ERR_DBAVAILTTERR-1026
TT_ERR_DBCONSISTTTERR-1060
TT_ERR_DBEXISTTTERR-1027
Table 7-1
Error MessageMessage ID
TT_ERR_DBFULLTTERR-1059
TT_ERR_DBUPDATETTERR-1058
TT_ERR_DISPOSITIONTTERR-1046
TT_ERR_FILETTERR-1028
TT_ERR_INTERNALTTERR-1051
TT_ERR_LASTTTERR-2047
TT_ERR_MODETTERR-1031
TT_ERR_NO_MATCHTTERR-1053
TT_ERR_NOMEMTTERR-1062
TT_ERR_NOMPTTERR-1033
TT_ERR_NOTHANDLERTTERR-1034
TT_ERR_NO_VALUETTERR-1050
TT_ERR_NUMTTERR-1035
TT_ERR_OBJIDTTERR-1036
TT_ERR_OPTTERR-1037
TT_ERR_OTYPETTERR-1038
TT_ERR_OVERFLOWTTERR-1055
TT_ERR_PATHTTERR-1040
TT_ERR_POINTERTTERR-1041
TT_ERR_PROCIDTTERR-1042
TT_ERR_PROPLENTTERR-1043
TT_ERR_PROPNAMETTERR-1044
TT_ERR_PTYPETTERR-1045
Table 7-1
Error MessageMessage ID
TT_ERR_PTYPE_STARTTTERR-1056
TT_ERR_READONLYTTERR-1052
TT_ERR_SCOPETTERR-1047
TT_ERR_SESSIONTTERR-1048
TT_ERR_SLOTNAMETTERR-1063
TT_ERR_STATETTERR-1061
TT_ERR_UNIMPTTERR-1054
TT_ERR_VTYPETTERR-1049
TT_ERR_XDRTTERR-1064
TT_OKTTERR-0
TT_STATUS_LASTTTERR-2048
TT_WRN_APPFIRSTTTERR-512
TT_WRN_LASTTTERR-1024
TT_WRN_NOTFOUNDTTERR-1
TT_WRN_SAME_OBJIDTTERR-4
TT_WRN_STALE_OBJIDTTERR-2
TT_WRN_START_MESSAGETTERR-5
TT_WRN_STOPPEDTTERR-3
Table 7-2 describes the ToolTalk error messages; the error messages are listed in order of their message id.
Table 7-2
Error MessageMessage IDError Message StringDescriptionSolution
TT_OKTTERR-0TT_OK
Request successful.
The call was completed
successfully.

TT_WRN_NOTFOUNDTTERR-1TT_WRN_NOTFOUND The object was not removed because it was not found.The ToolTalk service could not find the specified object in the ToolTalk database. The destroy operation did not succeed.
TT_WRN_STALE_OBJIDTTERR-2TT_WRN_STALE_OBJID The object attribute in the message has been replaced with a newer one. Update the place from which the object id was obtained.When the ToolTalk service looked up the specified object in the ToolTalk database, it found a forwarding pointer to the object.The ToolTalk service automatically puts the new objid in the message.

a. Use

tt_message_object() to retrieve the new objid.

b. Update any internal application references to the new objid.

TT_WRN_STOPPEDTTERR-3TT_WRN_STOPPED The query was halted by the filter procedure.The query operation being performed was halted by the Tt_filter_function.
TT_WRN_SAME_OBJIDTTERR-4TT_WRN_SAME_OBJID The moved object retains the same objid.The object moved stayed within the same file system. The ToolTalk service will retain the same objid and update the location.
TT_WRN_START_MESSAG ETTERR-5TT_WRN_START_MESSAGE This message caused this process to be started. This message should be replied to even if it is a notice.When the ToolTalk service starts an application to deliver a message to it, a reply to that message must be sent even if the message which ToolTalk is attempting to deliver is a notice.Use

tt_message_accept() or tt_message_reply() to reply to, fail, or reject the message after the process is started by the ToolTalk service.

Table 7-2
Error MessageMessage IDError Message StringDescriptionSolution
TT_WRN_APPFIRSTTTERR-512TT_WRN_APPFIRST This code should be unused.This code marks the beginning of the messages allocated for ToolTalk application warnings.
TT_WRN_LASTTTERR-1024TT_WRN_LAST This code should be unused.This code marks the last of the messages allocated for ToolTalk warnings.
TT_ERR_CLASSTTERR-1025TT_ERR_CLASS The Tt_class value passed is invalid.The ToolTalk service does not recognize the class value specified.The Tt_class values are TT_NOTICE and TT_REQUEST. Retry the call with one of these values.
TT_ERR_DBAVAILTTERR-1026TT_ERR_DBAVAIL A required database is not available. The condition may be temporary, trying again later may work.The ToolTalk service could not access the ToolTalk database needed for this operation.a. Check if the file server or workstation that contains the database is available. b. Try the operation again later.
TT_ERR_DBEXISTTTERR-1027TT_ERR_DBEXIST A required database does not exist. The database must be created before this action will work.The ToolTalk service did not find the specified ToolTalk database in the expected place.Install the rpc.ttdbserved program on the machine that stores the file or object involved in this operation.
TT_ERR_FILETTERR-1028TT_ERR_FILE File object could not be found.The file specified does not exist or is not accessible.a. Check the file path name and retry the operation. b. Check if the machine where the file is stored is accessible.
TT_ERR_MODETTERR-1031TT_ERR_MODE The Tt_mode value is not valid.The ToolTalk service does not recognize the specified mode value.The Tt_mode values are TT_IN, TT_OUT, and TT_INOUT. Retry the call with one of these values.
Table 7-2
Error MessageMessage IDError Message StringDescriptionSolution
TT_ERR_ACCESSTTERR-1032TT_ERR_ACCESS An attempt was made to access a ToolTalk object in a way forbidden by the protection system.You do not have the necessary access to the object and the application; for example, you do not have permission to destroy an object spec. Therefore, the operation cannot be performed.a. Obtain proper access to the object. b. Retry the operation.
TT_ERR_NOMPTTERR-1033TT_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.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.a. Verify that the ToolTalk service is installed. b. Verify that ttsession is installed on the machine in use.
TT_ERR_NOTHANDLERTTERR-1034TT_ERR_NOTHANDLE Only the handler of the message can do this.Only the handler of a message can perform this operation. This application is not the handler for this message.
TT_ERR_NUMTTERR-1035TT_ERR_NUM The integer value passed is not valid.An invalid integer value that was out-of-range was passed to the ToolTalk service.

Note: Simple out-of-range conditions, such as requesting the third value of a property that has only two values, return a null value.

Check the integer specified.
TT_ERR_OBJIDTTERR-1036TT_ERR_OBJID The object id passed does not refer to any existing object spec.The objid does not reference an existing objectt.Update the spec property that contains the objid specified.
TT_ERR_OPTTERR-1037TT_ERR_OP

The operation name passed is not syntactically valid.

The specified operation name is null or contains non-alphanumeric characters.a. Remove any non-alphanumeric characters. b. Retry the operation.
Table 7-2
Error MessageMessage IDError Message StringDescriptionSolution
TT_ERR_OTYPETTERR-1038TT_ERR_OTYPE The object type passed is not the name of an installed object type.The ToolTalk service could not locate the specified otype.Check the type of the object with tt_spec_type(). If the application was recently installed and the ToolTalk service has not reread the ToolTalk Types Database: a. Locate the process id for the ttsession. b. Force the reread with the USR-2 signal: % ps -elf | grep ttsession

% kill -USR2 <ttsession pid>

TT_ERR_ADDRESSTTERR-1039TT_ERR_ADDRESS The Tt_address value passed is not valid.The ToolTalk service does not recognize the address value specified.The Tt_address values are TT_PROCEDURE, TT_OBJECT, TT_HANDLER, and TT_OTYPE. Retry the call with one of these values.
TT_ERR_PATHTTERR-1040TT_ERR_PATH One of the directories in the file path passed does not exist or cannot be read.The ToolTalk service was not able to read a directory in the specified file path name.a. Check the pathname to ensure access to the specified directories. b. Check the machine where the file resides to make sure it is accessible.
TT_ERR_POINTERTTERR-1041TT_ERR_POINTER The opaque pointer (handle) passed does not indicate an object of the proper type.The pointer 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.a. Check the arguments for the ToolTalk function to find what arguments the function expects. b. Retry the operation with a pointer for a valid object.
TT_ERR_PROCIDTTERR-1042TT_ERR_PROCID The process id passed is not valid.The process identifier specified is out of date or invalid.Retrieve the default procid with tt_default_procid().
Table 7-2
Error MessageMessage IDError Message StringDescriptionSolution
TT_ERR_PROPLENTTERR-1043TT_ERR_PROPLEN The property value passed is too long.The ToolTalk service accepts property values of up to 64 characters.Shorten the property value to less than 64 characters.
TT_ERR_PROPNAMETTERR-1044TT_ERR_PROPNAME The property name passed is syntactically invalid.The property name is too long, contains non-alphanumeric characters, or is null.Check the property name, modify if necessary, and retry the operation.
TT_ERR_PTYPETTERR-1045TT_ERR_PTYPE The process type passed is not the name of an installed process type.The ToolTalk service could not locate the specified ptype.If the application was recently installed and the ToolTalk service has not reread the ToolTalk Types Database: a. Locate the process id for the ttsession. b. Force the reread with the USR-2 signal: % ps -elf | grep ttsession % kill -USR2 <ttsession pid>
TT_ERR_DISPOSITIONTTERR-1046TT_ERR_DISPOSITION The Tt_disposition value passed is not valid.The disposition passed is not recognized by the ToolTalk service.The Tt_disposition values are TT_DISCARD, TT_QUEUE, and TT_START. Retry the call with one of these values.
TT_ERR_SCOPETTERR-1047TT_ERR_SCOPE The Tt_scope value passed is not valid.The scope passed is not recognized by the ToolTalk service.The Tt_scope values are TT_SESSION and TT_FILE. Retry the call with one of these values.
TT_ERR_SESSIONTTERR-1048TT_ERR_SESSION The session id passed is not the name of an active session.An out-of-date or invalid ToolTalk session was specified.Either:

a. obtain the sessid of the current default session using tt_default_session() b. obtain the sessid of the initial session in which the application was started using tt_initial_session()

Table 7-2
Error MessageMessage IDError Message StringDescriptionSolution
TT_ERR_VTYPETTERR-1049TT_ERR_VTYPE The value type name passed is not valid.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.a. Change the type of the value to either int or string. b. Retry the operation.
TT_ERR_NO_VALUETTERR-1050TT_ERR_NO_VALUE No property value with the given name and number exists.The ToolTalk service could not locate a value for the property specified in the ToolTalk database.Retrieve the current list of properties to find the property.
TT_ERR_INTERNALTTERR-1051TT_ERR_INTERNAL Internal error (bug)The ToolTalk service has suffered an internal error.a. Restart all applications that are using the ToolTalk service. b. Report the error to the your system vendor support center.
TT_ERR_READONLYTTERR-1052TT_ERR_READONLY The attribute cannot be changed.The application does not have ownership or write permissions for the attribute. Therefore, this operation cannot be performed.
TT_ERR_NO_MATCHTTERR-1053TT_ERR_NO_MATCH No handler could be found for this message, and the disposition was not queue or start.The message the application sent could not be delivered. No applications that are running have registered interest in this type of message.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_UNIMPTTERR-1054TT_ERR_UNIMP Function not implemented.The ToolTalk function called is not implemented.
Table 7-2
Error MessageMessage IDError Message StringDescriptionSolution
TT_ERR_OVERFLOWTTERR-1055TT_ERR_OVERFLOW Too many active messages (try again later).The ToolTalk service has received the maximum amount of active messages (2000) it can properly handle.Either:

a. Retrieve any messages that the ToolTalk service may be queueing for the application, and send the message again later.

b. Start ttsession 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_STARTTTERR-1056TT_ERR_PTYPE_START Attempt to launch a client specified in the start attribute of a ptype failed.The ToolTalk service could not start the type of process specified.Verify that the application that the ptype represents is properly installed and has execute permission.
TT_ERR_CATEGORYTTERR-1057TT_ERR_CATEGORY Pattern object has no category set.The category was not set.
TT_ERR_DBUPDATETTERR-1058TT_ERR_DBUPDATE The database is inconsistent: another tt_spec_write updated object first.The ToolTalk service could not update the database because the specified object was already updated by a previous tt_spec_write call.
TT_ERR_DBFULLTTERR-1059ToolTalk database is full.The ToolTalk service could not write to the database because it is full.Create more space on the file system in which the database is stored.
TT_ERR_DBCONSISTTTERR-1060Database is access information is incomplete or database is corrupt (run ttdbck).The ToolTalk service could not write to the database because it is either corrupt, or the access information is incomplete.Run the ttdbck utility to repair the database.
Table 7-2
Error MessageMessage IDError Message StringDescriptionSolution
TT_ERR_STATETTERR-1061The Tt_message is in a state that is not valid for the attempted operation.The state of the message is invalid for the type of operation being requested.
TT_ERR_NOMEMTTERR-1062No more memory.There is not enough available memory to perform the operation.Check the swap space, then retry the operation.
TT_ERR_SLOTNAMETTERR-1063The slot name is syntactically invalid.The syntax for the slot name is not valid.Correct the syntax for the slot name.
TT_ERR_XDRTTERR-1065The XDR procedure failed on the given data, or evaluated to a 0 length structure.The XDR procedure failed on the given data, or evaluated to a 0 length structure.
TT_ERR_APPFIRSTTTERR-1536TT_ERR_APPFIRST This code should be unused.This code marks the beginning of the messages allocated for ToolTalk application errors.
TT_ERR_LASTTTERR-2047TT_ERR_LAST This code should be unused.This code marks the last of the messages allocated for ToolTalk errors.
TT_STATUS_LASTTTERR-2048TT_STATUS_LAST This code should be unused.This code marks the last of the messages allocated for ToolTalk status.