CONTENTS

  Title Page

  Copyright Page

  Preface

  1      Integrating Manufacturing Applications and Equipment
    1.1 Overview of BASEstar Classic Callable Services
      1.1.1      Data Management
      1.1.2      Distributed Messaging
      1.1.3      Device Communication
      1.1.4      Application Control Services
      1.1.5      Configuration Management
    1.2 BASEstar Classic Programming Tools
    1.3 Documentation Format for BASEstar Classic Callable Services
      1.3.1      Syntax Heading
      1.3.2      Return Values
    1.4 Channel and Item List Arguments
      1.4.1      Channel Argument
      1.4.2      Item List Arguments and Item Codes
    1.5 Synchronous and Asynchronous Services
    1.6 Writing and Executing a BASEstar Classic Application
      1.6.1      Compiling and Linking
      1.6.2      Running
    1.7 The C Language Binding
      1.7.1      Strings
      1.7.2      Compiled Points
      1.7.3      Data Values
      1.7.4      Time
      1.7.5      Itemlists
      1.7.6      AST Routines

  2      Data Management
    2.1 Overview
    2.2 Defining Data Elements and Data Structures
      2.2.1      Creating, Modifying, and Deleting Logical Point Definitions
      2.2.2      Referencing Logical Point Information
      2.2.3      Summary of Logical Point Definition Services
      2.2.4      Defining Data Structures
      2.2.5      Creating Data Structure Fields
      2.2.6      Summary of Structured Data Services
    2.3 Reading and Modifying Point Values and Status
      2.3.1      Retrieving and Setting Field Values
      2.3.2      Obtaining and Changing Point Status
      2.3.3      Summary of Read and Modify Point Services
    2.4 Automatic Notification of Data Changes
      2.4.1      Requesting Data Change Notification
      2.4.2      Interpreting Data Change Notifications
      2.4.3      Summary of Automatic Notification Services
    2.5 Exporting Data
      2.5.1      Creating External Maps
      2.5.2      Creating Map Elements
      2.5.3      Summary of Export Data Services

  3      Distributed and Event-Driven Messaging
    3.1 Overview
    3.2 DECmessageQ Messaging
      3.2.1      Using DECmessageQ in BASEstar Classic Applications
      3.2.2      Defining Logicals
      3.2.3      Requesting Data Change Notification
        3.2.3.1      Attaching to the DECmessageQ Bus
        3.2.3.2      Requesting BASEstar Classic Data Change Notification
        3.2.3.3      Receiving and Processing a Data Change Notification
      3.2.4      Initiating Data Change Notifications
        3.2.4.1      Attaching to a DECmessageQ Message Queuing Bus
        3.2.4.2      Data Change Notification Initiated by an API
        3.2.4.3      Data Change Notification Initiated by a CLI User
      3.2.5      Canceling Data Change Notification Requests
      3.2.6      DECmessageQ and BASEstar Classic Shutdown
    3.3 BASEstar Classic Messaging
      3.3.1      Creating Message Ports
        3.3.1.1      Port Identifications
        3.3.1.2      Unnamed Message Ports
        3.3.1.3      Named Message Ports
        3.3.1.4      Server Ports
        3.3.1.5      Circuit Cluster Ports
        3.3.1.6      Summary of Port Services
      3.3.2      Creating Message Circuits
        3.3.2.1      Message Circuits
        3.3.2.2      Circuit Clusters
        3.3.2.3      Summary of Circuit Services
      3.3.3      Sending and Receiving BASEstar Classic Messages
        3.3.3.1      Messages and Message Data
        3.3.3.2      Summary of Message Data Services
        3.3.3.3      Sending Messages
        3.3.3.4      Receiving Messages
        3.3.3.5      Message Security
        3.3.3.6      Summary of Send and Receive Message Services

  4      Device Communication
    4.1 Overview
      4.1.1      Device Access Software
      4.1.2      Device and Data Definition
    4.2 Defining Devices and Physical Points
      4.2.1      Creating Device Types and Paths
      4.2.2      Creating Device Definitions
      4.2.3      Summary of Device Definition Services
      4.2.4      Defining Physical Points
      4.2.5      Summary of Physical Point Definition Services
    4.3 Controlling and Monitoring Devices
      4.3.1      Accessing and Allocating Devices
      4.3.2      Starting and Stopping Devices
      4.3.3      Managing Device Files
      4.3.4      Monitoring Device Status
      4.3.5      Summary of Device Monitoring and Control Services
    4.4 Collecting Data and Polling
      4.4.1      Summary of Polling Services
      4.4.2      Unsolicited Data Collection
      4.4.3      Reading and Writing Device Data
      4.4.4      Summary of Read and Write Device Data Services

  5      Application Control
    5.1 Overview
    5.2 Starting Applications
    5.3 Synchronizing Applications
      5.3.1      Creating a Synchronization Element
      5.3.2      Reading a Synchronization Element Definition
      5.3.3      Creating a Synchronization Event List
      5.3.4      Defining a Trigger Event
      5.3.5      Pausing an Application
      5.3.6      Summary of Synchronization Services
    5.4 Using Synchronization Services
      5.4.1      Using the Synchronization Barrier
      5.4.2      Using the Synchronization Event
      5.4.3      Using the Synchronization Semaphore

  6      BASEstar Classic Programming Tools
    6.1 BASEstar Classic LSE Environment
      6.1.1      Accessing the BASEstar Classic LSE Environment
      6.1.2      Using the BASEstar Classic LSE Environment
        6.1.2.1      Routine Tokens
        6.1.2.2      Routine Argument Placeholders
        6.1.2.3      Constant Tokens
    6.2 Text Message Services
      6.2.1      OpenVMS Message File Structure
      6.2.2      Text Message Routines
      6.2.3      Text Message Support Programs
    6.3 Value Notification Utility
      6.3.1      Invoking the Value Notification Utility
      6.3.2      Using the Value Notification Utility

  A BASEstar Classic Callable Services
    A.1 Data Management Callable Services
    A.2 Distributed Messaging Callable Services
    A.3 Device Communication Callable Services
    A.4 Application Control Callable Services
    A.5 Configuration Management Callable Services

  B Programming Examples
    B.1 Programming Examples for Data Management Services
      B.1.1     Sample C Program for Verifying C Bindings
      B.1.2     Sample C Program for Obtaining a Point Value
      B.1.3     Sample PL/I Program for Setting a Logical Point Value
      B.1.4     Sample PL/I Program for Data Distribution
    B.2 Programming Examples for Distributed Messaging
      B.2.1     Sample C Program for Requesting BASEstar Classic Data Change Notification
      B.2.2     Sample C Program for Updating a Point After Attaching to the DECmessageQ Bus
      B.2.3     Sample C Program for Canceling BASEstar Classic Data Change Notification
      B.2.4     PL/I Programming Example for Messaging Services
    B.3 Progamming Examples for Device Communication Services
      B.3.1     Sample PL/I Program for Obtaining Device Information
      B.3.2     Sample PL/I Program for Reading Device Status
      B.3.3     Sample PL/I Program for Reading Device Data
      B.3.4     Sample PL/I Program for Writing Device Data
      B.3.5     Sample PL/I Program for Obtaining Pollset Members
    B.4 PL/I Programming Example for Application Control Services