Compaq_DECset_for_OpenVMS_____________________ Compaq DECset Environment Manager for OpenVMS Version 1.4 Release Notes August 2000 These release notes for Compaq DECset Environment Manager for OpenVMS Version 1.4 software contain important general information, new and changed features, current restrictions and documentation notes. Operating System and Version: Compaq OpenVMS VAX Operating System, Versions 6.2, 7.1, 7.2 Compaq OpenVMS Alpha Operating System, Versions 6.2, 7.1, 7.2-1 Compaq DECwindows Motif for OpenVMS, Versions 1.2-4, 1.2-5 Software Version: Compaq DECset for OpenVMS, Version 12.4 Compaq DECset Environment Manager for OpenVMS, Version 1.4 Compaq Computer Corporation Houston, Texas __________________________________________________________ © 2000 Compaq Computer Corporation © Electronic Data Systems Corporation 2000 COMPAQ, VAX, VMS, the Compaq logo, and the DIGITAL logo Registered in U.S. Patent and Trademark Office. DEC Ada, DECforms, DECnet, DECset, DECwindows, eXcur- sion, OpenVMS, and PATHWORKS are trademarks of Compaq Information Technologies Group, L.P. Microsoft, Visual C++, Windows, Windows 95, Windows 98, Windows 2000, and Windows NT are trademarks of Microsoft Corporation. Motif is a registered trademark of The Open Group. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. All other product names mentioned herein may be the trademarks or registered trademarks of their respective companies. Confidential computer software. Valid license from Compaq, EDS, or authorized sublicensor required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Neither Compaq nor EDS shall not be liable for technical or editorial errors or omissions contained herein. The information in this publication is subject to change without notice and is provided "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH RECIPIENT. IN NO EVENT SHALL COMPAQ OR EDS BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ OR EDS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE FOREGOING SHALL APPLY REGARDLESS OF THE NEGLIGENCE OR OTHER FAULT OF EITHER PARTY AND REGARDLESS OF WHETHER SUCH LIABILITY SOUNDS IN CONTRACT, NEGLIGENCE, TORT, OR ANY OTHER THEORY OF LEGAL LIABILITY, AND NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY. The limited warranties for Compaq and EDS products are exclusively set forth in the documentation accompanying such products. Nothing herein should be construed as constituting a further or additional warranty. This document was prepared using VAX DOCUMENT, Version 2.1. ________________________________________________________________ Contents Preface.................................................. v 1 General Information 1.1 Introduction.................................... 1-1 1.2 Associated Documents............................ 1-1 1.3 Installation.................................... 1-2 2 New Features 2.1 Environment Manager Disable..................... 2-1 2.2 MMS Generate Option............................. 2-2 3 Problems Fixed 4 Known Problems 5 Restrictions 6 Reporting Problems and Suggestions iii ________________________________________________________________ Preface These release notes characterize the Version 1.4 release of the Compaq DECset Environment Manager for OpenVMS systems. These notes contain information that either supplements or supersedes the information in the DECset documentation set. Intended Audience These release notes are intended for any user or system manager who needs information about the Environment Manager on either of the Compaq OpenVMS Operating System platforms(VAX or Alpha). Document Structure These release notes are organized as follows: o Chapter 1 contains general information about this release. o Chapter 2 contains a description of the new features. o Chapter 3 describes problems that have been fixed in the current release. o Chapter 4 describes all known problems in the current release. o Chapter 5 describes all restrictions. o Chapter 6 describes how to report problems. v Sending Compaq Your Comments We welcome your comments on these release notes or on any other pieces of documentation. See Chapter 6 for details on how to contact Compaq with your comments. The Following conventions are used in these release note __________________________________________________________ Convention__________Description___________________________ $ A dollar sign ($) represents the OpenVMS DCL system prompt. Ctrl/x The key combination Ctrl/x indicates that you must hold down the key labeled Ctrl while you press another key, for example, Ctrl/Y or Ctrl/Z or a pointing device button. boldface text Boldface text represents the introduction of a new term. monospace boldface Boldface monospace text represents text user input in interactive examples. italic text Italic text represents book titles, parameters, arguments, and information that can vary in system messages (for example, Internal error number). UPPERCASE Uppercase indicates the name of a command, routine, the name of a file, the name of a file protection code, or the abbreviation of a system privilege. lowercase Lowercase in examples indicates that you are to substitute a word or value ____________________of_your_choice._______________________ vi 1 ________________________________________________________________ General Information The information in these release notes pertain to the Compaq DECset Environment Manager Version 1.4. Compaq suggests that you upgrade your environment incrementally with each new release, but there is no technical requirement to do so. It is recommended that you review the release notes for each version because they capture important release-oriented information and advise you of changes between versions. 1.1 Introduction Environment Manager Version 1.4 is a minor release. 1.2 Associated Documents The following documents contain information related to the Environment Manager. Note however, that for the Compaq DECset for OpenVMS Version 12.4 release, only the software product descriptions, installation guide, and component product release notes have been updated. The revised installation guide for all DECset components is: o Compaq DECset for OpenVMS Installation Guide The document associated with the Environment Manager is: o Using DECset for OpenVMS Systems Also applicable are the general DECset documents: o Compaq DECset for OpenVMS VAX Software Product Description General Information 1-1 o Compaq DECset for OpenVMS Alpha Software Product Description o Guide to Detailed Program Design for OpenVMS Systems In addition to the base Environment Manager documentation, the DECset engineering team has also provided the Compaq DECset for OpenVMS Cookbook for an Integrated Product Development Environment. This document comprises a series of technical articles that describe how each of the component applications can be used in different programming environments. This document is available in PostScript(.PS), HTML(.HTML), and ASCII(.TXT) formats from the following location: SYS$SYSROOT:{SYSHLP.EXAMPLES.DECSET]DECSET_COOKBOOK.* 1.3 Installation The Environment Manager is installed automatically by other components of DECset. OpenVMS Alpha systems For a new installation of Environment Manager the following is required: Global Pages 1500 Global Sections 8 Disk Blocks 13500 OpenVMS VAX systems For a new installation of Environment Manager the following is required: Global Pages 700 Global Sections 6 Disk Blocks 13500 1-2 General Information 2 ________________________________________________________________ New Features DECset Version 12.4 is a minor release with the following goals for each individual DECset component: o To fix many known problems. o To add minor functionality. Details regarding particular functionality enhancements and bug fixes for each component are found in the individual component's release notes. The following enhancements were added in the Environment Manager Version 1.4. 2.1 Environment Manager Disable The Environment Manager can be stopped from running when a DECset component is activated by the presence of the logical DECSET$DISABLE_ENVMGR. A function is activated by a logical called DECSET$DISABLE_ ENVMGR that tests whether or not the logical is defined. The contents of the logical are irrelevent. When invoking a component using /INTERFACE=DECWINDOWS the logical can be set in two ways. o Define the logical before running the component using the DCL command DEFINE DECSET$DISABLE_ENVMGR " " o If a data base and context file were previously defined using the environment manager, at the command line prompt enter DECSET SET CONTEXT context-name /DATABASE=database-file-name. This will cause the logical defined in the context file to be set for the current process. New Features 2-1 To set the logical while in the Session Manager, before invoking a DECset component, use the session pulldown menu, then select Logical Names. The "Logical Names..." function is an optional menu item and if not currently available it can be added to the Session Manager menu bar. To add the "Logical Names..." item to the session manager see the DECwindows documentation for instructions on how to add items to your menus. When using an Alpha system and running the Common Desktop Environment the command line interface works the same as items 1 and 2 above utilizing DECTERM window. See the CDE documentation for creating applications using the Application Manager. 2.2 MMS Generate Option The MMS Generate function gives the capability to define several qualifiers to be used during the creation of a descriptor file. There are two toggle buttons that can be set and two text input fields that can contain additional qualifiers for compile and link commands. o Scan_Include - Setting this button will cause entries to be placed in the descriptor file to scan C/C++ include files for any dependencies o Built-In Rules Apply - Setting this button will cause the Generate function to use the built-in rules when creating the descriptor file. When this button is set, the Additional Compiler text field will be disabled. o Additional Compiler Switches - This text field will contain additional qualifiers that are to be placed on the compiler command when creating a descriptor file. The entry requires that the "/" on each qualifier also be included. ex: /ABC/DEF o Additional Linker Switches - This text field will contain additional qualifiers that are to be placed on the link command when creating a descriptor file. 2-2 New Features The entry requires that the "/" on each qualifier also be included. ex: /ABC/DEF New Features 2-3 3 ________________________________________________________________ Problems Fixed The following problems have been fixed in Environment Manager Version 1.4: o ID:3 - The Context database is left in an inconsistent state after a context file has been deleted. Corrected by deleting all files. o ID:5 - The environment manager commands DELETE CONTEXT ENTRY, DELETE CONTEXT FILE and DELETE DATABASE do not delete all the versions of the Contexts and Database files. Corrected by deleting all files. o ID:66 - Cannot apply default directory with unknown logical. Corrected an internal symbol that was defined improperly. o ID:72 - The function decset$ctx_display when displaying from the Main window View does not identify the view type on the list. Corrected the decset$ctx_display function and added another parameter that identifies the display type. o ID:83 - When a context is modified the "Save button" is enabled allowing changes to be saved. If a context is modified and then another function is selected but then canceled, the first change cannot be saved because the "Save button" was disabled by the Cancel on the second function. This has been corrected so that the SAVE button is not disabled if there is an outstanding change to be saved. o ID:85 - None of the controls worked in the HelpBox beyond the Main window. Problems Fixed 3-1 All HelpBox controls should now function correctly. o ID:91 - Attempting to save a context to a directory to which the user does not have write access will cause the Environment Manager to exit with a fatal error. Corrected by displaying an error that the context cannot be saved. o ID:92 - When displaying to a PC running eXcursion at 800 x 600 pixels some dialogs display incorrectly. The dialog content is smaller than the window size and buttons overlap. Corrected by changing the refresh type on the window. o ID:96 - Help on MMS Options Menu pulldown has incomplete text description. Description Help text has been added to the options help. o ID:97 - Same problem as Bug 85. All HelpBox controls should now function correctly. o ID:99 - Extra spaces being passed to MMS macro options. Spaces have been removed and macros should now function correctly. 3-2 Problems Fixed 4 ________________________________________________________________ Known Problems The following known problems exist in Environment ManagerVersion 1.4: o ID:7 - The Environment Manager GUI varies in its handling of error conditions. o ID:12 - The View and Print Context with Inheritance operations will always use the state of the current context as it exists in the context file for generating the information to be viewed or printed. o ID:20 - A logical name table cannot be added to the list of logical name tables if the new logical name table does not contain any logical name definitions. o ID:25 - After modifying a context and then selecting a new context by double clicking on a different context in the known contexts list, the first context is saved and the Save confirmation box is displayed, but the new context is not applied and the Apply confirmation box is not displayed. o ID:56 - If the Environment Manager terminates while a DECset client is currently in the middle of a context switch, then the client will timeout while waiting for a response from the Environment Manager and the client can be left in an inconsistent state. o ID:57 - If an error occurs during a context `apply' operation, the (usually partial) effects of the `apply' operation or DECSET SET CONTEXT command are not reversed. o ID:70 - If the Environment Manager GUI is running at the time that the Session Manager is terminated, a "Waiting for application response" error box is displayed. It is OK to ignore this error message. Known Problems 4-1 o ID:75 - If a DECset product times-out when registering with the DECset Environment Manager, it cannot distinguish if an initial context should be applied. o ID:79 - The following command gets a vague diagnostic message: $ decset set cont mms /data=mms %DECSET-F-UNEXPEOL, unexpected end of line encountered while parsing command o ID:84 - If you use Settings/Source Directory to define a source directory, LSE$SOURCE appears in the Settings /Logical Names box. o ID:95 - If you are in a context and want to change to a new context, when you double click on the new context in the context list, and the apply box appears if you select NO the new context is still set. Confirm Apply has to be set in the options menu also. o ID:100 After doing an install and running the IVP, If the IVP is run a second time it gets an RMS error of directory not found. This is a result of the envmgr when it uses the DECSET$BASE_CTX_pid.DAT file it does not set the Default directory path correctly in this file. 4-2 Known Problems 5 ________________________________________________________________ Restrictions The following restrictions apply to the Environment Manager's graphical user interface: 1. Keyboard traversals are unpredictable. If a dialog box is selected, for example, the settings menu option Symbols..., the insertion character "^" is not always displayed on the initial Symbol input field, but rather on the subsequent Definition field. Use the mouse to position the cursor on the desired input field, and click on the OK or Cancel buttons when you've completed input to the dialog box. The use of the Tab key to move between input fields is unpredictable. Use the mouse to move between input fields, then click on the OK or Cancel buttons when dialog box input is complete. 2. The inclusion of a nodename on a file specification is restricted. If a nodename is used on a file specification it is ignored. Restrictions 5-1 6 ________________________________________________________________ Reporting Problems and Suggestions Depending on the nature of the request or problem, customers can call Compaq provided their software contract and warranty entitles them to telephone support. Review the SPD and Warranty Addendum for an explanation of warranty. If a problem is encountered during the warranty period, customers can report the problem using DSNlink. In the United States, customers can call the Compaq Customer Support Center at 1-800-354-9000. In addition, Compaq provides access to Web Information and Support (WIS), an Internet-based electronic services application that allows customers to submit electronic service requests, access databases, download patch kits, transfer files from Compaq and connect to global notes conferences via the World Wide Web. Dial-In Access (DIA) users can access WIS by: 1. Opening http://www1.support.Compaq.com/wis. 2. Choosing a country code. 3. Entering DIA Access ID and password. WIS and DIA use the same underlying account and directory on the Compaq Customer Support Center host system. Customers can register for DIA and receive a WIS account by contacting their Customer Support Center or local Compaq representative. This method can also be used to make requests for additional features or modifications to existing features. When submitting a request, please include the following information: Reporting Problems and Suggestions 6-1 1. Environment Manager version number and type of OpenVMS operating system. 2. Problem summary. 3. Stack dumps or error logs (if applicable). 4. Files in machine-readable media: magnetic tape (preferred), floppy diskette, or tape cassette. 6-2 Reporting Problems and Suggestions