[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

HP DECwindows Motif for OpenVMS
Management Guide


Previous Contents Index

The following example enables the second screen (1) in a four-screen (0,1,2,3) multihead display:


Example


$ DECW$SERVER_ENABLESCREEN == "1"
      

DECW$SERVER_DISABLESCREEN

With a multihead system based on XINERAMA, you can choose to disable each screen in the display individually. This parameter disables the specified screen. The valid value ranges from 0 to 15, which represents the maximum number of screens supported by the extension.

Once a screen is disabled, it is no longer initialized as part of the display and is not assigned a screen number. Note that this changes the existing screen order and alters the display of any predefined edge attachments.

The following symbol definition disables the third screen (2) in a four-screen (0,1,2,3) multihead display:


Example


$ DECW$SERVER_DISABLESCREEN == "2"
      

DECW$SERVER_ONLYSCREEN

With a multihead system based on XINERAMA, you can choose to enable individual screens in the display at the exclusion of all others. This parameter explicitly enables the specified screen and disables all others. The valid value ranges from 0 to 15, which represents the maximum number of screens supported by the extension.

The following symbol definition enables the second screen (1) and disables all other screens (0,2,3) in a four-screen (0,1,2,3) multihead display:


Example


$ DECW$SERVER_ONLYSCREEN == "1"
      

DECW$SERVER_EDGE_LEFT

With a multihead system based on XINERAMA, edge controls are used to define the boundaries of the virtual display. This parameter determines to what screen(s) the left boundary of the display is attached. The values are determined by screen number, for example:

left-screen#, index-screen#, right-screen#

where index-screen# represents the number of the screen to which you want the boundary attached, left-screen# indicates the number of the screen directly to the left of the index, and right-screen# indicates the number of the screen directly to the right of the index. Repeat this pattern for each screen to which you want the border attached. A value of -1 equates to none.

The following symbol definition specifies the left edge of a square, four-screen display arranged in the following order:

  • 0 1
  • 2 3

where the left edge of the second and fourth screens (indices 1 and 3) are attached to the first and third screens (0,2):


Example


$ DECW$SERVER_EDGE_LEFT == "-1,0,-1,2"
      

DECW$SERVER_EDGE_RIGHT

With a multihead system based on XINERAMA, edge controls are used to define the boundaries of the virtual display. This parameter determines to what screen the right boundary of the display is attached. The values are determined by screen number, for example:

right-screen#, index-screen#, left-screen#

where index-screen# represents the number of the screen to which you want the boundary attached, right-screen# indicates the number of the screen directly to the right of the index, and left-screen# indicates the number of the screen directly to the left of the index. Repeat this pattern for each screen to which you want the border attached. A value of -1 equates to none.

The following symbol definition specifies the right edge of a square, four-screen display arranged in the following order:

  • 0 1
  • 2 3

where the right edges of the first and third screens (indices 0 and 2) are attached to the second and fourth screens (1,3):


Example


$ DECW$SERVER_EDGE_RIGHT == "1,-1,3,-1"
      

DECW$SERVER_EDGE_TOP

With a multihead system based on XINERAMA, edge controls are used to define the boundaries of the virtual display. This parameter determines to what screen the top boundary of the display is attached. The values are determined by screen number, for example:

top-screen#, index-screen#, bottom-screen#

where index-screen# represents the number of the screen to which you want the boundary attached, top-screen# indicates the number of the screen directly above the index, and bottom-screen# indicates the number of the screen directly below the index. Repeat this pattern for each screen to which you want the border attached. A value of -1 equates to none.

The following symbol definition specifies the top edge of a square, four-screen display arranged in the following order:

  • 0 1
  • 2 3

where the top edges of the third and fourth screens (indices 2 and 3) are attached to the first and second screens (0,1):


Example


$ DECW$SERVER_EDGE_TOP == "-1,-1,0,1"
      

DECW$SERVER_EDGE_BOTTOM

With a multihead system based on XINERAMA, edge controls are used to define the boundaries of the virtual display. This parameter determines to what screen the bottom boundary of the display is attached. The values are determined by screen number, for example:

bottom-screen#, index-screen#, top-screen#

where index-screen# represents the number of the screen to which you want the boundary attached, bottom-screen# indicates the number of the screen directly below the index, and top-screen# indicates the number of the screen directly above the index. Repeat this pattern for each screento which you want the border attached. A value of -1 equates to none.

The following symbol definition specifies the bottom edge of a square, four-screen display arranged in the following order:

  • 0 1
  • 2 3

where the bottom edges of the first and second screens (indices 0 and 1) are attached to the third and fourth screens (2,3):


Example


$ DECW$SERVER_EDGE_BOTTOM == "2,3,-1,-1"
      

3.1.2.5 Transport and Network Connections

The transport is the link between DECwindows client applications and the display server. Use the symbols in this section to control the types of available network transport links and the timing characteristics of the link.

DECW$SERVER_TRANSPORTS

You can specify which network transports your server monitors for incoming connections. Valid values for DECW$SERVER_TRANSPORTS are "DECNET", "LOCAL", "TCPIP", and "LAT". The default value for this parameter depends on the value of the DECW$INSTALL_TCPIP system logical. If the logical is set to True, the default value is "DECNET,LOCAL,TCPIP"; if the logical is not set, the default value is "DECNET,LOCAL."

The following example shows how to specify DECnet, local, and TCP/IP as the transports you will use:


Example


$ DECW$SERVER_TRANSPORTS == "DECNET,LOCAL,TCPIP"
      

DECW$XPORT_SYNC_TIMEOUT

This parameter defines the transport timeout value (in milliseconds). The default is 30000 milliseconds (30 seconds). If the client does not take action to empty its buffers before the timeout, the server disconnects the client.

The following logical definition extends the timeout value to 60000 milliseconds (1 minute):


Example


$ DEFINE/SYSTEM DECW$XPORT_SYNC_TIMEOUT 60000
      

3.1.2.6 Fonts

Displaying text is one of the major tasks of the display server. To display text, the display server is given a font name and a set of characters to be drawn. Usually, the font name corresponds to a particular font file resident on a server system (either display server or font server). When trying to match a font name with a font file, the display server searches the font path, which is an ordered list of directories. Each valid font directory contains a font directory file (DECW$FONT_DIRECTORY*.DAT) that lists font file names and corresponding font names. The display server searches each directory file, in order, until it finds a matching font name.

In addition, DECwindows Motif supports font alias files (DECW$FONT_ALIAS*.DAT), which can reside in any valid font directory. These files map one font name to a different font name. After the display server checks the font directory file in a given font directory without finding a match, it will then search the font alias file, if it exists. If it finds a match in the alias file, the translated font name is substituted and the search is restarted from the beginning of the font path.

3.1.2.6.1 Font Path

As stated in Section 3.1.2.6, the font path is an ordered list of directories in which font files that are available to the display server reside. The font path is constructed from a number of setup parameters.

The type of available graphics devices may also influence the contents of the font path. The logical name DECW$FONT in the server logical name table contains the font path. The font path is a subset of the following directories:

  • SYS$COMMON:[SYSFONT.DECW.CURSOR32]
  • SYS$COMMON:[SYSFONT.DECW.CURSOR16]
  • SYS$COMMON:[SYSFONT.DECW.100DPI]
  • SYS$COMMON:[SYSFONT.DECW.75DPI]
  • SYS$COMMON:[SYSFONT.DECW.COMMON]

The following directories are also included in the font path:

  • SYS$COMMON:[SYSFONT.DECW.SPEEDO]
  • SYS$COMMON:[SYSFONT.DECW.TRUETYPE]
  • SYS$COMMON:[SYSFONT.DECW.TYPE1]

Pointers to font servers can also be added to the end of the font path. For more information, see DECW$FONT_SERVERS.

A variant of each directory exists for user-supplied and euro-enabled fonts, for example: SYS$COMMON:[SYSFONT.DECW.USER_100DPI]. For more information, see Section 3.6.

DECW$SERVER_DENSITY

The server density value is used to determine the font size to use, either 75 or 100 dots per inch (dpi). If you have a 100-dpi monitor, you can have a screen density of 75 or 100 dpi. Fonts intended for 75-dpi monitors that are displayed on 100-dpi monitors may appear small and difficult to read.

The following symbol definition sets the screen density to use 100-dpi fonts:


Example


$ DECW$SERVER_DENSITY == "100"
      

DECW$CURSOR_SIZE

This parameter defines which cursor font directories are included in the font path. It can be set to 16 to include only the 16x16 cursors or to 32 to include both the 32x32 and 16x16 cursor. The larger cursor size resulting from a value of 32 is usually appropriate for a 100-dpi display.

The following symbol definition sets the cursor size to 16x16:


Example


$ DECW$CURSOR_SIZE == "16"
      

DECW$FONT_SERVERS

You can add font servers to the font path by defining the symbol DECW$FONT_SERVERS in the site-specific server section of the file SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM.

Multiple font servers can be added by defining the symbol as a comma-separated list. The symbol is not case sensitive.

The following symbol adds the font server ASHFLD::FONTSRV to the font path:


Example


$ DECW$FONT_SERVERS == "DECNET/ASHFLD::FONTSRV"
      

DECW$IPV6_FONT_SUPPORT

This parameter controls how the the TCP and TCPIP transport names are interpreted in the DECW$FONT_SERVER definition and whenever a client specifies an explicit font server path. Set the parameter to one of the following values:

  • TCP_IS_INET6
    The TCP and TCPIP transport names are interpreted as synonyms for the INET6 transport. Using this value enables IPv6 as the default transport between the display server and its font servers when the TCP or TCPIP transport name is specified. Note that this setting requests the IPv6 transport be used as a default. If the IPv6 transport is not available for the specified node, the IPv4 transport is used.
  • DISABLED
    The TCP and TCPIP transport names are interpreted as synonyms for the INET transport. This is the default value if the parameter is undefined. Using this value sets IPv4 as the transport between the display server and its font server when a TCP or TCPIP transport name is specified. A client can still request the IPv6 transport by explicitly specifying the INET6 transport in its font server path.

The following example specifies the transport names TCP and TCPIP be interpreted as synonyms for the INET6 transport:


Example


$ DECW$IPV6_FONT_SUPPORT == TCP_IS_INET6
      

3.1.2.6.2 Font Caching

A font file contains a compressed binary representation of all the glyphs, or characters, within that font. For example, the following font file contains all the information for the glyphs in the Helvetica 12-point font:


DECW$SYSCOMMON:[SYSFONT.DECW.100DPI]HELVETICA12_100DPI.DECW$FONT

The DECwindows display server supports the portable compiled format (PCF) that was introduced with the X11R5 display server. PCF is a modified font format that includes bit/byte ordering and alignment information as part of the font data and allows for vendor-independent font support.

DECW$SERVER_FONT_CACHE_SIZE

This parameter defines the number of units to allocate for each font. It only applies to 16-bit .PCF fonts. The default is 1024.

The following logical definition reduces the font cache size to 512:


Example


$ DEFINE/SYSTEM DECW$SERVER_FONT_CACHE_SIZE 512
      

DECW$SERVER_FONT_CACHE_UNIT

This parameter defines the bytes per unit. The default is 128.

The following logical definition increases the number of bytes per unit to 512:


Example


$ DEFINE/SYSTEM DECW$SERVER_FONT_CACHE_UNIT 512
      

3.1.2.6.3 Font Scaling

In addition to supporting several formats of scalable outline fonts, the DECwindows display server also can scale any of its bitmap fonts to any size.

Note, however, that the quality of these scaled bitmap fonts is significantly less than the original bitmap fonts or even comparable scaled outline fonts. By default, this capability is disabled. In some cases, this reduction in quality may be an acceptable tradeoff, given the greater flexibility in font sizes.

DECW$SERVER_SCALE_BITMAP_FONTS

This parameter enables the scaling of bitmap fonts to render arbitrary point-size characters. The default value is False (disabled).

The following logical definition enables scalable fonts:


Example


$ DEFINE/SYSTEM DECW$SERVER_SCALE_BITMAP_FONTS TRUE
      

3.1.2.7 Keyboard

Some default characteristics of the keyboard attached to the server system can be modified. These include keyboard operations, such as keyclick and bell volume and autorepeat, as well as how the keyboard keys are mapped to keyboard independent symbols used by client applications.

Additionally, the X Keyboard extension (XKB) provides enhanced capabilities for defining the keyboard layout and audio feedback. Use the parameters in this section when using XKB to specify the settings for the X Keyboard layout files. See Section 3.5 for instructions on how to load custom keymap and keyboard layout files.

Some of the keyboard settings in this section can be overriden by the Session Manager. Setting these symbols takes effect before the user logs in or if you are not using DECwindows Session Manager.

DECW$KEYMAP

The DECW$KEYMAP parameter translates to the directory specification where keyboard mapping files reside. It is provided for your reference only. Do not modify its value.

DECW$DEFAULT_KEYBOARD_MAP

You can specify the language for which your keyboard is designed. Valid values for DECW$DEFAULT_KEYBOARD_MAP are the file names (without file type) in the SYS$COMMON:[SYS$KEYMAP.DECW.SYSTEM] and SYS$COMMON:[SYS$KEYMAP.DECW.USER] directories.

For a list of valid keymap names, see Appendix B.

The following symbol definition changes the keyboard layout to a Dutch typewriter layout:


Example


$ DECW$DEFAULT_KEYBOARD_MAP == "DUTCH_LK201LH_TW"
      

DECW$SERVER_BELL_BASE_VOLUME

This parameter determines the volume of the bell sound in a keyboard. Values are from 0 to 100, with 100 being the loudest. The default volume level is 50.

The following logical definition sets the volume to one quarter of full volume:


Example


$ DEFINE/SYSTEM DECW$SERVER_BELL_BASE_VOLUME 25
      

DECW$SERVER_ENABLE_ACCESSX

This parameter enables the AccessX keyboard features for disabled users, such as sticky keys or slow keys. The valid values are 0 (disabled) or 1 (enabled). The default is 0.

The following example enables the AccessX features:


Example


$ DECW$SERVER_ENABLE_ACCESSX == "1"
      

DECW$SERVER_ENABLE_KB_AUTOREPEAT

Keyboard autorepeat is an option that causes a character to repeat itself automatically while that character key is pressed. You can enable this option by specifying True for this parameter.

The following logical definition enables keyboard autorepeating of typed characters:


Example


$ DEFINE/SYSTEM DECW$SERVER_ENABLE_KB_AUTOREPEAT T
      

DECW$SERVER_KEYCLICK_VOLUME

This parameter determines the volume of the click sound in a keyboard. Values are from 0 to 100, with 100 being the loudest. The default is 0.

The following symbol definition sets the volume to one quarter of full volume.


Example


$ DEFINE/SYSTEM DECW$SERVER_KEYCLICK_VOLUME 25
      

DECW$SERVER_KEY_REPEAT_DELAY

When using XKB, this parameter specifies the number of milliseconds before a keystroke is first repeated. The valid values for this parameter are 0 to 1000. The default is 660.

The following symbol definition specifies the delay for keystroke repetition:


Example


$ DECW$SERVER_KEY_REPEAT_DELAY == "800"
      

DECW$SERVER_KEY_REPEAT_INTERVAL

When using XKB, this parameter specifies the number of milliseconds between repeated keystrokes. The valid values for this parameter are 0 to 1000. The default is 40.

The following symbol definition specifies the interval for keystroke repetition:


Example


$ DECW$SERVER_KEY_REPEAT_INTERVAL == "20"
      

DECW$SERVER_XKEYBOARD_COMPILED_DIR

When using XKB, this parameter specifies the default directory for all compiled X keyboard files. This directory is also where the server places any keymap files that it compiles on demand. The default is SYS$COMMON:[SYS$KEYMAP.XKB.COMPILED].

The following symbol definition changes the root directory to SYS$COMMON:[SYS$KEYMAP.XKB.SERVER1]:


Example


$ DECW$SERVER_XKEYBOARD_COMPILED_DIR == "SYS$COMMON:[SYS$KEYMAP.XKB.SERVER1]"
      

DECW$SERVER_XKEYBOARD_DIRECTORY

When using XKB, this parameter specifies the default root directory for all X keyboard files. All component source X keyboard files are stored in subdirectories under this root directory. The default is DECW$SYSCOMMON:[SYS$KEYMAP.XKB].

The following symbol definition changes the root directory to SYS$COMMON:[SYS$KEYMAP.XKB]:


Example


$ DECW$SERVER_XKEYBOARD_DIRECTORY == "SYS$COMMON:[SYS$KEYMAP.XKB]"
      

DECW$SERVER_XKEYBOARD_LOAD_MAP

When using XKB, this parameter loads the X keyboard layout specified by DECW$SERVER_XKEYBOARD_MAP. The valid values for this parameter are 0 (disabled) or 1 (enabled). The default is 0. When this parameter is disabled, the DECwindows keyboard maps are used.

The following symbol definition loads the default DECwindows keyboard map file:


Example


$ DECW$SERVER_XKEYBOARD_LOAD_MAP == "1"
      

DECW$SERVER_XKEYBOARD_MAP

When using XKB, this parameter specifies the default X keyboard layout file for your keyboard. The default is DIGITAL_US_LK201. If the compiled layout file is not available in the area specified by DECW$SERVER_XKEYBOARD_COMPILED_DIR, the display server will attempt to compile the file on-demand based on data in the X keyboard components database.

The following symbol definition changes the X Keyboard layout to an alternate keyboard layout:


Example


$ DECW$SERVER_XKEYBOARD_MAP == "DIGITAL_US_LK401"
      


Previous Next Contents Index