![[Return to Library]](BOOKSHELF.GIF){kind=small}
![[Contents]](TOC.GIF){kind=small}
![[Previous Chapter]](http://www.tru64unix.compaq.com/docs/base_doc/DOCUMENTATION/HTML/AA-QTLMB-TE_html/REW.GIF)
![[Next Section]](http://www.tru64unix.compaq.com/docs/base_doc/DOCUMENTATION/HTML/AA-QTLMB-TE_html/NEXT.GIF)
![[Next Chapter]](FF.GIF){kind=small}
![[Index]](INDEX.GIF){kind=small}
![[Help]](HELP.GIF){kind=small}
This chapter contains notes about issues and known problems with the windowing software and, whenever possible, provides solutions or workarounds to those problems. The following topics are discussed in this chapter:
The following notes apply to graphics hardware restrictions.
![[Previous Section]](http://www.tru64unix.compaq.com/docs/base_doc/DOCUMENTATION/HTML/AA-QTLMB-TE_html/PREV.GIF)
The following notes apply to the Digital PBXGB-AA video card:
To disable X Server DMA for the PBXGB-AA video card, you must do the following:
If you are able to use the shutdown command, execute the following command as superuser:
#
/usr/sbin/shutdown +2 "Disabling graphics DMA"
If you cannot use the shutdown command (for example, if the X Server on the PBXGB-AA card is hung), you must halt your system by pressing the hardware HALT button and then reboot your system to single-user mode by entering the following command:
>>>
boot -f1 s
After your system is in single-user mode, mount all of your local file systems by entering the following command:
#
bcheckrc
#
cd /var/X11/xdm
You must then edit the Xservers file to append the text "-I -ffbDoDMA 0" to the end of the following line:
:0 local /usr/bin/X11/X
The following example illustrates backing up the Xservers file and then using the sed editor to make the appropriate change:
#
cp Xservers Xservers.old
#
sed '/^:0/s/$/ -I -ffbDoDMA 0/' Xservers.old > Xservers
#
cd /usr/dt/config
You must then edit the Xservers and Xservers.con files to append the text "-I -ffbDoDMA 0" to the end of the following line:
:0 Local local@console /usr/bin/X11/X :0
The following example illustrates backing up the Xservers and Xservers.con files and then using the sed editor to make the appropriate changes. This example assumes the files are the default distributed versions, in which the appropriate line for the change is the only line in each file that ends with the text ":0":
#
cp Xservers Xservers.old
#
cp Xservers.con Xservers.con.old
#
sed '/:0/s/$/ -I -ffbDoDMA 0/' Xservers.old > Xservers
#
sed '/:0/s/$/ -I -ffbDoDMA 0/' Xservers.con.old > Xservers.con
#
[Ctrl/D]
The system will then request the run level, to which you should answer the following:
Enter run level (0-9, s or S):
3
Different versions of Qvision demonstrate fillsolid drawing problems, leaving a line at the bottom of the screen, which is evident when running CDE blank lock screen. The line varies in color and intensity depending on the version of the Qvision board.
The following notes apply to X servers.
CDE provides limited support for X servers with more than one screen. While a multiscreen environment is possible, a number of inconsistencies are noticeable. For example, colors in secondary screens may not be correct, icons may not display properly, and applications may not appear on the screen where they are invoked. Digital is currently working with OSF to resolve issues related to multiscreen environments for future releases of CDE.
If you use the Keyboard Options desktop application /usr/dt/bin/dxkeyboard, to change the keymap, X11R5 clients will not be notified of the change. For example, a dxterm running on DEC OSF/1 Version 3.2 displaying to a Digital UNIX Version 4.0 system will not be notified that the keyboard mapping changed.
To avoid this problem, enter the following command after using dxkeyboard to change the keyboard mapping:
xmodmap -e "keycode 248 = NoSymbol"
The final revision of the X Keyboard Extension, XKB Version 1.0, will be different from XKB Version 0.65, shipping with this release. The format of /usr/lib/X11/xkb/keymaps.dir will change. Do not modify this file as it will not be preserved with future updates of the operating system.
To force the server to use a specific XKB keymap, add the -xkbmap option to the server options line in /usr/lib/X11/Xserver.conf. Refer to the reference page on Xdec for more information.
The following notes apply to X clients.
Color rich applications, such as Netscape, exhaust a large number of colormap resources. This results in problems with other graphical applications. For example, you may notice that icons normally displayed by the CDE Application Manager are not displayed when a color rich application is currently running on the system. Graphics displayed by applications and online help volumes may also be affected. The icon editor, dticon, may not be able to open a pixmap that contains a large number of colors.
In most cases this is a visual problem, and it may not be necessary to take any corrective actions. The CDE icon labels can be used in the same way as the icon for user actions such as drag-and-drop, single and double click.
The simplest solution is to exit the color rich application. There are several alternate actions:
Netscape*maxImageColors: 96
A new resource definition (*DXmfitToScreenPolicy: AS_NEEDED) has been added to the /usr/lib/X11/app-defaults/DXnotepad resource file for the C locale.
If you are doing an update installation, this new resource is not automatically merged into your existing /usr/lib/X11/app-defaults/DXnotepad file. Therefore, you must manually append the following text to your C-locale DXnotepad resource file:
*DXmfitToScreenPolicy: AS_NEEDED
This definition tells the toolkit to add scroll bars to a dialog box if the dialog box does not fit on the screen. It is required to support new workstations with smaller monitor resolutions.
When dxmail is run using a new locale setting, mail subjects in the mail folders are still encoded in the codeset used by the previous locale. Non-ASCII characters in these subjects will be displayed incorrectly.
To correct this, use the rescan mail folder function to convert all existing subjects lines to the codeset used by the new locale.
If /usr/sbin/xsetup is used to switch login environments from the CDE to XDM, it may need to install the subset OSFOLDX11410 to regain the expected user environment. If this subset is missing, the default X session will consist of a single xterm and the twm window manager instead of the more familiar Digital session manager.
The source code as provided in /usr/examples/motif/dxmandel does not produce a working version of the demonstration. This can be corrected if you change the first function call of XtToolkitThreadInitialize() to read XInitThreads(). Then remove the second call to XtToolkitThreadInitialize().
The following notes apply to CDE clients.
File Manager, Application Manager and Trash Manager are different views supported by the dtfile application. Avoid invoking dtfile from a remote system with the environment variable DISPLAY set appropriately. This is because of the client-server model used by the dtfile application and its close interaction with the tooltalk messaging system.
In the event of an unexpected behaviour from any of these utilities, please close down all windows associated with the File Manager, Application Manager and Trash Manager. Then kill all processes associated with dtfile. You can get the pid for each process using the following command line:
#
ps -aef | grep dtfile
When using enhanced security, Autopause does not allow you to resume a suspended CDE session.
If you are not logged in as root, the dtsession Autopause and Locking features will not unlock. The session must be unlocked either by typing the root password or remotely killing the dtsession process, terminating and restarting the session.
The dxpause program exhibits the same behavior and there is no workaround for this problem. To avoid the problem, turn off the Screen Lock toggle on the Style Manager menu, Screen option.
The dtmail utility does not honor the user configurable mail locking environment variable MAILLOCKING. If you are using NFS, you must have nfs locking enabled on both client and server systems.
DtMail will disable tooltalk locking by default. To enable it, select the following option from the Mail Options->Advance dialog box:
Use network aware mail file locking
Alternatively, set the following option in your $HOME/.mailrc file:
cdenotooltalklock='f'
If tooltalk locking is enabled, and the rpc.ttdbserverd daemon is not running, you will get the following message:
Mailer is unable to obtain exclusive access to this mailbox because the system is not responding.
For this time only, you can choose to open this mailbox read-only, or to open it read-write without exclusive access (use only if no one else is using this mailbox).
You can either quit and start the rpc.ttdbserverd daemon, or click on read-write allowing you to continue without tooltalk lock.
If you are running the automount daemon, the DtMail application may not be able to access your new mail inbox and you will see a dialog box showing the following message:
"Unable to access an object required to complete the operation"
If you see this message, copy the contents of your current mail inbox to a temporary file as a backup. and perform the following steps:
set cdenotooltalklock
Alternatively, you can use the following method while in DtMail:
Changing the values for rows and columns in the Mail Options->Message View will not take effect immediately when you click on OK or APPLY. Exit dtmail and restart it again from the control panel, command line, or file manager.
If you compose a mail message by selecting one of the following from the dtmail main window, attachments will not be included:
Include the attachments manually using the drag and drop feature.
Incorrect default permissions on /dev/zero prevent dtmail from starting.
You may see the following message when starting dtmail:
"No memory available for operation"
If you see this message, set the permission mode on /dev/zero to 666 as follows:
#
chmod 666 /dev/zero
The Common Desktop Environment (CDE) has a static dependency on the state of the network configuration. For more information, see Section 3.6.9.
CDE users should remove any xnlLanguage resource settings from their .Xdefaults files. Those settings are typically left over from one of the user's earlier DECwindows sessions, where the user selected a language from the session manager's language menu and then saved that setting.
The xnlLanguage settings should be removed because they override whatever language you select from the language menu in the CDE login window.
When logging in to the CDE desktop, it is possible that not all desired applications will be restarted. The X server process may not be able to handle all of the requests for new open connections causing some to fail in the XOpenDisplay call. Some applications, like xterm, will log startup errors, such as:
xterm error: can't open display :0
in the dxconsole window.
To avoid this problem, add the following resource to your $HOME/.Xdefaults file:
Dtsession*contManagement: 2
This resource enables a handshake protocol between the CDE session manager and window manager during the login phase to control the appearance of new windows. While it may marginally increase the time before the login completes, it better assures that all applications will be restarted.
For a multiuser system, this resource can be added to the /usr/dt/app-defaults/C/Dtsession file to make the change for all users automatically.
The following note applies to windows programming.
In the fonts Lucida-Typewriter-medium-R-normal, the glyphs for multiply (X) and divide (-:-) are reversed. The multiply is where the divide should be, and vice versa. If the representation of these glyphs are important to your application, use a different font.
The following notes apply to restrictions on use of internationalization features in the windowing environments.
Chinese DECterm software supports the use of DEC Hanyu, Big5 and DEC Hanzi as its terminal code. To process Taiwanese EUC codeset, users should do the following:
%
/usr/bin/X11/dxterm -xnl zh_TW.dechanyu
%
setenv LANG zh_TW.eucTW
%
/usr/i18n/bin/stty adec acode eucTW tcode dechanyu
After that, users can use terminal applications to process Taiwanese EUC files.
On PC-style keyboards, the Hanyu, Hanzi, Hangul and Kanji input servers use the Delete key instead of the Backspace key to erase information.
The Digital UNIX input servers for Hanyu, Hanzi, and Kanji support only X and local transports. Transports over DECnet and TCP/IP are not supported. DECnet and TCP/IP transports are available only for IM servers that have a single input-server atom name.
X11R6 input servers can connect to R4, R5 and R6 clients under the same locale. However, if the system is using multiscreen support, only R6 clients can be connected.
When the Language setting is zh_TW.big5, EDPC support must be turned off. Otherwise, random characters will appear in the candidate list for unsupported 4-byte encodings. Select the Input Method Customization... option from the Options button of the input server window in the lower left corner of your screen. Then in the customization dialog box, click the EDPC support button to off.
String conversion using XStringStyle() is not supported for interclient communication under the ja_JP.SJIS locale. This is because the X library assumes that the 7-bit string data has ISO8859-1:GL encoding, whereas the ja_JP.SJIS locale assumes the data has JISX0201.1979-0:GL encoding.
The new mdxbook command in the IOSWWOLDBKR410 subset is a variant of dxbook Version 3.0. Unlike dxbook, the mdxbook command supports printing files with Chinese and Korean characters.
The display quality of mdxbook is not as good as dxbook. Therefore, install mdxbook only if you need to print Chinese and Korean characters.
The following notes apply to Hebrew support.
HIM_ ALLOW_STATUSNONE
If XIMStatusNone is required but the variable is not defined, XIMStatusNothing will be used.
The environment variable ADECW_MOTIF12 is needed for the cut and paste operation of the DXmCSText to work properly in the Hebrew environment. If you encounter problems with the cut and paste operation of a mixed English/Hebrew/Numeric strings, use this workaround and define the variable in your working environment (the value is arbitrary).
When the notepad application is started with off-the-spot input style, the input area attached at the bottom of the application disappears during split view and delete view.
The X server will automatically choose a keymap based upon the language and keyboard settings of the system console. If your locale is not available on the system console, or you wish for the server to load a different keymap, you must set the system default keyboard map. The default keyboard map is specified by adding the -xkbmap option to the args list in the /usr/var/X11/Xserver.conf file. Add the -xkbmap option using the following syntax:
! you specify command line arguments here args < -pn -xkbmap <keymap_file_name>_<keymap_name> >
For example:
-pn -xkbmap digital_japanese_lk411aj
The available keymap files are located in /usr/lib/X11/xkb/keymap, where there is one file for each locale. The individual keymaps for the locale are in the keymap file, and are specified by the keyword xkb_keymap. For example, the keymap file /usr/lib/X11/xkb/keymap/digital_japanese, contains an entry for the lk411aj keymap.
In addition, keymaps can be changed after logging in by running the Keyboard Options desktop application /usr/dt/bin/dxkeyboard if you are using CDE. Use the keyboard setting option of the session manager if you are using xdm.
The following instructions are for modifying some system files to allow for some support of Lithuanian and Slovene.
DX applications this release do not support the use of mnemonics in Lithuanian and Slovene language variants.
For the Visual Differences application, /usr/bin/X11/dxdiff, to display differences between two text files written in Lithuanian or Slovene language you must do the following. Edit the resource file DxDiff located on /usr/lib/X11/app-defaults directory and change the following line:
*dxdiff*textdisplay*fontList: fixed
to:
*dxdiff*textdisplay*fontList: -*-terminal-medium-r-narrow--18-*-*-*-c-*-*-*
You need superuser (root) privileges to make this change.
Some DX applications that are not integrated as part of the CDE desktop, but can be invoked using the File Manager or command line, do not set all display fonts according to the locale in use. If users want these applications to provide full Lithuanian and/or Slovene language support, they must perform the following corrective actions on the system with Lithuanian and/or Slovene language variant installed.
Note that all these actions must be performed by superuser.
To use Lithuanian and/or Slovene national characters in dxmail, edit the resource file /usr/lib/X11/app-defaults/DXMail and change the following lines:
*outlineList*DXmfontListDefault: *-*-*-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1 *outlineList*DXmfontListLevel0: *-*-*-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1 *outlineList*DXmfontListLevel1: *-*-*-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1 *tocList*DXmfontListDefault: *-*-*-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1 *tocList*DXmfontListLevel0: *-*-*-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1 *Item.fontList: *-*-Helvetica-Bold-R-Normal--*-100-*-*-*-*-ISO8859-1 *XmText.FontList: *-*-*-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1 *Text.FontList: *-*-*-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1
to:
*outlineList*DXmfontListDefault: *-*-*-Medium-R-Normal--*-120-*-*-M-*-*-* *outlineList*DXmfontListLevel0: *-*-*-Medium-R-Normal--*-120-*-*-M-*-*-* *outlineList*DXmfontListLevel1: *-*-*-Medium-R-Normal--*-120-*-*-M-*-*-* *tocList*DXmfontListDefault: *-*-*-*-R-Normal--*-120-*-*-*-*-*-* *tocList*DXmfontListLevel0: *-*-*-*-R-Normal--*-120-*-*-*-*-*-* *Item.fontList: *-*-*-*-R-Normal--*-120-*-*-*-*-*-* *XmText.FontList: *-*-*-Medium-R-Normal--*-120-*-*-*-*-*-* *Text.FontList: *-*-*-Medium-R-Normal--*-120-*-*-*-*-*-*
To use Lithuanian and/or Slovene national characters in dxnotepad, edit the resource file /usr/lib/X11/app-defaults/DXnotepad and change the following line:
*textwindow.fontList: -*-Terminal-Medium-R-Narrow--*-140-*-*-C-*-ISO8859-1
to:
*textwindow.fontList: -*-Terminal-Medium-R-Narrow--*-140-*-*-C-*-*-*
In order to use Lithuanian and/or Slovene national characters in Bookreader bookshelf and book names, edit the resource file /usr/lib/X11/app-defaults/DXBookreader and change all occurrences of string:
-*-Menu-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1
to:
-*-*-*-R-Normal--*-120-*-*-P-*-*-*
The dxpaint Lithuanian and Slovene language variants do not support the insertion of Lithuanian and Slovene national specific characters.
The dxclock application displays date and time using English day/month abbreviations and format.
The dxcalendar application displays date and time using English day/month abbreviations and format.
To create calendar entries using Lithuanian and/or Slovene national specific characters, edit the resource file /usr/lib/X11/app-defaults/DXcalendar and change the following two lines:
*font_small_tb.fontList: \ -*-Menu-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1 *font_medium_tb.fontList: \ -*-Menu-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1
to:
*font_small_tb.fontList: -*-*-*-R-Normal--*-100-*-*-P-*-*-* *font_medium_tb.fontList: -*-*-*-R-Normal--*-120-*-*-P-*-*-*
In addition to the new default Common Desktop Environment (CDE), Digital UNIX V4.0 still supports DECwindows interface as an optional user interface. However, if you want to use the old DECwindows user interface you need to log in after selecting Dxsession session from Options --> Session menu of Digital UNIX login screen.
Lithuanian language variant users that wish to operate in Dxsession environment must specify the default user interface font by editing the file .Xdefaults located on their home directory and adding the following line and log in again:
*FontList: -*-*-*-r-Normal--*-120-*-*-*-*-*-*
If users operate in a multilingual user interface environment, this above corrective action will cause other language variants to display using the default font which is slightly different than to the font family used before this action was performed.
Users that wish to have the default user interface font to be used with the Motif window manager need to edit the resource file /usr/lib/X11/app-defaults/Mwm and change the following line:
Mwm*fontList: -*-Menu-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1
to:
Mwm*fontList: -*-*-*-R-Normal--*-120-*-*-P-*-*-*
Note that this change must be performed by a superuser (root).