Skip to ContentSun and Oracle Channel Sun How to Buy Log In

ToolTalk User's Guide

Contained Within

Find More Documentation

Featured Support Resources

Download this book in PDF

Previous: Glossary

Index

Symbols


$OPENWINHOME/li	201
$OPENWINHOME/lib/openwin-sys	199
() function	64
, tt	198
/etc/inet/inetd.conf	199
/usr/openwin/bin	198
tt_message_user	64
_SUN_TT_ARG_TRACE_WIDTH	32
_SUN_TT_FILE	32
_SUN_TT_HOSTNAME_MAP	32, 38
_SUN_TT_PARTITION_MAP	32, 39
_SUN_TT_SESSION	16, 32, 65, 200, 201, 202
_SUN_TT_TOKEN	32, 201
_sun_tt_token	217

A


accessing ToolTalk data from machinesnot running a ToolTalk databaseserver	37
accessing ToolTalk databases	57
adding a message pattern callback	95
adding callbacks to static patterns	89
adding files to scoped patterns	26
adding inter-operability functionality	160
adding ToolTalk code	166
.....Xedit files	166
.....Xfontsel files	174
adding values to spec properties	132
address attribute	83
address attributes	70
addressing
.....otype	80
addressing messages, methods of	10
algorithm
.....object-oriented message delivery	77
.....process-oriented messagedelivery	74
allocating storage space	145
allocation stack	143
alt.soft-sys.tooltalk	229
API header file, including in program	59
application programming interface(API)	12
application programming interface (API)libraries	30
application types, installing	41
architecture	13
arg_add call	219
args attribute	84


assigning otype, for specs	131
attributes
.....address	70, 83
.....arg	84
.....class	83
.....op	84
.....scope	70, 84
.....setting	83
attributes, of message patterns	20

B


background jobs	17
barg_add call	219
batch sessions	17
broken references	137

C


C2 qualification	226
callback routines	146
.....invoking	123
callback routines, adding to messagepatterns	95
callbacks, attached to static patterns	125
callbacks, for handlers	124
calls provided to manage informationstorage	144
CASE Interoperability Message Sets	6
CEPATH	32
changing ToolTalk-enhanced shellcommands	56
checking ToolTalk databases	18
checking ToolTalk error status	150
class attribute	83
close function	202
co-edit	18
communication process	13
comparing objids	134
components of the ToolTalk service	13
computational loops	213
connecting processes to the samesession	202
context arguments	146
context slots, used to create environmentvariables	35
contextdcl	105, 110
contexts, defined	27
contexts, to restrict matching	219
convert ToolTalk type data	30
converting ToolTalk types, script for	155
cp command	18
cpp command	41
creating a ptype file	103
creating dynamic message patterns	95
creating general messages	83
creating messages	80
creating object-oriented messages	87
creating otype files	109
creating process-oriented messages	86
creating specs	131

D


database
......check and recovery tool	30
......records	13
database server
......installing ToolTalk	35
......process	13
......redirecting	37
......redirecting file system partitions	38
......redirecting host machines	37
database server redirection files	200
database utility ttdbck	57
databases
......accessing ToolTalk	57
......check and repair utility, ttdbck	18
......displaying, checking, and repairing ofToolTalk	57
......maintaining ToolTalk	18
debugging, with ttsnoop	45
default session
......joining	97
......quitting	98
delete message	90


deleting message patterns
.....message patterns
............deleting	96
deleting messages	127
demonstration	159
demostration programs
.....co-edit	18
.....edit_demo	18, 139
.....ttsample1	18
.....ttsnoop	18
des	225
deserializing structured data	74
Desktop Services
.....Started	206
Desktop Services Message Set	2
destroying message patternsautomatically	96
destroying messages	127
destroying specs	137
determinging spec properties	132
determining who receive messages	10
directories, list and location of	29
DISPLAY	32, 201
disposition attributes	28
Document and Media Exchange MessageSet	4
dynamic message patterns	93
.....creating	95
dynamic method	19

E


edit_demo	18, 139
environment variables	31
....._SUN_TT_ARG_TRACE_WIDTH	32
....._SUN_TT_FILE	32
....._SUN_TT_HOSTNAME_MAP	32, 38
....._SUN_TT_PARTIITON_MAP	32
....._SUN_TT_PARTITION_MAP	39
....._SUN_TT_SESSION	16, 32, 65
....._SUN_TT_TOKEN	32
.....CEPATH	32
......created from message contexts	35
......DISPLAY	32
......SUN_TTSESSION_CMD	32
......TMPDIR	33
......TTPATH	32
error handling functions	150
error macros	150
error propagation	154
error status	149
......checking	150
......retrieving	150
error value	150
errors, process type	44
event loop	213
examining messages	120
examining spec information	134
examining type information	43

F


failed connection, causes of	36
failing requests	127
features, of the ToolTalk service	146
features, of ToolTalk	8
file	204
......ToolTalk concept of	11
file information
......managing	138
file query functions	147
file scope	71
file scoping, restrictions	11
file scoping, restrictions to	22
file-in-session scope	73
files
......hostname_map	37
......list and location of	29
......maintaining ToolTalk	18
......managing with object data	137
......object type	107
......partition_map	38
......XDR format	14
files of interest
......joining	99


.....quitting	99
file-scoped message flow	207
file-scoped messages, queued	226
filter routines	147
free storage space	90
freeing allocated storage space	146
functions
.....tt_message_user	64
functions with natural return values	150
functions without natural returnvalues	150

H


handling replies easily	120
handling requests	125
header file	30
help on how to invoke ttsession	15
hostname qualification of pathnames,explicit	228
hostname_map file	37
how applications use ToolTalkmessages	8
how the ToolTalk technology works	163

I


iarg_add call	219
identifying data in existing files	130
identifying messages easily	119
information provided by the ToolTalkservice	143
information provided to the ToolTalkservice	143
informing sender of failed request	127
initial session	60
initializing your process	61
installing application types	41
installing the ToolTalk database server
.....from a remote machine	36
installing theToolTalk database server	35
installing type information	112
invoking callback routines	123

J


joining default sessions	97
joining files of interest	99
joining multiple sessions	98

K


kill command	44

L


LD_LIBRARY_PATH	201
li	198
libtt	14, 202, 215
libtt.a	199
libtt.s	199
libtt.so	201
load balancing	213

M


maintaining specs	133
maintaining ToolTalk files anddatabases	18
managing files that contain objectdata	137
managing object and file information	138
manpages, location of ToolTalk	31
manually starting a session	15
marking information for storage	144
marking the ToolTalk API stack	120
merging compiled ToolTalk type files intorunning ttsession	112
merging type information	112
message
......delete	90
message attributes	69
message attributes, comparing to patternattributes	21
message callback	146


message callbacks	124
message callbacks, adding	87
message delivery
.....object-oriented algorithm	77
.....process-oriented algorithm	74
message paterns
.....unregistering	96
message pattern attributes	20
message patterns	9, 19
.....adding callbacks to	95
.....automatically unregistering anddestroying	96
.....minimum specifications	21
.....static	101
.....updating	97
message protocol	12
message_status_string	214
messages
.....completing	80
.....creating	80
.....creating general-purpose	83
.....deleting	127
.....determining recipients of	9
.....examining	120
.....handling	9
.....identifying and processing easily	119
.....methods of addressing	10
.....object-oriented	10
.....observing	9
.....process-oriented	10
.....receiving	9
.....sending	8, 90
messages, retrieving	117
MIT X	201
modifying applications	160
.....xedit	160
.....xfontsel	161
modifying applications to sendmessages	80
modifying makefile	161
modifying your application to use theToolTalk service	12
moving objects between file systems	136
moving objects between files	136
multiple processes	213
multiple sessions
......storing session ids of sessions	98
multiple sessions, joining	98
mv command	18, 56

N


network types database, converting	157
networked envirnoments	65
news group, ToolTalk	229
notice	67
notifying processes if tool exitsunexpectedly	153

O


object content	130
object data	129
object information
......managing	138
object specification (spec)	130
object type (otype)	107
object-oriented message delivery	77
object-oriented messages	10, 129
......creating	87
objects
......moving between file systems	136
......moving between files	136
......ToolTalk	130
objects, ToolTalk	228
objid
......comparing	134
......obtaining	131
......obtaining new	133
......retrieving new	133
obtaining new objid	133
obtaining objid	131
op attribute	84
otype
......assigning for specs	131
otype addressing	80


otype file	107
otype files
.....creating	109
.....header information	109
.....signature information	110
otype files, installing	41
otype signature	108
otypes, examining information	43

P


partition_map file	38
pattern attributes, comparing to messageattributes	21
pattern callback	146
pattern callbacks	124
pointers, to API objects	146
point-to-point (PTP) message passingfeature	83
point-to-point messages	124
process
.....communication	13
.....database server	13
process identifier (procid)	61
process type (ptype)	101
process type errors	44
process type, declaring	113
processing messages easily	119
process-oriented message delivery	74
process-oriented messages	10
.....creating	86
procid	61, 204
.....closing default	65
.....setting default	61
Project DOE	198
ps command	44
ptype	204
ptype file, creating	161
ptype files
.....creating	103
.....property information	104
.....registering	102
......registering with ToolTalk	113
......signature information	105
......unregistering with ToolTalk	115
ptype files, installing	41
ptype signature	102
ptype, installing	162
ptypes, check for existing	112
ptypes, examining information	43
ptypes, multiple	115
ptypes, undeclaring	115

Q


quitting default session	98
quitting files of interest	99

R


read in the types from database	16
reading
......hostname_map files	38
......partition_map files	39
reading ToolTalk data from read-only filesystem partitions	37
read-only file systems	130
read-only files, creating objects of piecesof	130
realpath	228
receiving ToolTalk messages	9
recipients	8
recognizing replies easily	120
records database	13
redirecting file system partitions	38
redirecting host machines	37
redirecting the ToolTalk databaseserver	37
register file scope patterns	204
registering
......in a specified session	62
......in the initial session	61
......with the ToolTalk service	60
registering in multiple sessions	63
registering ptypes	102


rejecting requests	127
removing type information	43
repairing ToolTalk databases	18
replies
.....recognizing and handling easily	120
replying to requests	125
request	67
requests
.....failing	127
.....handling	125
.....informing sender of failed	127
.....rejecting	127
.....replying to	125
reread types file	16
rereading type information	44
retrieving new obji	90
retrieving new objid	133
retrieving ToolTalk error status	150
return value
.....natural	150
.....no natural	150
returned integer, status	152
returned pointer, status	151
returned value, status	150
reverting to previous versions of theToolTalk database	37
rm command	18, 57
routines
.....callback	146
.....filter	147
rpc.ttdbserverd	13, 130, 198
running the new ToolTalk databaseserver	37
runtime stack	143

S


same process, sending and receivingmessages in	64
scenarios illustrating the ToolTalk servicein use	2
scope attribute	84
scope attributes	70
......file	71
......file-in-session	73
......session	73
scope, to union of TT_FILE_IN_SESSIONand TT_SESSION	71
scopes, that use files	71
scopes, types of	22
scoping messages to every client withregistered interest	73
scoping to file in session	24
scoping to file only	23
scoping to files and sessions	25
scoping to session only	22
senders	8
sending messages	90
......modifying applications	80
sending notices	67
sending requests	68
sending ToolTalk messages	8
serializing structured data	74
server authentication level	15
session identifier (sessid)	11
session identifiers, multiple for onesession	15
session scope	73
session, ToolTalk concept of	10
sessions bound to a character terminal	17
session-scoped message flow	206
session-scoped messages, queued	226
setting attributes	83
setting up to receive messages	63
share/include/desktop	198
shell commands
......standard
............cp	18
............mv	18, 56
............rm	18, 57
......ToolTalk-enhanced	18, 29, 56, 138
............changing	56
............ttmv	56
shell commands, ToolTalk-enhanced


.....ttcp	56, 138
.....ttmv	56, 138
.....ttrm	56, 138
.....ttrmdir	56, 138
.....tttar	56, 138
shell scripts
.....ttrsh	33
signals, to which ttsession responds	16
signatures
.....otype	108
.....ptype	102
SIGUSR1 signal	16
SIGUSR2 signal	16
silent operation	15
specSee object specification
spec, destroying an object	137
specs
.....adding values to properties	132
.....assigning otype	131
.....creating	131
.....destroying	137
.....determining properties	132
.....examining information	134
.....maintaining	133
.....moving objects	136
.....querying for objects	134
.....storing properties	132
.....updating	133
.....updating existing properties	132
.....writing into ToolTalk database	132
start a process tree session	16
start process tree sessions	16
starting a session manually	15
starting a ToolTalk session	15
starting programs on remote hosts	33
state change messages	69
static message patterns	101
static method	19
static patterns
.....adding callbacks	89
.....attaching callbacks	125
storing
.....hostname_map files	38
......partition_map files	38
storing spec properties	132
_SUN_TT_SESSION	16
SUN_TT_SESSION	203
SUN_TTSESSION_CMD	32
switching between multiple sessions	205
system types database, converting	156

T


-t option	206
-t option, of ttsnoop	45
TMPDIR environment variable	33
ToolTalk database server
......reverting to previous versions	37
......running new	37
ToolTalk message sets
......Desktop	2
......Document and Media Exchange	4
ToolTalk messages	8
ToolTalk object	130
ToolTalk service	1
ToolTalk type compiler tt_type_comp	107
ToolTalk types databases, moving	158
ToolTalk-enhanced shell commands	138
trace mode	16, 206, 217, 226
trace mode, toggling	16
TT_BOTH	25
tt_c.h	199
TT_CALLBACK_CONTINUE	208
TT_CALLBACK_PROCESSED	208
tt_close	65, 96, 202
tt_default_file	228
tt_default_session_set	62, 204
tt_fd	61, 62
TT_FILE	23
TT_FILE_IN_SESSION	24
tt_file_join	99
tt_file_objects_query	134, 147
tt_file_quit	99
TT_HANDLED	118


tt_int_error	152
tt_is_err	151, 152
tt_message__set	83
tt_message_accept	120, 216
tt_message_callback_add	87, 120, 211
tt_message_create	83
tt_message_destroy	87, 90, 127
tt_message_fail	127
tt_message_file	72, 228
tt_message_file attribute	212
tt_message_file_set	73
tt_message_object	90, 133
tt_message_receive	117, 124, 208, 213, 214
tt_message_reject	127, 213, 216
tt_message_send	137
tt_message_send_on_exit	153
tt_message_status_set	127
tt_message_status_string_set	127
tt_message_user call	209
tt_message_user_set	120
tt_objid_equal	134
tt_onotice_create	87
tt_open	61, 62, 199, 217
tt_orequest_create	87
tt_pattern_add	95
tt_pattern_callback_add	95, 119
tt_pattern_create	95
tt_pattern_destroy	96
tt_pattern_register	96
tt_pattern_set	95
tt_pattern_unregister	96, 113, 214
tt_pnotice_create	86
tt_pointer_error	151
tt_prequest_create	86
tt_ptype_declare	113
tt_ptype_undeclare	113, 115
TT_SESSION	22
tt_session_join	97
tt_session_quit	98
tt_spec_bprop	134
tt_spec_create	131
tt_spec_destroy	137
tt_spec_file	134
tt_spec_move	136
tt_spec_prop	134
tt_spec_prop_add	132
tt_spec_prop_set	132
tt_spec_type	134
tt_spec_type_set	131
tt_spec_write	132
Tt_status	65
tt_status_message	151
tt_type_comp	41, 102, 107, 199
TT_WRN_STALE_OBJID	90
TT_WRN_START_MESSAGE	120, 216
ttce2xdr	199
ttce2xdr script	155
ttcp	56, 138, 198
ttdbck	57, 199
ttdbck utility	18
ttm	198
ttmv	56, 138
ttmv command	56, 228
TTPATH	32, 200
ttrm	56, 138
ttrmdir	56, 138, 198
ttrsh shell script	33
ttsample1	18
ttsession	13, 29, 198
ttsession parameters	15
ttsnoop	18
ttsnoop utility	206
ttsnoop, debugging with	45
ttta	198
tttar	56, 138
type compiler	30
type compiler tt_type_comp	102
type information
......examining	43
......examining all types	43


.....installing	112
.....merging	112
.....reading	44
.....removing	43
types file, rereading	16
types of scopes	22

U


unix	225
unregistering a message pattern	96
unregistering message patternsautomatically	96
update existing spec properties	132
updating existing specs	133
updating message patterns	97
updating the ToolTalk service	44
user data cells	211
user type database, converting	155
USR1 signal	206

V


-v option	31
version number	16
version string	31

W


wildcarding patterns	218
writing specs, into ToolTalk database	132
writing ToolTalk data to read-only filesystem partitions	37

X


X Window System, establishing a sessionunder	17
xauth	225
XDR format file	14
Xedit	159
Xfontsel	159
XtAppAddInput call	208

Previous: Glossary