This chapter discusses the tasks that you need to perform after the DECwindows Motif installation is completed:

• Section 3.1, Starting the DECwindows Motif Software
• Section 3.2, Running the IVP
• Section 3.3, Choosing an Alternate Console
• Section 3.4, Selecting the Desktop

The DECwindows startup procedure runs automatically when the system reboots. Either the New Desktop login dialog box or the DECwindows desktop Start Session dialog box is displayed, depending on the value of the DECW$START_NEW_DESKTOP global symbol. (See Section 3.4 for more information.)

If the DW--MOTIF license that is installed on your system is not valid, appropriate messages display on your console terminal and DECwindows Motif is not automatically started. If this situation occurs, log in to the system, install the valid license, and start your DECwindows Motif software. For complete information on installing licenses using LMF, see the OpenVMS License Management Utility Manual. For information on starting DECwindows, see the chapter entitled "Starting DECwindows Motif" in Managing DECwindows Motif for OpenVMS Systems.

3.2 Running the IVP

Run the IVP, SYS$TEST:DECW$IVP.COM, after you install and start the DECwindows Motif product. This procedure contains six tests, which verify that the software installation is complete and accurate.

First, the IVP procedure attempts to run two display-oriented tests. When you invoke the IVP, it identifies your type of hardware.

• If you are using a workstation, you are asked where the display-oriented tests should display. Your current workstation is the default.
• If you are not using a workstation, the procedure prompts you for a display name.

Press Ctrl/Z at the prompt if you do not want to run the display-oriented tests. The IVP runs these tests only if the images exist on the system. If the IVP does not find the images, a message displays to inform you that the tests will not be run.

Next, if the display-oriented tests were selected and the display has been configured to support the LBX feature, the IVP repeats the same display-oriented tests using an LBX proxy server. For a description of how to configure support for the LBX feature, see the HP DECwindows Motif for HP OpenVMS Alpha New Features manual.

Finally, the IVP runs two nondisplay-oriented tests.

• The first of these tests invokes the Motif UIL compiler. If you did not install programming support, the IVP informs you that this test will not be run because the Motif UIL image does not exist. If this test is run, you are notified of its completion status.
• The last test converts a text file to DDIF format and then converts it back to text, comparing the original text file with the result. If the files match, the test is successful. You are notified of its completion status.

Example 3-1 shows you how to run the IVP.

Example 3-1 Sample IVP

$ @SYS$TEST:DECW$IVP Copyright 2003 Compaq Information Technologies Group, L.P. Compaq DECwindows Motif for OpenVMS Alpha Installation Verification Procedure (IVP) This IVP is intended to test some of the functionality of DECwindows Motif and to provide a quick method of verifying the installation. This machine is not a workstation. Please provide the nodename of a workstation on which to display the IVP tests. You must be sure that this account and node have security access to the display node, or the IVP will fail. To skip the display-oriented tests, press Ctrl/Z at the following prompt. _Display: NODE33::0.0 %DECW-I-IVP, The IVP will display on NODE33::0.0 %DECW-I-IVP, Running DECW$EXAMPLES:ICO.EXE for up to a minute. %DECW-I-IVP, Press Ctrl/Y to interrupt test. %DCL-S-SPAWNED, process DECW$IVP_ICO spawned %DECW-I-IVP, Running SYS$SYSTEM:DECW$CLOCK for up to a minute. %DECW-I-IVP, Press Ctrl/Y to interrupt test. %DCL-S-SPAWNED, process DECW$IVP_CLOCK spawned %DECW-I-IVP, Server does not support LBX. Proxy test skipped. %DECW-I-IVP, Invoking the UIL Motif compiler... %DECW-S-IVP, The UIL Motif compiler test completed successfully. %DECW-I-IVP, Beginning CONVERT/DOCUMENT IVP... %DECW-S-IVP, CONVERT/DOCUMENT IVP passed. %DECW-S-IVP, The IVP has completed. $

If the server supports LBX proxies, the following messages are displayed instead of the Server does not support LBX message shown in the preceding example:

%DECW-I-IVP, LBX Proxy tests, test will execute through a proxy %DECW-I-IVP, Running DECW$EXAMPLES:ICO.EXE for up to a minute. %DECW-I-IVP, Press Ctrl/Y to interrupt test. %DCL-S-SPAWNED, process DECW$IVP_LBX spawned PROXY_MANAGER=local/MISATO:9999 $ lbxproxy %DECW-I-ATTACHED, transport TCPIP attached to its network %DECW-I-ATTACHED, transport DECNET attached to its network %DCL-S-SPAWNED, process DECW$IVP_ICO spawned %DECW-I-IVP, Running SYS$SYSTEM:DECW$CLOCK for up to a minute. %DECW-I-IVP, Press Ctrl/Y to interrupt test. %DCL-S-SPAWNED, process DECW$IVP_CLOCK spawned

3.3 Choosing an Alternate Console

The DECwindows Motif software allows you to boot all configurations from the main console. You can then toggle between displaying and not displaying the operator window by pressing Ctrl/F2. The main console is always a workstation screen.

If you are logged in to the main console (workstation screen), you must log out before DECwindows will start. Issue the following command from the main console:

$@SYS$MANAGER:DECW$STARTUP

Once the command procedure completes, log out of the main console. Otherwise the server will not start and a login box will not appear.

For an alternative console, you can use a terminal connected to the workstation by means of a terminal port.

If you boot from the main console, the alternative console is connected when you invoke the DECwindows Motif startup command procedure.

If you boot the system from an alternative console, you cannot start the Console Window application. This application is described in the release notes.

3.4 Selecting the Desktop

DECwindows Motif provides a choice of two desktops: the New Desktop, which is derived from the Common Desktop Environment (CDE), and the traditional DECwindows desktop.

During the installation, if you choose to install both the New Desktop and the DECwindows desktop, you are asked which desktop you wish to be the default desktop.

To select the other desktop as the default desktop, perform the following steps.

1. If the file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM does not exist, copy it from DECW$PRIVATE_APPS_SETUP.TEMPLATE (or create it if an earlier version of DECwindows Motif has not been installed on your system). For example:

   $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE - _$ SYS$COMMON:[SYSMGR]DECW$PRIVATE_APPS_SETUP.COM

2. Edit SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM and add a symbol definition for DECW$START_NEW_DESKTOP. If you wish the New Desktop as the default enter the following global symbol definition:

   $ DECW$START_NEW_DESKTOP == "TRUE"

   
   If you want the DECwindows desktop as the default, enter the following global symbol definition:

   $ DECW$START_NEW_DESKTOP == "FALSE"

3. Restart DECwindows using the following command:

   $ @SYS$MANAGER:DECW$STARTUP RESTART

After you install the HP DECwindows Motif for HP OpenVMS Alpha product, you can tune your system to enhance performance, decrease the use of some system resources, and specify certain server settings. This chapter contains information about setting up your DECwindows Motif environment. See Managing DECwindows Motif for OpenVMS Systems and HP DECwindows Motif for HP OpenVMS Alpha New Features for additional system management information.

The following topics are discussed in this chapter:

• Section 4.1, Customizing the DECwindows X11 Display Server Startup Procedure
• Section 4.2, Determining and Reporting Problems

4.1 Customizing the DECwindows X11 Display Server Startup Procedure

• List of screens associated with this server
• Font, resolution, and color capabilities for each screen
• Layout of the keyboard (such as, LK201--AA or LK401--AA)
• Appropriate network transport
• List of valid font servers and whether to active the font server on this system
• Level of auditing for client connections
• List of X server extensions to activate (such as, XINERAMA, SECURITY, or XKB)
• Current security policy (if using SECURITY)
• Current location of X authority file
• List of users that have trusted access to this server
• Number and order of screens in a multihead configuration (if using XINERAMA)
• X keyboard layout and related options (if using XKB)

You can specify these display server settings by modifying 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.
2. Edit the file to add or change the desired setup options in either of two sections in the server startup file. Details on these options are available from Managing DECwindows Motif for OpenVMS Systems, HP DECwindows Motif for HP OpenVMS Alpha New Features, and the file itself. 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.
3. Restart DECwindows Motif on the workstations for which you customized the server startup using the following command:

   $ @SYS$MANAGER:DECW$STARTUP RESTART

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

• Call your HP 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 a sample installation of the DECwindows Motif software on the OpenVMS Alpha Version 7.3-1 operating system.

Refer to Chapter 2 for details about using the POLYCENTER Software Installation utility to install DECwindows Motif software.

The sample installation assumes that you have set the default directory to the device name and directory containing the DECwindows Motif saveset, as well as any necessary ECOs.

A.1 Sample Installation on an OpenVMS Alpha Version 7.3-1 System

Example A-1 Sample Installation of an Upgrade of the DECwindows Motif Software on an OpenVMS Alpha Version 7.3-1 System With Sufficient System Resources

$ PRODUCT INSTALL DWMOTIF [Return] The following product has been selected: DEC AXPVMS DWMOTIF V1.3-0 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.3-0: DECwindows Motif Copyright 2003 Compaq Information Technologies Group, L.P. Compaq Computer Corporation This product uses the PAK: DW-MOTIF Checking values of system parameters... OK DECWindows Motif V1.3-0 cannot be uninstalled. The DECwindows Motif for OpenVMS Alpha Version 1.3 software upgrade also updates certain images that are part of the OpenVMS Alpha operating system. Removing the DECwindows Motif Version 1.3 product (using PRODUCT REMOVE) does not restore the operating system images to their proper state. To revert to a previous version of DECwindows Motif, you must first reinstall the OpenVMS Alpha operating system and then install the appropriate version of DECwindows Motif. Be sure that you want to install the DECwindows Motif Version 1.3 software before proceeding. Do you want the defaults for all options? [YES] [Return] If a Local Language Variant is installed, refer to the Installation Guide. Do you want to continue? [YES] [Return] Do you want to review the options? [NO] Y [Return] DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif DEC AXPVMS VMS V7.3-1 [Installed] Install the DECwindows Motif Euro sign support: NO Install Low Bandwidth X (LBX) Support: YES Install the DECwindows Motif V1.3-0 client software: YES 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.3-0 DISK$2:[VMS$COMMON.] The following product will be removed from destination: DEC AXPVMS DWMOTIF V1.2-6 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.3-0 Layered Product The following product has been removed: DEC AXPVMS DWMOTIF V1.2-6 Layered Product DEC AXPVMS DWMOTIF V1.3-0: DECwindows Motif System reboot is required. Installation Verification Procedure can be run after reboot. $ Logout [Return]

If you installed DECwindows Motif using the POLYCENTER Software Installation utility, you can obtain a list of all installed files and the directories and subdirectories into which the files were installed.

To obtain this list, enter the following POLYCENTER Software Installation utility command:

$ PRODUCT SHOW OBJECT/product=dwmotif

Following is a sample output from this command.

OBJECT OBJECT TYPE STATUS ------ ----------- ------ [000000] directory OK [000000]DEC-AXPVMS-DWMOTIF-V0103-1.PCSI$DESCRIPTION file OK [000000]DEC-AXPVMS-DWMOTIF-V0103-1.PCSI$TLB file OK [CDA$LIBRARY] directory OK [CDA$LIBRARY]CL_DAY.DOC_STYLE file OK [CDA$LIBRARY]DEFSTYLE.DDIF file OK [CDE$DEFAULTS] directory OK [CDE$DEFAULTS] directory OK [CDE$DEFAULTS.SYSTEM] directory OK [CDE$DEFAULTS.SYSTEM] directory OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS] directory OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C] directory OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DT.DAT file OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCALC.DAT file OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTCREATE.DAT file OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTFILE.DAT file OK [CDE$DEFAULTS.SYSTEM.APP-DEFAULTS.C]DTHELLO.DAT file OK . . .