Documentation Home
> Common Desktop Environment: ToolTalk Messaging Overview
Common Desktop Environment: ToolTalk Messaging Overview
Book Information
Preface
Chapter 1 Introducing the ToolTalk Service
What Kind of Work Problems Can the ToolTalk Service Solve?
Tool Interchangeability
Control Integration
Network-Transparent Events
Automatic Tool Invocation
Distributed-Object System
Persistent Objects
Scenarios Illustrating How the ToolTalk Service Helps Solve Work Problems
Using the ToolTalk Desktop Services Message Set
The Smart Desktop
Integrated Toolsets
Using the ToolTalk Document and Media Exchange Message Set
Integrating Multimedia Functionality
Adding Multimedia Extensions to Existing Applications
Extending the X Cut-and-Paste Facility
How Applications Use ToolTalk Messages
Sending ToolTalk Messages
Message Patterns
Receiving ToolTalk Messages
ToolTalk Message Distribution
Process-Oriented Messages
Object-Oriented Messages
Determining Message Delivery
Sessions
Files
Modifying Applications to Use the ToolTalk Service
Chapter 2 How to Use ToolTalk Messaging
Telling Your Application About ToolTalk Functionality
Using the Messaging Toolkit and Including ToolTalk Commands
Using the ToolTalk Libraries
Before You Start Coding
What Is the Difference Between an Event and an Operation?
Sending Notices
Sending Requests
Developing a Scenario
How Will the Tools Work Together?
What Kinds of Operations Do the Tools Perform?
What Kinds of Operations Can the Tools Ask Other Tools to Perform?
What Events Will the Tools Generate That May Interest Other Tools?
What Events Generated by Other Tools Will Be of Interest to This Tool?
Preparing Your Application for Communication
Creating a Ptype File
Testing for Existing Ptypes in Current Session
Merging a Compiled Ptype File into a Currently Running ttsession
Tasks Every ToolTalk-aware Application Needs to Perform
Initializing the Toolkit
Joining the ToolTalk Session and Registering Message Patterns
Adding the ToolTalk Service to Event Loop
Tasks ToolTalk-aware Editor Applications Need to Perform
Writing a Media Load Pattern Callback
Declaring a Ptype
Passing Media Load Pattern Callbacks
Replying When Request Is Completed
Optional Tasks ToolTalk-aware Editor Applications Can Perform
Requesting Modify, Revert, or Save Operations
Notifying When a File Is Modified, Reverted, or Saved
Quitting a File
Chapter 3 Using TTSnoop to Debug Messages and Patterns
About TTSnoop
Where to Find TTSnoop
Starting TTSnoop
Composing and Sending Messages
Composing and Registering Patterns
Displaying Message Components
Sending Pre-Created Messages
Receiving Messages
Stop Receiving Messages
Chapter 4 Using ToolTalk Tracing
Accessing ToolTalk Tracing
Controlling Tracing
Controlling libtt Tracing
Controlling Client-Side Tracing
Tracing Message Traffic in a ToolTalk Session
Tracing ToolTalk Calls and Messages through the Server
Formats of Traced Functions
Message Summary Format
State Change Format
Message Delivery Format
Matching Format
Examples
Registering a Pattern and Sending a Matching Notice
Tracing a Message Flow
Settings for ToolTalk Tracing
Appendix A The Messaging Toolkit
General Description of the ToolTalk Messaging Toolkit
Toolkit Conventions
Using the Messaging Toolkit When Writing Applications
The ToolTalk Messaging Toolkit
ttdt_close
ttdt_file_event
ttdt_file_join
ttdt_file_notice
ttdt_file_quit
ttdt_file_request
ttdt_Get_Modified
ttdt_message_accept
ttdt_open
ttdt_Revert
ttdt_Save
ttdt_sender_imprint_on
ttdt_session_join
ttdt_session_quit
ttdt_subcontract_manage
ttmedia_Deposit
ttmedia_load
ttmedia_load_reply
ttmedia_ptype_declare
tttk_block_while
tttk_message_abandon
tttk_message_create
tttk_message_destroy
tttk_message_fail
tttk_message_receive
tttk_message_reject
tttk_op_string
tttk_Xt_input_handler
Appendix B The CoEd Demonstration Program
The CoEd Ptype File
The CoEd.C File
The Coeditor.C File
Appendix C New ToolTalk Functions
tt_error
tt_file_netfile
tt_host_file_netfile
tt_host_netfile_file
tt_message_print
tt_netfile_file
tt_pattern_print
Appendix D Examples
Example Ttdt_contract_cb
Example Ttdt_file_cb
Example Ttmedia_load_msg_cb
Example Ttmedia_load_pat_cb
Example Ptype Signature for Ttmedia_ptype_declare Function
Example for Xt Input Handler Function
Index
Numbers and Symbols
A
C
D
E
F
G
H
I
L
M
N
O
P
Q
R
S
T
U
X
© 2010, Oracle Corporation and/or its affiliates