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
     - ToolTalk Scenarios
           Connecting and Coordinating Programs
           Automating the Design Process
     - 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
       ToolTalk Architecture
     - Starting a ToolTalk Session
           Background and Batch Sessions
           X Window System
       Location of the ToolTalk Service Files
       Sample Programs
 - 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
     - ToolTalk Message Delivery Algorithm
         - Process-Oriented Message Delivery
               Example
         - Object-Oriented Message Delivery
               Example
           Otype addressing
     - 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
           Examining Spec Information
           Comparing Object Specs
           Querying for Specific Specs in a File
           Moving 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
     - 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
       Returned Pointer Status
       Returned Integer Status
       Error Propagation
 - Chapter 10. ToolTalk API
     - ToolTalk Enumerated Types
           Tt_address
           Tt_callback
           Tt_category
           Tt_class
           Tt_disposition
           Tt_filter
           Tt_mode
           Tt_scope
           Tt_state
           Tt_status
     - ToolTalk Functions
         - tt_close
               Returned Value
               Related Functions
         - tt_default_file
               Returned Value
               Related Functions
         - tt_default_file_set
               Arguments
               Returned Value
         - tt_default_procid
               Returned Value
         - tt_default_procid_set
               Arguments
               Returned Value
               Related Functions
         - tt_default_ptype
               Returned Value
               Related Functions
         - tt_default_ptype_set
               Arguments
               Returned Value
         - tt_default_session
               Returned Value
               Related Functions
         - tt_default_session_set
               Arguments
               Returned Value
               Related Functions
         - tt_error_int
               Arguments
               Returned Value
         - tt_error_pointer
               Arguments
               Returned Value
         - tt_fd
               Returned Value
               Related Functions
         - tt_file_copy
               Arguments
               Returned Value
               Related Functions
         - tt_file_destroy
               Arguments
               Returned Value
               Related Functions
         - tt_file_join
               Arguments
               Returned Value
         - tt_file_move
               Arguments
               Returned Value
               Related Functions
         - tt_file_objects_query
               Arguments
               Returned Value
         - tt_file_quit
               Arguments
               Returned Value
         - tt_free
               Arguments
         - tt_initial_session
               Returned Value
         - tt_int_error
               Arguments
               Returned Value
         - tt_is_err
               Arguments
               Returned Value
         - tt_malloc
               Arguments
               Returned Value
               Related Functions
         - tt_mark
               Returned Value
               Related Functions
         - tt_message_address
               Arguments
               Returned Value
         - tt_message_address_set
               Arguments
               Returned Value
         - tt_message_arg_add
               Arguments
               Returned Value
               Related Functions
         - tt_message_arg_bval
               Arguments
               Returned Values
         - tt_message_arg_bval_set
               Arguments
               Returned Values
               Related Functions
         + tt_message_arg_ival
         - tt_message_arg_ival_set
               Arguments
               Returned Values
               Related Functions
         - tt_message_arg_mode
               Arguments
               Returned Value
         - tt_message_arg_type
               Arguments
               Returned Value
         + tt_message_arg_val
         - tt_message_arg_val_set
               Arguments
               Returned Values
         - tt_message_args_count
               Arguments
               Returned Value
         - tt_message_barg_add
               Arguments
               Returned Values
               Related Functions
         - tt_message_callback_add
               Arguments
               Returned Values
         - tt_message_class
               Arguments
               Returned Value
         - tt_message_class_set
               Arguments
               Returned Values
         + tt_message_create
         - tt_message_create_super
               Arguments
               Returned Value
               Related Functions
         - tt_message_destroy
               Arguments
               Returned Value
               Related Functions
         - tt_message_disposition
               Arguments
               Returned Value
         - tt_message_disposition_set
               Arguments
               Returned Value
         - tt_message_fail
               Arguments
               Returned Value
               Related Functions
         - tt_message_file
               Arguments
               Returned Value
         - tt_message_file_set
               Arguments
               Returned Value
         - tt_message_gid
               Arguments
               Returned Value
               Related Functions
         - tt_message_handler
               Arguments
               Returned Value
         - tt_message_handler_ptype
               Arguments
               Returned Value
         - tt_message_handler_ptype_set
               Arguments
               Returned Value
         - tt_message_handler_set
               Arguments
               Returned Value
         - tt_message_iarg_add
               Arguments
               Returned Value
               Related Functions
         - tt_message_object
               Arguments
               Returned Value
         - tt_message_object_set
               Arguments
               Returned Value
         - tt_message_op
               Arguments
               Returned Value
         - tt_message_op_set
               Arguments
               Returned Value
         + tt_message_opnum
         - tt_message_otype
               Arguments
               Returned Value
         - tt_message_otype_set
               Arguments
               Returned Value
         - tt_message_pattern
               Arguments
               Returned Value
         - tt_message_receive
               Returned Value
         - tt_message_reject
               Arguments
               Returned Value
         - tt_message_reply
               Arguments
               Returned Value
         - tt_message_scope
               Arguments
               Returned Value
         - tt_message_scope_set
               Arguments
               Returned Value
         - tt_message_send
               Arguments
               Returned Value
         - tt_message_sender
               Arguments
               Returned Value
         - tt_message_sender_ptype
               Arguments
               Returned Value
         - tt_message_sender_ptype_set
               Arguments
               Returned Value
         - tt_message_session
               Arguments
               Returned Value
         - tt_message_session_set
               Arguments
               Returned Value
         - tt_message_state
               Arguments
               Returned Value
         - tt_message_status
               Arguments
               Returned Value
               Related Functions
         - tt_message_status_set
               Arguments
               Returned Value
         - tt_message_status_string
               Arguments
               Returned Value
               Related Functions
         + tt_message_status_string_set
         - tt_message_uid
               Arguments
               Returned Value
               Related Functions
         + tt_message_user
         - tt_message_user_set
               Arguments
               Returned Value
               Related Functions
         - tt_objid_equal
               Arguments
               Returned Value
         - tt_objid_objkey
               Arguments
               Returned Value
         - tt_onotice_create
               Arguments
               Returned Value
         - tt_open
               Returned Value
               Related Functions
         - tt_orequest_create
               Arguments
               Returned Value
         - tt_otype_base
               Arguments
               Returned Value
               Related Functions
         - tt_otype_derived
               Arguments
               Returned Value
               Related Functions
         - tt_otype_deriveds_count
               Arguments
               Returned Value
               Related Functions
         - tt_otype_hsig_arg_mode
               Arguments
               Returned Value
               Related Functions
         - tt_otype_hsig_arg_type
               Arguments
               Returned Value
               Related Functions
         - tt_otype_hsig_args_count
               Arguments
               Returned Value
               Related Functions
         - tt_otype_hsig_count
               Arguments
               Returned Value
               Related Functions
         - tt_otype_hsig_op
               Arguments
               Returned Value
               Related Functions
         - tt_otype_is_derived
               Arguments
               Returned Value
               Related Functions
         - tt_otype_osig_arg_mode
               Arguments
               Returned Value
               Related Functions
         - tt_otype_osig_arg_type
               Arguments
               Returned Value
               Related Functions
         - tt_otype_osig_args_count
               Arguments
               Returned Value
               Related Functions
         + tt_otype_osig_count
         - tt_otype_osig_op
               Arguments
               Returned Value
               Related Functions
         - tt_pattern_address_add
               Arguments
               Returned Value
         - tt_pattern_arg_add
               Arguments
               Returned Value
               Related Functions
         - tt_pattern_barg_add
               Arguments
               Returned Value
               Related Functions
         - tt_pattern_callback_add
               Arguments
               Returned Value
               Related Functions
         - tt_pattern_category
               Arguments
               Returned Value
               Related Functions
         - tt_pattern_category_set
               Arguments
               Returned Value
               Related Functions
         - tt_pattern_class_add
               Arguments
               Returned Value
         - tt_pattern_create
               Returned Value
               Related Functions
         - tt_pattern_destroy
               Arguments
               Returned Value
               Related Functions
         - tt_pattern_disposition_add
               Arguments
               Returned Value
         - tt_pattern_file_add
               Arguments
               Returned Value
         - tt_pattern_arg_add
               Arguments
               Returned Value
               Related Functions
         - tt_pattern_object_add
               Arguments
               Returned Value
         - tt_pattern_op_add
               Arguments
               Returned Value
         - tt_pattern_otype_add
               Arguments
               Returned Value
         - tt_pattern_register
               Arguments
               Returned Value
               Related Functions
         - tt_pattern_scope_add
               Arguments
               Returned Value
         - tt_pattern_sender_add
               Arguments
               Returned Value
         - tt_pattern_sender_ptype_add
               Arguments
               Returned Value
         - tt_pattern_session_add
               Arguments
               Returned Value
         - tt_pattern_state_add
               Arguments
               Returned Value
         - tt_pattern_unregister
               Arguments
               Returned Value
               Related Functions
         - tt_pattern_user
               Arguments
               Returned Value
               Related Functions
         - tt_pattern_user_set
               Arguments
               Returned Value
               Related Functions
         - tt_pnotice_create
               Arguments
               Returned Value
         - tt_pointer_error
               Arguments
               Returned Value
         - tt_prequest_create
               Arguments
               Returned Value
         - tt_ptr_error
               Arguments
               Returned Value
         - tt_ptype_declare
               Arguments
               Returned Value
         - tt_release
               Arguments
               Related Functions
         - tt_session_bprop
               Arguments
               Returned Values
         - tt_session_bprop_add
               Arguments
               Returned Values
         - tt_session_bprop_set
               Arguments
               Returned Values
         - tt_session_join
               Arguments
               Returned Values
               Related Functions
         - tt_session_prop
               Arguments
               Returned Value
         - tt_session_prop_add
               Arguments
               Returned Values
         - tt_session_prop_count
               Arguments
               Returned Value
         - tt_session_prop_set
               Arguments
               Returned Values
         - tt_session_propname
               Arguments
               Returned Value
         - tt_session_propnames_count
               Arguments
               Returned Value
         - tt_session_quit
               Arguments
               Returned Values
         - tt_spec_bprop
               Arguments
               Returned Values
         - tt_spec_bprop_add
               Arguments
               Returned Values
         - tt_spec_bprop_set
               Arguments
               Returned Values
         - tt_spec_create
               Arguments
               Returned Value
               Related Functions
         + tt_spec_destroy
         - tt_spec_file
               Arguments
               Returned Value
         - tt_spec_move
               Arguments
               Returned Value
         - tt_spec_prop
               Arguments
               Returned Value
         - tt_spec_prop_add
               Arguments
               Returned Values
               Related Functions
         - tt_spec_prop_count
               Arguments
               Returned Value
         - tt_spec_prop_set
               Arguments
               Returned Values
               Related Functions
         + tt_spec_propname
         - tt_spec_propnames_count
               Arguments
               Returned Value
         - tt_spec_type
               Arguments
               Returned Value
         - tt_spec_type_set
               Arguments
               Returned Values
               Related Functions
         - tt_spec_write
               Arguments
               Returned Values
               Related Functions
         - tt_status_message
               Arguments
               Returned Value
         - tt_X_session
               Arguments
               Returned Value
   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