Preface
This book describes the Common Desktop Environment (CDE) components,
commands, and error messages of the ToolTalk® service.
In-depth information about the functionality of the ToolTalk service in
general is beyond the scope of this book. That is, CDE ToolTalk Messaging Overview does not describe all ToolTalk APIs or commands, or other ToolTalk
functionality not specifically related to this release of the ToolTalk service for
the Common Desktop Environment. See the
ToolTalk Reference Manual
ToolTalk Reference Manual and the
ToolTalk User'
s Guide
ToolTalk User's Guide for this information.
Who Should Use This Book
This manual is for developers who create or maintain applications that use the
ToolTalk service to inter‐operate with other applications in Common Desktop Environment
. This manual assumes familiarity with ™ ]]>operating system commands, system administrator
commands, and system terminology.
How This Book Is Organized
This book is organized as follows:
, describes how the ToolTalk
service works and how it uses information that your application supplies to
deliver messages; how applications use the ToolTalk service; and application
and ToolTalk components.
, contains the information you
need to write an application using the ToolTalk service in the Common Desktop Environment
, including the kinds of ToolTalk toolkit messages that
need to be included in your application in order for it to inter-operate with
other ToolTalk-aware Common Desktop Environment-compliant applications.
, describes how
to create and send custom‐constructed ToolTalk messages, and also how to
selectively monitor any or all ToolTalk messages.
, describes how a ToolTalk pattern
matches and delivers every message ttsession sees.
, describes some of the application
program interface (API functions) that are a part of the messaging toolkit.
, contains the source code
for the ToolTalk demo program, broadcast.
Appendix C discusses writing thread-safe ToolTalk applications.
Related Books and Other Documentation
CDE ToolTalk Messaging Overview does not provide in‐depth information about
ToolTalk functionality, in-depth information about
ToolTalk and its functionality. In addition to the ToolTalk product base
documentation (that is, ToolTalk User's Guide and the ToolTalk Reference Manual),
the following related ToolTalk documentation provide in-depth information
about the ToolTalk functionality that is beyond the
scope, of this book
scope of this book:
The ToolTalk Service - An Inter-Operability Solution, ISBN 013-088717-X
The ToolTalk Service - An Inter-Operability Solution (Published by SunSoft Press/PTR Prentice Hall, ISBN 013-088717-X)
This book describes ToolTalk and its functionality in depth, and is
appropriate for all platforms to which ToolTalk has been ported. It is
available at your local bookstore or directly from PTR Prentice Hall.
ToolTalk and Open Protocols, ISBN 013-031055-7
ToolTalk and Open Protocols by Astrid M. Julienne and Brian Holtz
(Published by SunSoft Press/PTR Prentice Hall, ISBN 013-031055-7)
This book describes how to create and develop open protocols for
applications that use a messaging service to communicate with other
applications. The general principles described in this book provide an
application with the flexibility required for users to easily inter‐change
tools. It is available at your local bookstore or directly from PTR Prentice
Hall.
ToolTalk Message Sets
ToolTalk
Desktop Services Message Set
Desktop Services Message Set
These conventions apply to any tools in a POSIX or X11 environment. In
addition to standard messages for these environments, the Desktop
conventions define data types and error codes that apply to all of the
ToolTalk inter‐client conventions.
ToolTalk
Document and Media Exchange Message Set
Document and Media Exchange Message Set
Allows a tool to be a container for arbitrary media, or to be a media
player/editor that can be driven from such a container.
CASE Inter-Operability Message Set
CASE Inter-Operability Message Set
An open specification defining abstract, framework-neutral message
interfaces for CASE set-up by Sunsoft, DEC, and SGI. This work has been
merged with HP's CASE Communique work, which defined message
interfaces for HP's SoftBench Broadcast Message Server framework, and
was submitted as a joint draft to ANSI X3H6. As of this writing, ANSI
X3H6 is still reviewing the joint submission draft. More information on
the draft
X3H6 standard
X3H6 standard can be retrieved from
ftp.netcomcom
ftp.netcom.com, in
/pub/X3H
/pub/X3H6; or you can contact:
X3 Secretariat
Computer and Business Equipment Manufactures Assoc
Computer and Business Equipment Manufactures Assoc
1250 Eye St NW
Washington DC  20005-3922
Telephone: (202) 737-8888 (press `1' twice)
Fax: (202) 638-4922 or (202) 628-2829
ToolTalk News Group
The ToolTalk
news group
news group is:
alt.soft-sys.tooltalk
alt.soft-sys.tooltalk
What DocBook SGML Markup Means
This book is written in the Structured Generalized Markup
Language (SGML) using the DocBook Document Type Definition (DTD).
The following table describes the DocBook markup used for
various semantic elements.
DocBook SGML Markup
Markup Appearance
Semantic Element(s)
Example
AaBbCc123
The names of commands.
Use the ls command to list files.
AaBbCc123
The names of command options.
Use ls −a
to list all files.
AaBbCc123
Command-line placeholder:
replace with a real name or value.
To delete a file, type rm filename.
AaBbCc123
The names of files and
directories.
Edit your .login
file.
AaBbCc123
Book titles, new words or terms, or
words to be emphasized.
Read Chapter 6 in User's
Guide.
These are called class options.
You must be root to do this.