Software Product Description ___________________________________________________________________ PRODUCT NAME: POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) INTRODUCTION The POLYCENTER Framework Developer's Toolkit consists of software and documentation used in the development of POLYCENTER Network Manage- ment 200/400 Access Modules (AMs) and Function Modules (FMs). Avail- able in OpenVMS and RISC/ULTRIX versions, the product is intended for experienced system software developers. The POLYCENTER Framework Developer's Toolkit is one of several prod- ucts in the POLYCENTER Product Family, a group of related network and system management software products based on the Digital Enterprise Management Architecture (EMA). For an overview of these products, re- fer to the POLYCENTER Network Management Product Family Overview Soft- ware Product Description (SPD 37.20.xx). DESCRIPTION The POLYCENTER Framework Developer's Toolkit consists of software tools and documentation that enable users to design and develop Access or Function Modules for the following POLYCENTER Network Manager 200/400 Family Products: o POLYCENTER Framework (DECmcc Director) (SPD 32.46.xx) o POLYCENTER Network Manager 200 (DECmcc Basic Management System) (DECmcc BMS, SPD 32.48.xx) o POLYCENTER Network Manager 400 (DECmcc Enterprise Management Sta- tion) (DECmcc EMS, SPD 31.88.xx) DIGITAL January 1995 AE-PC88G-TE POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) Note: POLYCENTER Framework or POLYCENTER Network Manager 200 or POLY- CENTER Network Manager 400 software is required for installing, en- rolling, testing, and operating management modules developed using the POLYCENTER Framework Developer's Toolkit. The POLYCENTER Framework De- veloper's Toolkit software simplifies the design and implementation of application-specific modules by offering a runtime kernel execu- tive, various service programs, and source code for sample Access and Function Modules. DOCUMENTATION The POLYCENTER Framework Developer's Toolkit documentation provides information to assist in the design and development of POLYCENTER Net- work Management Modules. It includes the following documents: o Enterprise Management Architecture (EMA) General Description o EMA Entity Model o The DECmcc System Reference Manual (SRM Volume 1 & 2) o POLYCENTER Management Module Programming o The POLYCENTER Framework Developer's Toolkit Reference The POLYCENTER Module Reference Manuals, available on-line only, pro- vide specifications of the services offered and required by each POLY- CENTER/DECmcc network management module. DEVELOPMENT UTILITIES Development utilities and tools that are part of the Toolkit include the Design Framework, a sample Access Module, and an example Function Module: o POLYCENTER Network Management Design Framework is a set of generic software components that enable users to construct a starter Man- agement Module. Such a module can be used as a base for the devel- opment of application-specific Access or Function Modules. The De- sign Framework uses proven development techniques that minimize 2 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) coding errors, expedite development, and reduce coding ambiguities that can arise during module design. o Sample Access Module is a basic example of an AM that can be run on a POLYCENTER Network Manager 200/400 or POLYCENTER Framework system. It contains working examples of many of the POLYCENTER Network Manager 200/400 interfaces, including the mcc_call interface and calls to many of the POLYCENTER Network Manager 200/400 routines that enable Management Modules to reside on and interoperate within a POLYCENTER Network Manager 200/400 system. The Sample AM is implemented using the Design Framework. NOTE: The Sample AM explicitly uses Phase IV of DECnet-VAX, or DECnet-ULTRIX. If DECnet is unavailable, the Sample AM may be run with the transport disabled for illustration purposes only. o Example Function Module contains working examples of common rou- tines used by FMs to access the services of the POLYCENTER Network Manager system and other FMs and AMs. It is layered on top of the Sample AM. o The following utilities are included in the POLYCENTER Framework and POLYCENTER Network Manager 200/400 Software and are necessary for enrolling application-specific access modules and related files into the POLYCENTER Network Management system: o Management Specification Language (MSL) Translator Utility o Dictionary Administrator Program (DAP) Utility o Bed Driver (TBD) Utility o Help File Builder (HFB) Utility These utilities allow on-site enrollment of access and function mod- ules. The POLYCENTER Framework Developer's Toolkit Reference (AA-PD5MC-TE) describes each utility in detail. 3 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) HARDWARE REQUIREMENTS Processors Supported OpenVMS-based Processors: VAX: VAXft Model 410, VAXft Model 610, VAXft Model 612 VAX 4000 Model 300, VAX 4000 Model 400, VAX 4000 Model 500, VAX 4000 Model 600 VAX 4000 Model 700 VAX 6000 Model 400 Series, VAX 6000 Model 500 Series, VAX 6000 Model 600 Series VAX 7000 Model 600 Series VAX 8200, VAX 8250, VAX 8600, VAX 8650, VAX 8700, VAX 8800, VAX 8810, VAX 8820, VAX 8830, VAX 8840 VAX 9000 Model 110, VAX 9000 Model 210, VAX 9000 Model 300 Series, VAX 9000 Model 400 Series MicroVAX: MicroVAX 3300, MicroVAX 3400, MicroVAX 3500, MicroVAX 3600, 4 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) MicroVAX 3800, MicroVAX 3900 VAXstation: VAXstation 3200, VAXstation 3500, VAXstation 3520, VAXstation 3540 VAXstation 4000 Model 60, VAXstation 4000 Model 90, VAXstation 4000 Model 90A VAXserver: VAXserver 3400, VAXserver 3500, VAXserver 3600, VAXserver 3602, VAXserver 3800, VAXserver 3900 VAXserver 4000 Model 300, VAXserver 4000 Model 500 VAXserver 4000 Model 600 VAXserver 4000 Model 700 VAXserver 6000 Model 410, VAXserver 6000 Model 420, VAXserver 6000 Model 510, VAXserver 6000 Model 520, VAXserver 6000 Model 610, VAXserver 6000 Model 620, VAXserver 6000 Model 630 ULTRIX-based Processors: RISC: DECstation: DECstation 5000 Model 120/125/133/150 CX, DECstation 5000 Model 120/125/133/150 HX, DECstation 5000 Model 120/125/133/150 MX, DECstation 5000 Model 120/125/133/150 PX, DECstation 5000 Model 120/125/133/150 TX, 5 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) DECstation 5000 Model 120/125/133/150 PXG, DECstation 5000 Model 120/125/133/150 PXG+, DECstation 5000 Model 120/125/133/150 PXG Turbo, DECstation 5000 Model 120/125/133/150 PXG Turbo+ DECstation 5000 Model 200 CX, DECstation 5000 Model 200 HX, DECstation 5000 Model 200 MX, DECstation 5000 Model 200 PX, DECstation 5000 Model 200 TX, DECstation 5000 Model 200 PXG, DECstation 5000 Model 200 PXG+, DECstation 5000 Model 200 PXG Turbo, DECstation 5000 Model 200 PXG Turbo+ DECstation 5000 Model 240/260 HX, DECstation 5000 Model 240/260 MX, DECstation 5000 Model 240/260 TX, DECstation 5000 Model 240/260 PXG+, DECstation 5000 Model 240/260 PXG Turbo+ DECsystem: DECsystem 5000 Model 200, DECsystem 5000 Model 240, DECsystem 5100, DECsystem 5400, DECsystem 5500, DECsystem 5810, DECsystem 5900 Processors Not Supported MicroVAX I, MicroVAX II, MicroVAX 2000 MicroVAX 3100 Model 10/10E, MicroVAX 3100 Model 20/20E MicroVAX 3100 Model 30 MicroVAX 3100 Model 40 MicroVAX 3100 Model 80 6 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) MicroVAX 3100 Model 90 VAXstation I, VAXstation II, VAXstation 2000 VAXstation 3100 Model 30, VAXstation 3100 Model 38, VAXstation 3100 Model 40, VAXstation 3100 Model 48, VAXstation 3100 Model 76 VAX-11/725, VAX-11/730, VAX-11/750, VAX-11/780, VAX-11/782, VAX-11/785 VAX 4000 Model 60, VAX 4000 Model 90, VAX 4000 Model 100, VAX 4000 Model 200, VAX 4000 VLC VAX 6000 Model 200 Series, VAX 6000 Model 300 Series VAX 8300, VAX 8350, VAX 8500, VAX 8530, VAX 8550, VAX 10000 Model 600 Series VAXstation 8000 VAXft Model 110, VAXft Model 310 VAXserver 6000 Model 210, VAXserver 6000 Model 220, VAXserver 6000 310, VAXserver 6000 Model 320 VAXserver 3100, VAXserver 3300, VAXserver 4000 Model 200 Personal DECstation 5000 Model 20/25 MX, Personal DECstation 5000 Model 20/25 HX, Personal DECstation 5000 Model 20/25 TX, Personal DECstation 5000 Model 20/25 PXG+, Personal DECstation 5000 Model 20/25 PXG Turbo +, 7 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) DECsystem 3100, DECsystem Model 25, DECsystem 2100, DECsystem 5820, DECsystem 5830, DECsystem 5840. DECstation 3100, DECstation Model 3100 series. MINIMUM RECOMMENDED CONFIGURATION * For OpenVMS: Processor Capac- 6 SPECmark ity: Memory Required: 32 MB Disk: RZ25 For RISC/ULTRIX: Processor Capac- 16 SPECmark ity: Memory Required: 48 MB Disk: RZ56 Disk * Specific network environments may require larger configurations. Disk Space Requirements (Block Cluster Size = 1) For OpenVMS: Disk space 44,000 blocks on the system disk required for installation and use: 25 blocks on the mcc_common disk 44,025 blocks total For RISC/ULTRIX: 8 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) Disk space 20,000 Kbytes required for installation and use: The sizes are approximate; actual sizes may vary depending on the user's system environment, configuration, and software options. OPTIONAL HARDWARE VT1300 and VT2000 Color Terminals are supported. CLUSTER ENVIRONMENT This layered product is fully supported when installed on any valid and licensed VAXcluster* configuration without restrictions. The HARD- WARE REQUIREMENTS section details any special hardware required by this product. * V5.x VAXcluster configurations are fully described in the VAXclus- ter Software Product Description (29.78.xx) and include CI, Eth- ernet, and Mixed Interconnect configurations. IMPORTANT INTEROPERABILITY INFORMATION FOR OPENVMS USERS ONLY Interoperability problems may occur when more than one product con- taining DECthreads is installed on a system. This occurs because some products overwrite the system version of DECthreads. If a product with a different version of DECthreads is installed after POLYCENTER Frame- work, problems may occur. POLYCENTER Framework V1.4 is linked with DECthreads V1.0-422. Later versions of DECthreads have a backwards compatible API. Consequently, no problem should result from having a more recent version of DECthreads on the system. Only SSB versions of DECthreads are supported. 9 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) SOFTWARE REQUIREMENTS FOR OPENVMS For Systems Using Terminals (no DECwindows Motif interface): o OpenVMS VAX Operating System V5.5-2 to V6.1 o One of the following POLYCENTER software packages: - POLYCENTER Framework V1.4 - POLYCENTER Network Manager 200 V1.4 - POLYCENTER Network Manager 400 V2.4 For Workstations Running DECwindows Motif: o OpenVMS VAX Operating System V5.5-2 to V6.1 o DECwindows Motif V1.1 for OpenVMS V5.5-2 DECwindows Motif V1.2 for OpenVMS V6.1 o One of the following POLYCENTER software packages: - POLYCENTER Framework V1.4 - POLYCENTER Network Manager 200 V1.4 - POLYCENTER Network Manager 400 V2.4 NOTE: The VAX C compiler on OpenVMS V5.5-2, or the DEC C compiler on OpenVMS 6.1, is required to compile the sample AM. POLYCENTER Network Manager is compiled using VAX C. The DEC C documentation explains the coexistence issues that need to be considered. OpenVMS Tailoring For OpenVMS systems, the following OpenVMS classes are required for full functionality of this layered product: o OpenVMS Required Saveset o Network Support o Programming Support o Utilities 10 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) For more information about OpenVMS classes and tailoring, refer to the OpenVMS Operating System Software Product Description (SPD 25.01.xx) SOFTWARE REQUIREMENTS FOR RISC/ULTRIX For Systems Using Terminals (no Motif interface): o ULTRIX Operating System V4.2, V4.3, V4.3A, V4.4 o One of the following POLYCENTER software packages: - POLYCENTER Framework V1.4 - POLYCENTER Network Manager 200 V1.4 - POLYCENTER Network Manager 400 V2.4 For Workstations (both with and without Motif): o ULTRIX Worksystem Software V4.2, V4.3, V4.3A, V4.4 o DECwindows Motif V1.1.3 (for Ultrix V4.2, V4.3, 4.3A) DECwindows Motif V1.2 (for Ultrix V4.4) o One of the following POLYCENTER software packages: - POLYCENTER Framework V1.4 - POLYCENTER Network Manager 200 V1.4 - POLYCENTER Network Manager 400 V2.4 RISC/ULTRIX Subsets: The following subsets are required for this layered product: o UDTBASE42x, UDTINTLRT42x, UDTPGMR42x, UDTINTLPGMR42x (ULTRIX 4.2) o UDTBASE43x, UDTINTLRT43x, UDTPGMR43x, UDTINTLPGMR43x (ULTRIX 4.3, 4.3A) o UDTBASE44x, UDTINTLRT44x, UDTPGMR44x, UDTINTLPGMR44x (ULTRIX 4.4) For more information on ULTRIX Subsets, refer to the ULTRIX Operat- ing System Software Product Description (SPD 26.40.xx). 11 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) 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, please con- tact your local Digital office. LICENSE MANAGEMENT FACILITY This product supports the OpenVMS and ULTRIX License Management Fa- cilities (LMF). License units for this product are allocated on an Unlimited Use Ba- sis. For more information on the License Management Facility, refer to the OpenVMS VAX Operating System Software Product Description (SPD 25.01.xx) or the ULTRIX Operating System SPD (26.40.xx). For more information about Digital's licensing terms and policies please contact your local Digital office. OPTIONAL SOFTWARE For OpenVMS: VAX Language-Sensitive Editor/Source Code Analyzer V3.0 GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of this product may be different from the requirements for the current version. 12 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) DISTRIBUTION MEDIA This product is available as part of the OpenVMS VAX and ULTRIX Lay- ered Product Consolidated Distributions on CD-ROM. This product is also available on TK50 Streaming Tape The software documentation for this product is available as part of the OpenVMS VAX Online Documentation Library on CD-ROM. ORDERING INFORMATION For OpenVMS: Software Licenses: QL-YSWA9-AA Software Media: QA-YSWAA-H5 Software Documentation: QA-YSWAA-GZ Software Product Services: QT-YSWA*-** For RISC/ULTRIX: Software License: QL-GU7A8-AA Software Media: QA-GU7AA-H5 Software Documentation: QA-GU7AA-GZ Software Product Services: QT-GU7A*-** * Denotes variant fields. For additional information on available li- censes, services and media, refer to the appropriate price book. SOFTWARE PRODUCT SERVICES A variety of service options are available from Digital. For more in- formation, contact your local Digital office. Network Management Services are also available. These include, but are not restricted to, the following: o Network Management Operations Services o Network Management Planning and Design Services o Network Management Implementation Services 13 POLYCENTER Framework Developer's Toolkit, Version 1.4 SPD 32.49.05 (Formerly DECmcc Developer's Toolkit) o Network Management Training For local availability, please contact your Digital Sales 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 the Software Warranty Addendum of this SPD. The above information is valid at time of release. Please contact your local Digital office for the most up-to-date information. R Motif is a registered trademark of Open Software Foundation, Inc. [TM] The DIGITAL Logo, DEC, DECmcc, DECnet, DECsystem, DECsta- tion, DECwindows, Digital, MicroVAX, OpenVMS, POLYCENTER, TK, Ultrix, VAX, VAXcluster, VAXstation, and VAXserver are trademarks of Digital Equipment Corporation. ©1995 Digital Equipment Corporation. All Rights Reserved. 14