# Compaq DECwindows Motif
for OpenVMS
Installation Guide

Previous | Contents | Index

## 3.2.15 Using the AUTOGEN Utility to Set System Parameters

The installation procedure might automatically run AUTOGEN, depending on which type of system you are using:

- A nonworkstation system
  If you install Compaq DECwindows Motif for OpenVMS on a nonworkstation system (that is, an OpenVMS host system), the following message is displayed:

      This system is not a workstation.
      It will not be necessary to run AUTOGEN.

- A workstation system that runs Compaq DECwindows Motif for OpenVMS software with correct system parameters
  If you install Compaq DECwindows Motif for OpenVMS on a workstation system and your system parameters are correct, the following message is displayed:

                The installation procedure has determined that your system parameters are
                set correctly and that it will not be necessary to run AUTOGEN or reboot
                the system.

                If your system is already running DECwindows Motif, restart DECwindows
                Motif with the following DCL command:

                     $ @SYS$MANAGER:DECW$STARTUP RESTART

                If your system is NOT already running DECwindows Motif, start DECwindows
                Motif with the following DCL command:

                     $ @SYS$MANAGER:DECW$STARTUP

                                          * * * N O T E * * *

                If you are installing DECwindows Motif from your workstation console, log
                off after you enter the command to start DECwindows Motif.

- A workstation system that runs Compaq DECwindows Motif for OpenVMS software with incorrect system parameters
  If you install Compaq DECwindows Motif for OpenVMS on a workstation system and your system parameters need to be reset, the following message is displayed:

      The installation of DECwindows Motif has determined that some of your
      system parameter values will require modification in order to start
      Compaq DECwindows Motif for OpenVMS, Version 1.2--6.  To set your
      parameters correctly, run AUTOGEN using the following DCL command:

              $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK

      This will adjust your system parameters and reboot the system.

- A workstation system that runs Compaq DECwindows Motif for OpenVMS with incorrect system parameters, and you answered Yes to a system shutdown

      The OpenVMS AUTOGEN procedure will now be run to set your system
      parameters. After that, your system will be automatically rebooted.

      After the system has been rebooted, successful installation of the
      workstation software will be indicated by the appearance of the
      Start Session window.

      %AUTOGEN-I-BEGIN, GETDATA phase is beginning.
       .
       .
       .
      %AUTOGEN-I-BEGIN, GENPARAMS phase is beginning.
       .
       .
       .
      %AUTOGEN-I-BEGIN, GENFILES phase is beginning.
       .
       .
       .
      %AUTOGEN-I-BEGIN, SETPARAMS phase is beginning.
       .
       .
       .

             Installation of DWMOTIFVAXU6 V1.2 completed at 10:57

      %VMSINSTAL-I-SHUTDOWN, This product requires that the system be rebooted.

             SHUTDOWN -- Perform an Orderly System Shutdown
                         on node NODE01
       .
       .
       .

## 3.2.16 Completing the Installation Procedure

When the installation is completed, a message similar to the following is displayed:

    Installation of DWMOTIFVAXU6 V1.2 completed at 10:57

    VMSINSTAL procedure done at 12:45

These messages indicate that the installation procedure completed successfully.

Your system automatically shuts down if AUTOGEN is run; you must then reboot your system. See the upgrade and installation supplement for your VAX processor for instructions on how to reboot your system.

Note If you upgrade your system with a higher version of OpenVMS at a later time, you might need to reinstall the Compaq DECwindows Motif for OpenVMS software.

# 3.3 Recovering from Errors

Errors can occur during the installation if any of the following conditions exist:

- Incorrect OpenVMS operating system version.
- Insufficient quotas.
- Insufficient values for system parameters.
- OpenVMS help library is currently in use.
- Product license is not registered and loaded.

For descriptions of the error messages generated by these conditions, see the documents listed in the Associated Documents section in the Preface. These documents may help you diagnose errors and decide what corrective actions to take.

# 3.4 Accessing the Release Notes

During the installation, the VMSINSTAL procedure copies theCompaq DECwindows Motif for OpenVMS Release Notes to the SYS$HELP:DECW$MOTIFU6012.RELEASE_NOTES file. Once you return to DCL level, you can print this file or display it at a terminal. Refer to Section 3.2.5 for more information about accessing the release notes.

# Chapter 4
After Installing the Software

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

- Section 4.1, Starting the DECwindows Motif Software
- Section 4.2, Running the IVP
- Section 4.3, Choosing an Alternate Console
- Section 4.4, Selecting the Desktop (Alpha Only)

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.

# 4.1 Starting the DECwindows Motif Software

If you perform a system reboot following the installation of DECwindows Motif, the DECwindows startup procedure runs automatically when the system reboots. On OpenVMS Alpha systems, 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 4.4 for more information.) On OpenVMS VAX systems the Start Session dialog box is displayed. Proceed to Section 4.2 if you allowed a system reboot and DECwindows has successfully started.

If you chose not to reboot the system after the installation, you must start or restart the DECwindows Motif software by running the DECwindows startup procedure, as described in the following paragraphs. When the startup procedure has successfully completed, either the New Desktop login dialog box or the DECwindows desktop Start Session dialog box is displayed, as explained in the previous paragraph.

Compaq DECwindows Motif for OpenVMS software can be started only if your system parameters are correct. Proceed to one of the following sections if your system parameters are correct:

- Section 4.1.1, Standalone Systems
- Section 4.1.2, OpenVMS Cluster Systems

If your system parameters are not correct, then use one of the following methods to adjust them accordingly:

- Invoke the AUTOGEN utility:

      $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT CHECK_FEEDBACK

- Attempt to start the DECwindows Motif software. The DECwindows Motif startup procedure checks your system parameters. If they are too low, the procedure displays a series of messages describing the required system parameters. These same parameters are adjusted in the system's MODPARAMS.DAT file. Then the procedure displays following:

      Some SYSGEN parameters must be reset for DECwindows to start.
      If you type YES, AUTOGEN will change these parameters and reboot your system.
      If you type NO, AUTOGEN will not run or cause a reboot, but DECwindows
      will not start.

      To run AUTOGEN at a later date, enter the following command:

        $ @SYS$UPDATE:AUTOGEN getdata reboot check_feedback

      Do you want the system to run AUTOGEN for you [Yes]?

After the system is rebooted and the startup is completed, the Start Session dialog box displays.

The Compaq DECwindows Motif for OpenVMS software is now installed and running on your system.

Run the Installation Verification Procedure (IVP) as described in Section 4.2 to verify that the installation of Compaq DECwindows Motif for OpenVMS software is complete and accurate.

## 4.1.1 Standalone Systems

Perform one of the following procedures to start your DECwindows Motif software on a standalone system:

- If your system is not running DECwindows Motif, then start DECwindows Motif with the following command:

      $ @SYS$MANAGER:DECW$STARTUP

- If your system is currently running DECwindows Motif, then restart DECwindows Motif with the following command:

      $ @SYS$MANAGER:DECW$STARTUP RESTART

Note If your system has a workstation display, then the command to restart DECwindows Motif will end your current session. The Start Session dialog box displays on your terminal, and you must log back in to continue using DECwindows Motif.

The Compaq DECwindows Motif for OpenVMS software is now installed and running on your system.

Run the IVP as described in Section 4.2 to verify that the installation of Compaq DECwindows Motif for OpenVMS is complete and accurate.

## 4.1.2 OpenVMS Cluster Systems

Starting Compaq DECwindows Motif for OpenVMS on nonsatellite and satellite nodes is described in the sections that follow.

### 4.1.2.1 Starting Nonsatellite and Boot Nodes

To start Compaq DECwindows Motif for OpenVMS software on each of the nonsatellite nodes within your cluster, perform one of the following procedures:

- If your system is not running DECwindows Motif, then start DECwindows Motif with the following command:

      $ @SYS$MANAGER:DECW$STARTUP

- If your system is currently running DECwindows Motif, then restart DECwindows Motif with the following command:

      $ @SYS$MANAGER:DECW$STARTUP RESTART

Note If the nonsatellite node or boot node has a workstation display, then the command to restart DECwindows Motif will end your current session. The Start Session dialog box displays on your terminal; log in again to continue using DECwindows Motif.

The Compaq DECwindows Motif for OpenVMS software is now installed and running on your system.

Run the IVP as described in Section 4.2 to verify that the installation of the Compaq DECwindows Motif for OpenVMS product is complete and accurate.

### 4.1.2.2 Starting Satellite Nodes

To start the Compaq DECwindows Motif for OpenVMS software that is installed on the boot node, perform one of the following procedures on each satellite node in the cluster that will run Compaq DECwindows Motif for OpenVMS software:

- If the node is not running DECwindows Motif, then start DECwindows Motif with the following command:

      $ @SYS$MANAGER:DECW$STARTUP

- If the node is currently running DECwindows Motif, then restart DECwindows Motif with the following command:

      $ @SYS$MANAGER:DECW$STARTUP RESTART

Once DECwindows Motif is started or restarted on each node in the OpenVMS Cluster, then the installation is considered complete. Now run the IVP as described in Section 4.2.

# 4.2 Running the IVP

Run the IVP, SYS$TEST:DECW$IVP.COM, after you install and start the Compaq DECwindows Motif for OpenVMS product. This procedure contains four 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.

Note If you are invoking the IVP from a LAT Xterminal using LAT software, enter the following command first:
    $ SET DISPLAY/CREATE/NODE=LAT_nnnnnnnnnnnn/TRANSPORT=LAT
Substitute your actual LAT terminal number for nnnnnnnnnn. Enter the default at the _Display: prompt.

Next, 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 4-1 shows you how to run the IVP.

Example 4-1 Sample IVP

    $ @SYS$TEST:DECW$IVP
    Copyright 2000 Compaq Computer Corporation

    Compaq DECwindows Motif for OpenVMS 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, 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.
    $

# 4.3 Choosing an Alternate Console

The Compaq DECwindows Motif for OpenVMS 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.

# 4.4 Selecting the Desktop (Alpha Only)

On OpenVMS Alpha systems, Compaq DECwindows Motif for OpenVMS 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 wish 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

Previous | Next | Contents | Index