# 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:

- Section 5.1, Customizing the DECwindows X11 Display Server Startup Procedure
- Section 5.2, Using the DECW$MOTIF_TAILOR Utility (VMS Version 5.5--2 Only)
- Section 5.3, Adding DECwindows Base-Support Files
- Section 5.4, Determining and Reporting Problems

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:

- Whether you have a 75-dpi or 100-dpi monitor
- Whether you have a North American keyboard layout (such as for an LK201--AA or --LA or an LK401--AA or --LA keyboard)
- Whether the DECwindows X11 display server uses only DECnet for OpenVMS software and local transports
- Whether the DECwindows X11 display server logs both successful and unsuccessful connect and disconnect messages to the DECW$SERVER_n_ERROR.LOG file

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:

- The first phase lists each class of DECwindows Motif files and asks whether you want to delete the class from the system disk.
- The second phase deletes the files you indicated from the system disk.

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