If you previously chose not to install or if you removed DECwindows base-support software, perform one of the following procedures to add DECwindows base-support files:

• On OpenVMS Alpha systems, reconfigure the operating system specifying that you want DECwindows Motif support.
• On OpenVMS VAX systems, use the SYS$UPDATE:DECW$TAILOR.EXE procedure to add or remove support files from the system disk.

To reconfigure the OpenVMS Alpha operating system to add DECwindows Motif support, use the PRODUCT RECONFIGURE command.

5.3.2 Using the SYS$UPDATE:DECW$TAILOR.EXE Command (VAX Only)

You can use the DECW$TAILOR utility to add or remove some or all DECwindows base-support files from the system disk.

DECW$TAILOR is similar to DECW$MOTIF_TAILOR. However, the DECW$TAILOR utility is used to add or remove files that support the DECwindows display server (for example: base-support, workstation, and font files).

DECW$TAILOR includes three phases:

• The first phase asks whether you want to tailor your system by adding files ("tailor on") or by deleting files ("tailor off").
• In the second phase, if you choose the tailor-on procedure, DECW$TAILOR lists each class of DECwindows files and asks whether you want to include them on the system disk. If you choose the tailor-off procedure, DECW$TAILOR lists each class of DECwindows files and asks whether you want to delete them from the system disk.
• In the third phase, DECW$TAILOR carries out your instructions.

Table 5-3 lists the classes and subclasses of DECwindows files that you can add or remove from your system using DECW$TAILOR.

Table 5-3 Classes of Files That Can Be Added or Removed with the DECW$TAILOR Utility

Class	Subclass	Description
DECwindows base support files (DECwindows applications files)	No subclasses in this tailor class	Files necessary to run the DECwindows Motif client and DECwindows display server.
DECwindows workstation support files (DECwindows device support files)	PEX for PHIGS support files	Files necessary to run the DECwindows display server; the PEX subclass includes support files for three-dimensional graphics.
75-dpi video font files	No subclasses in this tailor class	Device support files for 75-dpi monitors.
100-dpi video font files	No subclasses in this tailor class	Device support files for 100-dpi monitors.

Adding DECwindows Files to the System Disk

To add DECwindows files to the system disk, perform the following steps:

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

   $ RUN SYS$UPDATE:DECW$TAILOR

   
   After a brief overview, the DECW$TAILOR program 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 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 - DECwindows device support files Size of entire class (with subclasses): 14107 Size of common files required for any subclass: 10645 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 are needed to support your system. DECW$TAILOR displays step-by-step instructions. Follow these instructions to specify which of the classes or subclasses you want to add.

   Caution To cancel DECW$TAILOR during this phase, press Ctrl/C, Ctrl/Y, or Ctrl/Z. If you cancel DECW$TAILOR following this class selection phase, a partially tailored disk may result.

4. DECW$TAILOR creates a temporary command file and asks for the name of the device that contains the distribution media.

   Note The distribution media is the OpenVMS distribution media that contains the DECwindows save sets.

5. DECW$TAILOR adds the files you selected and displays the names of those files.

Example 5-2 shows how to use DECW$TAILOR to add files to a system disk. The example was run on a VMS 5.5--2 system.

Example 5-2 Sample DECW$TAILOR Session

$ RUN SYS$UPDATE:DECW$TAILOR . . . Do you want to tailor files "ON" or "OFF"? ON TAILOR-ON --------- 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 add a class or subclass to your system. Under some classes, there is a set of common files that is required in order for any subclasses to work. These files are added when you ask for either the entire class or any of its subclasses. Total size of the system disk is 1216665 blocks. Total space used on the system disk is 1121958 blocks. Total space left on the system disk is 94707 blocks. CLASS - DECwindows applications files Size of entire class (with subclasses): 11544 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? YES CLASS - DECwindows device support files Size of entire class (with subclasses): 14107 Size of common files required for any subclass: 10645 Do you wish to select the entire class (default = NO)? [Return] Do you wish to select any of its subclasses (default = NO)? [Return] CLASS - 75 dots per inch video font files Size of entire class (with subclasses): 2539 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? [Return] CLASS - 100 dots per inch video font files Size of entire class (with subclasses): 3829 No subclasses in this tailor class. Do you wish to select the entire class (default = NO)? [Return] CLASS - DECwindows programming support files Size of entire class (with subclasses): 26208 Size of common files required for any subclass: 924 Do you wish to select the entire class (default = NO)? [Return] Do you wish to select any of its subclasses (default = NO)? [Return] CLASS - Example files Size of entire class (with subclasses): 3160 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 add all of the options selected? YES Creating temporary command file, please wait... * Enter device containing DECwindows distribution media: . . .

5.4 Determining and Reporting Problems

If you encounter a problem while using DECwindows Motif, report it to Compaq. Review the Software Product Description (SPD) and Warranty Addendum for an explanation of warranty. If you encounter a problem during the warranty period, you can take one of the following actions:

• Call your Compaq support representative if your software contract or warranty agreement entitles you to telephone support.
• If you discover a problem with or have comments about the documentation, print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by Internet, fax, or mail. (See the Reader's Comments section in the Preface for addresses.)

This appendix contains sample installations of the DECwindows Motif Version 1.2-5 for OpenVMS software on OpenVMS Alpha Version 7.1, OpenVMS VAX Version 7.1, and OpenVMS Alpha Version 6.2 systems. Section A.1 presents a sample DECwindows Motif installation on an OpenVMS Alpha Version 7.1 operating system. Section A.2 presents a sample DECwindows Motif installation on an OpenVMS VAX Version 7.1 operating system. Section A.3 presents a sample DECwindows Motif installation on an OpenVMS Alpha Version 6.2 operating system. Refer to Chapter 2 for details about using the POLYCENTER Software Installation utility to install DECwindows Motif Version 1.2-5 for OpenVMS software.

The sample installations assume that you have set the default directory to the device name and directory containing the PCSI ECO and DECwindows Motif savesets. (The PCSI ECO is only required for the supported versions of OpenVMS prior to Version 7.2. See the Guide to the DECwindows Motif Version 1.2--5 for OpenVMS CD--ROM for details about this ECO.)

A.1 Sample Installation on an OpenVMS Alpha Version 7.1 System

Example A-1 Sample Installation of the Mandatory ECO for PCSI on an OpenVMS Alpha System

Welcome to the OpenVMS Alpha Operating System, Version 7.1 $ PRODUCT INSTALL VMS62TO71U2_PCSI [Return] The following product has been selected: DEC AXPVMS VMS62TO71U2_PCSI V1.0 Patch (maintenance update) Do you want to continue? [YES] [Return] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS VMS62TO71U2_PCSI V1.0 * This product does not have any configuration options. Execution phase starting ... The following product will be installed to destination: DEC AXPVMS VMS62TO71U2_PCSI V1.0 DISK$2:[VMS$COMMON.] Portion done: 0% ...10% ...20% ...40% ...50% ...80% ...90% ...100% The following product has been installed: DEC AXPVMS VMS62TO71U2_PCSI V1.0 Patch (maintenance update)

Example A-2 Sample Installation of an Upgrade of DECwindows Motif on an OpenVMS Alpha Version 7.1 System With Sufficient System Resources

$ PRODUCT INSTALL DWMOTIF [Return] The following product has been selected: DEC AXPVMS DWMOTIF V1.2-5 Layered Product Do you want to continue? [YES] [Return] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif Copyright Digital Equipment Corporation 1988, 1998. All rights reserved. Digital Equipment Corporation This product uses the PAK: DW-MOTIF Checking values of system parameters... OK Do you want the defaults for all options? [YES] [Return] Local Language Variants of DECwindows Motif must be upgraded at this time. Do you want to continue? [YES] [Return] Do you want to review the options? [NO] Y [Return] DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif DEC AXPVMS VMS V7.1 [Installed] Install New Desktop: YES Install Manual (reference) pages for the New Desktop: YES Make the New Desktop the default desktop: YES Install traditional DECwindows Desktop: YES Programming Support for the C Language: YES Programming Support for the Pascal Language: YES Programming Support for the FORTRAN Language: YES Programming Support for the New Desktop: YES Programming examples: YES Sound example files: YES Programming examples for DECwindows: YES Programming examples for the New Desktop: YES Translated Image Support: YES Are you satisfied with these options? [YES] [Return] Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF V1.2-5 DISK$2:[VMS$COMMON.] The following product will be removed from destination: DEC AXPVMS DWMOTIF V1.2-4 DISK$2:[VMS$COMMON.] Portion done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% **** DECwindows Motif application and run-time support files DETECTED **** **** DECwindows device support files DETECTED **** ...100% The following product has been installed: DEC AXPVMS DWMOTIF V1.2-5 Layered Product The following product has been removed: DEC AXPVMS DWMOTIF V1.2-4 Layered Product DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif System reboot will be required following upgrade of language variants. Installation Verification Procedure can be run after reboot. $ Logout [Return]

A.2 Sample Installation on an OpenVMS VAX Version 7.1 System

Example A-3 Sample Installation of an Upgrade of DECwindows Motif Version 1.2-5 for OpenVMS on an OpenVMS VAX Version 7.1 System With Insufficient System Resources

The following product has been selected: DEC VAXVMS DWMOTIF V1.2-5 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC VAXVMS DWMOTIF V1.2-5: DECwindows Motif Digital Equipment Corporation 1988, 1998. All rights reserved. Digital Equipment Corporation This product uses the PAK: DW-MOTIF Checking values of system parameters... %DECW-W-BADVALUE, SYSGEN parameter PQL_MBYTLM is 40000, should be at least 48000 The installation procedure has determined that some system parameter values require modification to install the DECwindows Motif Version 1.2-5 for OpenVMS software. Please type the following command to run AUTOGEN and reboot your system before restarting the DECwindows installation. This will set the system parameters to appropriate values for running DECwindows Motif V1.2-5. @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK The DECwindows installation is being terminated. Please run AUTOGEN and restart the installation. %PCSI-E-S_OPFAIL, operation failed %PCSIUI-E-ABORT, operation terminated due to an unrecoverable error condition SYSTEM logged out at 20-NOV-1998 17:03:49.25

At this point, run AUTOGEN and then restart the installation.

The following product has been selected: DEC VAXVMS DWMOTIF V1.2-5 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC VAXVMS DWMOTIF V1.2-5: DECwindows Motif Digital Equipment Corporation 1988, 1998. All rights reserved. Digital Equipment Corporation This product uses the PAK: DW-MOTIF Checking values of system parameters... OK Do you want the defaults for all options? [YES] Local Language Variants of DECwindows Motif must be upgraded at this time. Do you want to continue? [YES] Do you want to review the options? [NO]Y [Return] DEC VAXVMS DWMOTIF V1.2-5: DECwindows Motif DEC VAXVMS VMS V7.1 [Installed] DECwindows Motif runtime support files: YES Programming Support for the C Language: YES Programming Support for the FORTRAN Language: YES Programming Support for the Pascal Language: YES Programming examples: YES Are you satisfied with these options? [YES][Return] Execution phase starting ... The following product will be installed to destination: DEC VAXVMS DWMOTIF V1.2-5 DISK$VAX71_124_P2:[VMS$COMMON.] The following product will be removed from destination: DEC VAXVMS DWMOTIF V1.2-4 DISK$VAX71_124_P2:[VMS$COMMON.] Portion done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% **** DECwindows Motif application and run-time support files DETECTED **** **** DECwindows device support files DETECTED **** ...100% The following product has been installed: DEC VAXVMS DWMOTIF V1.2-5 Layered Product The following product has been removed: DEC VAXVMS DWMOTIF V1.2-4 Layered Product DEC VAXVMS DWMOTIF V1.2-5: DECwindows Motif System reboot will be required following upgrade of language variants. Installation Verification Procedure can be run after reboot. DEC VAXVMS DWMOTIF V1.2-5: DECwindows Motif System reboot will be required following upgrade of language variants. Installation Verification Procedure can be run after reboot.

A.3 Sample Installation on an OpenVMS Alpha Version 6.2 System

Example A-4 Sample Installation of the Mandatory ECO for PCSI on an OpenVMS Alpha System

The following product has been selected: DEC AXPVMS VMS62TO71U2_PCSI V1.0 Do you want to continue? [YES] [Return] *** DEC AXPVMS VMS62TO71U2_PCSI V1.0 %PCSIUI-I-DONEASK, execution phase starting The following product will be installed: DEC AXPVMS VMS62TO71U2_PCSI V1.0 %PCSI-I-VOLINFO, estimated space information for volume DISK$2 -PCSI-I-VOLSPC, -331 required; 2851892 available; 2852223 net Portion Done: 0% ...10% ...40% ...80% ...90% ...100% The following product has been installed: DEC AXPVMS VMS62TO71U2_PCSI V1.0

Example A-5 Sample Installation of an Upgrade of DECwindows Motif on an OpenVMS Alpha System With Insufficient System Resources

$ PRODUCT INSTALL DWMOTIF [Return] The following product has been selected: DEC AXPVMS DWMOTIF V1.2-5 Layered Product Do you want to continue? [YES] [Return] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif Copyright Digital Equipment Corporation 1988, 1998. All rights reserved. Digital Equipment Corporation This product uses the PAK: DW-MOTIF Checking values of system parameters... %DECW-W-BADVALUE, SYSGEN parameter GBLPAGES is 110000, should be at least 150000 %DECW-W-BADVALUE, SYSGEN parameter NPAGEDYN is 1867776, should be at least 1998848 The installation procedure has determined that some system parameter values require modification to install the DECwindows Motif Version 1.2-5 for OpenVMS software. Please type the following command to run AUTOGEN and reboot your system before restarting the DECwindows installation. This will set the system parameters to appropriate values for running DECwindows Motif V1.2-5. @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK The DECwindows installation is being terminated. Please run AUTOGEN and restart the installation. %PCSI-E-S_OPFAIL, operation failed %PCSIUI-E-ABORT, operation terminated due to an unrecoverable error condition

At this point, run AUTOGEN and then restart the installation.

The following product has been selected: DEC AXPVMS DWMOTIF V1.2-5 Layered Product Do you want to continue? [YES] [Return] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif Copyright Digital Equipment Corporation 1988, 1998. All rights reserved. Digital Equipment Corporation This product uses the PAK: DW-MOTIF Checking values of system parameters... OK Do you want the defaults for all options? [YES] [Return] Local Language Variants of DECwindows Motif must be upgraded at this time. Do you want to continue? [YES] [Return] Do you want to review the options? [NO] Y [Return] DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif DEC AXPVMS VMS V6.2-1H3 [Installed] Install New Desktop: YES Install Manual (reference) pages for the New Desktop: YES Make the New Desktop the default desktop: YES Install traditional DECwindows Desktop: YES Programming Support for the C Language: YES Programming Support for the Pascal Language: YES Programming Support for the FORTRAN Language: YES Programming Support for the New Desktop: YES Programming examples: YES Sound example files: YES Programming examples for DECwindows: YES Programming examples for the New Desktop: YES Translated Image Support: YES Are you satisfied with these options? [YES] [Return] Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DWMOTIF V1.2-5 DISK$2:[VMS$COMMON.] The following product will be removed from destination: DEC AXPVMS DWMOTIF V1.2-4 DISK$2:[VMS$COMMON.] Portion done: 0% ...10% ...20% ...30% ...40% ...50% ...60% ...70% ...80% ...90% **** DECwindows Motif application and run-time support files DETECTED **** **** DECwindows device support files DETECTED **** ...100% The following product has been installed: DEC AXPVMS DWMOTIF V1.2-5 Layered Product The following product has been removed: DEC AXPVMS DWMOTIF V1.2-4 Layered Product DEC AXPVMS DWMOTIF V1.2-5: DECwindows Motif System reboot will be required following upgrade of language variants. Installation Verification Procedure can be run after reboot.