Preface

This book describes the Common Desktop Environment (CDE) components, commands, and error messages of the ToolTalk^TM service.

---

Note -

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 ToolTalk APIs or commands, or other ToolTalk functionality not specifically related to this release of the ToolTalk service for the Common Desktop Environment.

---

Who Should Use This Book

This manual is for developers who create or maintain applications that use the ToolTalk service to interoperate with other applications in Common Desktop Environment. This manual assumes familiarity with the ToolTalk service and its functionality, UNIX® operating system commands, system administrator commands, and system terminology.

How This Book Is Organized

This book is organized as follows:

Chapter 1, Introducing the ToolTalk Service 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.

Chapter 2, How to Use ToolTalk Messaging 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 interoperate with other ToolTalk-aware Common Desktop Environment-compliant applications.

Chapter 3, Using TTSnoop to Debug Messages and Patterns describes how to create and send custom-constructed ToolTalk messages, and also how to selectively monitor any or all ToolTalk messages.

Chapter 4, Using ToolTalk Tracing describes how a ToolTalk pattern matches and delivers every message ttsession sees.

Appendix A, The Messaging Toolkit describes some of the application program interface (API functions) that are a part of the messaging toolkit.

Appendix B, The CoEd Demonstration Program gives the ToolTalk-related portions of the ptype, header, and .c files of the ToolTalk demo program CoEd.

Appendix C, New ToolTalk Functions describes the ToolTalk functions that map file names between local and canonical paths.

Related Books and Other Documentation

CDE ToolTalk Messaging Overview does not provide 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:

• 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.

• ToolTalk and Open Protocols (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 interchange tools.

• ToolTalk Message Sets

  • ToolTalk 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

    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

    An open specification defining abstract, framework-neutral message interfaces for CASE set up by Sun, 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. More information on the draft X3H6 standard can be retrieved from ftp.netcom.com, in /pub/X3H6; or you can contact:

    X3 SecretariatComputer and Business Equipment Manufactures Assoc1250 Eye St NWWashington DC 20005-3922Telephone: (202) 737-8888 (press `1' twice)Fax: (202) 638-4922 or (202) 628-2829

Accessing Sun Documentation Online

The docs.sun.com^SM Web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://docs.sun.com.

Typographic Conventions

The following table describes the typographic changes used in this book.

Table P-1 Typographic Conventions

Typeface or Symbol	Meaning	Example
AaBbCc123	The names of commands, files, and directories; on-screen computer output	Edit your .login file. Use ls -a to list all files. machine_name% you have mail.
AaBbCc123	What you type, contrasted with on-screen computer output	machine_name% su Password:
AaBbCc123	Command-line placeholder: replace with a real name or value	To delete a file, type rm filename.
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.

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P-2 Shell Prompts

Shell	Prompt
C shell prompt	machine_name%
C shell superuser prompt	machine_name#
Bourne shell and Korn shell prompt	$
Bourne shell and Korn shell superuser prompt	#