ECO NUMBER: VMS721H1_GRAPHICS-V0300 PRODUCT: OpenVMS Alpha OPERATING SYSTEM V7.2-1H1 UPDATE PRODUCT: OpenVMS Alpha OPERATING SYSTEM V7.2-1H1 COVER LETTER 1 KIT NAME: VMS721H1_GRAPHICS-V0300 2 KITS SUPERSEDED BY THIS KIT: None. 3 KIT DEPENDENCIES: 3.1 The following remedial kit(s) must be installed BEFORE installation of this, or any required kit: VMS721H1_UPDATE-V0500 3.2 In order to receive all the corrections listed in this kit, the following remedial kits should also be installed: None. 4 KIT DESCRIPTION: 4.1 Version(s) of OpenVMS to which this kit may be applied: OpenVMS Alpha V7.2-1H1 4.2 Files patched or replaced: o [SYSLIB]DECW$OPENGLPEERRI.EXE (new image) o [SYSLIB]DECW$OPENGLSHR_V11.EXE (new image) o [SYSLIB]DECW$OPENGLUSHR_V11.EXE (new image) o [SYSLIB]DECW$OPENGLUTSHR.EXE (new image) o [SYSLIB]DECW$OPENGLWIDGETSHR_V11.EXE (new image) o [SYSLIB]DECW$OPENGL_PROTOCOL_V11.EXE (new image) o [SYSLIB]DECW$SERVER_DDX_GB.EXE (new image) o [SYSLIB]DECW$SERVER_DDX_GZ.EXE (new image) o [SYSLIB]DECW$SERVER_DDX_P2.EXE (new image) -- COVER LETTER -- Page 2 16 May 2002 o [SYSLIB]DECW$SERVER_DDX_P3.EXE (new image) o [SYSLIB]DECW$SERVER_DIX.EXE (new image) o [SYSLIB]DECW$SERVER_RIDDGL.EXE (new image) o [SYSLIB]DECW$SERVER_SISWDDGL.EXE (new image) o [SYSEXE]DECW$SETSHODIS.EXE (new image) o [SYSLIB]DECW$SVEXT_DEC_PEER_GLX.EXE (new image) o [SYSLIB]DECW$SVEXT_GLX_P350.EXE (new image) o [SYSLIB]DECW$TRANSPORT_COMMON.EXE (new image) o [SYSLIB]DECW$TRANSPORT_DECNET.EXE (new image) o [SYSLIB]DECW$TRANSPORT_LOCAL.EXE (new image) o [SYSLIB]DECW$TRANSPORT_TCPIP.EXE (new image) o [SYSEXE]DECW$XFS.EXE (new image) o [SYSEXE]FSINFO.EXE (new image) o [SYSEXE]FSLSFONTS.EXE (new image) o [SYS$LDR]SYS$GBDRIVER.EXE (new image) o [SYS$LDR]SYS$GFDRIVER.EXE (new image) o [SYS$LDR]SYS$GYCDRIVER.EXE (new image) o [SYS$LDR]SYS$GZDRIVER.EXE (new image) o [SYS$LDR]SYS$GZVDRIVER.EXE (new image) o [SYS$LDR]SYS$INDRIVER.EXE (new image) o [SYS$LDR]SYS$WSDRIVER.EXE (new image) o [SYSMGR]DECW$DEVICE_CONFIG_GB.COM (new file) o [SYSMGR]DECW$DEVICE_CONFIG_GF.COM (new file) o [SYSMGR]DECW$DEVICE_CONFIG_GZ.COM (new file) o [SYSMGR]DECW$DEVICE_CONFIG_P2.COM (new file) o [SYSMGR]DECW$STARTSERVER.COM (new file) o [DECW$INCLUDE.GL_1_1]GL.H (new file) -- COVER LETTER -- Page 3 16 May 2002 o [DECW$INCLUDE.GL_1_1]GLU.H (new file) o [DECW$INCLUDE.GL_1_1]GLUT.H (new file) o [DECW$INCLUDE.GL_1_1]GLWDRAWA.H (new file) o [DECW$INCLUDE.GL_1_1]GLWMDRAWA.H (new file) o [DECW$INCLUDE.GL_1_1]GLX.H (new file) o [DECW$INCLUDE.GL_1_1]GLXDECPROTO.H (new file) o [DECW$INCLUDE.GL_1_1]GLXINT.H (new file) o [DECW$INCLUDE.GL_1_1]GLXMD.H (new file) o [DECW$INCLUDE.GL_1_1]GLXPROTO.H (new file) o [DECW$INCLUDE.GL_1_1]GLXTOKENS.H (new file) o [DECW$INCLUDE.GL_1_1]GL_1_1_SETUP.COM (new file) o [SYSEXE]SYS$CONFIG.DAT (new file) o [SYSHLP]P300_350_V2_README.HTML (new file) o [SYSHLP]P300_350_V2_README.PDF (new file) o [SYSHLP]P300_350_V2_README.TXT (new file) o [SYSHLP]P300_350_V2_README_CONTENTS.HTML (new file) 5 NEW FUNCTIONALITY ADDED IN THE VMS721H1_GRAPHICS-V0300 KIT 5.1 PowerStorm 300/350 OpenVMS Graphics Support This document contains the release notes for PowerStorm 300/350 Graphics Support Version 2.0 for OpenVMS. Specific information about this support can be found in the P300_350_V2_README file. This file is available in the following formats: File Format ------------------- ------------------ P300_350_V2_README.TXT Text P300_350_V2_README.PDF Acrobat Reader P300_350_V2_README.HTML HTML P300_350_V2_README_CONTENTS.HTML HTML These files can be found at SYS$COMMON:[SYSHLP] -- COVER LETTER -- Page 4 16 May 2002 5.2 New ELSA GLoria Synergy DDX image A new device dependent X server image is provided to improve performance on EV6 (21264) based platforms containing ELSA GLoria Synergy graphics modules. A new procedure, SYS$MANAGER:DECW$DEVICE_CONFIG_P2.COM, is executed automatically during DECwindows startup. The new procedure will, on appropriate platforms, define a logical name that will redirect the server to use the new P2 device dependent X code, DECW$SERVER_DDX_P2.EXE. DECW$SERVER_DDX_GZ.EXE will continue to be used on older platforms containing ELSA GLoria Synergy graphics modules. Image(s) Affected: - [SYSLIB]DECW$SERVER_DDX_P2.EXE 6 GENERAL GRAPHICS PROBLEMS ADDRESSED IN THE VMS721H1_GRAPHICS-V0300 KIT o Attempts to use the MIT-SHM Shared Memory Extension fail with the following error: X Error of failed request: BadAccess (attempt to access private resource denied) Major opcode of failed request: 131 (MIT-SHM) Minor opcode of failed request: 1 (X_ShmAttach) Serial number of failed request: 11 Current serial number in output stream: 12 Images Affected: - [SYSLIB]DECW$SERVER_DIX.EXE o In OpenVMS V7.3, the default decwindows transport can be specified via the logical name DECW$SETDISPLAY_DEFAULT_TRANSPORT. However, any SET DISPLAY commands will now change the transport to the default transport, not the transport previously specified. For example, $ show display Device: WSA24: [super] Node: NODE1 Transport: DECNET Server: 0 Screen: 0 $ show log DECW$SETDISPLAY_DEFAULT_TRANSPORT "DECW$SETDISPLAY_DEFAULT_TRANSPORT" = "tcpip" (LNM$SYSTEM_TABLE) -- COVER LETTER -- Page 5 16 May 2002 $ set displ/node=NODE2 $ show display Device: WSA24: [super] Node: NODE2 Transport: tcpip Server: 0 Screen: 0 $ set display/screen=1 $ show display Device: WSA24: [super] Node: NODE1 Transport: tcpip Server: 0 Screen: 1 The DECW$SETDISPLAY_DEFAULT_TRANSPORT default transport setting should only be used with the "$set display/create" qualifier. Images Affected: - [SYSEXE]DECW$SETSHODIS.EXE o Under some circumstances the DECwindows server can abort during startup. The SYS$MANAGER:DECW$SERVER_0_ERROR.LOG file contains the error message "failed to initialize core devices". Images Affected: - [SYSLIB]DECW$SERVER_DIX.EXE o When drawing connected line segments with the line width set to 1, the pixel at the join point between two line segments is not drawn in some cases. Images Affected: - [SYSLIB]DECW$SERVER_DIX.EXE o The system may crash with an SSRVEXCEPT or PGFIPLHI bugcheck on SMP systems when terminating client processes which are connected using the local transport. Images Affected: - [SYSLIB]DECW$TRANSPORT_LOCAL.EXE -- COVER LETTER -- Page 6 16 May 2002 7 ELSA PROBLEMS ADDRESSED IN THE VMS721H1_GRAPHICS-V0300 KIT o When an X/Motif application issues an XDrawRectangle or XDrawRectangles request with a negative x coordinate, the coordinate is incorrectly treated as a large positive number, resulting in spurious lines being drawn on the screen. Images Affected: - [SYSLIB]DECW$SERVER_DDX_GZ.EXE o If the DECwindows server is started with the pixel depth (DECW$SERVER_PIXEL_DEPTH logical name) set to 16, the server will crash. This problem is seen with the ELSA Gloria Synergy graphics controller (SN-PBXGK-BB), only when using the older DECW$SERVER_DDX_GZ.EXE server image. Images Affected: - [SYSLIB]DECW$SERVER_DDX_GZ.EXE o When using the ELSA Gloria Synergy graphics controller (SN-PBXGK-BB) in 8 bit mode, the DECwindows server can crash when copying data from the screen to a pixmap. This is most often seen when performing a drag-and-drop operation. The server can crash in several different locations depending on the timing of the operation. Another symptom of the same problem is that the server can return spurious BadAlloc errors (server resources exhausted). Images Affected: - [SYSLIB]DECW$SERVER_DDX_GZ.EXE o There are screen corruption problems when using the ELSA Gloria Synergy graphics controller (SN-PBXGK-BB): o Spurious horizontal lines are displayed when drawing diagonal lines in 8 bit mode. o When dragging a window on the screen with "display window contents during move" enabled and the screen backdrop set to Background, remnants of the window are left behind on the backdrop. Images Affected: - [SYSLIB]DECW$SERVER_DDX_P2.EXE -- COVER LETTER -- Page 7 16 May 2002 o When using the ELSA Gloria Synergy graphics controller (SN-PBXGK-BB) and running applications which write a lot of data to the screen (such as rapidly scrolling text in a DECterm window), the system clock loses time. Images Affected: - [SYS$LDR]SYS$GZDRIVER.EXE - [SYS$LDR]SYS$GZVDRIVER.EXE o User messages enabled in the console variable BOOT_OSFLAGS (bit<17> = 1) or on the console BOOT command line (e.g., >>> B -FL 0,20000) may cause a system crash or hang while booting with an ELSA GLoria Synergy graphics controller (SN-PBXGK-BB), a JIB graphics controller (3X-DEPVD-AA), or a Trifecta graphics controller (3X-DEPVZ-AA), especially on an SMP system with the console variable CONSOLE set to SERIAL. Images Affected: - [SYS$LDR]SYS$GZDRIVER.EXE - [SYS$LDR]SYS$GZVDRIVER.EXE o Some monitors like the Compaq P75 & P700, fail to synchronize when the Trifecta graphics controller (3X-DEPVZ-AA) or the JIB graphics controller (3X-DEPVD-AA) attempts to put the screen into standby mode. The problem manifests itself with the screen going partly black; you may see a partial display and the screen may blink and/or click. Images Affected: - [SYS$LDR]SYS$GZDRIVER.EXE - [SYS$LDR]SYS$GZVDRIVER.EXE 8 TGA2 (POWERSTORM 4D20/3D30) PROBLEMS IN THE VMS721H1_GRAPHICS-V0300 KIT o When booting with a PowerStorm 3D30 (SN-PBXGB-AA) or a PowerStorm 4D20 (SN-PBXGB-CA) graphics controller and the SYSGEN parameter POOLCHECK enabled, the system may crash with an ACCVIO bugcheck. Images Affected: -- COVER LETTER -- Page 8 16 May 2002 - [SYS$LDR]SYS$GYCDRIVER.EXE 9 VX1 PROBLEMS ADDRESSED IN THE VMS721H1_GRAPHICS-V0300 KIT o The following screen corruption problems occur when using the 3Dlabs Oxygen VX1 graphics controller (SN-PBXGF-AB): o Video corruption is produced when dragging certain icons around the CDE desktop. For example, after moving an icon from the Application Manager window to the desktop, each subsequent move of the icon on the desktop (backdrop required), leaves behind unintended pixels. o With selected backdrops, video corruption is produced when dragging objects around the CDE desktop. For example, when dragging a window around the desktop with the "GRAY" backdrop selected, remnants of the left and right window borders are left behind on the desktop in the form of spurious vertical lines. Images Affected: - [SYSLIB]DECW$SERVER_DDX_P3.EXE o With the 3Dlabs Oxygen VX1 graphics controller (SN-PBXGF-AB) and either 8 or 16 bits per pixel selected, extra pixels may be drawn around the edges of objects. Images Affected: - [SYSLIB]DECW$SERVER_DDX_P3.EXE o With the 3Dlabs Oxygen VX1 graphics controller (SN-PBXGF-AB), the Monitor utility may show excessive time in "Interrupt State" when the screen saver is active. Images Affected: o [SYS$LDR]SYS$GFDRIVER.EXE -- COVER LETTER -- Page 9 16 May 2002 10 P350 PROBLEMS ADDRESSED IN THE VMS721H1_GRAPHICS-V0300 KIT o Occasionally the DECwindows server would crash when an application did extensive creation and deletion of 3D contexts interspersed with extensive 2D drawing, including window creation and destruction. Images Affected: o [SYSLIB]DECW$SERVER_DIX.EXE o [SYSLIB]DECW$OPENGLPEERRI.EXE o Running the Viewperf 6.1.2 MedMCAD test causes an application crash when using LOCAL transport or a server crash when using network transport. Images Affected: o [SYSLIB]DECW$SERVER_RIDDGL.EXE o [SYSLIB]DECW$OPENGLPEERRI.EXE o When 3D contexts using a network connection are destroyed, their buffers are not being properly deallocated. The result is that, as applications create and delete 3D contexts, over time the server's virtual memory undergoes unconstrained growth. Images Affected: o [SYSLIB]DECW$SERVER_DDX_GB.EXE o Certain OpenGL viewing transformations result in incorrect placement of primitives drawn. Images Affected: o [SYSLIB]DECW$OPENGLPEERRI.EXE o [SYSLIB]DECW$SERVER_RIDDGL.EXE o The following problems are corrected: - Repeated calls to glXMakeCurrent with a network connection caused a slow but steady increase in the server's virtual memory space. - Drawing polygons or triangles in GL_LINE mode along the bottom or right edge of the OpenGL viewport resulted in extra lines being drawn along the edge of the viewport. -- COVER LETTER -- Page 10 16 May 2002 - When a single OpenGL context was used to render to two different windows, sometimes the display in one window was corrupted. - Stippled line strips with sub-pixel segments were not rendered by OpenGL. - In some instances, the DECwindows server would hang when rendering certain horizontal lines as filled rectangles. - In some instances, the DECwindows server would hang when rendering certain polygons. - Drop-down menu items became blank when the mouse was moved over a menu tear-off line. - In some instances, pixel corruption would occur when a window was moved over a highlighted item. Images Affected: o [SYSLIB]DECW$OPENGLSHR_V11.EXE o [SYSLIB]DECW$OPENGL_PROTOCOL_V11.EXE o [SYSLIB]DECW$OPENGLPEERRI.EXE o [SYSLIB]DECW$SERVER_DDX_GB.EXE o [SYSLIB]DECW$SERVER_RIDDGL.EXE o [SYSLIB]DECW$SVEXT_GLX_P350.EXE o Some programs using GLUT (OpenGL Utility Toolkit) - specifically the glutIdleFunc function - would loop infinitely and/or ignore keyboard/mouse input. Images Affected: o [SYSLIB]DECW$OPENGLUTSHR.EXE o XFillRectangle calls with extremely out-of-range coordinates sometimes resulted in erroneous drawing artifacts outside the window. Images Affected: o [SYSLIB]DECW$SERVER_DDX_GB.EXE o [SYSLIB]DECW$SERVER_RIDDGL.EXE -- COVER LETTER -- Page 11 16 May 2002 11 KIT INSTALLATION RATING: The following kit installation rating, based upon current CLD information, is provided to serve as a guide to which customers should apply this remedial kit. (Reference attached Disclaimer of Warranty and Limitation of Liability Statement) INSTALLATION RATING: INSTALL_2 : To be installed by all customers using the following feature(s): One of the following graphics controllers: o ELSA Gloria Synergy (SN-PBXGK-BB) o JIB graphics controller (3X-DEPVD-AA) o Trifecta (3X-DEPVZ-AA) o PowerStorm 3D30 (SN-PBXGB-AA) o PowerStorm 4D20 (SN-PBXGB-CA) o 3Dlabs Oxygen VX1 (SN-PBXGF-AB) o PowerStorm 300 (SN-PBXGD-AD) o PowerStorm 350 (SN-PBXGD-AE) 12 INSTALLATION INSTRUCTIONS: Install this kit with the POLYCENTER Software Installation utility by logging into the SYSTEM account, and typing the following at the DCL prompt: PRODUCT INSTALL VMS721H1_GRAPHICS /SOURCE=[location of Kit] The kit location may be a tape drive, CD, or a disk directory that contains the kit. Additional help on installing PCSI kits can be found by typing HELP PRODUCT INSTALL at the system prompt The images in this kit will not take effect until the system is rebooted. If you have other nodes in your OpenVMS cluster, they must also be rebooted in order to make use of the new image(s). If it is not possible or convenient to reboot the entire cluster at this time, a rolling re-boot may be performed. -- COVER LETTER -- Page 12 16 May 2002 12.1 Special Installation Instructions: 12.1.1 BAP SYSGEN Parameter Settings Note that the graphics system will fail to initialize unless certain SYSGEN parameters are set. If buffer addressable pool (BAP) space has not been previously created, or there is insufficient BAP on the system, then SYS$GBDRIVER will fail to come online. The driver will register its BAP requirements with the system so that AUTOGEN will create the BAP region or adjust the BAP region to meet the new requirements. If you run AUTOGEN with the usual parameters: $ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT and the system has not been up for at least 24 hours then AUTOGEN will fail. In order to set the BAP parameters properly you must run AUTOGEN a second time by issuing the following command: $ @SYS$UPDATE:AUTOGEN GENPARAMS REBOOT FEEDBACK The user should inspect SYS$SYSTEM:AGEN$PARAMS.REPORT to ensure that the SYSGEN parameters are suitable before re-running AUTOGEN. If any parameter is not suitable then that parameter should be adjusted in MODPARAMS.DAT and AUTOGEN should be run again: $ @SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT 12.1.2 Scripting of Answers to Installation Questions During installation, this kit will ask and require user response to several questions. If you wish to automate the installation of this kit and avoid having to provide responses to these questions, you must create a DCL command procedure that includes the following definitions and commands: - $ DEFINE/SYS NO_ASK$BACKUP TRUE - $ DEFINE/SYS NO_ASK$REBOOT TRUE - Add the following qualifiers to the PRODUCT INSTALL command and add that command to the DCL procedure. /PROD=DEC/BASE=AXPVMS/VER=V3.0 -- COVER LETTER -- Page 13 16 May 2002 - De-assign the logicals assigned For example, a sample command file to install the VMS721H1_GRAPHICS-V0300 kit would be: $ $ DEFINE/SYS NO_ASK$BACKUP TRUE $ DEFINE/SYS NO_ASK$REBOOT TRUE $! $ PROD INSTALL VMS721H1_GRAPHICS/PROD=DEC/BASE=AXPVMS/VER=V3.0 $! $ DEASSIGN/SYS NO_ASK$BACKUP $ DEASSIGN/SYS NO_ASK$REBOOT $! $ exit Copyright (c) Compaq Computer Corporation, 2002 All Rights Reserved. Unpublished rights reserved under the copyright laws of the United States. COMPAQ, the Compaq logo, VAX, Alpha, VMS, and OpenVMS are registered in the U.S. Patent and Trademark Office. All other product names mentioned herein may be trademarks of their respective companies. Confidential computer software. Valid license from Compaq 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. Compaq shall not 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 Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY THIS PATCH IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR PARTICULAR PURPOSE, OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED TO THE EXTENT PERMITTED BY APPLICABLE LAW. IN NO EVENT WILL Compaq BE LIABLE FOR ANY LOST REVENUE OR PROFIT, OR FOR SPECIAL, INDIRECT, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, WITH RESPECT TO ANY PATCH MADE AVAILABLE HERE OR TO THE USE OF SUCH PATCH.