[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

HP DECwindows Motif for OpenVMS

Release Notes

January 2005

This manual describes corrections, known problems, and restrictions that pertain to the DECwindows Motif Version 1.5 software.

Revision/Update Information: This manual supersedes the HP DECwindows Motif for OpenVMS Alpha Release Notes for Version 1.3--1.

Operating Systems: OpenVMS I64 Version 8.2

OpenVMS Alpha Version 8.2

Software Versions: DECwindows Motif for OpenVMS I64 Version 1.5

DECwindows Motif for OpenVMS Alpha Version 1.5

Hewlett-Packard Company
Palo Alto, California

Confidential computer software. Valid license from HP 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.

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 herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Java is a US trademark of Sun Microsystems, Inc.

UNIX is a registered trademark of The Open Group.

The X device is a trademark of X/Open Company Ltd. in the UK and other countries.

Printed in the US

ZK6470

This document was prepared using DECdocument, Version V3.3-1e.

Contents

Index

Preface

These release notes describe corrections, known problems, and restrictions that pertain to the HP DECwindows Motif for OpenVMS Version 1.5 (DECwindows Motif) software on the OpenVMS I64 and OpenVMS Alpha platforms.

The notes in this manual are cumulative from DECwindows Motif for OpenVMS Version 1.0 and indicate any undocumented items that still pertain to the software. A label within each note specifies when the correction or problem was introduced.

Intended Audience

This manual is intended for users, system managers, and programmers who work with DECwindows Motif.

Document Structure

This manual is structured as follows:

Chapter 1 provides an overview of the current release.
Chapter 2 contains general user release notes for all users.
Chapter 3 contains release notes intended for system managers.
Chapter 4 contains release notes intended for application and system programmers.
Chapter 5 describes changes and corrections to the DECwindows Motif documentation set.
Appendix A contains excerpted material from the OSF/Motif Release 1.2 Notes.
Appendix B describes the OSF/Motif sample programs included with DECwindows Motif.

Reader's Comments

HP welcomes your comments on this manual. Please send comments to either of the following addresses:

Internet	openvmsdoc@hp.com
Postal 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/order

Conventions

The following product names may appear in this manual:

HP OpenVMS Industry Standard 64 for Integrity servers
OpenVMS I64
I64

All three names---the longer form and the two abbreviated forms---refer to the version of the OpenVMS operating system that runs on the Intel Itanium architecture.

All uses of DECwindows and DECwindows Motif refer to the HP DECwindows Motif for OpenVMS software; and all uses of X server and the X display server refer to the DECwindows X11 Display Server. Additionally, all uses of DECwindows XUI (X User Interface) refer to the DECwindows product prior to DECwindows Motif Version 1.0.

The following typographic conventions may be used in this manual:

Ctrl/ x	A sequence such as Ctrl/ x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button.
PF1 x	A sequence such as PF1 x indicates that you must first press and release the key labeled PF1 and then press and release another key or a pointing device button.
`[Return]`	In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.) In the HTML version of this document, this convention appears as brackets, rather than a box.
...	Horizontal ellipsis points in examples indicate one of the following possibilities: Additional optional arguments in a statement have been omitted. The preceding item or items can be repeated one or more times. Additional parameters, values, or other information can be entered.
. . .	Vertical ellipsis points indicate the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed.
( )	In command format descriptions, parentheses indicate that you must enclose the choices in parentheses if you choose more than one.
[ ]	In command format descriptions, brackets indicate optional elements. You can choose one, none, or all of the options. (Brackets are not optional, however, in the syntax of a directory name in an OpenVMS file specification or in the syntax of a substring specification in an assignment statement.)
[\|]	In command format descriptions, vertical bars separating items inside brackets indicate that you choose one, none, or more than one of the options.
{ }	In command format descriptions, braces indicate required elements; you must choose one of the options listed.
text style	This text style represents the introduction of a new term or the name of an argument, an attribute, or a reason. In the HTML version of this document, this convention appears as italic text.
italic text	Italic text emphasizes important information and indicates complete titles of manuals and variables. Variables include information that varies in system messages (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where dd represents the predefined code for the device type).
UPPERCASE TEXT	Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.
Monospace type	Monospace type indicates code examples and interactive screen displays. In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example.
-	A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line.
numbers	All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.

Chapter 1
Introduction

This chapter summarizes the corrections, restrictions, and known problems identified during or associated with the DECwindows Motif Version 1.5 software. Table 1-1 lists all the notes added or revised during this release and cross-references the sections in which they are described.

For a detailed description of the features and enhancements introduced with this release, see the HP DECwindows Motif for OpenVMS New Features manual.

**Table 1-1 Directory of Notes for DECwindows Motif Version 1.5**
Title	Section
General DECwindows Motif Environment Notes
Web Browser Support	Section 2.2.1
Scaled Bitonal Images Now Display Correctly (Alpha Only)	Section 2.2.2
Applications That Issue Lengthy Server Requests Now Respond Correctly (Alpha Only)	Section 2.2.3
Applications Running Over the LOCAL Transport No Longer Cause System Lag	Section 2.2.4
Applications That Use GKS May Fail Unexpectedly	Section 2.2.5
New Desktop Environment Notes
Default Width of the Calculator Increased	Section 2.3.1
File Manager No Longer Hangs During Large Copy or Move Operations	Section 2.3.2
File Manager Cancels Restore Operations Properly (Alpha Only)	Section 2.3.3
Application Notes
Clock: Clock Updates Correctly after the System Time is Reset (Alpha Only)	Section 2.4.3.1
DECterm: Graphics Applications Using ReGIS No Longer Cause DECterm to Crash (Alpha Only)	Section 2.4.4.1
DECterm: DECterm Windows Positioned Correctly (Alpha Only)	Section 2.4.4.2
DECterm: Use CREATE/TERMINAL/DETACH to Display Broadcast Messages	Section 2.4.4.3
DECterm: Using CREATE/TERMINAL with IPv6 Support Enabled	Section 2.4.4.4
Tool and Utility Notes
fsinfo: Font Server Information Utility Fails After Invoking	Section 2.5.2.1
Installation and Upgrade Notes
DECwindows Motif Version Support and Compatibility	Section 3.1.1
Limited Support for Third-Party TCP/IP Products (Alpha Only)	Section 3.1.2
DECW$STARTUP Requires SHARED Privilege	Section 3.1.3
Security and Authorization Notes
GENPWD Flag Now Handled Properly (Alpha Only)	Section 3.3.1
Setting the hostList Resource Manually	Section 3.3.3
Desktop Management Notes
Trusted Unpause Operations Allowed (Alpha Only)	Section 3.4.1
ACME Login Features Not Supported (I64 Only)	Section 3.4.2
Font and Keymap Management Notes
Queries on TrueType Font Properties No Longer Reset the Display Server (Alpha Only)	Section 3.5.1
X Display Server Management Notes
Adjusting Pixel Depth on Systems with ATI RADEON Graphics Cards	Section 3.7.1
Performance Degradation May Occur on XINERAMA Multihead Systems	Section 3.7.2
General Programming Notes
Motif Toolkit and X Window System Support and Compatibility	Section 4.1.1
Run-Time and Programming Environment Support	Section 4.1.2
Multithreaded Applications with Upcalls Enabled No Longer Cause Address Corruption (Alpha Only)	Section 4.1.3
DECwindows Display Server Blocks Write Operations When All Transport Buffers are in Use	Section 4.1.4
Functions Calling getaddrinfo and getnameinfo are not Threadsafe Over TCP/IP Connections	Section 4.1.5
Running Translated Images on OpenVMS Systems (Alpha Only)	Section 4.1.12
Application Programming Notes
DEClinks: DEClinks Shareable Libraries Not Available (I64 only)	Section 4.2.2.1
OSF/Motif Toolkit (Xm) Notes
OSF/Motif Release 1.1.3 Programming Support and XUI	Section 4.3.3
Memory Leaks in Cascade and Toggle Buttons Corrected (Alpha Only)	Section 4.3.4
Memory Leaks in Bulletin Boards Corrected (Alpha Only)	Section 4.3.5
UID Files for Example Programs	Section 4.3.8
X Window System Toolkit (Xt) Notes
XtGetValues Function and Null Argument Values	Section 4.5.1
X Window System Library (Xlib) Notes
XPutImage Now Displays Wide Graphic Images Correctly	Section 4.6.1
Xlib Routines Now Use Recursive Locks	Section 4.6.2
Memory Leaks in XOpenDisplay and XCloseDisplay Corrected (Alpha Only)	Section 4.6.3
XOpenDisplay Calls No Longer Leave a Pending Wake (Alpha Only)	Section 4.6.4
State of Event Flag Number 63 Changed Only After Reserved (Alpha Only)	Section 4.6.5
Xpoll.h Header File and ConnectionNumber Macro Restriction	Section 4.6.6

Chapter 2
General User Release Notes

This chapter contains information about DECwindows Motif for general users.

2.1 OpenVMS Display Device and Layered Product Interfaces

This section contains release notes that pertain to the OpenVMS display device (SET DISPLAY) and DECwindows Motif layered product interfaces.

2.1.1 OpenVMS Display Device (SET DISPLAY)

This section contains notes pertaining to OpenVMS display devices created and managed using the SET DISPLAY and SHOW DISPLAY commands. For more information on these commands, see the HP OpenVMS DCL Dictionary: N--Z or online help.

2.1.1.1 SET DISPLAY/REVOKE Error Message is Misleading

V1.3

The error message for revoking a cookie that has timed out is misleading. The error message indicates there is a %SYSTEM-F-BADPARAM, bad parameter value. This does not indicate the nature of the error.

2.1.1.2 I/O Error Displayed When Using SET DISPLAY/REVOKE

V1.3

Using the SET DISPLAY/REVOKE command to revoke a generated, trusted, cookie can sometimes result in an I/O error similar to the following:

XIO:  fatal IO error 65535 (connection aborted) on X server ":0.0"
      after 10 requests (8 known processed) with 0 events remaining.

This error results from the cookie being used by the SET DISPLAY/REVOKE command to connect to the server. Revoking the cookie breaks the connection to the display server.

Although the error appears fatal, the revoke operation actually completes successfully.

2.1.1.3 Display Devices Not Deleted Upon Exit

V1.2--6

When creating user-mode display devices with the DCL SET DISPLAY command, note that any unused devices may not be deleted when you log out of DECwindows Motif. Display devices created with SET DISPLAY are seen as permanent devices until used by an X client application and are not destroyed upon exit.

To avoid this problem, create supervisor-mode display devices.

2.1.2 DECTPU

This section contains release notes related to the DECwindows Motif interface to DECTPU.

2.1.2.1 Small Display Monitors and DECTPU

V1.0

When running DECTPU for DECwindows Motif on small display monitors, the main window can be less than fully visible.

To correct this condition, follow these steps:

Add the following resources to the DECTPU section of your X resource file:

Tpu.Tpu$MainWindow.X:                             0
Tpu.Tpu$MainWindow.Y:                             0
Tpu.Tpu$MainWindow.Rows:                          21
Tpu*condensedFont:                                on
Tpu*fontSetSelection:                             1

Copy the resource file from SYS$LIBRARY:EVE.DAT and add the previous lines.
Use the logical name TPU$DEFAULTS to point at the new resource file.
The following example references the X resource file EVE_SMALL_WINDOW.DAT, which defines the appropriate TPU window properties. The DECwindows Motif user interface to DECTPU is then invoked to edit the file LOGIN.COM.
$ DEFINE TPU$DEFAULTS SYS$LOGIN:EVE_SMALL_WINDOW.DAT $ EDIT/TPU/INTER=DECWINDOWS LOGIN.COM

2.2 General DECwindows Motif Environment

This section contains release notes that pertain to the general DECwindows Motif user environment. This includes corrections, restrictions, and known problems that are common to both the New Desktop and the Traditional DECwindows Desktop environments.

2.2.1 Web Browser Support

V1.5

The HP Secure Web Browser (SWB) is the officially supported web browser for the HP OpenVMS Alpha and HP OpenVMS I64 operating systems. SWB is a licensed part of these operating systems and is based on the Mozilla Web Browser, which is designed for standards compliance, performance, and portability.

The OpenVMS Alpha version of the browser is available from the following location:

http://h71000.www7.hp.com/openvms/products/ips/cswb/cswb.html

This page contains installation and running instructions, as well as information about hardware and software prerequisites, system parameters, account quotas, and problem reporting.

The OpenVMS I64 version of the browser is a part of one or more of the OpenVMS I64 Operating Environments (OEs) and is included on the OE distribution media. See the HP OpenVMS I64 Software Product Description (SPD) for more information on the specific OE bundles available with this release of OpenVMS.

Note

There may be instances where running Java applications from the SWB will cause the system to freeze briefly. This is due to the way the DECwindows X display server currently handles non-blocking write operations to a requesting client application. See Section 4.1.4 for more information on this restriction.

2.2.2 Scaled Bitonal Images Now Display Correctly (Alpha Only)