DIGITAL Software Product Description ___________________________________________________________________ PRODUCT NAME: DECset Release 12.1 for OpenVMS VAX Systems SPD 27.07.16 DESCRIPTION DECset for OpenVMS VAX Systems is an integrated programming tool set that supports software developers' coding, debugging, testing, and main- tenance activities. DECset for OpenVMS VAX Systems contains the following components: o DEC Language-Sensitive Editor/Source Code Analyzer (LSE/SCA), Ver- sion 4.4, for OpenVMS VAX Systems o DEC Test Manager, Version 3.7, for OpenVMS VAX Systems o DEC Performance and Coverage Analyzer (PCA), Version 4.4, for Open- VMS VAX Systems o DEC Code Management System (CMS), Version 3.8, for OpenVMS VAX Sys- tems o DEC Module Management System (MMS), Version 3.1, for OpenVMS VAX Systems The tools in the DECset tool set can be used in either a workstation or character-cell terminal environment. All components include both DECwindows Motif® for OpenVMS VAX and command-line interfaces. In addition to these six tools, DECset also provides an Environment Manager (ENVMGR), which provides a single mechanism for tailoring the execution environment for a set of DECset tools. DECset also provides the program design facility, a set of features in LSE, SCA, and the May 1996 compilers that aid in the detailed program design phase of software development. DECset for OpenVMS VAX Systems Components DEC Language-Sensitive Editor/Source Code Analyzer for OpenVMS VAX Sys- tems: Language-Sensitive Editor The Language-Sensitive Editor (LSE) is a multilanguage programmer's editor. Language-specific templates and online language help assist both new and experienced programmers in developing programs faster. With LSE, users can efficiently edit, compile, review diagnostic in- formation from compilations, and correct compile time errors without exiting the editor. LSE also enables users to customize and extend their editing environment. Programmers can perform low-level program designs with LSE by embed- ding pseudocode in source code. Users can also view source code at var- ious levels of detail by replacing a sequence of source lines with a single overview line. LSE provides an interface via callable routines, as well as through the LSE command-line interface and the DECwindows Motif for OpenVMS VAX interface. The following VAX compilers fully support LSE; the language templates are included with LSE: DEC Ada DEC BASIC DEC C DEC C++ VAX COBOL DEC Fortran DEC PASCAL VAX BLISS-32 VAX C VAX MACRO 2 VAX PL/1 The following VAX products partially support LSE (refer to product SPDs for more details); the templates are included with the product: VAX ACMS VAX DATATRIEVE Note: Certain LSE features are not available when using language pre- processors, such as those supplied for Oracle Rdb. LSE works in concert with CMS, SCA, and the VAX Debugger to provide a highly interactive, online environment that facilitates the NAVIGATE- EDIT-COMPILE-DEBUG portion of the program development cycle. DECset users can directly reserve and replace files from CMS while in LSE, go to the exact source code location in LSE from the SCA, and go to the exact source code location in LSE from the VAX Debugger. Source Code Analyzer The Source Code Analyzer (SCA) aids programmers in understanding the complexities of software systems. Since it allows users to analyze an entire system, as opposed to individual modules, and helps users un- derstand unfamiliar systems, SCA is extremely useful during both the implementation and maintenance phases of a project. SCA provides navigation capabilities to assist users in locating and viewing components of their source code. SCA accomplishes this by stor- ing compiler-generated information about a set of source files in an SCA library. SCA then allows users to perform queries about their source code in the following ways: o Using a name browser to locate all items that match a search string. o Specifying a cross-reference query to find how and where program symbols are used. o Specifying a call graph query to graphically display call relation- ships between routines. 3 o Specifying a data structure query to graphically display the struc- ture of data types in the source code or to find symbols of a given type. After users have a query result, they can use the go-to-source fea- ture to navigate to locations of interest in their source code. SCA also provides static analysis capabilities to assist users in check- ing consistent use of program symbols. SCA provides an interface via callable routines, as well as through the SCA command-line interface and the DECwindows Motif for OpenVMS VAX interface. The following VAX compilers generate information to pop- ulate an SCA library: DEC Ada DEC BASIC DEC C VAX COBOL DEC Fortran DEC PASCAL VAX BLISS-32 VAX MACRO VAX PL/1 Note: SCA is not available when using language preprocessors, such as those supplied for Oracle Rdb. The following VAX compilers also generate pseudocode and specialized comment processing information so SCA can produce design reports, cross- reference and analysis information: DEC Ada DEC BASIC DEC C VAX COBOL DEC Fortran DEC PASCAL VAX BLISS-32 4 VAX PL/1 DEC Language-Sensitive Editor/Source Code Analyzer for OpenVMS VAX Sys- tems is a component of the DECset for OpenVMS VAX Systems product and is also available separately. Please refer to the ORDERING INFORMA- TION section of this SPD. DEC Test Manager for OpenVMS VAX Systems The DEC Test Manager for OpenVMS VAX Systems is a regression testing tool that automates the creation and maintenance of regression tests. It also automatically compares test run results with expected test re- sults. The DEC Test Manager provides users with flexibility in orga- nizing tests, selecting tests for execution, and verifying and review- ing test results. With the DEC Test Manager users can: o Test batch and command-line applications. o Test interactive applications that input and output text to character- cell terminals (DEC and ANSI CRT) with single display plane. o Create and record tests. o Group tests into meaningful combinations. o Execute specific tests, groups of tests, or combinations of groups of tests. o Compare the results of the executed tests with benchmark test re- sults to determine differences. o View test results interactively. o Update benchmarks as needed. o Filter test results to ignore output that is expected to change for each test execution. The DEC Test Manager enables users to store software test descriptions and related files in CMS libraries for storage efficiency. 5 The DEC Test Manager provides an interface through callable routines, as well as through the DEC Test Manager command-line interface and the DECwindows Motif for OpenVMS VAX interface. The DEC Test Manager for OpenVMS VAX Systems is a component of the DEC- set for OpenVMS VAX Systems product and is also available separately. Please refer to the ORDERING INFORMATION section of this SPD. DEC Performance and Coverage Analyzer for OpenVMS VAX Systems The DEC Performance and Coverage Analyzer (PCA) for OpenVMS VAX Sys- tems helps users pinpoint execution bottlenecks in application pro- grams. PCA can also identify which parts of an application are not ex- ecuted by a given set of test data. PCA has two components: the Col- lector, which gathers performance or test coverage data on the run- ning user program; and the Analyzer, which later processes and dis- plays the collected data. The Analyzer graphically presents informa- tion in four types of charts: histograms, tables, annotated source list- ings, and call trees. PCA does not analyze operating system performance or aid in hardware resource planning. PCA can gather and report on the following types of performance data: o Call stacks o CPU sampling data o Event markers o PC sampling data o Page fault data o System services data o Input/Output data o Exact execution counts o Test coverage data 6 o Ada tasking data Additional PCA features include the following: o Traversing commands to sift through performance data o Screen mode to display different types of data in separate windows o Multiple data kinds allowing the display of different categories of performance data in the same histogram or table o Acceptable noncoverage indicating portions of code that are accept- ably noncovered to the Analyzer o Filtering to analyze only a subset of data With PCA, users can analyze applications written in any of the fol- lowing OpenVMS languages: DEC Ada DEC BASIC DEC C VAX COBOL DEC Fortran DEC PASCAL VAX BLISS-32 VAX PL/1 PCA works in concert with LSE and the DEC Test Manager. From the character- cell version of PCA, users can communicate with LSE and can examine source code. When used with the DEC Test Manager, PCA can evaluate the code coverage of a user's test system. PCA provides a command-line interface and the DECwindows Motif for Open- VMS VAX interface. DEC Performance and Coverage Analyzer for OpenVMS VAX Systems is a com- ponent of the DECset for OpenVMS VAX Systems product and is also avail- able separately. Please refer to the ORDERING INFORMATION section of this SPD. DEC Code Management System for OpenVMS VAX Systems 7 The DEC Code Management System (CMS) for OpenVMS VAX Systems provides an efficient method for storing project files and tracking all changes to those files. Code management is especially important to projects that have long life spans or several versions of the software. CMS stores any kind of RMS file, including documents; plans; speci- fications; status reports; source code files; object files; executable images; sixel files; or other records, and keeps these files in project libraries. CMS also stores history information. As a project evolves, CMS tracks changes to the library by storing only the changes made to a file. Not only does this reduce the amount of disk space used for storing multiple versions of files, but it also allows CMS to recon- struct any previous version of a file and to identify the changes made between any two versions. In addition to storing successive changes, CMS maintains a record of who is currently working on a library el- ement and a historical record of library access. With CMS, users can: o Support multiple project libraries. o Retrieve previous generations (versions). o Delete, purge, or collapse generations. o Obtain a report of file modifications, including when, why, and by whom the modification was made. o Determine the origin of each line of a file, either as an annotated listing or as comments in the file. o Manage concurrent modifications. o Merge separately developed modifications. o Combine related files together as a class (group). o Relate the generation of one element to the corresponding gener- ations of other elements for purposes of freezing baselines or re- leases and for organizing ongoing development. o Interface via callable routines, as well as through the CMS command- line interface and the DECwindows Motif for OpenVMS VAX interface. 8 o Through the use of CMS access control lists, fine tune security mech- anisms applied to CMS libraries, and provide a means of notifica- tion about library events. CMS can act as a project's central repository, by storing and track- ing source-code files, object code, documentation, and a variety of files generated by other tools. CMS can store files for MMS and the DEC Test Manager. LSE and DEC Test Manager users can access CMS el- ements directly from within LSE and DEC Test Manager. The DEC Code Management System provides an interface through callable routines, as well as through the command-line interface and the DECwin- dows Motif for OpenVMS VAX interface. DEC Code Management System for OpenVMS VAX Systems is a component of the DECset for OpenVMS VAX Systems product and is also available sep- arately. Please refer to the ORDERING INFORMATION section of this SPD. DEC Module Management System for OpenVMS VAX Systems: DEC Module Management System (MMS) for OpenVMS VAX Systems automates and simplifies the building of software applications, whether they are simple programs of only one or two files or complex programs consist- ing of many source files, message files, and documentation. MMS can optimize the build process by rebuilding only those components (and their dependencies) in a system that have changed since the system was last built. In this way, MMS eliminates the steps of recompiling and linking modules that have not changed. MMS can automatically gener- ate description files. Once users create a description file contain- ing the rules describing the relationships among the components of their application and the MMS commands to build the application, MMS can build both small or large systems with a single command. MMS provides a command-line interface and the DECwindows Motif for Open- VMS VAX interface. DEC Module Management System for OpenVMS VAX Systems is a component of the DECset for OpenVMS VAX Systems product and is also available separately. Please refer to the ORDERING INFORMATION section of this SPD. 9 HARDWARE REQUIREMENTS Processors Supported: VAXft: VAXft 3000 Model 110 VAXft 3000 Model 310 VAXft 3000 Model 410 VAXft 3000 Model 610 VAXft 3000 Model 612 VAX: VAX 4000 Model 50 VAX 4000 Model 100, 100A, 105A VAX 4000 Model 200 VAX 4000 Model 300 VAX 4000 Model 500, 500A, 505A VAX 4000 Model 600, 600A VAX 4000 Model 700, 700A, 705A VAX 6000 Model 210, 220, 230, 240 VAX 6000 Model 310, 320, 330, 340, 360 VAX 6000 Model 410, 420, 430, 440, 450, 460 VAX 6000 Model 510, 520, 530, 540, 550, 560 VAX 6000 Model 610, 620, 630, 640, 650, 660 VAX 7000 Model 610, 620, 630, 640, 650, 660 VAX 7000 Model 710, 720, 730, 740, 750, 760 VAX 8200, VAX 8250 VAX 8300, VAX 8350 VAX 8500, VAX 8530, VAX 8550 VAX 8600, VAX 8650 VAX 8700 VAX 8800, VAX 8810, VAX 8820, VAX 8830, VAX 8840 VAX 9000 Model 110, 110VP VAX 9000 Model 210, 210VP 10 VAX 9000 Model 310, 310VP VAX 9000 Model 320, 320VP VAX 9000 Model 330, 330VP VAX 9000 Model 340, 340VP VAX 9000 Model 410, 410VP VAX 9000 Model 420, 420VP VAX 9000 Model 430, 430VP VAX 9000 Model 440, 440VP VAX 10000 Model 610, 620, 630, 640, 650, 660 VAX-11/730, VAX-11/750 VAX-11/780, VAX-11/785 MicroVAX: MicroVAX II MicroVAX 2000 MicroVAX 3100 Model 10/10E, 20/20E, 30, 40, MicroVAX 3100 Model 80, 85, 90, 95, 96 MicroVAX 3200, MicroVAX 3300 MicroVAX 3400, MicroVAX 3500 MicroVAX 3600, MicroVAX 3800, MicroVAX 3900 VAXstation: VAXstation II/GPX, VAXstation II/QVSS VAXstation 2000/GPX, VAXstation 2000/MFB VAXstation 3100/GPX Model 38, 48, 76 VAXstation 3100/SPX Model 38, 48, 76 VAXstation 3100 Model 30, 38, 40, 48, 76 VAXstation 3200 VAXstation 3500, VAXstation 3520, VAXstation 3540 VAXstation 4000 Model 60, 90, 95, 96, VLC 11 VAXserver: VAXserver 3100 Model 10, 10E, 20, 20E VAXserver 3200, 3300, 3400 VAXserver 3500, 3600, 3800, 3900 VAXserver 4000 Model 200, 300, 400, 500, 600 VAXserver 6000 Model 210, 220 VAXserver 6000 Model 310, 320 VAXserver 6000 Model 410, 420 VAXserver 6000 Model 510, 520 VAXserver: VAXserver 8200, 8250 VAXserver 8300, 8350 VAXserver 8530, 8550 VAXserver 8600, 8650 VAXserver 8700 VAXserver 8800, 8810, 8820, 8830, 8840 Processors Not Supported: MicroVAX I VAXstation I VAXstation 8000 VAX-11/725 VAX-11/750, VAX-11/751 VAX-11/782, VAX-11/785 Processor Restrictions: A TK50 Tape Drive is required for standalone MicroVAX 2000 and VAXs- tation 2000 systems. Terminals Character-cell interfaces for DECset are supported on the following terminals: o VT1xx 12 o VT2xx o VT3xx o VT4xx o VT5xx o ANSI CRT Disk Space Requirements (Block Cluster Size = 1): Each component of DECset for OpenVMS VAX Systems can be installed sep- arately. Each component requires the following disk space for a suc- cessful installation: ___________________________________________________________________ Space required Space required for use (per- COMPONENT__________to_install_________manent)______________________ LSE: 40,000 blocks 13,500 blocks (20.5M bytes) (7.0M bytes) SCA: 13,000 blocks 9,000 blocks (6.7M bytes) (4.7M bytes) DEC Test Man- 9,000 blocks 10,000 blocks ager: (4.7M bytes) (5.2M bytes) PCA: 12,000 blocks 5,000 blocks (6.1M bytes) (2.6M bytes) MMS: 2,800 blocks 300 blocks (1.5M bytes) (0.2M bytes) CMS: 9,000 blocks 4,000 blocks (4.7M bytes) (2.1M bytes) 13 ___________________Space_required_____Space_required_for_use_(per-_ COMPONENT__________to_install_________manent)______________________ ENVMGR: 2,000 blocks 800 blocks ___________________(1.1M_bytes)_______(0.5M_bytes)_________________ Requirements for installation of all DECset for OpenVMS VAX Systems components, including Language-Sensitive Editor support for all lan- guages, requires the following disk space: ___________________________________________________________________ Space required Space required for use (per- COMPONENT__________to_install_________manent)______________________ ALL COMPONENTS: 87,800 blocks 48,600 blocks ___________________(45.3M_bytes)______(24.9M_bytes)________________ These counts refer to the maximum 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. The minimum supported memory for this application running in a stan- dalone DECwindows Motif® for OpenVMS VAX environment, with both the client and server executing on that same system, is 32 MB. The performance and memory usage of DECwindows Motif for OpenVMS VAX applications are particularly sensitive to system configuration. Less memory may be required on the DECwindows Motif for OpenVMS VAX client system (the system where the software is installed and executed) if the server (the component that displays the application) resides on another system. More memory may be required on a system with several applications running or where it may be desirable to improve the per- formance of an application. 14 CLUSTER ENVIRONMENT This layered product is fully supported when installed on any valid and licensed VMScluster* configuration without restrictions. The HARD- WARE REQUIREMENTS sections of this product's Software Product Descrip- tion detail any special hardware required by this product. * VAXcluster configurations are fully described in the VAXcluster Soft- ware Product Description (SPD 29.78.xx) and include CI, Ethernet, and Mixed Interconnect configurations. SOFTWARE REQUIREMENTS For Systems Using Terminals (Without DECwindows Motif for OpenVMS VAX Interface): o OpenVMS VAX Operating System, Version 5.5 - Version 7.0 For Systems Running DECwindows Motif for OpenVMS VAX: o OpenVMS VAX Operating System, Version 5.5 - Version 7.0 o DECwindows Motif for OpenVMS VAX, Version 1.2 OPTIONAL SOFTWARE Certain versions of these products depend upon a specific version of the operating system. Please refer to the SPD of the product in ques- tion to determine which version is necessary. o DEC Ada Version 3.2 o DEC BASIC Version 3.7 o DEC C Version 5.2 o DEC C++ Version 5.2 o VAX COBOL Version 5.3 o DEC Fortran Version 6.4 o DEC PASCAL Version 5.5 15 o VAX BLISS-32 Version 4.6 o VAX PL/1 Version 3.5A 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 9-track 1600 BPI Magtape, TK50 Streaming Tape This product is also available as part of the OpenVMS Consolidated Soft- ware distribution on CD-ROM QA-VWJ8A-A8. The software documentation for this product is also available as part of the OpenVMS Online Documentation Library on CD-ROM. ORDERING INFORMATION To order the DECset for OpenVMS VAX Systems product (includes all com- ponents): Software Licenses: Personal Use : QL-965AA-2B Concurrent Use : QP-965AA-3B Unlimited System Use: QL-965A*-** Software Media/Documentation: QA-965AA-H* Software Documentation (Hard Copy): QA-965AA-GZ Software Product Services: QT-965A*-** To Order Components Separately: DEC Language-Sensitive Editor/Source Code Analyzer for OpenVMS VAX Sys- tems: 16 Software Licenses: Personal Use : QL-057AA-2B Concurrent Use : QL-057AA-3B Unlimited System Use: QL-057**-** Software Media/Documentation: QA-965AA-H* Software Documentation (Hard Copy): QA-965AA-GZ Software Product Services: QT-057A*-** DEC Test Manager for OpenVMS VAX Systems: Software Licenses: Personal Use : QL-927AA-2B Concurrent Use : QL-927AA-3B Unlimited System Use: QL-927**-** Software Media/Documentation: QA-965AA-H* Software Documentation (Hard Copy): QA-965AA-GZ Software Product Services: QT-927A*-** DEC Performance and Coverage Analyzer for OpenVMS VAX Systems: Software Licenses: Personal Use : QL-119AA-2B Concurrent Use : QL-119AA-3B Unlimited System Use: QL-119**-** Software Media/Documentation: QA-965AA-H* Software Documentation (Hard Copy): QA-965AA-GZ Software Product Services: QT-119A*-** DEC Code Management System for OpenVMS VAX Systems: Software Licenses: Personal Use : QL-007AA-2B Concurrent Use : QL-007AA-3B Unlimited System Use: QL-007**-** Software Media/Documentation: QA-965AA-H* Software Documentation (Hard Copy): QA-965AA-GZ Software Product Services: QT-007A*-** DEC Module Management System for OpenVMS VAX Systems: 17 Software Licenses: Personal Use : QL-VADAA-2B Concurrent Use : QL-VADAA-3B Unlimited System Use: QL-VAD**-** Software Media/Documentation: QA-965AA-H* Software Documentation (Hard Copy): QA-965AA-GZ Software Product Services: QT-VADA*-** * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. SOFTWARE LICENSING This software is only furnished under a license. For more information about Digital's licensing terms and policies, contact your local Dig- ital office. License Management Facility Support: These layered products support the OpenVMS License Management Facil- ity. License units for the DECset for OpenVMS VAX Systems product AND for the component products are allocated on an Unlimited System Use and Personal and Concurrent Use basis. Each Personal Use license allows one identified individual to use the layered product. Each Concurrent Use license allows any one individ- ual at a time to use the layered product. These licenses are shared on VAX and Alpha Systems. For more information on the OpenVMS License Management Facility, re- fer to the OpenVMS Operating System Software Product Description (SPD 25.01.xx) or documentation. 18 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. This means that Digital will rem- edy any nonconformance when it is reported to Digital by the customer during the warranty period. The warranty period is one year. It begins when the software is in- stalled or thirty days after delivery to the end user, whichever oc- curs first and expires one year later. All warranty-related support for this software will end one year after release of the subsequent versions. Warranty is provided in the country of purchase. Digital will provide a service location which will accept reporting (in format prescribed by Digital) of a nonconformance problem caused when using the licensed software under normal conditions as defined by this SPD. Digital will remedy a nonconformance problem in the current unaltered release of the licensed software by issuing a correction information such as: cor- rection documentation, corrected code; or a notice of availability of corrected code; or a restriction or a bypass. The customer will be re- sponsible for the preparation and submission of the problem report to the service location. WARRANTY EXCLUSION Digital does not warrant that the software licensed to the customer shall be error free, that the software shall operate with any hard- ware and software other than as specified in this SPD, that the soft- ware shall satisfy the customer's own specific requirements, or that copies of the software other than those provided or authorized by Dig- ital shall conform to the SPD. 19 Digital makes no warranties with respect to the fitness and operabil- ity of modifications not made by Digital. If the software fails to function for reasons stated above, the cus- tomer's warranty will be invalidated and all service calls will be bil- lable at the prevailing per call rates. This Software Warranty is effective for licensed software products or- dered in the United States after October 1988 and supersedes all prior versions. The previous information is valid at time of release. Please contact your local Digital office for the most up-to-date information. ® Motif is a registered trademark of Open Software Foundation, Inc. [TM] The DIGITAL logo, CI, DEC, DEC Ada, DEC BASIC, DEC Fortran, DECset, DECwindows, Digital, MicroVAX, OpenVMS, VAX, VAX C, VAX BLISS-32, VAXcluster, VAXft, VAX MACRO, VAXserver, VAXstation, VMScluster, and VT are trademarks of Digital Equipment Corporation. © 1996 Digital Equipment Corporation. All rights reserved. 20