CONTENTS Title Page Copyright Page Preface PART I Introduction 1 Overview 1.1 What Does DECosap Stand For? 1.2 DECosap: What It Is and What It Does 1.3 DECosap and DEComni: H1 Towards AP Towards MMS 1.4 The DECosap for VMS Environment 1.4.1 Users and Applications 1.4.2 Configuration Facilities 1.4.3 Programming Facilities 1.4.4 Monitoring Facilities 1.5 SINEC-AP Support 1.5.1 Supported AP Objects 1.5.2 Supported AP Services 1.6 SINEC-H1 Support 1.6.1 Supported H1 Objects 1.6.2 Supported H1 Services 2 DECosap Concepts and Facilities 2.1 AP and H1 Concepts Relevant to DECosap 2.1.1 Objects Used to Model a Manufacturing Plant 2.1.2 Client and Server Applications 2.1.3 Associations 2.1.4 AP Service Classes 2.1.5 H1 Service Classes 2.2 A Sample Manufacturing Plant 2.2.1 Plant Configuration 2.2.2 Plant Operation PART II Working with SINEC-AP 3 Configuration 3.1 Plant Object Definitions 3.1.1 ODF Definitions 3.1.1.1 The OSAP Application Profile 3.1.1.2 Supported Definition Classes 3.1.1.3 Creating VMD Definitions 3.1.1.4 Creating Unnamed Variable Definitions 3.1.1.5 Creating Message Definitions 3.2 Application Descriptors 3.2.1 Application Descriptor Data for a Remote Partner Application 3.2.2 Application Descriptor Data for a DECosap Application 3.2.3 ODSCL Commands to Create Application Descriptors 3.2.4 Examples 4 ODF Command Extension Reference DEFINE MESSAGE 5 Programming with DECosap 5.1 Introduction 5.2 User Include Files 5.3 AP Services and API Procedures 5.3.1 Mapping AP Client Service Requests into API Procedures 5.3.2 Mapping AP Server Service Requests into API Procedures 5.4 The OSAP Application Profile 5.5 Run-time Definitions 5.5.1 Supported Definition Classes 5.5.2 Creating VMD Definitions 5.5.2.1 Considerations on VMD Supported Services 5.5.2.2 Defaults for VMD Attributes 5.5.3 Creating Unnamed Variable Definitions 5.5.3.1 Local Definition of an Unnamed Variable 5.5.4 Creating Message Definitions 5.6 Variable Access Services 5.7 Serial Transfer Services 5.7.1 Reading and Writing a Message 5.7.2 Exchanging a Message 5.7.3 Receiving and Fulfilling an Incoming Read (or Write) Message Request 5.7.4 Receiving and Fulfilling an Incoming Exchange Message Request 5.7.5 Sending an Unacknowledged Message 5.8 Local DEComni Operations 5.8.1 Canceling a Request 6 Monitoring the DECosap Environment 6.1 DEComni Monitoring Utility 6.2 DECnet/OSI Monitoring Utility 7 A Complete Example of a DECosap Application 7.1 Introduction 7.2 PLC Configuration 7.2.1 Definition of the Variable with VMD Scope 7.2.2 Definition of the Static Characteristics of the Association 7.3 DECosap Environment Configuration 7.4 Code of the DECosap Application PART III Working with SINEC-H1 8 Configuration 8.1 Plant Object Definitions 8.1.1 ODF Definitions 8.1.1.1 The OSH1 Application Profile 8.1.1.2 Supported Definition Classes 8.1.1.3 Creating VMD Definitions 8.1.1.4 Creating Unnamed Variable Definitions 8.1.1.5 Creating Message Definitions 8.1.1.6 Creating Domain Definitions 8.2 Application Descriptors 8.2.1 Application Descriptor Data for a Called Application 8.2.2 Application Descriptor Data for a Calling Application 8.3 ODSCL Commands to Create Application Descriptors 8.3.1 Examples 9 Programming with DECosap 9.1 Introduction 9.2 User Include Files 9.3 H1 Services and API Procedures 9.3.1 Mapping H1 Client Service Request into API Procedures 9.3.2 Mapping H1 Server Service Request into API Procedures 9.4 The OSH1 Application Profile 9.5 Run-time Definitions 9.5.1 Supported Definition Classes 9.5.2 Creating VMD Definitions 9.5.2.1 Considerations on VMD Supported Services 9.5.2.2 Model Attribute for H1 VMDs 9.5.2.3 Defaults for VMD Attributes 9.5.3 Creating Domain Definitions 9.5.4 Creating Program Invocation Definitions 9.5.5 Creating Unnamed Variable Definitions 9.5.6 Creating MMS Named Type Definitions 9.5.7 Creating Message Definitions 9.6 Message Services 9.6.1 Sending a Message 9.6.2 Receiving a Message 10 Monitoring the DECosap Environment 10.1 DEComni Monitoring Utility 10.2 DECnet/OSI Monitoring Utility 11 A Complete Example of a DECosap Application 11.1 Introduction 11.2 PLC Configuration 11.2.1 Definition of the Static Characteristics of the Read Connection 11.2.2 Definition of the Variable 11.3 DECosap Environment Configuration 11.4 Code of the DECosap Application PART IV Extension to DEComni Procedure Calls 12 Extension to DEComni Procedure Calls omni_define omni_exchange_data omni_get_definition omni_get_handle_by_name omni_get_handle_list omni_get_indications omni_get_value omni_listen omni_modify_definition omni_put_value omni_send_value 12.1 AP Error Messages 12.1.1 Explanation and User Action 12.2 H1 Error Messages 12.2.1 Explanation and User Action PART V Appendices A Overview of SINEC and Related Siemens Products A.1 SINEC Overview A.1.1 Architecture A.1.2 The SINEC-H1 Local Area Transport Network A.1.3 The SINEC-AP Protocol A.1.3.1 AP-Association A.1.3.2 AP-Client and AP-Server Applications A.1.3.3 SINEC-AP Message Structure A.1.3.4 The AP-Monitor A.2 AP Objects and Services A.2.1 Classes of AP Objects A.2.1.1 Object Scope A.2.2 Classes of AP Services A.2.2.1 List of AP Services A.2.2.2 Description of the Serial Transfer Service Class A.2.2.3 Description of the Time Function Service Class A.3 Siemens Communication Processors and Supported AP Services B Comparison Between the MMS and the SINEC AP Models B.1 Introduction B.2 Scope of the MMS and the AP Models B.3 Entities and Objects B.4 Services and Service Classes B.4.1 Comparison between Open AP Services and MMS Services B.4.2 AP Open Classes Limitations B.4.2.1 VMD Support Services B.4.2.2 Variable Access Services C ODF Predefined Types C.1 ODF Predefined Types EXAMPLES 3-1 How to Set the OSAP Application Profile(AP) 3-2 Creating the Local Definition of a Remote AP VMD 3-3 Creating the Local Definition of a Local AP VMD 3-4 Creating an AP Message Definition 3-5 Creating an AD for a Remote AP Server 3-6 Creating an AD for a DECosap AP Server 3-7 Modifying an AD (AP) 5-1 Creating the Run-Time Local Definition of a Remote AP VMD 5-2 Creating the Run-Time Local Definition of a Local AP VMD 5-3 Creating a Run-Time AP Message Definition 5-4 A DECosap Client Application Reads and Writes an AP Message 7-1 Application Descriptor for the DECosap AP Client Application 7-2 Application Descriptor for the Remote Server Application 8-1 How to Set the OSH1 Application Profile (H1) 8-2 Creating the Local Definition of a Remote H1 VMD 8-3 Creating the Local Definition of a Local H1 VMD 8-4 Creating an H1 Message Definition 8-5 Creating an AD for a Called H1 Application 8-6 Modifying an AD (H1) 9-1 Creating a Run-Time H1 Message Definition 9-2 A DECosap Application Sends an H1 Message 9-3 A DECosap Application Receives an H1 Message 11-1 Application Descriptor for the DECosap H1 Client Application 11-2 Application Descriptor for the Remote H1 Server Application FIGURES 1-1 DECosap Scenario 1-2 The DECosap Environment 1-3 DECosap Implementation of SINEC-AP 1-4 DECosap Implementation of SINEC-H1 2-1 Sample Manufacturing Plant 2-2 Definitions of Local and Remote VMDs for the Sample Manufacturing Plant 2-3 Associations in the Sample Manufacturing Plant 3-1 An AD for a Remote AP Server Application 3-2 An AD for a DECosap AP Server Application 5-1 Extended Unconstrained AP Address Format (Display Flag = 0) 5-2 Extended Unconstrained AP Address Format (Display Flag = 1) 5-3 Device Dependent Data 7-1 Association Between the DECosap AP Client Application and the Remote AP Server 7-2 Sample AP Manufacturing Plant Configuration 7-3 The COM143 Variable Definition Display Form (AP) 7-4 The COM143 Static Characteristics Definition Display Form (AP) 8-1 An AD for a Called H1 Application 11-1 Association Between the DECosap H1 Client Application and the Remote H1 Server 11-2 Sample H1 Manufacturing Plant Configuration 11-3 The COM 535 Display Form (H1) A-1 Siemens SINEC: Integration of Automation Components A-2 SINEC and the ISO/OSI Reference Model A-3 Comparing SINEC with the ISO/OSI Reference Model A-4 Client and Server Roles in SINEC-AP A-5 Syntax of a Generic AP-PDU A-6 How an AP-Client Accesses the Objects Owned by an AP-Server A-7 Example of Object Definition TABLES 1 Documentation Conventions 1-1 Supported AP Services 1-2 Supported H1 Services 2-1 AP Service Classes 2-2 H1 Service Classes 3-1 Attributes of the DEFINE VMD Command that have a Specific Meaning in the DECosap Context (AP) 3-2 Supported Conformance Building Blocks (AP) 3-3 Open AP Service Identifiers 3-4 Not Open AP Service Identifiers 3-5 CPU Identifiers (AP) 3-6 Arguments of ODSCL Commands (AP) 3-7 Attributes of ODSCL Command Arguments (AP) 4-1 ODF Naming Format in the AP Context 5-1 API Procedures that Can Be Invoked by a DECosap AP Application 5-2 Invoking API Procedures to Issue AP Client Requests 5-3 Invoking API Procedures to Fulfill AP Server Requests 8-1 Attributes of the DEFINE VMD Command that have a Specific Meaning in the DECosap Context (H1) 8-2 Supported Conformance Building Blocks (H1) 8-3 Open H1 Service Identifiers 8-4 Not Open H1 Service Identifiers 8-5 Arguments of ODSCL Commands (H1) 8-6 Attributes of ODSCL Command Arguments (H1) 9-1 API Procedures that Can be Invoked by a DECosap H1 Application 9-2 Invoking API Procedures to Issue H1 Client Requests 9-3 Invoking API Procedures to Fulfill H1 Server Requests 12-1 API Procedures for Serial Transfer Services 12-2 Class Constants 12-3 VMD Attributes and Expected Data Types 12-4 Domain Attributes and Expected Data Types 12-5 PI Attributes and Expected Data Types 12-6 Named Variable Attributes and Expected Data Types (AP Only) 12-7 Unnamed Variable Attributes and Expected Data Types 12-8 MMS Named Type Attributes and Expected Data Types 12-9 MMS Type Specification Attributes and Expected Data Types 12-10 Application Named Type and Expected Data Types 12-11 Application Type Specification and Expected Data Types 12-12 MMS Structure Component and Expected Data Types 12-13 Application Structure Component and Expected Data Types 12-14 Message Attributes and Expected Data Types 12-15 Class Constants 12-16 Definition Class Constants 12-17 omni_get_indications Function Values 12-18 Indications Received 12-19 VMD Attributes, Expected Data Types, and Defaults 12-20 Domain Attributes, Expected Data Type, and Defaults 12-21 PI Attributes, Expected Data Types, and Defaults 12-22 Named Variable Attributes, Expected Data Types, and Defaults 12-23 Unnamed Variable Attributes, Expected Data Types, and Defaults 12-24 MMS Named Type Attributes, Expected Data Types, and Defaults 12-25 Application Named Type Attributes, Expected Data Types, and Defaults 12-26 MMS Type Specification Attributes, Expected Data Types, and Defaults 12-27 Application Type Specification Attributes, Expected Data Types, and Defaults 12-28 MMS Structure Component Attributes, Expected Data Types, and Defaults 12-29 App Structure Component Attributes, Values, and Defaults 12-30 Message Attributes and Expected Data Types 12-31 AP Error Messages 12-32 H1 Error Messages A-1 Classes of AP Objects A-2 Classes of AP Services A-3 List of AP Services A-4 Siemens Communication Processors and Supported AP Services B-1 Comparing Entities and Objects B-2 Comparison between SINEC-AP and MMS Service Classes B-3 MMS Services and Open AP Services C-1 Predefined Application Types Provided by DECosap for VMS