L CM50S User Manual CM11-530 L Implementation CM50S CM50S User Manual CM11-530 Release 5.0 3/96 Copyright, Trademarks, and Notices © Copyright 1995 by Honeywell Inc. Revision 03 – March 15, 1996 While this information is presented in good faith and believed to be accurate, Honeywell disclaims the implied warranties of merchantability and fitness for a particular purpose and makes no express warranties except as may be stated in its written agreement with and for its customer. In no event is Honeywell liable to anyone for any indirect, special or consequential damages. The information and specifications in this document are subject to change without notice. Trademark Acknowledgments: TDC 3000 is a U.S. registered trademark of Honeywell, Inc. Other brand or product names are trademarks of their respective owners. About This Publication This publication provides information on the writing, installation, testing, and modification of Application Programs that execute in the CM50S (Rel 5.0) environment as an integral part of a TDC 3000X Process Control System. It does not, by itself, cover everything you need to know to develop advanced control schemes. Essential topics covered elsewhere include: • TDC 3000X System Concepts • TDC 3000X System Configuration • FORTRAN, "C," and Pascal Programming Languages A list of related publications is located in paragraph 1.3 of this publication. Users of previous CM50S releases will find a discussion of support for vintage interface routines at subsection 1.4 You should be aware that all programmatic interface calls to CM50S are grouped by programming language. Tab 2 precedes the FORTRAN calls (sections 9 through 12), Tab 3 precedes the Pascal calls (Sections 13 through 16), and Tab 4 precedes the C language calls (sections 17 through 20). NOTE This publication supports Release 5.0 of CM50S for OpenVMS VAX and OpenVMS AXP. NOTE Change bars in this publication are used to indicate the technical changes that were made at Release 5.0 CM50S User Manual 3/96 CM50S User Manual 3/96 Table of Contents 1 INTRODUCTION 1.1 DEC VAX Interface to TDC 3000X 1.2 DEC VAX Interface Architecture 1.3 References 1.3.1 Publications Found in the TDC 3000X LCN Bookset 1.4 Support for Vintage Interface Routines 1.5 Restrictions on Entity Name Lengths TAB 1 —GENERAL USE INFORMATION 2 CONCEPTS AND MECHANISMS 2.1 Exchanging Data with an LCN 2.1.1 Single Point Transfers 2.1.2 Data Definition Tables 2.1.3 Multi-Point List Transfers 2.1.4 Point List Transfers 2.1.5 Dynamic Indirection 2.2 User Program Characteristics 2.2.1 Data Acquisition Programs (DAPs) 2.2.2 Advanced Control Programs (ACPs) 2.2.3 Indirect Control Programs 2.2.4 Program Execution Control 2.2.5 Summary of Program Execution Options 2.2.6 ACP Execution Example 2.3 CG/PLNM Database 2.3.1 Advanced Control Interface Data Points (ACIDPs) 2.3.2 Calculated Results Data Points (CRDPs) 2.3.3 Resident Data Definition Tables 2.4 Operator Interfaces to Application Programs 2.4.1 Process Operator Interfaces 2.4.2 Computer Operator Interfaces 2.5 CM50S Programmatic Interface 2.5.1 Programmatic Interface Include Files 2.5.2 Programmatic Interface Flag Parameter 2.5.3 Linking Application Programs to CM50S 2.6 Implementation Steps 2.6.1 System Start Up 2.6.2 Prepare CG/PLNM-Resident Data Points 2.6.3 Prepare Data Definition Tables 2.6.4 Compile, Link, and Install Programs 2.6.5 Test and Modify Programs and DDTs 3 ACCESS AND SECURITY 3.1 User Access to CM50S 3.1.1 User Registration Requirements 3.1.2 Log In Procedures 3.1.3 Menu-Driven Operations 3.1.4 DCL Commands and Error Messages 3.2 Starting Up CM50S 3.2.1 Using the CM50S_MGR Account 3.2.2 Submitting a Start Up Request CM50S User Manual i 3/96 Table of Contents 3.3 Shutting Down CM50S 3.3.1 User Notification 3.3.2 User Specified Delay 3.3.3 User Friendly Termination 3.3.4 Commnad 3.4 Limiting Access to Functions 3.4.1 Restrictive Rights 3.4.2 Access Control Lists 3.5 ACP Security 3.5.1 ACIDPs 3.5.2 Limiting Triggers 3.5.3 Running Under Specified Accounts 3.5.4 Privileges and Quotas 3.5.5 ACP Installation Log 3.6 Sending Modified Files to the LCN 3.6.1 ASCII File Extensions 3.6.2 Customizing File Extension Control 4 CG/PLNM POINT PREPARATION 4.1 CG/PLNM Point Building Overview 4.2 Custom Data Segment Construction 4.2.1 Custom Data Segment Heading 4.2.2 Custom Data Segment Parameters 4.2.3 Custom Data Segment Example 4.2.4 Custom Data Segment Compilation Recommendation 4.3 ACIDP/CRDP Point Building 4.3.1 ACIDP Scheduling Recommendations 4.3.2 The ACCESSKEY Parameter 4.3.3 Support for Continuous Control 4.4 ACIDP and CRDP Displays 4.4.1 CG/PLNM Parameter Descriptions 4.5 CG/PLNM Database Displays 4.5.1 CG Database Display 4.5.2 Status of Computer Gateways Display 4.5.3 Resident DDT Summary Display 4.5.4 Calculated Results Data Points Display 4.5.5 ACIDP Detail Display 4.5.6 ACIDP Summary Display 4.5.7 LCN Configuration Display 5 PROGRAM INSTALLATION AND TESTING 5.1 Program Linking 5.2 ACP Operations Screen 5.2.1 ACP Operations Screen Fields 5.2.2 ACP Operations Screen Function Keys 5.3 Modify Program Connection with ACIDP Screen 5.3.1 Modify Program Connection with ACIDP Screen Data Fields 5.3.2 Modify Program Connection with ACIDP Screen Function Keys 5.4 ACP List Screen 5.4.1 ACP List Screen Fields CM50S User Manual ii 3/96 Table of Contents 5.4.2 ACP List Screen Function Keys 5.5 ACP Installation Screens 5.5.1 ACP Installation Screen 1 Fields 5.5.2 ACP Installation Screen 1 Function Keys 5.5.3 ACP Installation Screen 2 Fields 5.5.4 ACP Installation Screen 2 Function Keys 5.5.5 Use of DCL Within an ACP 5.6 ACP Installer Activity Log Screen 5.6.1 ACP Installer Activity Log Screen Fields 5.6.2 ACP Installer Activity Log Screen Function Keys 5.7 Test and Restricted Modes of ACP Operation 5.7.1 Test Mode Operation 5.7.2 Restricted Mode Operation 5.8 Recovery of an ACP From Abort State 6 DATA DEFINITION TABLES 6.1 Overview of DDT Preparation 6.2 DDT Operations Screen 6.2.1 DDT Operations Screen Fields 6.2.2 DDT Operations Screen Function Keys 6.3 Edit DDT Screens 6.3.1 DDT Table Entry Rules 6.3.2 Input DDT Data Entry Screens 6.3.3 Output DDT Data Entry Screens 6.3.4 History DDT Data Entry Screen 6.4 ACIDP-DDT Prefetch Screen 6.5 DDT Error Summary Display 6.6 DDT Detail Description Displays 6.6.1 Function Keys for DDT Detail Displays 6.6.2 Data Presentation Rules for DDT Detail Displays 6.6.3 DDT Display Screens for Input Tables 6.6.4 DDT Display Screens for Output Tables 6.6.5 DDT Display Screen for History Tables 6.7 DDT List Display 6.7.1 DDT List Screen Data Fields 6.7.2 DDT List Screen Function Keys 6.8 DDT Source File Preparation Rules 6.8.1 Data Type Records 6.8.2 Point Identification Records 6.8.3 Point Option Records 6.8.4 Description Record 6.8.5 DDT File Data Entry Rules 7 UTILITY OPERATIONS 7.1 Task Scheduler 7.1.1 Task Scheduler Operation 7.1.2 Scheduler Command Table File 7.1.3 Command Table Modification 7.1.4 Task Scheduler Menu 7.1.5 Scheduler DCL Command Files 7.2 Makeinc Utility CM50S User Manual iii 3/96 Table of Contents 7.2.1 Running the Makeinc Program 7.2.2 Makeinc Error Screen 7.2.3 Using the List Format 7.2.4 Using the Item and Typed Item Formats 7.3 LCN File Transfer Operations 7.3.1 File Transfer Menu 7.3.2 Read File from LCN 7.3.3 Write File to LCN 7.3.4 Catalog File LIst 7.3.5 File Attributes 7.3.6 Volume List 7.3.7 Retrieve Volumes 7.3.8 Copy File 7.3.9 Move File 7.3.10 Rename File 7.3.11 Create Directory 7.3.12 Delete Directory 7.3.13 Delete File 7.3.14 Dataout Status 7.3.15 Abort Transfer 7.3.16 CM Journal Access 7.3.17 Save File from LCN 7.3.18 Load LCN File from OpenVMS 8 DCL COMMAND INTERFACE 8.1 Using the Command Interpreter 8.1.1 Incorporating CM50S Commands into DCL 8.1.2 Options and Qualifiers 8.1.3 Help and Error Handling 8.2 Retrieving LCN Data 8.2.1 Viewing LCN Value 8.2.2 History Module Collection Rate 8.3 Manipulating ACPs 8.3.1 Activate an ACP 8.3.2 Deactivate an ACP 8.3.3 Install an ACP 8.3.4 Uninstall an ACP 8.3.5 Connect an ACP to an ACIDP 8.3.6 Disconnect an ACP 8.3.7 Change Program Mode of an ACP 8.3.8 Display Status of an ACP 8.3.9 Display List of ACPs 8.4 Manipulating DDTs 8.4.1 Build a DDT 8.4.2 Delete a DDT 8.4.3 Install a DDT as CG Resident 8.4.4 Remove a DDT from the CG 8.4.5 Connect a DDT to an ACIDP 8.4.6 Disconnect a DDT from an ACIDP 8.4.7 Modify the Prefetch Triggers for a DDT 8.4.8 Display Summary Information for a DDT 8.4.9 Display Detailed Information for a DDT 8.4.10 Display List of DDTs CM50S User Manual iv 3/96 Table of Contents 8.5 Transferring LCN Files 8.5.1 LCN File Read 8.5.2 LCN File Write 8.5.3 List LCN Filenames 8.5.4 List LCN File Attributes 8.5.5 List File Attributes to Dataout 8.5.6 List LCN Volumes 8.5.7 Listing LCN Volumes to Dataout 8.5.8 Copy LCN File 8.5.9 Move LCN Files 8.5.10 Rename LCN File 8.5.11 Delete LCN File 8.5.12 Directory Transactions 8.5.13 Dataout Request 8.5.14 Dataout Status 8.5.15 Abort File Transfer 8.5.16 CM Journal Access 8.5.17 LCN File Save 8.5.18 LCN File Load TAB 2—FORTRAN INTERFACE 9 FORTRAN LANGUAGE CONSIDERATIONS 9.1 CM50S Include Files 9.1.1 Include Files for Data Transfer Functions 9.1.2 Include Files for DDT and ACP Management 9.1.3 Programmatic Interface Flag Parameters 9.2 Calling Conventions 9.3 Compatibility of Application Program with its DDTs 9.4 Data Representations 9.5 Commonly Made Errors 9.6 Error Detection by Interface Functions 9.7 Summary of User-Program Interfaces 10 LCN DATA TRANSFERS (FORTRAN) 10.1 Multipoint (DDT) Data Transfers 10.1.1 DDT Get Data Interface 10.1.2 DDT Store Data Interface 10.1.3