SGI Techpubs Library
Techpubs Library
Home/Search
Books by Product
What's New
Help


IRIX 6.5 Linux Hardware Freeware (IRIX) Windows
   
To further optimize your search, select from the following options:
 Search only in:
Search only titles    Show only 1 hit/book      Results/page:


IRIX 6.5  »  Books  »  Developer  »  
ToolTalk™ Programmer's Guide
(document number: 007-1611-020  /  published: 1994-11-14)   additional info | download

The ToolTalk Programmer's Guide describes the ToolTalk service and how to modify your application to send and receive ToolTalk messages. It is for application developers who create or maintain applications and wish to use the ToolTalk message service. This manual assumes familiarity with the IRIX operating system environment. After you have read this manual, you should have an understanding of what the ToolTalk service is and how it works; what is required to integrate with the ToolTalk service; how to modify your application to send messages addressed to processes or ToolTalk objects; how to register message pattern information for the messages you want to receive; how to receive and handle messages delivered to your application by the ToolTalk service; and how to create and manage ToolTalk objects in your application's data. This manual is intended for systems running IRIX 4.0.1 or later. The manual does not provide ToolTalk installation procedures. To install the ToolTalk service, see the ToolTalk Setup and Administration Guide.

table of contents (expand all | collapse all)  |  list of figures  |  list of tables  |  list of examples  |  list of procedures  |  

   Front Matter
 - Introduction
       Who Should Use This Book
       How This Book Is Organized
       Related Books
       Typographic Conventions and Symbols Used in this Manual
 + Chapter 1. ToolTalk Overview
 - Chapter 2. Participating in ToolTalk Sessions
       Including the ToolTalk API Header File
     - Registering with the ToolTalk Service
           Registering in the Initial Session
           Registering in a Specified Session
       Setting Up to Receive Messages
       Unregistering from the ToolTalk Service
 - Chapter 3. Dynamic Message Patterns
       Message Pattern Attributes
     - Defining Dynamic Messages
           Creating a Message Pattern
           Adding a Message Pattern Callback
           Registering a Message Pattern
           Deleting and Unregistering a Message Pattern
     - Updating Message Patterns with the Current Session or File
           Joining the Default Session
           Joining Files of Interest
 - Chapter 4. Static Message Patterns
       Message Pattern Attributes
       Defining Static Messages
     - Defining Process Types
           Signatures
         - Creating a Ptype File
               Property_id Information
               Psignature Matching Information
               Psignature Actions Information
     - Defining Object Types
           Signatures
         - Creating Otype Files
               Obj_Header Information
               Osignature Information
               Osignature Actions Information
       Installing Type Information
       Making Type Information Available to the ToolTalk Service
       Declaring Process Type
       Data Type Registration
 - Chapter 5. Sending Messages
     - How the ToolTalk Service Routes Messages
           Sending Notices
           Sending Requests
     - Message Attributes
           Address Attribute
         - Scope Attributes
               File Scope
               Session Scope
               File-In-Session Scope
     + ToolTalk Message Delivery Algorithm
     - Modifying Applications to Send ToolTalk Messages
           Creating Messages
         - Using the General-Purpose Function to Create ToolTalk Messages
               Class
               Address
               Scope
               Op
               Args
           Creating Process-Oriented Messages
           Creating and Completing Object-Oriented Messages
           Adding Message Callbacks
           Sending a Message
       Request Examples
 - Chapter 6. Receiving Messages
     - Retrieving Messages
           Identifying and Processing Messages Easily
           Recognizing and Handling Replies Easily
       Examining Messages
       Invoking Callback Routines
     - Handling Requests
           Replying to Requests
         - Rejecting or Failing a Request
               Rejecting a Request
               Failing a Request
       Destroying Messages
 - Chapter 7. Objects
     - Object-Oriented Messaging
           Object Data
     - Creating Object Specs
           Assigning Otypes
           Determining Object Specification Properties
           Storing Spec Properties
           Adding Values to Properties
       Writing Object Specs
       Updating Object Specs
     + Maintaining Object Specs
       Destroying Object Specs
     - Managing Object and File Information
           Managing Files that Contain Object Data
           Managing Files that Contain ToolTalk Information
       Examples
 - Chapter 8. Managing Information Storage
       Information Provided to the ToolTalk Service
       Information Provided by the ToolTalk Service
     - Calls Provided to Manage the Storage of Information
         - Marking and Releasing Information
               Marking Information for Storage
               Releasing Information No Longer Needed
               Example of Marking and Releasing Information
         - Allocating and Freeing Storage Space
               Allocating Storage Space
     - Special Case: Callback and Filter Routines
           Callback Routines
           Filter Routines
 - Chapter 9. Handling Errors
     - Retrieving ToolTalk Error Status
           Checking ToolTalk Error Status
         - Returned Value Status
               Functions with Natural Return Values
               Functions with No Natural Return Values
       Returned Pointer Status
       Returned Integer Status
       Error Propagation
 + Chapter 10. ToolTalk API
   Appendix A. Quick Reference to ToolTalk API
 - Appendix B. ToolTalk API Summary (Functional Grouping)
       Initialization
       Message Patterns
       Session
       Files
       Messages
       Objects
       ToolTalk Storage Management
       ToolTalk Error Status
       Exiting
       ToolTalk Error-Handling Macros
   Appendix C. Initialization Error Messages
 - Appendix D. ToolTalk Error Messages
       TT_WRN_NOTFOUND
       TT_WRN_NOTFOUND
       TT_WRN_STALE_OID
       TT_WRN_STOPPED
       TT_WRN_SAME_OBJID
       TT_WRN_START_MESSAGE
       TT_WRN_APPFIRST
       TT_WRN_LAST
       TT_ERR_CLASS
       TT_ERR_DBAVAIL
       TT_ERR_DBEXIST
       TT_ERR_FILE
       TT_ERR_MODE
       TT_ERR_ACCESS
       TT_ERR_NOMP
       TT_ERR_NOTHANDLER
       TT_ERR_NUM
       TT_ERR_OBJID
       TT_ERR_OP
       TT_ERR_OTYPE
       TT_ERR_ADDRESS
       TT_ERR_PATH
       TT_ERROR_OTYPE
       TT_ERR_PROCID
       TT_ERR_PROPLEN
       TT_ERR_PROPNAME
       TT_ERR_PTYPE
       TT_ERR_DISPOSITION
       TT_ERR_SCOPE
       TT_ERR_SESSION
       TT_ERR_VTYPE
       TT_ERR_NO_VALUE
       TT_ERR_INTERNAL
       TT_ERR_READONLY
       TT_ERR_NO_MATCH
       TT_ERR_UNIMP
       TT_ERR_OVERFLOW
       TT_ERR_PTYPE_START
       TT_ERR_APPFIRST
       TT_ERR_LAST
       TT_STATUS_LAST
   Index


home/search | what's new | help