DIGITAL Software Product Description ___________________________________________________________________ PRODUCT NAME: DEComni API SPD 47.88.04 Version 3.1 DESCRIPTION DEComni API is a network communications product that provides an Ap- plication Programming Interface (API) for the connection and manage- ment of manufacturing shop floor devices and control systems. The DEComni API is also bundled with the BASEstar Open product and pro- vides for both open and proprietary device connections. For more in- formation, refer to the Software Product Descriptions for BASEstar Open (SPD 47.87.xx) and the various Device Access Software products belong- ing to the BASEstar Open product. Components DEComni API DEComni API contains a callable runtime library that is an implemen- tation of the MMS Device Model. Service classes supported are in the following categories: Environment, VMD Support, Domains, Program In- vocations, and Variables. ODSCL ODSCL is a command line interface to the Omni Directory Service. This management level tool provides system managers the following functions: o Register directory names o Deregister directory names o Modify directory names March 1997 AE-OYTAC-TE o Query the directory OmniView OmniView is a demonstration application written using the callable in- terface that operates in a DECwindows Motif[R] environment. It pro- vides a limited user interface to the following MMS client services from a system running the prerequisite software: o Initiate o Conclude o Status o Abort o GetNameList o Identify o GetCapabilityList o Read o Write o Start o Stop o Reset o GetVariableAccessAttributes o GetDomainAttributes o GetProgramInvocationAttributes OmniView is only supported on OpenVMS systems. Object Definition Facility (ODF) 2 ODF is used to define the objects and attribute values that are ex- pected to be found at a remote Virtual Manufacturing Device (VMD). This facility is also used to define aspects of a local VMD if supported by the application. ODF is used to define the mapping of MMS variable types to and from OpenVMS data type definitions. ODF is only supported on OpenVMS systems. DEComni API Installation Verification Procedure (IVP) The DEComni API IVP performs a series of tests to verify proper in- stallation. INSTALLATION Only experienced customers should install the DEComni API product. DIG- ITAL recommends that all other customers purchase DIGITAL Installa- tion Services. These services provide for installation of the soft- ware product by an experienced DIGITAL software specialist. Installation for DEComni API consists of the following: o Verification that all components of DEComni API have been received o Verification that the necessary versions of the pre-requisite 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 as specified this SPD o Customer making available for a reasonable period of time, as mu- tually agreed upon by DIGITAL and the customer, all hardware com- munication facilities and terminals that are to be used during in- stallation o Installation of the DEComni API software by creating the necessary directories and by copying the software from the distribution me- dia 3 o Verification that DEComni API has been installed correctly by us- ing the IVP Connectivity to all other nodes within the network is the responsi- bility of the customer. SUPPORTED PRODUCTS This SPD defines the following DEComni API products: o DEComni API for DIGITAL UNIX Version 3.1 o DEComni API for OpenVMS Alpha Version 3.1 o DEComni API for OpenVMS VAX Version 3.1 HARDWARE REQUIREMENTS 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 (Block Cluster Size = 1): For_OpenVMS_Alpha_Systems__________________________________________ During Instal- lation___________Permanent_Use_____________________________________ 60,000_blocks____40,000_blocks_____________________________________ 4 For_OpenVMS_VAX_Systems____________________________________________ During Instal- lation___________Permanent_Use_____________________________________ 60,000_blocks____40,000_blocks_____________________________________ For_DIGITAL_UNIX_Systems___________________________________________ Component________Permanent_Use_____________________________________ File system 340 Kbytes root usr 36 Mbytes var 250 Kbytes ___________________________________________________________________ Total____________37_Mbytes_________________________________________ Note: No files are installed in the root file system. These totals 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 For OpenVMS Alpha Systems: o OpenVMS Operating System Version 6.1 to 7.1 For OpenVMS VAX Systems: o OpenVMS Operating System Version 6.1 to 7.1 5 For DIGITAL UNIX Systems: o DIGITAL UNIX Operating System Version 3.2 or 4.0 OPTIONAL SOFTWARE o OpenVMS DECwindows Motif[R] V1.2 (only if using OmniView) o Oracle Rdb V5.1 (VAX) or V6.0 (Alpha) for OpenVMS run-time option (only if using ODF) 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 OpenVMS Alpha, OpenVMS VAX and DIGITAL UNIX platforms. It is also available on TK50 media for Open- VMS VAX platforms. ORDERING INFORMATION For DIGITAL UNIX Systems: The DEComni API product kit is included in the BASEstar Open Server for DIGITAL UNIX Consolidated Software Distribution: Software Media: QA-5SRAA-H8 Software Licenses: QL-0YTA*-** Software Documentation: QA-0YTAA-GZ Software Product Services: QT-0YT*-** 6 For OpenVMS Alpha Systems: Software Licenses: QL-2QC*-** Software Documentation: QA-2QCAA-GZ Software Product Services: QT-2QC*-** For OpenVMS VAX Systems: Software Licenses: QL-4VBA*-AA Software Documentation: QA-2QCAA-GZ Software Product Services: QT-4VB*-** * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. SOFTWARE LICENSING The DEComni API license gives the user the right to use the software on a single CPU and includes the delivery of a license product Autho- rization Key (PAK) to enable DEComni API software. This software is furnished under the licensing provisions of Digital Equipment Corpo- ration's Standard Terms and Conditions. For more information about DIG- ITAL licensing terms and policies, contact your local DIGITAL office. License Management Facility Support: This layered product supports the OpenVMS and DIGITAL UNIX License Man- agement Facility. License units for this product are allocated on a CPU-capacity basis. For more information about the License Management Facility, refer to the appropriate SPD or documentation for your operating system. SOFTWARE PRODUCT SERVICES A variety of service options are available from DIGITAL. For more in- formation, contact your local DIGITAL office. 7 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 standard terms and conditions relating to DIGITAL SPDs. The above information is valid at time of release. Please contact your local DIGITAL office for the most up-to-date information. © 1997 Digital Equipment Corporation. All rights reserved. [R] Motif is a registered trademark of Open Software Foundation, Inc. [TM]The DIGITAL Logo, Alpha AXP, AXP, BASEstar, CI, DEC, DEC- station, DECsystem, DECwindows, DIGITAL, MicroVAX, OpenVMS, VAXserver, VAXstation, and VMS are trademarks of Digital Equip- ment Corporation. 8