Compaq DECwindows Motif
for OpenVMS
Installation Guide


Previous Contents Index


Chapter 5
Managing DECwindows Motif Software

This chapter contains information about managing the performance of your Compaq DECwindows Motif for OpenVMS software. It also describes how to add and remove DECwindows Motif files from your system disk using tailoring utilities. See Managing DECwindows Motif for OpenVMS Systems for additional system management information.

The following topics are discussed in this chapter:

After you install the Compaq DECwindows Motif for OpenVMS product, you can tune your system to enhance performance or to decrease the use of some system resources. For information about tuning your system, see Managing DECwindows Motif for OpenVMS Systems.

5.1 Customizing the DECwindows X11 Display Server Startup Procedure

The DECwindows X11 display server manages the graphics devices on your workstation, such as the display, keyboard, and mouse.

Note

Start the DECwindows X11 display server on workstation systems only.

The startup command procedures automatically determine most of the configuration parameters for the DECwindows X11 display server. However, the command procedures cannot determine some items, such as the following:

To ensure that the DECwindows X11 display server is set up correctly, modify the server startup file as follows:

  1. Make a copy of the file SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.TEMPLATE and rename it to SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM. This server startup file shows how to customize individual workstations by adding a section of DCL commands for each workstation. You can add setup options in either of two sections in the server startup file. Setup options added to the Cluster Common or Standalone Workstation Setup section affect all nodes in a cluster. Setup options added to the Cluster Member Workstation-Specific Setup section affect only individual nodes. If you add a workstation-specific option, you must also update the variable node_list.
  2. If your screen supports 100 dots-per-inch, add the following line:


    $ DECW$SERVER_DENSITY == "100" 
    

    Add this line to the section for each workstation that has a 100 dots-per-inch monitor, or add it to the common section for all workstations (if all the workstations have 100-dpi monitors).

  3. If you want the server to log successful connect and disconnect messages, add the following line:


    $ DECW$SERVER_CONNECT_LOG == "TRUE" 
    

  4. Add the following line to the section for monochrome GPX workstations:


    $ DECW$COLOR == "FALSE" 
    

    No modification is necessary for grayscale (intensity) screens.

  5. Add the following line to the section for workstations with keyboards that are not North American LK201 models:


    $ DECW$DEFAULT_KEYMAP == "xxxxx" 
    

    In the previous line, replace xxxxx with the correct DECwindows keymap name. You can determine the correct name from the model number of your LK201 or LK401 keyboard. Turn the keyboard upside down and look for a label that specifies the model number. The model number is in a format similar to LK201--xx or LK401--xx. The model number may also be listed as LK201 or LK401. In this case, the xx that you need is in another part of the label where there is a number that looks similar to the following:


    nn-nnnnn-xx
    

    Use the xx part of this number to choose a keymap name from Table 5-1. Choose the keymap ending in _DP for data-processing keyboard layout and the keymap ending in _TW for typewriter layout.
    Table 5-1 is arranged according to the dialect for which each keyboard is designed.
    After you choose a keymap name, modify the DECwindows X11 display server startup file. For example, to change the keyboard layout to a Dutch typewriter layout, add the following line to the DECwindows X11 display server startup file:


    $ DECW$DEFAULT_KEYBOARD_MAP == "DUTCH_LK201LH_TW" 
    

    Add a similar line for each workstation that does not have a North American keyboard layout or add the line to the common section for all workstations (if all the workstations use the same keyboard layout).

  6. Enter the following command to restart DECwindows Motif on the workstations for which you customized the server startup by using the following command:


    $ @SYS$MANAGER:DECW$STARTUP RESTART
    

Table 5-1 DECwindows Keymap
Dialect Model DECwindows Keymap
Austrian/German LK201-(AG,LG,BG,MG) AUSTRIAN_GERMAN_LK201LG_DP
    AUSTRIAN_GERMAN_LK201LG_TW
  LK201-(NG,PG) AUSTRIAN_GERMAN_LK201NG_DP
    AUSTRIAN_GERMAN_LK201NG_TW
  LK401-(AG) AUSTRIAN_GERMAN_LK401AG_TW
Belgian/French LK201-(AP,LP,BP,MP) BELGIAN_FRENCH_LK201LP_DP
    BELGIAN_FRENCH_LK201LP_TW
Belgian/French LK401-(AP) BELGIAN_FRENCH_LK401AP_DP
    BELGIAN_FRENCH_LK401AP_TW
British LK201-(AE,LE,BE,ME) BRITISH_LK201LE_DP
    BRITISH_LK201LE_TW
British LK401-(AA,PA) BRITISH_LK401AA_DP
    BRITISH_LK401AA_TW
Canadian/French LK201-(AC,LC,BC,MC) CANADIAN_FRENCH_LK201LC_DP
    CANADIAN_FRENCH_LK201LC_TW
Canadian/French LK401-(AC,LC,BC,MC) CANADIAN_FRENCH_LK401AC_DP
    CANADIAN_FRENCH_LK401AC_TW
Danish LK201-(AD,LD,BD,MD) DANISH_LK201LD_DP
    DANISH_LK201LD_TW
  LK201-(ED,RD,FD) DANISH_LK201RD_DP
    DANISH_LK201RD_TW
Danish LK401-(AD,LD,BD,MD) DANISH_LK401AD_DP
    DANISH_LK401AD_TW
Dutch LK201-(AH,LH,BH,MH) DUTCH_LK201LH_DP
    DUTCH_LK201LH_TW
  LK201-(NH,PH) DUTCH_LK201NH
  LK401-(NH,PH) DUTCH_LK401AH
Finnish LK201-(AF,LF,BF,MF) FINNISH_LK201LF_DP
    FINNISH_LK201LF_TW
  LK201-(NX,PX) FINNISH_LK201NX_DP
    FINNISH_LK201NX_TW
Finnish LK401-(AF,LF,BF,MF) FINNISH_LK401AF_DP
    FINNISH_LK401AF_TW
Flemish LK201-(AB,LB,BB,MB) FLEMISH_LK201LB_DP
    FLEMISH_LK201LB_TW
Flemish LK401-(AB,LB,BB,MB) FLEMISH_LK401AB_DP
    FLEMISH_LK401AB_TW
Icelandic LK201-(AU,LU,BU,MU) ICELANDIC_LK201LU_DP
    ICELANDIC_LK201LU_TW
Italian LK201-(AI,LI,BI,MI) ITALIAN_LK201LI_DP
    ITALIAN_LK201LI_TW
Italian LK401-(AI,LI,BI,MI) ITALIAN_LK401AI_DP
    ITALIAN_LK401AI_TW
North American LK201-(AA,LA,BA,MA) NORTH_AMERICAN_LK201LA
North American LK401-(AA,LA,BA,MA) NORTH_AMERICAN_LK401AA
Norwegian LK201-(AN,LN,BN,MN) NORWEGIAN_LK201LN_DP
    NORWEGIAN_LK201LN_TW
  LK201-(EN,RN,FN) NORWEGIAN_LK201RN_DP
    NORWEGIAN_LK201RN_TW
Norwegian LK401-(AN,LN,BN,MN) NORWEGIAN_LK401AN_DP
    NORWEGIAN_LK401AN_TW
Portuguese LK201-(AV,LV,BV,MV) PORTUGUESE_LK201LV
Portuguese LK401-(AV,LV,BV,MV) PORTUGUESE_LK401AV
Spanish LK201-(AS,LS,BS,MS) SPANISH_LK201LS_DP
    SPANISH_LK201LS_TW
Spanish LK401-(AS,LS,BS,MS) SPANISH_LK401AS_DP
    SPANISH_LK401AS_TW
Swedish LK201-(AM,LM,BM,MM) SWEDISH_LK201LM_DP
    SWEDISH_LK201LM_TW
  LK201-(NM,PM) SWEDISH_LK201NM_DP
    SWEDISH_LK201NM_TW
Swedish LK401-(AM,LM,BM,MM) SWEDISH_LK401AM_DP
    SWEDISH_LK401AM_TW
Swiss/French LK201-(AK,LK,BK,MK) SWISS_FRENCH_LK201LK_DP
    SWISS_FRENCH_LK201LK_TW
Swiss/French LK401-(AK,LK,BK,MK) SWISS_FRENCH_LK401AK_DP
    SWISS_FRENCH_LK401AK_TW
Swiss/German LK201-(AL,LL,BL,ML) SWISS_GERMAN_LK201LL_DP
    SWISS_GERMAN_LK201LL_TW
Swiss/German LK401-(AL,LL,BL,ML) SWISS_GERMAN_LK401AL_DP
    SWISS_GERMAN_LK401AL_TW
Combined US/UK LK201-(EE,RE,PE) UK_LK201RE
    US_LK201RE
Combined US/UK LK401-(EE,RE,PE) UK_LK401AA
    US_LK401AA

5.2 Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5--2 Only)

Use the DECW$MOTIF_TAILOR utility to remove DECwindows Motif files from the system disk (for example, support files for the Toolkit, applications, and programming). If you later decide that you want DECwindows Motif programming support, add the files to the system disk by reinstalling the system. See Section 5.3 for information about adding files.

Note

Use the DECW$MOTIF_TAILOR utility only if you installed the DECwindows Motif for OpenVMS kit using VMSINSTAL. If you installed the Compaq DECwindows Motif for OpenVMS kit using the POLYCENTER Software Installation utility (PCSI), remove files using the PCSI commands PRODUCT REMOVE or PRODUCT RECONFIGURE. (For more information on PCSI commands, enter HELP PRODUCT at the DCL prompt or refer to the POLYCENTER Software Installation Utility User's Guide.)

The DECW$MOTIF_TAILOR process includes two phases:

Table 5-2 lists the classes (or groups) and subclasses of DECwindows Motif files that you can delete using the DECW$MOTIF_TAILOR utility. For a list of DECwindows Motif files and their descriptions and classes, see Appendix C.

Table 5-2 Classes of OpenVMS Files That Can Be Removed with the DECW$MOTIF_TAILOR Utility
Class Subclass Description
VMS DECwindows run-time support No subclasses in this tailor class DECwindows Motif run-time support.
VMS DECwindows CDA support No subclasses in this tailor class DECwindows Motif CDA support.
VMS DECwindows Motif applications files DECwindows Motif computer-based instruction (CBI) The DECwindows Motif applications files provide a variety of applications.
DECwindows Motif C programming support files No subclasses in this tailor class DECwindows Motif C programming support files are needed only to develop applications and are not required to run DECwindows Motif applications. These files are provided for programming in the C language using conventions and standards developed at the Massachusetts Institute of Technology (MIT).
DECwindows FORTRAN programming support files No subclasses in this tailor class FORTRAN support files are provided for this programming language. The files are needed only to develop applications and are not required to run DECwindows Motif applications.
DECwindows Pascal programming support files No subclasses in this tailor class Pascal support files are provided for this programming language. The files are needed only to develop applications and are not required to run DECwindows Motif applications.
DECwindows Motif example files No subclasses in this tailor class DECwindows Motif example files.
Sound editor support files No subclasses in this tailor class Sound-editor support files.
NCSA Mosaic No subclasses in this tailor class NCSA Mosaic web browser.

Removing DECwindows Motif Files from the System Disk

To remove DECwindows Motif files from the system disk, do the following:

  1. Log in to the SYSTEM account.
  2. Enter the following command at the DCL prompt:


    $ RUN SYS$UPDATE:DECW$MOTIF_TAILOR
    

    After a brief overview, the DECW$MOTIF_TAILOR utility lists each group, or class, of files and its size in blocks. Files are grouped according to their function. For example, all the files required for DECwindows for OpenVMS device support are in one class. A file class is made up of many small subclasses. You can eliminate an entire class of files, or you can eliminate one or more of its subclasses. For example:


    CLASS - VMS DECwindows Motif applications files 
                 Size of entire class (with subclasses): 12181 
                 Size of common files required for any subclass: 11160 
                 Do you wish to select the entire class (default = NO)? 
                 Do you wish to select any of its subclasses (default = NO)?
              .
              .
              .
    

  3. Decide which file classes or subclasses you do not need to support your system. The DECW$MOTIF_TAILOR utility displays step-by-step instructions. Follow these instructions to specify which of the classes or subclasses you want to remove.
  4. The DECW$MOTIF_TAILOR utility deletes the files you select and displays the names of those files.

You can ignore "file not found" messages in the log files; tailoring functions are not affected by these messages. The installation procedure deletes files that it does not read.

Caution

To cancel DECW$MOTIF_TAILOR during the first phase, press Ctrl/C, Ctrl/Y, or Ctrl/Z. If you cancel DECW$MOTIF_TAILOR during the second phase, a partially tailored disk may result. For a description of both phases, see Section 5.2.

Example 5-1 shows how to use DECW$MOTIF_TAILOR to remove files from a system disk.

Example 5-1 Sample DECW$MOTIF_TAILOR Session

$ RUN SYS$UPDATE:DECW$MOTIF_TAILOR
   .
   .
   .
TAILOR-OFF 
---------- 
 You will now be prompted with a list of the classes and subclasses of 
 DECwindows files that are optional. The size of each class and subclass is 
 included in the list. This will help you decide whether or not you want to 
 remove a class or subclass from your system. 
 
 Under some classes there is a set of common files that is required in order 
 for any subclasses to work. These files will only be deleted if you remove 
 the ENTIRE class. If you choose to keep any subclass, this set of files is 
 not deleted. 
 
 NOTE: The files associated with selected classes and subclasses will 
       be removed from your system. 
 
 
Total size of the system disk is 2050860 blocks. 
Total space used on the system disk is 684720 blocks. 
Total space left on the system disk is 1366140 blocks. 
 
 
CLASS - VMS DECwindows Runtime Support 
          Size of entire class (with subclasses): 27303 
          No subclasses in this tailor class. 
          Do you wish to select the entire class (default = NO)? [Return]
CLASS - VMS DECwindows CDA Support 
          Size of entire class (with subclasses): 3625 
          No subclasses in this tailor class. 
          Do you wish to select the entire class (default = NO)? Yes
CLASS - VMS DECwindows Motif applications files 
          Size of entire class (with subclasses): 12181 
      Size of common files required for any subclass: 11160
      Do you wish to select the entire class (default = NO)? [Return]
      Do you wish to select any of its subclasses (default = NO)? [Return]
 
CLASS - DECwindows C programming support files 
          Size of entire class (with subclasses): 6727
      No subclasses in this tailor class. 
          Do you wish to select the entire class (default = NO)? Yes
 
CLASS - DECwindows FORTRAN programming support files 
          Size of entire class (with subclasses): 2404
      No subclasses in this tailor class. 
          Do you wish to select the entire class (default = NO)? Yes
 
CLASS - DECwindows Pascal programming support files 
          Size of entire class (with subclasses): 3009
      No subclasses in this tailor class. 
          Do you wish to select the entire class (default = NO)? [Return]
CLASS - DECwindows Motif example files 
          Size of entire class (with subclasses): 9535
      No subclasses in this tailor class. 
          Do you wish to select the entire class (default = NO)? Yes
CLASS - Sound editor support files 
          Size of entire class (with subclasses): 1776
      No subclasses in this tailor class. 
          Do you wish to select the entire class (default = NO)? Yes
 
 
CLASS - NCSA Mosaic 
          Size of entire class (with subclasses): 1168
      No subclasses in this tailor class. 
          Do you wish to select the entire class (default = NO)? [Return]
 
Files have been selected 
Do you wish to remove all of the options selected? [Return]
Do you wish to remove all of the options selected? Yes
Removing files, please wait... 
%VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[CDA$LIBRARY]DEFSTYLE.DDIF;* 
%VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$CSW.UID;* 
%VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEW.UID;* 
%VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEWWGT.UID;* 
%VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[DECW$DEFAULTS.SYSTEM]DDIF$VIEWWGT12.UID;* 
%VMSTLR-I-DELFILE, deleting file: SYS$SYSROOT:[SYSEXE]CDA$CONVERT.EXE;* 
. 
. 
.


Previous Next Contents Index