Software Product Description ___________________________________________________________________ PRODUCT NAME: HP DECset Release 12.7 for OpenVMS VAX Systems SPD 27.07.22 DESCRIPTION HP DECset for OpenVMS VAX Systems is an integrated programming tool set that supports software developers' coding, debugging, testing, and maintenance activities. HP DECset for OpenVMS VAX Systems contains the following components: o HP Language-Sensitive Editor/Source Code Analyzer (LSE), Version 5.0, for OpenVMS VAX Systems o HP Source Code Analyzer(SCA), Version 4.9, for OpenVMS VAX Systems o HP Digital Test Manager, Version 4.3, for OpenVMS VAX Systems o HP Performance and Coverage Analyzer (PCA), Version 4.9, for Open- VMS VAX Systems o HP Code Management System (CMS), Version 4.4, for OpenVMS VAX Sys- tems o HP Module Management System (MMS), Version 3.7, for OpenVMS VAX Sys- tems The tools in the DECset tool set can be used in either a workstation or character-cell terminal environment. All components include both HP DECwindows Motif for OpenVMS VAX and command-line interfaces. In addition to these six tools, DECset has an Environment Manager (EN- VMGR) that provides a single mechanism for tailoring the execution en- vironment for a set of DECset tools. DECset also provides the program design facility, a set of features in LSE/SCA and the compilers, that aids in the detailed program design phase of software development. July 2005 HP DECset for OpenVMS VAX Systems Components HP 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. Note: The following LSE-supported compilers are available on the Open- VMS VAX platform: HP Ada for OpenVMS VAX HP BASIC for OpenVMS VAX HP C for OpenVMS VAX HP C++ for OpenVMS VAX HP COBOL for OpenVMS VAX HP Fortran 77 for OpenVMS VAX HP Pascal for OpenVMS VAX The following VAX products partially support LSE (refer to product SPDs for more details); the templates are included with the product: ACMS (SPD 25.50.xx) DATATRIEVE (SPD 24.44.xx) 2 LSE works in conjunction with CMS, SCA, and the OpenVMS VAX Debugger to provide a highly interactive, online environ- ment that facilitates the NAVIGATE-EDIT-COMPILE-DEBUG portion of the program development cycle. DECset users can directly reserve and re- place files from CMS while in LSE, go to the exact source code loca- tion in LSE from SCA, and go to the exact source code location in LSE from the OpenVMS VAX Debugger. Source Code Analyzer The Source Code Analyzer (SCA) aids programmers in understanding the complexities of software systems. Because it allows users to analyze an entire system, as opposed to individual modules, and it helps users understand 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. 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. User controlled marking of items of interest is provided so users can mark items to be queried and save that information to a command file to be reused. 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. 3 SCA also provides static analysis capabilities to assist users in check- ing for 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. Note: The following SCA-supported compilers are available on the Open- VMS VAX platform: HP Ada for OpenVMS VAX HP BASIC for OpenVMS VAX HP C for OpenVMS VAX HP COBOL for OpenVMS VAX HP Fortran 77 for OpenVMS VAX * HP Pascal for OpenVMS VAX VAX MACRO for OpenVMS VAX * Refer to the Product SPD or Release Notes for extent of support. HP 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 INFORMATION section of this SPD. HP Digital Test Manager for OpenVMS VAX Systems The HP Digital Test Manager for OpenVMS VAX Systems is a regression testing tool that automates the creation and maintenance of regres- sion tests. It also automatically compares test run results with ex- pected test results. The Digital Test Manager provides users with flex- ibility in organizing tests, selecting tests for execution, and ver- ifying and reviewing test results. With the Digital Test Manager users can: o Test batch and command line applications. o Create and record tests. o Group tests into meaningful combinations. 4 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 Digital Test Manager enables users to store software test descrip- tions and related files in CMS libraries for storage efficiency. The Digital Test Manager provides an interface through callable rou- tines, as well as through the Digital Test Manager command-line interface and the DECwindows Motif for OpenVMS VAX interface. The HP Digital Test Manager for OpenVMS VAX Systems is a component of the HP DECset for OpenVMS VAX Systems product and is also available separately. Please refer to the ORDERING INFORMATION section of this SPD. HP Performance and Coverage Analyzer for OpenVMS VAX Systems The HP 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. 5 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 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 PCA works in concert with LSE and the Digital Test Manager. From the character-cell version of PCA, users can communicate with LSE and can examine source code. When used with the Digital 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. 6 PCA is a component of the HP DECset for OpenVMS VAX Systems product and is also available separately. Please refer to the ORDERING INFOR- MATION section of this SPD. HP Code Management System for OpenVMS VAX Systems The HP 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, spec- ifications, status reports, source code files, object files, executable images, sixel files, and 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 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). 7 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. 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 Digital Test Manager. LSE and Digital Test Manager users can access CMS elements directly from within LSE and Digital Test Manager. CMS is a component of the HP DECset for OpenVMS VAX Systems product and is also available separately. Please refer to the ORDERING INFOR- MATION section of this SPD. HP Module Management System for OpenVMS VAX Systems HP 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) that have changed since the system was last built. In this way, MMS eliminates the steps of recompiling and linking mod- ules that have not changed. MMS can automatically generate descrip- tion files. Once users create a description file containing the rules describing the relationships among the components of their applica- tion 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. 8 HP MMS is a component of the HP DECset for OpenVMS VAX Systems prod- uct and is also available separately. Please refer to the ORDERING IN- FORMATION section of this SPD. 9 HARDWARE REQUIREMENTS Processors Supported: Any VAX system that is capable of running OpenVMS Version 6.2 or V7.3 or later. Terminals Character cell interfaces for DECset are supported on the following terminals: o VT1xx o VT2xx o VT3xx o VT4xx o VT5xx o ANSI CRT Disk Space Requirements (Block Cluster Size = 1): Each component of HP DECset for OpenVMS VAX Systems can be installed separately. Each component requires the disk space specified in the following table for a successful installation: ___________________________________________________________________ Space Required Space Required For Use (per- Component__________To_Install_________manent)______________________ LSE 40,000 blocks 27,500 blocks (20.5M bytes) (14.0M bytes) SCA 18,000 blocks 15,500 blocks (9.5M bytes) (8.0M bytes) Digital Test 15,000 blocks 10,000 blocks Manager 10 ___________________Space_Required_____Space_Required_For_Use_(per-_ Component__________To_Install_________manent)______________________ (7.8M bytes) (5.2M bytes) PCA 23,000 blocks 10,000 blocks (12.0M bytes) (5.2M bytes) MMS 4,500 blocks 3,000 blocks (2.3M bytes) (1.6M bytes) CMS 39,000 blocks 4,500 blocks (20.0M bytes) (2.3M bytes) ENVMGR 13,500 blocks 12,000 blocks ___________________(7.0M_bytes)_______(6.2M_bytes)_________________ Requirements for installation of all HP DECset for OpenVMS VAX Sys- tems components, including Language-Sensitive Editor support for all languages, requires the disk space specified in the following table: 11 ___________________Space_Required_____Space_Required_For_Use_(per-_ Component__________To_Install_________manent)______________________ All Components 153,000 blocks 87,500 blocks ___________________(79.0M_bytes)______(44.5M_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. 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. * VMScluster configurations are fully described in the HP VMSclus- ter Software for OpenVMS Software Product Description (SPD 29.78.xx) and include CI, Ethernet, DSSI, FDDI, SCSI, and Mixed Interconnect configurations. 12 SOFTWARE REQUIREMENTS For Systems Using Terminals (Without DECwindows Motif for OpenVMS VAX Interface): o OpenVMS VAX Operating System, Version 6.2, 7.3 (SPD 25.01.xx) For Systems Running DECwindows Motif for OpenVMS VAX: o OpenVMS VAX Operating System, Version 6.2, 7.3 (SPD 25.01.xx) o DECwindows Motif for OpenVMS, Version 1.2-6 (SPD 42.19.xx) OPTIONAL SOFTWARE o HP DECset Clients for CMS and MMS (SPD 64.06.xx) DECset Clients for CMS and MMS provides convenient access from the desk- top personal computer (PC) to the CMS libraries and frequently used CMS and MMS functions that reside on OpenVMS systems. Certain versions of the following products depend upon a specific ver- sion of the operating system. Please refer to the Software Product De- scription of the product in question to determine which version is nec- essary. o HP Ada Version 3.5A for OpenVMS VAX (SPD 26.60.xx) o HP BASIC Version 3.9 for OpenVMS VAX (SPD 25.36.xx) o HP C Version 6.4 for OpenVMS VAX (SPD 25.38.xx) o HP C++ Version 5.6C for OpenVMS VAX (SPD 37.39.xx) o HP COBOL Version 5.7 for OpenVMS VAX (SPD 25.04.xx) o HP Fortran 77 Version 6.6 for OpenVMS VAX (SPD 25.16.xx) o HP Pascal Version 5.8 for OpenVMS VAX (SPD 25.11.xx) 13 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 on the OpenVMS VAX Software Layered Prod- ucts Library Package (order number QA-5G88A-H8). Online only documen- tation is distributed on the OpenVMS VAX Online Documentation Library (order number QA-VYR8A-G8), and binaries only are distributed on the OpenVMS VAX Software Layered Products Library (order number QA-5FW8A- A8). These CD-ROMS contain the HP DECset for OpenVMS VAX Systems soft- ware binaries and online documentation in HTML or PDF format. The DEC- set Documentation is also available in hard copy, which can be ordered separately. ORDERING INFORMATION To order the HP DECset for OpenVMS VAX Systems product (includes all components): Software Licenses: Personal Use : QL-965AA-2B Concurrent Use : QP-965AA-3B Unlimited System Use: QL-965A*-** Software Media/Documentation: QA-5G88A-H8 Software Documentation (Hard Copy): QA-MUPAA-GZ To Order Components Separately: HP Language-Sensitive Editor/Source Code Analyzer for OpenVMS VAX Sys- tems: Software Licenses: Personal Use : QL-057AA-2B Concurrent Use : QL-057AA-3B Unlimited System Use: QL-057A*-** 14 Software Media/Documentation: QA-5G88A-H8 Software Documentation (Hard Copy): QA-MUPAA-GZ HP Digital Test Manager for OpenVMS VAX Systems: Software Licenses: Personal Use : QL-927AA-2B Concurrent Use : QL-927AA-3B Unlimited System Use: QL-927A*-** Software Media/Documentation: QA-5G88A-H8 Software Documentation (Hard Copy): QA-MUPAA-GZ HP Performance and Coverage Analyzer for OpenVMS VAX Systems: Software Licenses: Personal Use : QL-119AA-2B Concurrent Use : QL-119AA-3B Unlimited System Use: QL-119A*-** Software Media/Documentation: QA-5G88A-H8 Software Documentation (Hard Copy): QA-MUPAA-GZ HP Code Management System for OpenVMS VAX Systems: Software Licenses: Personal Use : QL-007AA-2B Concurrent Use : QL-007AA-3B Unlimited System Use: QL-007A*-** Software Media/Documentation: QA-5G88A-H8 Software Documentation (Hard Copy): QA-MUPAA-GZ 15 HP Module Management System for OpenVMS VAX Systems: Software Licenses: Personal Use : QL-VADAA-2B Concurrent Use : QL-VADAA-3B Unlimited System Use: QL-VADA*-** Software Media/Documentation: QA-5G88A-H8 Software Documentation (Hard Copy): QA-MUPAA-GZ * 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 only under a license. For more information about HP's licensing terms and policies, contact your local HP office. License Management Facility Support: These layered products support the HP OpenVMS License Management Fa- cility. License units for the HP 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 41.87.xx or 25.01.XX) or doc- umentation. 16 SOFTWARE PRODUCT SERVICES A variety of service options are available from HP. For more infor- mation, contact you local HP account representative or distributor. Information is also available on www.hp.com/hps/software. SOFTWARE WARRANTY This software is provided by HP with a 90 day conformance warranty in accordance with the HP warranty terms applicable to the license pur- chase. © 2005 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP and/or its sub- sidiaries required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Soft- ware Documentation, and Technical Data for Commercial use. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing here in should be construed as constituting an additional war- ranty. HP shall not be liable for technical or editorial errors or omis- sions contained herein. 17 18