*
* README for IBM Visualization Data Explorer for Suns running SunOS 4.1.x
*
* (C) COPYRIGHT International Business Machines Corp. 1991-1997
* All Rights Reserved.
* Licensed Materials - Property of IBM
*
* US Government Users Restricted Rights - Use, duplication or
* disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
*
*
 
 
The information contained in this file consists of hints for using the
system, help with functions that may not be apparent, and last minute updates
to the existing documentation.  It is advisable to review this file any time
Data Explorer updates are applied.
 
========================================================================
 
CONTENTS
 
    To go directly to an item, search for the item number beginning
    at the left margin.
 
    1. System Configuration 
       A. Default Keyboard Mappings
       B. Memory Usage
       C. Running DX elsewhere and displaying on OpenWindows
    2. Hardware Rendering Considerations
       A. Shared Library Support for Hardware Rendering 
       B. Hardware Rendering Not Available Message
       C. Transparency for Hardware Rendering
       D. SunOS 4.1.2 and Two Hardware Windows
    3. On Line Help Path Menu
    4. Message "dlopen:stub interception failed"
 
========================================================================
 
 
1. System Configuration 
 
A. Default Keyboard Mappings
On the Sun SPARCstations, Ctrl+Delete is Ctrl+Del.  "Del" is found
on the numeric keypad.  Data Explorer responds to the "End" key and arrow
keys found on the numeric keypad.  The mnemonic key to pull down the menus
uses the diamond key as the modifier, instead of the Alt key.
 
B. Memory Usage
On Sun running SunOS 4.1.x, the Data Explorer executive uses the
contents of the /etc/dmesg file to determine the amount of physical memory
available on the workstation.  From this amount of physical memory,
it determines an allowable memory size based on the algorithm described 
in the architecture independent README.  If this file is not available 
for reading or the amount of physical memory is not indicated in the file, 
then the executive uses a default memory size of 32 megabytes.  If you 
wish to run Data Explorer with more or less memory than the default, then 
use "dx -memory #" where '#' is a number in megabytes. 
 
C. Running DX elsewhere and displaying on OpenWindows
Running an OSF/Motif Version 1.2 client on another machine and displaying
the windows on OpenWindows under SunOS 4.1.x can cause the OpenWindows
server to ignore button presses when displaying popup or pulldown menus.
Data Explorer, when run on SGIs, Data General AViiONs, Digital Equipment 
Corporation workstations, and Sun workstations as an OSF/Motif 1.2 client
shows these problems.  In these cases, either kill the user interface from
the remote machine, or use OSF/Motif keyboard handling to terminate Data
Explorer.
 
 
 
2. Hardware Rendering Considerations
 
A. Shared Library Support for Hardware Rendering
When hardware rendering is requested for the first time, the executive
dynamically loads /usr/lpp/dx/bin_sun4/DXhwdd.so and the xgl shared
libraries.  If one of these is not present then hardware rendering will
be disabled.
 
B. Hardware Rendering Not Available Message
When the message 'Hardware rendering not available: /usr/lib/libxgl.so not
found' appears, then xgl shared library or run-time support has not been
installed.
 
C. Transparency
Transparency is not handled by the Sun Hardware Renderer.
 
D. SunOS 4.1.2 and Two Hardware Windows
When rendering with two Hardware windows and using direct interactors,
images may be corrupted and appear in the opposite window. This is fixed
with SunOS 4.1.3.
 
 
3. On Line Help Path Menu
In the current implementation of Data Explorer, the pop-up menu
providing the current help path is not supported.
 
4. Message "dlopen:stub interception failed"
If the message 'dlopen:stub interception failed' results when attempting
hardware rendering it may be a result of a problem on SunOS when there
are references in the LD_LIBRARY_PATH environment variable to directories
that are by default searched by the dynamic loader (e.g. /lib or /usr/lib).
This can be worked around by removing any references to directories that
are searched by default.  This includes removing softlinks such as
/usr/ucblib which may be linked to /usr/lib.
 
  
----------------------------------------------------------------------
 
The following trademarks apply to this information:
 
IBM is a registered trademark of International Business Machines Corporation.
IBM Visualization Data Explorer is a trademark of International
    Business Machines Corporation.
Motif, OSF, and OSF/Motif are trademarks of Open Software Foundation, Inc.
SPARCstation is a trademark of SPARC International.
Sun, Sun-4, XGL, and OpenWindows are trademarks of Sun Microsystems, Inc.
AViiON is a trademark of Data General Corporation.