CONTENTS Title Page Copyright Page Preface 1 Introduction to the DCM-Modeled Device Connectivity 1.1 Why You Should Use DCM-Modeled Device Connectivity 1.2 Using the DCM-Modeled Device Conenctivity 1.3 Limitations Part I DCM Guide Section 2 DCM-Modeled Device Connectivity Reference 2.1 Device Services VMD 2.2 Data Services Device_Data_Point 3 Configuring BASEstar Devices 3.1 Creating a BASEstar Device Definition 3.1.1 Creating Device Types 3.1.2 Creating Communication Paths 3.1.3 Creating a Device Definition 3.1.4 Setting the Default Timeout 3.1.5 Overriding Device Allocation 3.1.6 Timer Queue Entry Quotas 3.2 Collecting and Distributing Data from Plant Devices 3.2.1 Creating Physical Points 3.2.2 Collecting Device Data 3.2.2.1 Collecting Data Through Polling 3.2.2.2 Defining BASEstar Pollsets 3.2.2.3 Collecting Unsolicited Data 3.2.3 Distributing Device Data 4 Mapping BASEstar Open and BASEstar Classic DCM Types 4.1 Types Correspondence 4.2 Exceptions and Particular Cases 4.2.1 Variable Length Arrays 4.2.2 Data Structures 4.2.3 String Handling 5 Configuration and Usage Examples 5.1 Example 1: Solicited Reading and Writing on a Device 5.1.1 Creating PODB Definitions 5.1.2 Creating the BASEstar Classic DCM Configuration 5.1.3 Operating the Device Variables 5.2 Example 2: Same as Example 1, but Unsolicited Value Changes Are Handled 5.3 A Complete Example 5.3.1 Creating the BASEstar Classic DCM Definitions 5.3.2 Creating the BASEstar Open Definitions 6 Using the BASEstar CLI for Accessing Devices 6.1 Overview of BASEstar CLI for DCM 6.2 Accessing the BASEstar CLI in DCM-mode 6.3 Command Format 6.4 CLI Features 6.5 Creating Command Procedures 7 Using BASEstar CLI General Commands 7.1 Working with the BASEstar CLI 7.2 Communicating with Plant Equipment 7.2.1 Configuring BASEstar Devices 7.2.1.1 Defining Device Types 7.2.1.2 Defining Device Paths 7.2.1.3 Defining Devices 7.2.2 Collecting Data from Plant Devices 7.2.2.1 Creating Physical Points 7.2.2.2 Defining Pollsets to Poll Plant Equipment 7.2.2.3 Reading and Writing Values 8 Using BASEstar CLI System Commands 8.1 Device Connection Management Global Sections 8.1.1 Configuration Global Section 8.1.2 Data Global Section 8.1.3 Device Access Software Support Global Section 8.2 Setting the BASEstar System Status Part II DCM Reference Section 9 BASEstar CLI Device Connection Management Command Reference BSTAR CREATE DEVICE CREATE PATH CREATE PHYPOINT CREATE POLLSET CREATE TYPE DELETE DEVICE DELETE PATH DELETE PHYPOINT DELETE POLLSET DELETE TYPE EXIT HELP MODIFY DEVICE MODIFY PATH MODIFY PHYPOINT MODIFY POLLSET MODIFY TYPE READ DATA READ PHYPOINT READ STATUS SHOW DEVICE SHOW PATH SHOW PHYPOINT SHOW POLLSET SHOW TYPE WRITE DATA WRITE PHYPOINT 10 BASEstar CLI System Command Reference SET PARAMETER SHOW PARAMETER SHOW SYSTEM START SYSTEM STOP SYSTEM 11 BASEstar CLI Device Connection Management System Command Reference DUMP ILANSEC DUMP SPTSEC EXTRACT DEVICE EXTRACT PATH EXTRACT PHYPOINT EXTRACT POLLSET EXTRACT TYPE LOOP 12 Configuring and Tuning the Device Manager 12.1 Creating OpenVMS Accounts 12.1.1 Setting Process Quotas 12.1.2 Setting Privileges 12.1.3 Adding Identifiers 12.2 Device Connection Management Parameters 12.2.1 Calculating the Data Global Section Size 12.2.2 Calculating the SPT Global Section Size 12.2.3 Maximum SPT Global Section Sizes 12.2.4 Dividing the Global Section Block Sizes Part III Examples of Device Access Software 13 Overview of the RS-232 Devices DAS 13.1 Description 13.2 Device Communications 13.3 Supported Functions 14 Configuration of the RS-232 Devices DAS 14.1 Files Created During Installation 14.2 Configuration Tasks 14.2.1 Editing the Configuration File 14.2.1.1 Type Records 14.2.1.2 Path Records 14.2.1.3 Device Records 14.2.1.4 RS-232 DAS Configuration File 14.2.2 Setting the SPT Block Parameter 14.2.3 Configuring Ports 14.2.4 Setting Up Plant-Floor Equipment 15 Use of the RS-232 Devices DAS 15.1 Accessing BASEstar DAS for RS-232 Device Functions 15.2 Supported Functions 15.3 Structured Data 15.4 Supported Data Types 15.5 Automatic Data Collection 15.5.1 Unsolicited Data Collection 15.5.2 Pollsets 16 Overview of the DECnet and TCP/IP Networks DAS 16.1 Description 16.2 Device Communications 16.3 Supported Functions and Devices 17 Configuration of the DECnet and TCP/IP Networks DAS 17.1 Optional Software 17.2 Files Created During Installation 17.3 Configuration Tasks 17.3.1 Editing the Configuration File 17.3.1.1 BASEstar Application Parameters 17.3.1.2 Type Records 17.3.1.3 Path Records 17.3.1.4 Device Records 17.3.1.5 Network DAS Configuration File 17.3.2 Setting the SPT Block Parameter 18 Use of the DECnet and TCP/IP Networks DAS 18.1 Accessing Network DAS Functions 18.2 Network NCT Pseudodevice Supported Functions 18.2.1 Read and Write Data Functions 18.2.2 Loop Function 18.3 Supported Data Types 18.4 Automatic Data Collection 18.4.1 Unsolicited Data Collection 18.4.2 Pollsets 19 Writing a Network Cooperating Task 19.1 Establishing a Network Link 19.2 Communicating with the Network DAS 19.3 NCT Data Structures 20 Overview of the DECdevice DAS 20.1 Description 20.2 Device Communications 20.3 Supported Functions 21 Configuration of the DECdevice DAS 21.1 Files Created During Installation 21.2 Configuration Tasks 21.2.1 Editing the Configuration File 21.2.1.1 Type Records 21.2.1.2 Path Records 21.2.1.3 Device Records 21.2.1.4 DECdevice DAS Configuration File 21.2.2 Setting the SPT Block Parameter 22 Use of the DECdevice DAS 22.1 Accessing DECdevice Functions 22.2 Supported Functions 22.2.1 Read and Write Data Functions 22.2.2 Display Status Function 22.3 Structured Data 22.4 Supported Data Types 22.5 Automatic Data Collection 23 DECdevice Simulator 23.1 Invoking the DECdevice Simulator 23.2 Using the DECdevice Simulator 23.2.1 Reading Values 23.2.2 Writing Values 23.2.3 Accessing Help 23.2.4 Exiting the DECdevice Simulator 23.2.5 DECdevice Global Section Structure 23.3 DECdevice Simulator Errors A BASEstar Physical Point Formats B History File Event Specifications EXAMPLES 5-1 Creating PODB Definitions (Direct Access to a Device) 5-2 Creating the Type, Path and Device Definitions 5-3 Creating a Physical Point 5-4 Creating PODB definitions (Unsolicited Access to a Device) 5-5 Creating a Physical Point 5-6 Creating the BASEstar Classic DCM Definitions 5-7 Creating the BASEstar Open Definitions 6-1 Sample Command Procedure 14-1 RS-232 DAS Type Configuration 14-2 RS-232 DAS Path Configuration 14-3 RS-232 DAS Device Configuration 14-4 RS-232 DAS Configuration File 15-1 RS-232 READ DATA Output 15-2 RS-232 WRITE DATA Output 17-1 Network DAS Type Configuration 17-2 Network DAS Path Configuration 17-3 Network DAS Device Configuration 17-4 Network DAS Configuration File 18-1 Network DAS LOOP Output 21-1 DECdevice DAS Type Configuration 21-2 DECdevice DAS Path Configuration 21-3 DECdevice DAS Device Configuration 21-4 DECdevice DAS Configuration File 22-1 DECdevice READ DATA Output 22-2 DECdevice WRITE DATA Output 22-3 DECdevice READ STATUS Output FIGURES 13-1 BASEstar DAS for RS-232 Device Communications 16-1 Network DAS Communication 19-1 NCT Request and Response Data Structures 20-1 DECdevice DAS Communications TABLES 1 Conventions Used in BASEstar Open 4-1 Mapping BASEstar Classic Types into BASEstar Open Datatypes 11-1 Header Area for the Configuration Global Section 11-2 Free Block for the Configuration Global Section 11-3 Sequence Block for the Configuration Global Section 11-4 Physical Point Definition Block for the Configuration Global Section 11-5 Unsolicited Definition Block for the Configuration Global Section 11-6 Distributed Definition Block for the Configuration Global Section 11-7 Device Definition Block for the Configuration Global Section 11-8 Diagnostic Block for the Configuration Global Section 11-9 Pollset Definition Block for the Configuration Global Section 11-10 Interface Definition Block for the Configuration Global Section 11-11 Header Area for the DAS Support Global Section-Part 1 11-12 Definition Block for the DAS Support Global Section 11-13 Header Area for the DAS Support Global Section-Part 2 12-1 Process Resource Limits 12-2 Device Connection Management Parameters 12-3 SPT Global Section Sizing 14-1 RS-232 DAS Files 14-2 RS-232 DAS CREATE TYPE Parameters 14-3 RS-232 DAS CREATE PATH Parameters 14-4 RS-232 DAS CREATE DEVICE Parameters 17-1 Network DAS Files 17-2 Network DAS CREATE TYPE Parameters 17-3 Network DAS CREATE PATH Parameters 17-4 Network DAS CREATE DEVICE Parameters 19-1 NCT Request Data Structure 19-2 NCT Response Data Structure 21-1 DECdevice DAS Files 21-2 DECdevice CREATE TYPE Parameters 21-3 DECdevice CREATE PATH Parameters 21-4 DECdevice CREATE DEVICE Parameters 22-1 DECdevice Display Status Interface Access 23-1 DECdevice Read Command Output 23-2 DECdevice Write Command Output A-1 Device Connection Management Physical Point Syntax and Encoding B-1 BASEstar Event Specifications