HP OpenVMS Systems Documentation

HP DECwindows Motif for OpenVMS
Management Guide

Use the symbols in this section to modify mouse pointer characteristics. All the mouse pointer settings in this section are 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$SERVER_MOUSE_ACCELERATION

This parameter defines the relationship of mouse movement to pointer movement. The possible values are as follows:

• 2 (fast)
• 1 (medium)
• 0 (slow)

The following logical definition causes the pointer to move at the fast speed in relation to your mouse movements:

Example

$ DEFINE/SYSTEM DECW$SERVER_MOUSE_ACCELERATION 2
      

DECW$SERVER_MOUSE_THRESHOLD

This parameter defines the minimum motion of the mouse (in pixels) at which the DECwindows server is notified of the motion. The default is 4 pixels.

The following logical definition causes the mouse to be very sensitive to movement, resulting in the report of movement to the DECwindows server:

Example

$ DEFINE/SYSTEM DECW$SERVER_MOUSE_THRESHOLD 1
      

The display server uses a color database file to translate color names passed to the server from client applications into RGB values. Use the symbols in this section to modify color database characteristics.

DECW$RGBPATH

This parameter defines the RGB database filename to be used with the display server. The default name is SYS$MANAGER:DECW$RGB.DAT.

The following symbol definition changes the filename value to DECW$RGBPATH.DAT:

Example

$ DECW$RGBPATH == "SYS$MANAGER:DECW$RGBPATH.DAT"
      

The screen saver causes the monitor to go blank after a specified length of time (10 minutes by default) during which no user input occurs. Note that the actual value is specified in seconds.

Optionally, the server displays a black or white X of a random size and location on the screen when the screen saver timeout expires. A second parameter specifies the interval after which the screen saver pattern is repainted.

DECW$SERVER_SCREEN_SAVER_PREFER_BLANKING

This parameter determines the method by which screen saver is performed. When the value is True (the default), the DECwindows server causes the video device driver to turn off the video signal when the Screen Saver timeout expires. When the value is False, the DECwindows server blanks the screen when the timeout expires.

The following logical definition causes the screen to be cleared when the screen saver timeout expires:

Example

$ DEFINE/SYSTEM DECW$SERVER_SCREEN_SAVER_PREFER_BLANKING F
      

DECW$SERVER_SCREEN_SAVER_TIMEOUT

This parameter defines the initial time (in minutes) before the screen saver is activated, after which the screen saver interval takes effect. The default is 600 seconds (10 minutes).

The following logical definition causes the initial screen saver time to be 5 minutes:

Example

$ DEFINE/SYSTEM DECW$SERVER_SCREEN_SAVER_TIMEOUT 5
      

DECW$SERVER_SCREEN_SAVER_INTERVAL

This parameter defines the number of minutes the server waits before repainting the screen background. The screen saver rearranges the screen pixels to avoid burning the screen phosphor. Some servers use nonblanking screen savers, such as swimming fish or logos. The default is 600 seconds (10 minutes).

The following logical definition causes the background screen to be repainted in 7-minute intervals:

Example

$ DEFINE/SYSTEM DECW$SERVER_SCREEN_SAVER_INTERVAL 7
      

In general, it is the responsibility of the client application to restore occluded regions of the screen once they are exposed. However, the display server has several techniques available to perform this operation on behalf of the client. These are the backing store and save under options.

Backing store saves portions of windows in server memory just before they are obscured. Later, when the portions are exposed, the server can repaint them without involving the client. This can drastically reduce the time required to repaint, particularly for windows containing complex graphics or for environments where the client/server link is slow.

Save under is a similar mechanism where just prior to painting a window, the server saves the portion of the screen that is about to be obscured.

Both of these mechanisms are available by default and can be set on a window-by-window basis. Heavy use of these mechanisms does increase the memory requirements of the server. You may want to disable these features when debugging client applications to ensure that the application handles all expose events properly.

DECW$SERVER_DEFAULT_BACKING_STORE

You can enable this option in three types of window states. The following table lists possible values for the symbol and their meanings:

A True value for DECW$SERVER_DISABLE_BACKING_STORE causes the backing store option not to be used. The value for DECW$SERVER_DEFAULT_BACKING_STORE can be overridden in applications on a per-window basis.

The following logical definition causes the server to save and restore windows when the windows are mapped to the screen:

Example

$ DEFINE/SYSTEM DECW$SERVER_DEFAULT_BACKING_STORE 1
      

DECW$SERVER_DISABLE_BACKING_STORE

Use this parameter to disable backing store support. The default value is False so that backing store is enabled by default.

When DECW$SERVER_DISABLE_BACKING_STORE is set to True (disable backing store), restart the server, at which time the backing store option is disabled. Thereafter, to reenable backing store, deassign or redefine DECW$SERVER_DISABLE_BACKING_STORE and restart the server.

If your application window comes up blank, then the application is requesting backing store incorrectly and waiting for an expose event to begin processing. Either modify your application so that it does not request backing store, or set DECW$SERVER_DISABLE_BACKING_STORE to True, and restart the DECwindows display server.

The following symbol definition disables backing store:

Example

$ DECW$SERVER_DISABLE_BACKING_STORE == "T"
      

DECW$SERVER_DISABLE_SAVE_UNDER

The save under option records window information that may be hidden when another window is placed on top. You can disable this option by specifying True for this parameter.

The save under option is similar to the backing store option, but only the occluded portions of windows are saved by the server so that when that portion of the window becomes visible, the server redraws that portion of the window.

The following symbol definition disables the server's save under option:

Example

$ DEFINE/SYSTEM DECW$SERVER_DISABLE_SAVE_UNDER T
      

The display server creates a log file into which it writes informational and error messages to aid in troubleshooting problems. The log file is called SYS$MANAGER:DECW$SERVER_n_ERROR.LOG, where n is the server number (usually 0).

The display server uses a condition handler to trap error conditions (such as an access violation) that might otherwise cause the display server to stop. If the condition handler detects a nonfatal error, it tries to allow the display server to continue. The condition handler always records the error in the error log file. If the condition handler detects errors for a single client (2 by default), it disconnects the client.

When the condition handler recovers from an error, the display server may lose track of some resources, such as memory. Therefore, after a number of these exceptions (10 by default), the condition handler broadcasts a message to all users on the system indicating that the display server may be running in a degraded mode and suggests that the display server should be restarted. If you see a message like this, restart the display server at the next convenient opportunity. See Section 2.2 for instructions for restarting the server.

DECW$SERVER_AUDIT_LEVEL

This parameter controls whether normal client connect/disconnect messages are logged in the error log file. Valid values for this parameter are:

• 0 (disabled)
• 1 (enabled)
• 2 (enabled with success messages)
• 4 (enabled with security logging)

The default value is 0.

The following symbol definition enables minimal audit logging:

Example

$ DECW$SERVER_AUDIT_LEVEL == "1"
      

DECW$SERVER_BUG_COMPATIBILITY

Inconsistencies between pre--X11R4 servers and the X11 protocol allowed some undefined bits to be set in some X requests. By strictly enforcing this part of the protocol, however, some applications that set undefined bits no longer worked. By setting bug compatibility to True (default), the server will continue to allow these applications to work; however, the applications should be recoded to comply with the X11 protocol.

The following symbol definition allows pre--X11R4 servers and X11 protocol applications to function correctly:

Example

$ DECW$SERVER_BUG_COMPATIBILITY == "T"
      

DECW$SERVER_DUMP

Setting this parameter to True adds the /DUMP qualifier to the DCL RUN command, which causes a process dump if the server crashes. Specifying True also automatically disables the server condition handler (sets DECW$SERVER_DISABLE_CH to True).

The following logical definition adds the /DUMP qualifier to the DCL RUN command and disables the server condition handler:

Example

$ DEFINE DECW$SERVER_DUMP T
      

DECW$SERVER_ERROR_LOG_TO_KEEP

This parameter defines the number of versions of the error log file to save. The default is two versions.

The following symbol definition causes the DECwindows server to save the three most recent versions of the error log file:

Example

$ DECW$SERVER_ERROR_LOG_TO_KEEP == "3"
      

DECW$CLIENT_ERROR_THRESHOLD

This parameter defines the number of protocol errors generated by a single client above which the client will be terminated. The default is one protocol error.

The following logical definition causes the DECwindows display server to terminate a client after 10 or more protocol errors have been generated:

Example

$ DEFINE/SYSTEM DECW$CLIENT_ERROR_THRESHOLD 10
      

DECW$SERVER_ERROR_THRESHOLD

This parameter defines the total number of server errors allowed (10 by default) before reporting the following message:

Server internal runtime error threshold exceeded (code = %x),
server performance may be degraded.

The symbol %x is replaced by the condition code (in hexadecimal) that forced the error. The most typical value is "c", specifying an access violation.

The following message is also broadcast to all logged-in terminals:

DECW$SERVER_ERROR: internal runtime error threshold exceeded.
Performance may be degraded, restart DECwindows software when
convenient by @SYS$MANAGER:DECW$STARTUP RESTART.

After every five server errors that exceed the threshold, the following message is sent to the SYS$MANAGER:DECW$SERVER_0_ERROR.LOG log file and broadcast to terminals connected to the server:

Server performance still degrading...

Three categories of errors are handled by the condition handler of the server and are reported to the log file; where %d is decimal value and %x is hexadecimal value.

• Errors that count toward the client error threshold
  • If the error count is less than the client error threshold, the following error is reported:

    opcode %d is ignored due to internal runtime error %x for client %d (#error = %d)

  • If the error count equals or exceeds the client error threshold, the following error is reported:

    Client %d has made too many runtime errors %d, its connection is marked for termination

• Errors that disconnect a client

  Client %d has been disconnected due to unrecoverable runtime error %x detected while processing opcode %d

  
  Or, if the server is processing an opcode for a server extension, the following message is displayed:

  Exception trapped while processing extension opcode %d (extension id=%d)

• Errors that terminate the server

  Unrecoverable server internal error (error code = %d) found, terminating all connections. . . . List of active images and call chain at time of the error . . . ** SERVER INTERNAL RUNTIME ERROR ENCOUNTERED, SERVER HAS JUST CRASHED!! ** ********************************************

The following logical definition causes the DECwindows server to report a system degradation message after 20 server errors have accumulated:

Example

$ DEFINE/SYSTEM DECW$SERVER_ERROR_THRESHOLD 20
      

If DECW$PRIVATE_SERVER_SETUP.COM is placed in SYS$COMMON:[SYSMGR], symbols defined within the file apply to every system that shares that system disk, which is usually every member of a cluster.

To customize the DECwindows environment for all systems in an OpenVMS cluster, perform the following steps:

1. Copy the template file into SYS$COMMON:[SYSMGR]DECW$PRIVATE_SERVER_SETUP.COM.
2. Edit the command file and search for the section titled Cluster-Common or Standalone Workstation Setup. If no such section exists, search for node_list = "".
3. Add any customizations in this section.
4. Restart the DECwindows display server with the following command:

   $ @SYS$STARTUP:DECW$STARTUP RESTART

   
   You need to restart DECwindows on each system on which you want the customizations to take effect.

   Caution Restarting the DECwindows server disconnects all current client processes.

In some cases, one or more systems in a cluster have special server requirements. Use one of the following methods to customize specific systems in your cluster:

• Create a private copy of the DECW$PRIVATE_SERVER_SETUP.COM file and place it in SYS$SPECIFIC:[SYSMGR] on each system that you want customized.
• Use the node list facility in the DECW$PRIVATE_SERVER_SETUP.COM file, as follows:
  1. Edit the DECW$PRIVATE_SERVER_SETUP.COM and search for node_list = "".
  2. Add the nodes in your cluster between the quotation marks. For example:

     $ node_list = "NODE1/NODE2/NODE3"

  3. At the end of the command procedure, add a label and your system-specific definitions.

The following example shows how to customize NODE1, NODE2, and NODE3.

$!
$! server symbol definitions for NODE1
$!
$DO_NODE1:
$ DECW$SERVER_TRANSPORTS == "DECNET,LOCAL,TCPIP,LAT"
$ EXIT
$!
$! server symbol definitions for NODE2
$!
$DO_NODE2:
$ DECW$SERVER_DENSITY == "75"
$ EXIT
$!
$! server symbol definitions for NODE3
$!
$DO_NODE3:
$ DECW$DEFAULT_KEYBOARD_MAP == "US_LK201AA"
$ EXIT

This section lists the commands that you can use to determine the current server settings.

3.1.5.1 Displaying the Server Logical Name Table

You can use the DCL SHOW LOGICAL command to display all of the logical names in the server logical name table that are defined from symbols specified in the DECwindows startup process.

The following example shows how to enter the command and illustrates a typical display:

$ SHOW LOGICAL/TABLE=DECW$SERVER0_TABLE

(DECW$SERVER0_TABLE)

  "DECW$COLOR" = "TRUE"
  "DECW$DEFAULT_FONT" = "FIXED"
  "DECW$DEFAULT_KEYBOARD_MAP" = "NORTH_AMERICAN_LK401AA"
  "DECW$FONT" = "DECW$SYSCOMMON:[SYSFONT.DECW.USER_CURSOR32]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.CURSOR32]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.USER_CURSOR16]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.CURSOR16]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.USER_100DPI]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.100DPI]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.USER_75DPI]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.75DPI]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.USER_COMMON]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.COMMON]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.SPEEDO]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.TYPE1]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.USER_TYPE1]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.TRUETYPE]"
        = "DECW$SYSCOMMON:[SYSFONT.DECW.USER_TRUETYPE]"
  "DECW$KEYBOARD" = "OPA2:"
  "DECW$KEYMAP" = "DECW$SYSCOMMON:[SYS$KEYMAP.DECW.USER]"
        = "DECW$SYSCOMMON:[SYS$KEYMAP.DECW.SYSTEM]"
  "DECW$MONITOR_DENSITY" = "100"
  "DECW$POINTER" = "TTA0:"
  "DECW$RGBPATH" = "SYS$MANAGER:DECW$RGB.DAT"
  "DECW$SERVER_AUDIT_LEVEL" = "4"
  "DECW$SERVER_BUG_COMPATIBILITY" = "Y"
  "DECW$SERVER_DISABLE_BACKING_STORE" = "FALSE"
  "DECW$SERVER_DISABLE_CH" = "N"
  "DECW$SERVER_DISABLE_TEST" = "F"
  "DECW$SERVER_ENABLE_ACCESSX" = "0"
  "DECW$SERVER_EXTENSIONS" = "Xie"
        = "Multi-Buffering"
        = "Sec_Xag"
  "DECW$SERVER_KEY_REPEAT_DELAY" = "660"
  "DECW$SERVER_KEY_REPEAT_INTERVAL" = "40"
  "DECW$SERVER_SCREENS" = "GYA0"
  "DECW$SERVER_TRANSPORTS" = "DECNET"
        = "LOCAL"
        = "TCPIP"
        = "LAT"
  "DECW$SERVER_XKEYBOARD_COMPILED_DIR" = "SYS$COMMON:[SYS$KEYMAP.XKB.COMPILED]"
  "DECW$SERVER_XKEYBOARD_DIRECTORY" = "DECW$SYSCOMMON:[SYS$KEYMAP.XKB]"
  "DECW$SERVER_XKEYBOARD_LOAD_MAP" = "0"
  "DECW$SERVER_XKEYBOARD_MAP" = "DIGITAL_US_LK201"
  "DECW$SYSCOMMON" = "SYS$SYSROOT"
  "DECW$XPORT_LRP_SIZE" = "32768"
  "DECW$XSIZE_IN_PIXELS" = "1280"
  "DECW$YSIZE_IN_PIXELS" = "1024"