HP_DECset_for_OpenVMS_______________________________ DECset Environment Manager for OpenVMS Release Notes August 2003 These release notes describe important general information, new and changed features, current restrictions, and documentation notes that pertain to the DECset Environment Manager Version 1.5 for OpenVMS software. Operating System Version: HP OpenVMS VAX Version 6.2, 7.2, or 7.3 HP OpenVMS Alpha Version 6.2, 7.2-2, or 7.3-1 Software Version: HP DECset Version 12.5 for OpenVMS DECset Environment Manager Version 1.5 for OpenVMS Hewlett-Packard Company Palo Alto, California ________________________________________________________________ © 2003 Hewlett-Packard Development Company, L.P. Microsoft, Windows, Windows NT, and Visual C++ are U.S. registered trademarks of Microsoft Corporation. Motif is a trademark of The Open Group in the United States and other countries. Confidential computer software. Valid license from HP and/or its subsidiaries 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 vendors standard commercial license. Neither HP nor any of its subsidiaries shall be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for HP products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. _________________________________________________________________ Contents Preface................................................... v 1 General Information 1.1 Introduction..................................... 1-1 1.2 Associated Documents............................. 1-1 1.3 Using DECset with DECwindows Motif............... 1-2 1.4 Installation..................................... 1-2 2 New Features 3 New Features in Version 1.4 3.1 Environment Manager Disable...................... 3-1 3.2 MMS Generate Function............................ 3-2 4 Problems Fixed 5 Known Problems 6 Restrictions iii _________________________________________________________________ Preface These release notes characterize the DECset Environment Manager Version 1.5 for OpenVMS (Environment Manager) software. These notes contain information that either supplements or supersedes the information in the HP DECset Version 12.5 for OpenVMS (DECset) documentation set. Intended Audience These release notes are intended for users and system managers who need information about the Environment Manager on either of the 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 contains a description of the new features added in Version 1.4. o Chapter 4 describes all problems resolved by the current release. o Chapter 5 describes all known problems in the current release. o Chapter 6 describes all restrictions. v Related Documents For additional information about OpenVMS or DECset products and services, visit the following web site: http://www.hp.com/go/openvms Reader's Comments HP welcomes your comments on these release notes. Please send comments to either of the following addresses: Internet openvmsdoc@hp.com Mail Hewlett-Packard Company OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 How To Order Additional Documentation For information about how to order additional documentation, visit the following World Wide Web address: http://www.hp.com/go/openvms/doc/ Conventions The following conventions are used in these notes. ___________________________________________________________ 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 user text input in interactive examples. vi ___________________________________________________________ Convention__________Description____________________________ 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.________________________ vii 1 _________________________________________________________________ General Information The information in these release notes pertains to the DECset Environment Manager Version 1.5 for OpenVMS (Environment Manager) software. HP 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.5 is a minor release. 1.2 Associated Documents The following documents contain information related to the Environment Manager. Note however, that for the HP DECset Version 12.5 for OpenVMS release, only the software product descriptions and component product release notes have been updated. The main 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 Installation Guide o HP DECset for OpenVMS VAX Software Product Description o HP DECset for OpenVMS Alpha Software Product Description o Guide to Detailed Program Design for OpenVMS Systems General Information 1-1 In addition to the base Environment Manager documentation, the DECset engineering team has also provided the HP 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 Using DECset with DECwindows Motif To use the DECset Environment Manager with the DECwindows Motif interface, one of the following must be installed: o HP DECwindows Motif for OpenVMS Alpha Version 1.2-5, 1.2-6, or 1.3 o HP DECwindows Motif for OpenVMS VAX Version 1.2-5 or 1.2-6 1.4 Installation The Environment Manager is installed automatically by other components of DECset. For HP OpenVMS Alpha Systems For a new installation of Environment Manager the following is required: Global Pages 1500 Global Sections 8 Disk Blocks 13500 For HP 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 No new features have been added to the Environment Manager for Version 1.5. New Features 2-1 3 _________________________________________________________________ New Features in Version 1.4 The following enhancements were added to the Environment Manager for Version 1.4. 3.1 Environment Manager Disable You can stop the Environment Manager from running when you activate a DECset component by defining the logical DECSET$DISABLE_ENVMGR. The value of the logical is irrelevant. When invoking a component using /INTERFACE=DECWINDOWS the logical can be set in one of three 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, use the DCL command DECSET SET CONTEXT context-name /DATABASE=database-file- name. This causes the logical defined in the context file to be set for the current process. o 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 running the Common Desktop Environment (CDE), the command line interface works the same as the first two items in the preceding list, see the CDE documentation for creating applications using the Application Manager. New Features in Version 1.4 3-1 3.2 MMS Generate Function The MMS Generate function gives you 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 causes 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 causes the Generate function to use the built-in rules when creating the descriptor file. When this button is set, the Additional Compiler text field is disabled. o Additional Compiler Switches - Use this text field to provide additional qualifiers that are to be placed on the compiler command when creating a descriptor file. The entry requires that the slash character ( / ) on each qualifier also be included. ex: /ABC/DEF o Additional Linker Switches - Use this text field to provide additional qualifiers that are to be placed on the link command when creating a descriptor file. The entry requires that the slash character ( / ) on each qualifier also be included. ex: /ABC/DEF 3-2 New Features in Version 1.4 4 _________________________________________________________________ Problems Fixed The following problems have been fixed in Environment Manager Version 1.5: o ID:100 - Default directory path was not always set correctly and this resulted in an RMS error indicating that the directory could not be found. This problem has been corrected. o ID:101 - If a list of files was given for the Linker Options and/or the Linker Object Libraries, all but the last file in each list was ignored. This problem has been corrected. o ID:102 - Macro definitions entered in the MMS Definition /Directive Options window were lost when the context was saved. This problem has been corrected. o ID:103 - Use of quoted strings in the value of MMS macros and in the MMS Generator Additional Compiler /Linker Switches text box did not work correctly. This problem has been corrected. o ID:104 - When selecting the MMS Macro selection box, only the first of the currently defined macro definitions appeared in the dialog box. This problem has been corrected. o ID:105 - Symbol values defined when setting to a new context could, in some circumstances, be truncated. This problem has been corrected. Problems Fixed 4-1 5 _________________________________________________________________ Known Problems The following known problems exist in Environment Manager Version 1.5: o ID:12 - The View and Print Context with Inheritance operations always use the original state of the currently selected context. Any changes made since selecting the context, that have not been saved, are ignored when 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 times out 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 5-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 DECSET SET CONTEXT command may occasionally fail, for no apparent reason, with one of the following diagnostic messages: %DECSET-F-UNEXPEOL, unexpected end of line encountered while parsing command or %DECSET-F-CANTOPENCTXFIL, cannot open context file If this problem persists and you are certain that the failing command is correct, then delete the following files: $ DELETE SYS$LOGIN:DECSET$BASE_CTX_*.DAT;* $ DELETE SYS$LOGIN:DECSET$PREV_CTX_*.DAT;* $ DELETE SYS$LOGIN:DECSET$UTIL_CTXDB_*.DAT;* 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. 5-2 Known Problems 6 _________________________________________________________________ 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 not supported. If a nodename is used on a file specification it is ignored. Restrictions 6-1