DIGITAL Software Product Description ___________________________________________________________________ PRODUCT NAME: DECosap/AP for Digital UNIX, Version 3.0 SPD (Digital's Omni Services for SINEC Au- 47.96.01 tomation Protocols/SINEC AP Services) DESCRIPTION DECosap/AP for Digital UNIX is a network communication product. It pro- vides a solution to connect Digital Digital UNIX applications with shop floor devices based on Siemens[R] SINEC[R] Automation Protocol (AP) communication protocol. Although mainly oriented to the manufac- turing environment, SINEC AP addresses generic applications and is in- tended to provide a common communication method between different Siemens automation devices-Programmable Logic Controllers (PLCs), Numeric Con- trol 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 for Digital UNIX fully supports the SINEC AP communication protocol as detailed in Hardware Requirements. 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 for Digital UNIX relies upon DECnet/OSI to complete the communication stack. For more information, refer to the DECnet/OSI Software Product Description (SPD 41.92.xx) February 1996 AE-PZAUB-TE DECosap/AP for Digital UNIX, Version 3.0 SPD 47.96.01 (Digital's 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 In- terface (API). For more information, refer to the DEComni API Soft- ware 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 De- scription 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 for Digital UNIX uses the DEComni API facility ODSCL. o Installation Verification Procedure (IVP) DECosap/AP for Digital UNIX IVP performs a series of tests to ver- ify proper installation. Documentation DECosap/AP for Digital UNIX includes the following documentation: o DECosap for OSF/1 AXP Network Manager's and Programmer's Guide pro- vides an overview of SINEC H1 (see the DECosap/H1 for Digital UNIX Software Product Description-SPD 47.95.01) 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 de- scribes the use of the DEComni API utility ODSCL. o DECosap for Digital UNIX Installation Guide explains how to pre- pare for installation, how to install the product, and what to do after DECosap is installed. 2 DECosap/AP for Digital UNIX, Version 3.0 SPD 47.96.01 (Digital's Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) INSTALLATION Only experienced customers should attempt to install this product. Dig- ital Equipment Corporation recommends that all other customers pur- chase Digital's Installation Services. These services provide for in- stallation of the software by an experienced Digital Software Special- ist. The installation of DECosap/AP for Digital UNIX consists of the following: o Verification that all components of the product have been received. o Verification that the necessary versions of the prerequisite soft- ware and documentation are available. o Verification of the appropriate system parameters. o Verification that the system meets the minimum hardware and soft- ware requirements. o Provision for a reasonable period of time, as mutually agreed upon by Digital and the customer, of all hardware communication facil- ities and terminals that are to be used during installation. o Installation of the software by creating the necessary directories and copying the software from the distribution media. o Verification of the proper installation of the product by running the IVP. Note: If a software specialist is required to modify the operating sys- tem parameters from a previous installation, a prevailing rate time and materials charge will apply. Connectivity to all other nodes within the network is the responsi- bility of the customer. Delays caused by any failure to meet these re- sponsibilities will be charged at the prevailing rate for time and ma- terials. 3 DECosap/AP for Digital UNIX, Version 3.0 SPD 47.96.01 (Digital's Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) ORDERING INFORMATION Software Licenses (unlimited use): QL-0Z8A*-AA Software Licenses (concurrent use): QL-0Z8AM-*B Software Documentation: Q-0Z8AA-GZ Software Product Services: QT-0Z8A*-** * Denotes variant fields. For additional information on available li- censes, services, and media refer to the appropriate price book. SOFTWARE LICENSING This software is furnished under the licensing provisions of Digital Equipment Corporation's Standard Terms and Conditions. For more in- formation about Digital's licensing terms and policies, contact your local Digital office. License Management Facility Support: This layered product supports the Digital UNIX License Management Fa- cility. Two types of license are available: o "Unlimited system use" license-available for a processor o "Concurrent use" license-available for a device connection For more information on the License Management Facility, refer to the Digital UNIX Software Product Description (SPD 41.61.xx) or the Guide to Software Licensing for the Digital UNIX Operating System documen- tation set. SOFTWARE PRODUCT SERVICES A variety of service options are available from Digital. For more in- formation, contact your local Digital office. 4 DECosap/AP for Digital UNIX, Version 3.0 SPD 47.96.01 (Digital's Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) SOFTWARE WARRANTY Warranty for this software product is provided by Digital with the pur- chase of a license for the product as defined in the Software Warranty Addendum of this SPD. Warranty Limitations Digital has developed this product according to SINEC AP Protocol Spec- ification produced by Siemens. Not all Siemens Communication Proces- sors (CP) support the full range of SINEC AP services. The services supported by each CP are listed at the end of this document. To min- imize the risk of interworking problems, Digital has tested this prod- uct against selected Siemens devices to prove interoperability. HARDWARE REQUIREMENTS Alpha AXP-Based Processors Supported WorkstationDEC 3000 Model 300 AXP DEC 3000 Model 400 AXP DEC 3000 Model 500 AXP Servers: DEC 3000 Model 400 AXP DEC 3000 Model 500 AXP DEC 4000 AXP DEC 7000 AXP DEC 10000 AXP Processors Not Supported Non-Alpha AXP processors are not supported. Other Hardware Required o IEEE 802.3 Connection 5 DECosap/AP for Digital UNIX, Version 3.0 SPD 47.96.01 (Digital's Omni Services for SINEC Automation Protocols/SINEC AP Services) Disk Space Requirements Disk space required for installation: o 15 MB Disk space required for use (permanent): o 10 MB 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. SOFTWARE REQUIREMENTS o Digital UNIX operating system Version 3.2 Layered Products: o DEComni API for Digital UNIX V3.0 o DECnet/OSI for Digital UNIX V3.2 GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of this product may be different from the requirements for the current version. 6 DECosap/AP for Digital UNIX, Version 3.0 SPD 47.96.01 (Digital's Omni Services for SINEC Automation Protocols/SINEC AP Services) DISTRIBUTION MEDIA This product is available as part of the Digital UNIX Consolidated Soft- ware distribution on CD-ROM. 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 and DECosap/H1 for Digital UNIX Version 3.0. 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 for Digital UNIX Ver- CP231A _______________________sion_3.0______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 7 DECosap/AP for Digital UNIX, Version 3.0 SPD 47.96.01 (Digital's Omni Services for SINEC Automation Protocols/SINEC AP Services) ___________________________________________________________________ Table 1 (Cont.): Siemens SINEC AP CBB Services Cross Reference __________________Table____________________________________________ DECosap/AP for Digital UNIX Ver- CP231A ___________________________________________________________________ KS100 ______________________________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 ___________________________________________________________________ ____________________________Variable_Access_Services_______________ Read B B N B N Write B B N B N InformationReport B B N B N GetVariableAccessAttribCtes S N B N 8 DECosap/AP for Digital UNIX, Version 3.0 SPD 47.96.01 (Digital's Omni Services for SINEC Automation Protocols/SINEC AP Services) ___________________________________________________________________ Table 1 (Cont.): Siemens SINEC AP CBB Services Cross Reference __________________Table____________________________________________ DECosap/AP for Digital UNIX Ver- CP231A ___________________________________________________________________ KS100 ___________________________Domain_Management_Services______________ InitiateDownloadSequencC S N C N DownloadSegment C S N C N TerminateDownloadSequenCe S N C N InitiateUploadSequence C S N C N UploadSegment C S N C N TerminateUploadSequenceC 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 9 DECosap/AP for Digital UNIX, Version 3.0 SPD 47.96.01 (Digital's Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) ___________________________________________________________________ Table 1 (Cont.): Siemens SINEC AP CBB Services Cross Reference __________________Table____________________________________________ DECosap/AP for Digital UNIX Ver- CP231A ___________________________________________________________________ KS100 __________________________Program_Invocation_Services______________ CreateProgramInvocationC B N N N DeleteProgramInvocationC 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 GetProgramInvocationAttCibutes 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 10 DECosap/AP for Digital UNIX, Version 3.0 SPD 47.96.01 (Digital's Omni Services for SINEC Automation Protocols/SINEC AP Services) ___________________________________________________________________ Table_2:__Siemens_SINEC_AP_CBB_Parameters_Cross_Reference_Table____ DECosap/AP for Parameters_____________Digital_UNIX_Version_3.0____________________ 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) [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] Siemens, Simatic, Simadyn and SINEC are registered trademarks of Siemens AG. 11 DECosap/AP for Digital UNIX, Version 3.0 SPD 47.96.01 (Digital's Omni Services for SINEC Automation Protocols/SINEC AP Ser- vices) [R] Intel is a registered trademark of Intel Corporation. [R] MS-DOS, Microsoft, MS Windows and Windows NT are registered trademarks of Microsoft Corporation. 12