DIGITAL Software Product Description ___________________________________________________________________ PRODUCT NAME: DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automa- tion Protocols/SINEC AP Services) DESCRIPTION DECosap/AP is a network communication product. It provides a solution to connect DIGITAL applications with shop floor devices based on Siemens[R] SINEC[R] Automation Protocol (AP) communication protocol. Although mainly oriented to the manufacturing environment, SINEC AP addresses generic applications and is intended to provide a common communication method between different Siemens automation devices - Programmable Logic Controllers (PLCs), numeric control machines, robots, personal computers and minicomputers. Siemens SINEC AP is layered on top of the SINEC H1 network and pro- vides proprietary Session, Presentation, and Application layers. The result offers an integrated Siemens Level 1 solution with an associ- ated value of a consistent and uniform view to the plant floor appli- cations. DECosap/AP fully supports the SINEC AP communication protocol. Features DECosap/AP provides the support for SINEC AP Application, Presenta- tion, and Session layers. As this communication protocol is defined on top of the ISO OSI Transport Layer, DECosap/AP relies upon DECnet /OSI to complete the communication stack. For more information, re- fer to the DECnet/OSI Software Product Description (SPD 41.92.xx) April 1997 AE-PZAUD-TE DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) Because of the functional compatibility between Siemens SINEC AP and MMS (Manufacturing Messaging Services), ISO International Standard 9506, Parts 1 and 2, DECosap is integrated with the software architecture of the DEComni API product to supply the Application Programming Interface (API). For more information, refer to the DEComni API Software Product Description (SPD 47.88.xx). Components o DECosap/AP Services This component adds support for SINEC AP functionality under the DEComni API. Supported services are listed at the end of this Software Product Description and are divided into the following categories: Environmental Management, VMD Support, Variable Access, Serial Transfer, Program Invocation, and Domain Services. o Configuration and Management Facilities DECosap/AP uses the DEComni API facility ODSCL. On OpenVMS platforms, the following DEComni API facilities are sup- ported: - ODF (Omni Definition Facility) - OmniView o Support for the Device Access Services of BASEstar Open o Installation Verification Procedure (IVP) The DECosap IVP performs a series of tests to verify proper instal- lation. 2 DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) Documentation DECosap/AP includes the following documentation: o A platform-specific Network Manager's and Programmer's Guide that provides an overview of SINEC H1 (see the DECosap/AP Software Product Description - SPD 47.95.04) and SINEC AP concepts and terminology. It includes a description of the services that are available through DEComni API and features of DECosap. It also describes the use of the DEComni API utility ODSCL. o A platform-specific Installation Guide that explains how to pre- pare for installation, how to install the product, and what to do after DECosap is installed. INSTALLATION Before attempting to install the software, the customer must have all pre-requisite hardware and software. Digital Equipment Corporation recommends that a customer's first purchase include DIGITAL Installation Services. Connectivity to all other nodes within the network is the responsi- bility of the customer. SUPPORTED VERSIONS This SPD covers the following versions of the DECosap product: o DECosap/AP and DECosap/H1 for OpenVMS VAX o DECosap/AP and DECosap/H1 for OpenVMS Alpha o DECosap/AP and DECosap/H1 for DIGITAL UNIX 3 DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) ORDERING INFORMATION DECosap/AP for OpenVMS VAX: The DECosap/AP product kit is included in the BASEstar Open Server for OpenVMS VAX Consolidated Software Distribution: Software Media: QA-5SRAC-H8 Software Licenses (unlimited use): QL-5BP**-** Software Documentation: QA-5BP**-** Software Product Services: QT-5BQ**-** DECosap/AP for OpenVMS Alpha: The DECosap/AP product kit is included in the BASEstar Open Server for OpenVMS Alpha Consolidated Software Distribution: Software Media: QA-5SRAB-H8 Software Licenses (unlimited use): QL-2XVA*-** Software Documentation: QA-2XVAA-GZ Software Product Services: QT-2XVA*-** DECosap/AP for DIGITAL UNIX: The DECosap/AP product kit is included in the BASEstar Open Server for DIGITAL UNIX Consolidated Software Distribution: Software Media: QA-5SRAA-H8 Software Licenses (unlimited use): QL-0Z8A*-** Software Documentation: QA-0Z8A*-GZ Software Product Services: QT-0Z8A*-** * Denotes variant fields. For additional information on available licenses, services, and media refer to the appropriate price book. 4 DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) SOFTWARE LICENSING This software is furnished under the licensing provisions of Digital Equipment Corporation's Standard Terms and Conditions. For more in- formation about the DIGITAL licensing terms and policies, contact your local DIGITAL office. License Management Facility Support: This layered product supports the DIGITAL License Management Facil- ity. Two types of license are available: o "Unlimited system use" license-available for a processor o "Concurrent use" license-available for a device connection (not available with OpenVMS VAX) SOFTWARE PRODUCT SERVICES A variety of service options are available from DIGITAL. For more in- formation, contact your local DIGITAL office. SOFTWARE WARRANTY Warranty for this software product is provided by DIGITAL with the purchase of a license for the product as defined in the standard terms and conditions relating to DIGITAL SPDs. Warranty Limitations DIGITAL has developed this product according to SINEC AP Protocol Specification produced by Siemens. Not all Siemens Communication Processors (CP) support the full range of SINEC AP services. The services supported by each CP are listed at the end of this document. To minimize the risk of interworking problems, DIGITAL has tested this product against selected Siemens devices to prove interoperability. 5 DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) HARDWARE REQUIREMENTS Processors Supported: o Alpha processors supporting either: - OpenVMS Alpha Version 6.1 to 7.1 - DIGITAL UNIX Version 3.2 or 4.0 o VAX processors supporting: - OpenVMS VAX Version 6.1 to 7.1 DISK SPACE REQUIREMENTS OpenVMS Alpha: o 42 Mb (installation) o 26 Mb (permanent use) OpenVMS VAX: o 40 Mb (installation) o 18 Mb (permanent use) DIGITAL UNIX: o 26 Mb (installation) o 10 Mb (permanent use) Note: A configuration with at least 16 MB of memory is recommended. These values refer to the disk space required on the system disk. The sizes are approximate; actual sizes may vary depending on the user's system environment, configuration, and software options. 6 DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) SOFTWARE REQUIREMENTS DECosap/AP for OpenVMS Alpha: o OpenVMS Alpha Version 6.1 to 7.1 o DECnet/OSI for OpenVMS Alpha Version 6.3 to 7.1 o Either: - DEComni API V3.1 for OpenVMS Alpha, or - BASEstar Open Server V3.1 for OpenVMS Alpha o ORACLE Rdb Version 5.1[1] o OpenVMS DECwindows Motif Version 1.2[2] DECosap/AP for OpenVMS VAX:) o OpenVMS VAX Version 6.1 to 7.1 o DECnet/OSI for OpenVMS VAX Version 6.3 to 7.1 o Either: - DEComni API for OpenVMS VAX V3.1, or - BASEstar Open Server for OpenVMS VAX V3.1 o ORACLE Rdb Version 6.0 or 6.1[1] o OpenVMS DECwindows Motif Version 1.2[2] DECosap/AP for DIGITAL UNIX: o DIGITAL UNIX Version 3.2 or 4.0 o Either: - DEComni API V3.1 for DIGITAL UNIX, or - BASEstar Open Server V3.1 for DIGITAL UNIX ____________________ [1] Only necessary if you are using DEComni API with the ODF component. [2] Only necessary if you are using DEComni API with the OmniView component. 7 DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of this product may be different from the requirements for the current version. DISTRIBUTION MEDIA This product is available on CD-ROM for the supported operating sys- tem, and on TK50 media for OpenVMS VAX. 8 DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Services) APPENDIX A - SINEC AP Functionality Cross Reference Tables The following tables list the Conformance Building Block (CBB) services and parameters that are supported by DECosap/AP Ver- sion 3.1. They are compared to the services provided within the first version. The level of support depends upon the level of functionality provided by the target Siemens[R] communication processors. ___________________________________________________________________ Table_1:__Siemens_SINEC_AP_CBB_Services_Cross_Reference_Table______ DECosap/AP Version CP231A _________________________3.1______CP143_____CP231B___CP141___ KS100 _____________________Environment_Management__________________ Initiate B B N B N Conclude B B N B N Abort B B N N N Cancel C N N N N _____________________________________________________________ ______________________VMD_Support_Services___________________ Status B B N B N GetNameList C S N B N Identify B B N B N GetCapabilityList C S N B N UnsolicitedStatus B B N B N 9 DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Services) ___________________________________________________________________ Table 1 (Cont.): Siemens SINEC AP CBB Services Cross Reference __________________Table____________________________________________ DECosap/AP Version CP231A _________________________3.1______CP143_____CP231B___CP141___ KS100 ____________________Variable_Access_Services_________________ Read B B N B N Write B B N B N InformationReport B B N B N GetVariableAccessAttributes C S N B N _____________________________________________________________ ___________________Domain_Management_Services________________ InitiateDownloadSequence C S N C N DownloadSegment C S N C N TerminateDownloadSequence C S N C N InitiateUploadSequence C S N C N UploadSegment C S N C N TerminateUploadSequence C S N C N RequestDomainDownload C S N C N RequestDomainUpload C S N C N LoadDomainContent N S N C N StoreDomainContent N S N C N DeleteDomain C S N C N GetDomainAttributes C S N C N 10 DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) ___________________________________________________________________ Table 1 (Cont.): Siemens SINEC AP CBB Services Cross Reference __________________Table____________________________________________ DECosap/AP Version CP231A _____________________________________________________________ KS100 ____________________Program_Invocation_Services_______________ CreateProgramInvocation C B N N N DeleteProgramInvocation C B N N N Start C B N N N Stop C B N N N Resume C B N N N Reset C B N N N Kill C B N N N GetProgramInvocationAttributes C B N N N ______________________________________________________________ ____________________Serial_Transfer_Services__________________ Read B B B B B Write B B B B B Send B B B B B Exchange_________________B_______B_________B________B_________B Where the following symbols apply: B = Client and Server C = Client only S = Server only N = Not supported 11 DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Services) ___________________________________________________________________ Table_2:__Siemens_SINEC_AP_CBB_Parameters_Cross_Reference_Table____ Parameters_____________DECosap/AP_Version_3.1______________________ STR1 TRUE STR2 TRUE NEST 10 VNAM TRUE VADR TRUE VALT TRUE VSCA FALSE TPY FALSE VLIS FALSE REAL FALSE AKEC FALSE CEI____________________FALSE_______________________________________ Supported Siemens Communication Processors (CP) are: o CP143: for Simatic[R] S5 PLC family o CP231A/B: for Sinumerik NC 800 and Sirotec Robot Controllers o CP141, CP1412, CP1413: for Sicomp PC 32-xx (PC AT[R] Compatible) o KS100: for Sicomp M70 (with IOSY-H1 software providing SINEC AP) © 1997 Digital Equipment Corporation. All rights reserved. [TM]The DIGITAL logo, Alpha, AXP, BASEstar, Bookreader, DEC, DE- Comni, DECosap, DECstation, DECsystem, DECnet, DIGITAL, Mi- croVAX, TK, VAX, VAXstation, OpenVMS are trademarks of Digital Equipment Corporation. [R] Intel is a trademark of Intel Corporation. [R] Motif is a trademark of the Open Software Foundation, Inc. 12 DECosap/AP Version 3.1 SPD 47.96.04 (DIGITAL Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) [R] MS-DOS, Microsoft and Windows 95 are trademarks of Microsoft Corporation. [TM]Windows NT is a registered trademark of Microsoft Corporation. [R] HP-UX is a trademark of Hewlett-Packard Company. [R] UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd. [R] ORACLE is a trademark of Oracle Corporation. 13