DIGITAL Software Product Description ___________________________________________________________________ PRODUCT NAME: DEComni MMS SPD 47.89.02 Version 3.0 DESCRIPTION DEComni MMS is a network communication product that provides a solu- tion for the connection and management of manufacturing/utility con- trol devices and systems. DEComni MMS implements the Manufacturing Mes- sage Specification (MMS), ISO/IEC 9506-1 and ISO/IEC 9506-2. When com- bined with prerequisite hardware and software, DEComni MMS interop- erates with other systems supporting the Manufacturing Message Spec- ification ISO/IEC9506-1 and ISO/IEC 9506-2 specifications. Features DEComni MMS is an implementation of the Manufacturing Message Spec- ification (MMS), ISO/IEC 9506. It relies upon the DEComni API prod- uct that provides a high level applications programming interface (API) with a high degree of functionality built in. The interface is easy to use and requires very little support code. For more information, please refer to the DEComni API Software Product Description (SPD 47.88.xx). DEComni MMS provides, as a minimal set, the Client Conformance require- ments for the services specified in MAP Implementation Class MAP3. The product is able to connect to those devices that have implemented to ISO/IEC 9506 (MMS). February 1996 AA-2YUAA-TE CONFORMANCE TO STANDARDS The conformance of DEComni MMS software to OSI standards is specified in Appendix A of this SPD. INSTALLATION Only experienced customers should install DEComni MMS software. Dig- ital recommends that all other customers purchase Digital's Instal- lation Services. These services provide for installation of the soft- ware product by an experienced Digital Software Specialist. Installation steps for DEComni MMS consists of the following: o Verification that all components of DEComni MMS 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 as specified in this SPD o Installation of the DEComni MMS software by creating the necessary directories and by copying the software from the distribution me- dia o Verification that DEComni MMS has been installed correctly by us- ing the IVP DEComni MMS Installation Verification Procedure (IVP) The DEComni MMS IVP performs a series of tests to verify proper in- stallation. HARDWARE REQUIREMENTS Alpha Processors Supported All Alpha processors supported by the DEComni API product. Refer to SPD 47.88.xx. 2 Disk Space Requirements (Block Cluster Size = 1): For_OpenVMS_Systems________________________________________________ During Instal- lation___________Permanent_Use_____________________________________ 35,000_blocks____20,000_blocks_____________________________________ For_Digital_UNIX_Systems___________________________________________ Component___Installation_Permanent_Use_____________________________ File 340 kbytes 340 kbytes System Root /usr/opt 7 mbytes 6 mbytes /usr/var 5 mbytes 2 kbytes /opt Total_______13_mbytes____9_mbytes__________________________________ SUPPORTED PRODUCTS This SPD defines the following DEComni MMS products: o DEComni MMS for Digital UNIX Version 3.0 o DEComni MMS for OpenVMS Alpha Version 3.0[1] SOFTWARE REQUIREMENTS For OpenVMS Alpha Systems:[1] o OpenVMS Alpha Operating System V6.1 o DECnet/OSI for OpenVMS Alpha V6.0 ____________________ At the time of writing, this platform only supports a field test ver- sion of DEComni MMS Version 3.0 3 For Digital UNIX Systems: o Digital UNIX Operating System V3.2 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. DISTRIBUTION MEDIA This product is distributed with the Digital CD-ROM software libraries for OpenVMS Alpha and for Digital UNIX. ORDERING INFORMATION For OpenVMS Alpha systems: Software Licenses: QL-2QD**-** Documentation Kit: QA-2QDAA-GZ Software Product Services: QT-2QD**-** For Digital UNIX systems: Software Licenses: QL-2YU**-** Documentation Kit: QA-2YUAA-GZ Software Product Services: QT-2YU**-** * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. The above information is valid at time of release. Please contact your local Digital office for the most up-to-date information. 4 SOFTWARE LICENSING The DEComni MMS 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 MMS software. This software is furnished under the licensing provisions of Digital Equipment Corpo- ration's Standard Terms and Conditions for software licenses. For more information about Digital's 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 the product are allocated on a CPU- capacity basis. For more information on the License Management Facility, refer to the appropriate operating system SPD or documentation. 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 pur- chase of a license for the product as defined in this SPD. Warranty Limitations Digital has produced this product according to Protocol Specifications produced by the International Organization for Standardization (ISO) defined in Appendix A of this SPD. Digital warrants this product to conform to these Protocol specifi- cations, as described by these International Standards. 5 Digital cannot assume responsibility for problems caused by: o Other vendors' nonconformance to the International Standards that DEComni API implements o Ambiguities in the International Standards implemented by DEComni MMS o Flaws in the protocol design appearing in the International Stan- dards implemented by DEComni MMS Assistance requested of Digital for problems resulting from any of the errors listed above will result in all associated service calls be- ing billed at the prevailing per call rates. To minimize the risk of problems, Digital has tested this product against selected other ISO /IEC 9506-1 and ISO/IEC 9506-2 implementations. APPENDIX A: Conformance to Standards This appendix defines the conformance of DEComni MMS DEComni MMS prod- uct to International Organization for Standardization (ISO) interna- tional specifications for protocol standards as specified in ISO/IEC 9506-2 clause 18. ___________________________________________________________________ Table_1:_PICS_Part_1:_Implementation_Information___________________ Attribute____________________________Value_________________________ Implementation's Vendor Name Digital Implementation's Model Name DEComni MMS Implementation's Revision Identi- V3.0 fier Machine Name(s) and Version Num- - ber(s) Operating System(s) OpenVMS, Digital UNIX MMS Abstract Syntax [1 0 9506 2 1] 6 ___________________________________________________________________ Attribute____________________________Value_________________________ MMS Version Number Supported 1 MMS Companion Standard Abstract None Syntaxes MMS Companion Standard Version N/A Number Supported Calling MMS-user (indicate "Yes" or Yes "No") Called MMS-user (indicate "Yes" or Yes "No") List_of_Standardized_Names___________None__________________________ ___________________________________________________________________ Table_2:_PICS_Part_2:_Service_CBBs_________________________________ Service_Conformance_Building_Blocks__S(erver),_C(lient),_or_B(oth)_ Initiate B Conclude B Cancel - UnsolicitedStatus B Status B GetNameList B Identify B Rename - GetCapabilityList B Read B Write B InformationReport B GetVariableAccessAttributes B 7 ___________________________________________________________________ Service_Conformance_Building_Blocks__S(erver),_C(lient),_or_B(oth)_ DefineNamedVariable - DefineScatteredAccess - GetScatteredAccessAttributes - DeleteVariableAccess - DefineNamedVariableList B GetNamedVariableListAttributes B DeleteNamedVariableList B DefineNamedType - GetNamedTypeAttributes - DeleteNamedType - Input - Output - TakeControl - RelinquishControl - DefineSemaphore - DeleteSemaphore - ReportSemaphoreStatus - ReportPoolSemaphoreStatus - ReportSemaphoreEntryStatus - AttachToSemaphore - InitiateDownloadSequence C DownloadSegment S TerminateDownloadSequence S InitiateUploadSequence C UploadSegment C TerminateUploadSequence C RequestDomainDownload S RequestDomainUpload S 8 ___________________________________________________________________ Service_Conformance_Building_Blocks__S(erver),_C(lient),_or_B(oth)_ LoadDomainContent B StoreDomainContent B DeleteDomain B GetDomainAttributes B CreateProgramInvocation B DeleteProgramInvocation B Start B Stop B Resume B Reset B Kill B GetProgramInvocationAttributes B ObtainFile B DefineEventCondition - DeleteEventCondition - GetEventConditionAttributes - ReportEventConditionStatus - AlterEventConditionMonitoring - TriggerEvent - DefineEventAction - DeleteEventAction - GetEventActionAttributes - ReportEventActionStatus - DefineEventEnrollment B (See Note 9) DeleteEventEnrollment B (See Note 9) AlterEventEnrollment - ReportEventEnrollmentStatus - GetEventEnrollmentAttributes B (See Note 9) 9 ___________________________________________________________________ Service_Conformance_Building_Blocks__S(erver),_C(lient),_or_B(oth)_ AcknowledgeEventNotification - AttachToEventCondition - EventNotification B GetAlarmSummary - GetAlarmEnrollmentSummary - ReadJournal - WriteJournal - InitializeJournal - CreateJournal - DeleteJournal - ReportJournalStatus__________________-_____________________________ ___________________________________________________________________ Table_3:_PICS_Part_3:_Parameter_CBB________________________________ Parameter Conformance Building Blocks_______________________________Supported_(Value)_____________ STR1 Y STR2 Y NEST ( >=0 . Give integer value.) 10 VNAM Y VADR Y VALT Y VSCA N TPY N VLIS NY REAL N CEI__________________________________N_____________________________ 10 ___________________________________________________________________ Table_4:_Supplemental_PICS_Table___________________________________ Service_Conformance_Building_Blocks__S(erver),_C(lient),_or_B(oth)_ FileOpen B FileRead B FileClose B FileRename B FileDelete B FileDirectory________________________C_____________________________ ___________________________________________________________________ Table_5:_PICS_Part_4:_Local_Implementation_Values__________________ Attribute____________________________Value_________________________ Range of values for floating point See Note 1 numbers Supported values of the floating See Note 1 point exponent width Supported values of the floating See Note 1 point format width Range of values for signed integer ±2**32-1 Range of values for unsigned inte- 2**32 ger The following semantics are defined for the use of the local detail calling/called fields. As a result, a limit is set for a maximum MMS PDU size which limits specific functions. Maximum length for BIT STRING in See Note 2 bits Maximum length for OCTET STRING in See Note 2 octets 11 ___________________________________________________________________ Attribute____________________________Value_________________________ Address formats for VADR Parameter N/A CBB Maximum Input Time Out in seconds N/A Level of support for time See Note 3 Granularity of time in milliseconds N/A Uninterruptible access to variable See Note 4 Priority processing for semaphores N/A Capabilities of VMD N/A Local Detail N/A File Name Syntax See Note 5 Range of Maximum Services Outstand- See Note 6 ing Calling Range of Maximum Services Outstand- See Note 6 ing Called Execution Argument N/A Additional Code in Error Type See Note 7 Additional Detail in Error Type See Note 7 Method for Extended Derivation of N/A Status Information Local Detail Calling/Called See Note 8 Load Data Format N/A Maximum Number of Upload State N/A Machines___________________________________________________________ Note 1: VAX F floating point is supported. The range is 1.17545*10**-38 through 1.17545*10**38. An exponent width of 8 bits is supported. A format width of 32 bits is supported. Note 2: 12 The effective length for strings is limited by the maximum PDU size. See Note 8. Note 3: Date and Time are supported. Support for Time Sequence Identifier is N/A. Note 4: Read and Write indications are delivered to user written code and thus uninterruptible access is application dependent. Note 5: The syntax and semantics for file name are specified by the OpenVMS operating system. This is documented in the OpenVMS documentation un- der "Full File Specification". Wildcard specifiers are not permitted. The file name must be specified in the first graphic string of the File- Name production. Any information in additional graphic strings will be ignored. Note 6: The range is 1-infinity. Acceptance of indications is under program- ming control. The actual number of outstanding requests allowable is dependent upon process memory limits which is set by either the pro- grammer or system manager. Note 7: This implementation does not specify additional code nor additional detail in error type. Note 8: The following semantics are defined for the use of the local detail calling/called fields. As a result, a limit is set for a maximum MMS PDU size, which limits specific functions. 13 The semantics of this field are contained in the implementation agree- ments of the NIST (National Institute for Standards and Technology - OSE Implementor's Workshop) Special Publication 500-214 titled Sta- ble Implementation Agreements for Open Systems Interconnection Pro- tocols, Version 7, Edition 1, December 1993, Part 20 (MMS) Sections 8.2.0.3 and 8.2.0.4. Note 9: The optional parameter of Event Actions on an Event Enrollment is not supported. © 1996 Digital Equipment Corporation. All rights reserved. [R] Motif is a registered trademark of Open Software Foundation, Inc. [TM]The DIGITAL Logo, AXP CI, DEC, DECnet, DEComni, DECosap, DECwindows, Digital, MicroVAX, Rdb, OpenVMS, TK, VAX, VAX- cluster, VAXft, VAXserver, VAXstation, and VMS are trademarks of Digital Equipment Corporation. 14