HP OpenVMS Systems Documentation

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 Installation Verification Procedure (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.

3.2.1 Starting the Procedure

To start the IVP procedure, invoke the SYS$TEST:DECW$IVP command procedure. The dialog begins with a brief introduction.

$ @SYS$TEST:DECW$IVP
Copyright 2003 Hewlett-Packard Development Company, L.P.

HP 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.

$ SET DISPLAY/CREATE/NODE=LAT_nnnnnnnnnnnn/TRANSPORT=LAT

Next, the IVP procedure attempts to run two display-oriented tests. Whether these tests are run and how they are run depends on your hardware and on the availability of the test images.

• If the test images exist and you are invoking the tests from a workstation, you are asked where the display-oriented tests should display. Your current workstation is usually the default display. The default display is usually taken from the value of the DECW$DISPLAY logical associated with the process running the IVP. The logical can point to either a local or remote display server.
• If the test images exist and you are not using a workstation, the procedure indicates that you need to enter a node name at the _Display: prompt. In this case, the DECW$DISPLAY logical is not defined, therefore there is no default display. For example, if you use the SET HOST command to access a system and do not define the DECW$DISPLAY logical, the IVP does not know if you are on a workstation. In this case, you enter the name of the node where you wish the display to occur.
• If the IVP does not find the images, a message displays to inform you that the tests will not be run.

Press Ctrl/Z at the prompt if you do not want to run the display-oriented tests.

The following example shows the display test dialog on a workstation system. The display device _WSA150 could be either a local display or a remote display.

To skip the display-oriented tests, press Ctrl/Z at the following prompt.

_Display:[_WSA150:]:
%DECW-I-IVP, The IVP will display on WSA150:
%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

The following partial example shows the test being run on a non-workstation system.

This machine is not a workstation.  Please provide the node name 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
%DECW-I-IVP, The IVP will display on NODE33::0.0

The remainder of the dialog is identical to the workstation example.

3.2.3 LBX IVP Tests

Next, if the display-oriented tests were selected and the required images are available, the procedure attempts to run the LBX proxy tests. The dialog's display of the test results depends on whether a display name or node name was entered in the previous dialog section, if a display name was entered whether the display is local or remote, and, if a local display, whether the display has been properly configured to support the LBX test. The following list describes the IVP's actions in each of several possible cases.

• If the display entered in the first part of the IVP dialog is a local display and the display server has been configured to support the LBX and SECURITY features and the IVP process has the required privileges, the IVP displays the following messages.

  %DECW-I-IVP, LBX Proxy tests, tests 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 Using port number '50' %DCL-S-SPAWNED, process DECW$IVP_ICO spawned %DECW-I-IVP, End of LBX Proxy tests

• If the display entered in the first part of the dialog is a remote display, the procedure is unable to determine if the display server supports the LBX and SECURITY features. The dialog issues a message warning you that the tests will fail if the remote server is not properly configured. The following example shows the LBX portion of the IVP after a remote display has been selected and the process running the IVP has the required privileges. If the remote server is properly configured, the remainder of the LBX portion of the dialog is identical to the first case in this list. If the remote server is not properly configured, the LBX test (and the IVP) will fail.

  The LBX tests can only be executed if the display server has been configured to support the LBX and SECURITY extensions and this account has permission to generate cookies. Normally, remote servers will not give that permission and the LBX tests cannot be executed. Answer "NO" at the following prompt to skip the LBX tests. Execute LBX test? YES

• If the display entered in the first part of the IVP dialog is a local display and the display server has been configured to support the LBX and SECURITY features but the process running the IVP does not have the required privileges, the IVP displays the following message.

  %DECW-I-IVP, No privilege to execute LBX part of test. Proxy test skipped.

• If the display entered in the first part of the IVP dialog is a local display and the display server has not been configured to support the LBX feature, the IVP displays the following message.

  %DECW-I-IVP, Server does not support LBX extension. Proxy test skipped.

• If the display entered in the first part of the IVP dialog is a local display and the display server has not been configured to support the SECURITY feature, the IVP displays the following message.

  %DECW-I-IVP, Server does not support SECURITY extension. Proxy test skipped.

• If a node name is entered in the first part of IVP dialog instead of a display name, the IVP displays the following message.

  %DECW-I-IVP, LBX Proxy tests need a display device. Proxy test skipped.

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.

The following example shows the IVP output for the final two tests.

%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.
$

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 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 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, Adding DECwindows Base-Support Files
• Section 4.3, 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 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 previously chose not to install or if you removed DECwindows base-support software, reconfigure the operating system specifying that you want DECwindows Motif support.

4.2.1 Reconfiguring the OpenVMS Operating System

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

4.3 Determining and Reporting Problems

If you encounter a problem while using DECwindows Motif, report it to HP. Review the DECwindows Motif for OpenVMS Alpha Version 1.3-1 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--2 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--2 System

$ PRODUCT INSTALL DWMOTIF [Return]

The following product has been selected:
    DEC AXPVMS DWMOTIF V1.3-1              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-1: DECwindows Motif

    Copyright 2003 Hewlett-Packard Development Company, L.P.

    Hewlett-Packard Company

    This product uses the PAK: DW-MOTIF

Checking values of system parameters...

                                       OK


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-1: DECwindows Motif
    DEC AXPVMS VMS V7.3-2 [Installed]

    Install Low Bandwidth X (LBX) Support: YES
    Install the DECwindows Motif V1.3-1 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-1              DISK$2:[VMS$COMMON.]
The following product will be removed from destination:
    DEC AXPVMS DWMOTIF V1.3-0              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-1              Layered Product
The following product has been removed:
    DEC AXPVMS DWMOTIF V1.3-0              Layered Product

DEC AXPVMS DWMOTIF V1.3-1: DECwindows Motif

    System reboot is required.

    Installation Verification Procedure can be run after reboot.
$ Logout [Return]