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.

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.

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.

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;* . . .