HP OpenVMS Systems Documentation

HP DECwindows Motif for OpenVMS
Management Guide

To load a different desktop than the one chosen during installation, set the value of the DECW$START_NEW_DESKTOP symbol in DECW$PRIVATE_APPS_SETUP.COM to either TRUE (for the New Desktop) or FALSE (for the Traditional DECwindows Desktop).

If file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM does not already exist, create it from the template, as follows:

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

Enable use of IPv6 by defining the global symbol DECW$IPV6_SUPPORT in the DECW$PRIVATE_APPS_SETUP.COM file. Users can override the resulting systemwide logical, if required. Define the symbol using one of the following values:

• TCP_IS_INET6
  Use this value if your network has been configured to support IPv6. The TCPIP and TCP transport names are interpreted as synonyms for the INET6 transport. Note that the INET6 transport attempts to use IPv6 where available; it does not guarantee that the IPv6 will be used. Individual programs can explicitly specify either the INET6 or INET transport option.
  If you set this value, and your domain name servers are not configured to handle IPv6, then you may experience delays when opening display connections.
• DISABLED
  Use this value only if an application opens display connections from user-mode AST routines. The TCPIP and TCP transport names are interpreted as synonyms for the INET transport. The INET6 transport option is not available.
• "any other value"
  Use this value if your network does not support IPv6, or if IPv6 is only used for select IPv6-over-IPv4 tunnels. The TCPIP and TCP transport names are synonyms for the INET transport. Unlike the the DISABLED option, individual programs can explicitly specify either the INET6 or INET transport option. This is the default value if the logical name is undefined.

The default behavior of this logical provides display name and client-server connection functionality identical to previous versions of DECwindows Motif.

You can substitute the default HP logo with an alternate logo by running a separate application that displays your logo.

To do this, you need to define a global symbol in the DECW$PRIVATE_APPS_SETUP.COM file and create a DCL command file that contains the commands to display your logo. For example, to display your own logo on the login screen:

• Create a command file (SYS$MANAGER:LOGO.COM, for example).
• Define the global symbol DECW$LOGINLOGO in SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM, with its value set to the name of your command file. Note that this command file is run by the system account.

To create a custom logo, do the following:

1. If the SYS$MANAGER directory does not contain a command file, copy the template file to a command file:

   $ COPY SYS$COMMON:[SYSMGR]DECW$PRIVATE_APPS_SETUP.TEMPLATE - _$ SYS$SPECIFIC:[SYSMGR]DECW$PRIVATE_APPS_SETUP.COM/LOG

2. Edit the file and define the symbol DECW$LOGINLOGO to point to the command file that displays your custom logo.
   Add the following line:

   $ DECW$LOGINLOGO == "SYS$MANAGER:MYLOGO.COM"

3. Create the command file that displays your logo. This needs to be the file name and directory specified in step 2. Note that the command file runs as a detached process under the SYSTEM account. Be careful not to give users access to the system through your custom logo. Do not run applications like FileView or DECterm as a custom logo.
   For example, the file SYS$MANAGER:MYLOGO.COM could contain this command to display the icosahedron that is shipped as an example program:

   $ RUN DECW$EXAMPLES:ICO

4. Restart DECwindows by rebooting your workstation running DECW$STARTUP, as follows.

   $ @SYS$STARTUP:DECW$STARTUP RESTART

   
   To restore the HP logo, you need to remove the definition of DECW$LOGINLOGO from your DECW$PRIVATE_APPS_SETUP.COM file and restart DECwindows.

If a license for DECwindows Motif has not been registered for the SYSTEM account, DECwindows does not display customized login logos. This can occur on systems with DECwindows Motif personal-use licenses that do not include SYSTEM on the list of authorized DECwindows users.

To display a customized logo on a DECwindows Motif with a personal-use license, add the following definition to the SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM file:

$ DECW$LOGINLOGOSUB == "TRUE"

After editing the setup file, restart DECwindows Motif, as follows:

$ @SYS$MANAGER:DECW$STARTUP RESTART

DECwindows Motif login starts the logo process as a subprocess instead of as a detached process.

4.4.6 Displaying Console Messages

You can choose to display operator messages (OPCOM) in the console window using the Console Window application. The console window is a six-line display area at the top of the screen.

Specify how to display messages by defining the global symbol DECW$CONSOLE_SELECTION in the DECW$PRIVATE_APPS_SETUP.COM file. Enter one of the following values: WINDOW, DISABLE, or ENABLE.

• WINDOW
  Displays console messages in the Console Window application. If you specify the WINDOW value, the Console Window is displayed in the lower right corner of the login screen by default and continues to be displayed after the user logs in to the system.
  The Console Window application shares the same executable file and looks similar to the Message Window. However, a menu bar is not displayed in the Console Window; it reads its resources from the DECW$CONSOLE.DAT file instead of from the DECW$MESSAGEPANEL.DAT file. Internally, the Console Window is invoked by running the DECW$MESSAGEPANEL.EXE executable with the command line option -console.
  To control the initial position of the Console Window and the classes of OPCOM output that are enabled, you can the define the DECW$CONSOLE_GEOMETRY global symbol in the file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM.
  The DECW$CONSOLE_GEOMETRY symbol specifies the value of the -geometry option in the DECW$MESSAGEPANEL.EXE command line; this command is used to start the Console Window application. The default value is "-0-0", which specifies the location of the window in the lower right corner of the screen.
  To position the window at the lower left corner of the screen, for example, add the following line to the command file SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM:

  $ DECW$CONSOLE_GEOMETRY == "+0-0"

• DISABLE (default)
  Disables broadcasts to the OPA0: device. Console messages are not displayed.
• ENABLE
  Displays console messages in the console window.

  Note Although ENABLE was the default value in previous releases of DECwindows Motif, it is recommended that you do not use this option. Displaying console messages by default in the console window can corrupt the contents of the workstation display.

If you are a system manager, you can set up user accounts to run only certain applications. For example, you might want users to use only the Bookreader application.

This section describes the following three methods for setting up dedicated DECwindows accounts:

• Modifying the Session Manager command procedure
• Modifying the Session Manager executable file
• Modifying the Session Manager profile file

You can define the global symbol DECW$SESSIONCOM in the SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM file so that when a user logs in, LOGINOUT runs a command file other than DECW$STARTSM.COM. This action bypasses Session Manager altogether.

In Example 4-1, DECW$SESSIONCOM is defined in DECW$PRIVATE_APPS_SETUP.COM to point to the private command procedure SYS$MANAGER: PRIVATE_SESSIONCOM.COM. The default command file is SYS$MANAGER:DECW$STARTSM.COM.

Because DECW$SESSIONCOM is defined in the system logical name table, it affects Session Manager startup for every user name. Your private command file must check the user name under which it is running and run the normal DECW$STARTSM.COM procedure for nondedicated accounts.

To modify the Session Manager command procedure:

1. Create the command procedure shown in Example 4-1.

   Example 4-1 Using a Private Session Manager Command File

   $ CREATE SYS$MANAGER:PRIVATE_SESSIONCOM.COM $! $! Check to see whether this is the dedicated DECwindows account. $! If it isn't, run the normal procedure to start Session Manager. $! $ username = F$USER() $ IF F$LOCATE("BOOK_READER", username) .NE. F$LENGTH(username) - THEN GOTO dedicated $! $! Normal, nondedicated DECwindows login $! $ @SYS$MANAGER:DECW$STARTSM $ EXIT $! $! Dedicated DECwindows login. Run Bookreader and then exit. $! $ dedicated: $! $ RUN SYS$SYSTEM:DECW$WSINIT $ display = F$TRNLNM("DECW$DISPLAY") $ RUN/DETACHED/OUTPUT='display' SYS$SYSTEM:DECW$MWM (1) $ RUN SYS$SYSTEM:DECW$BOOKREADER $ endsession := $DECW$ENDSESSION (2) $ endsession -noprompt (3) $ STOP/ID=0 (4)

   1. DECW$MWM is the Motif Window Manager. Its SYS$OUTPUT definition needs to be set to the translation of DECW$DISPLAY so that DECW$DISPLAY is defined correctly in the detached process.
   2. DECW$ENDSESSION resets the server and displays a Start Session dialog login box.
   3. The -noprompt qualifier prevents DECW$ENDSESSION from asking the user to confirm whether to end the session. (If the user cancels the End Session operation, the workstation will be unusable because Bookreader will exit and the login box will not be displayed.)
   4. STOP/ID=0 logs out the process without writing an error message to SYS$OUTPUT.
2. Define the DECW$SESSIONCOM symbol in DECW$PRIVATE_APPS_SETUP.COM as follows:

   $ DECW$SESSIONCOM :== SYS$MANAGER:PRIVATE_SESSIONCOM.COM

   
   If SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM does not already exist, create it as follows from the template file:

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

3. Restart DECwindows by entering the following command:

   $ @SYS$MANAGER:DECW$STARTUP RESTART

   
   This step is necessary for the changes to DECW$PRIVATE_APPS_SETUP.COM to take effect.
4. Log in to the dedicated account on a DECwindows system.
   After entering the user name and password of the dedicated account, Bookreader starts and Session Manager is not displayed. When the user exits from Bookreader, the PRIVATE_SESSIONCOM.COM procedure ends the session operation and then logs out. The End Session command displays the Start Session screen.

You can define DECW$SESSIONMAIN in the SYS$MANAGER: DECW$PRIVATE_APPS_SETUP.COM file so that DECW$STARTSM.COM runs the specified command file instead of DECW$SESSION.EXE. Session Manager reads resource files and runs login command files but does not display the Session Manager menu bar. With this method, ensure that the End Session command does not prompt for confirmation.

When DECW$STARTSM.COM starts (that is, if DECW$SESSIONCOM has its default value), it starts Session Manager by running the DCL command that is stored in the logical name DECW$SESSIONMAIN. To define this logical name, edit SYS$MANAGER: PRIVATE_APPS_SETUP.COM so that it defines the global symbol DECW$SESSIONMAIN as the DCL command to execute.

This method is similar to the one described in the Section 4.4.7.1 except that, with this method, DECW$STARTSM.COM executes the SYLOGIN.COM, LOGIN.COM, DECW$SYLOGIN.COM, and DECW$LOGIN.COM command procedures. Also, DECW$STARTSM.COM executes DECW$WSINIT.EXE, so the private command procedure does not need to do so.

To modify the Session Manager executable file:

1. Create the command procedure shown in Example 4-2.

   Example 4-2 Modifying the Session Manager Executable File

   $ CREATE SYS$MANAGER:PRIVATE_SESSIONMAIN.COM $! $! Check to see whether this is the dedicated DECwindows account. $! If it isn't, run the normal procedure to start Session Manager. $! $ username = F$USER() $ IF F$LOCATE("BOOK_READER", USERNAME) .NE. F$LENGTH(USERNAME) - THEN GOTO dedicated $! $! Normal, nondedicated DECwindows login $! $ RUN SYS$SYSTEM:DECW$SESSION $ EXIT $! $! Dedicated DECwindows login. Run Bookreader and then exit. $! $ dedicated: $! $ display = F$TRNLNM("DECW$DISPLAY") $ RUN/DETACHED/OUTPUT='display' SYS$SYSTEM:DECW$MWM (1) $ RUN SYS$SYSTEM:DECW$BOOKREADER $ endsession := $DECW$ENDSESSION (2) $ endsession -noprompt (3) $ STOP/ID=0 (4)

   1. DECW$MWM is the Motif Window Manager. Its SYS$OUTPUT definition needs to be set to the translation of DECW$DISPLAY so that DECW$DISPLAY is defined correctly in the detached process.
   2. DECW$ENDSESSION resets the server and displays a new Start Session screen.
   3. The -noprompt qualifier prevents DECW$ENDSESSION from displaying the End Session prompt. (If the user cancels the End Session prompt, the workstation will be unusable because Bookreader will exit and the Start Session screen will not be displayed.)
   4. STOP/ID=0 logs out the process without writing a message to SYS$OUTPUT.
2. Define the DECW$SESSIONMAIN symbol in DECW$PRIVATE_APPS_SETUP.COM.
   Edit this command procedure to define DECW$SESSIONMAIN. Note that the symbol must be defined as a DCL command (unlike DECW$SESSIONCOM, which is defined as the name of a command procedure).

   $ DECW$SESSIONMAIN :== @SYS$MANAGER:PRIVATE_SESSIONMAIN.COM

   
   If SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM does not already exist, create it as follows from the template file:

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

3. Restart DECwindows by entering the following command:

   $ @SYS$MANAGER:DECW$STARTUP RESTART

   
   This step is necessary for the changes to DECW$PRIVATE_APPS_SETUP.COM to take effect.
4. Log in to the dedicated account on a DECwindows system.

After entering the user name and password of the dedicated account, Bookreader starts and the Session Manager menu bar is not displayed. When the user exits Bookreader, the PRIVATE_SESSIONMAIN.COM procedure performs an End Session operation and then logs out. The End Session command displays a DECwindows Start Session screen.

4.4.7.3 Modifying the Session Manager Profile File

This method starts Session Manager normally, but the system manager customizes its menus to remove any applications that are not started automatically. By removing certain applications, you can limit user access to applications.

With this method, the Session Manager menu bar is displayed, and the user can interact with whatever dialog boxes the system manager does not disable.

To modify the Session Manager profile file:

1. Log in to the dedicated account on a DECwindows system.
   When you enter the user name and password of the dedicated account, Session Manager starts.
2. Add the applications to the automatic startup list that you want to be displayed when a user logs in.
   Choose Automatic Startup... from the Session Manager Options menu. Session Manager displays the Automatic Startup dialog box.
   Use this dialog box to remove any undesired applications, such as FileView, from the automatic startup list. (For more information about using the Automatic Startup dialog box, see Using DECwindows Motif for OpenVMS.)

   Note Do not remove Window Manager from the automatic startup list.

   
   For this example add Bookreader to the list and click on OK.
3. Remove Applications from the Session Manager menu bar.
   Choose Menu Bar... from the Session Manager Options menu. Session Manager displays the Menu Bar dialog box.
   Use this dialog box to remove the applications you do not want to be displayed. (For more information about using the Menus dialog box, see Using DECwindows Motif for OpenVMS.)
   Click on OK to save your changes and to dismiss the dialog box.
4. Choose Save Session Manager from the Session Manager Options menu to save your menu bar settings.
5. Remove any menu items that you do not want to be displayed on the Options menu.
   Choose Menus... from the Session Manager Options menu and remove the following menu items from the Session Manager Options menu:
   • Automatic Startup...
   • Menus...
   • Menu Bar...
   • Save Session Manager
   
   You should also remove any other menu items that you do not want users to have access to in the dedicated account, such as Security.
   After removing the items, click on OK to dismiss the dialog box and to save your menu settings.
6. Choose End Session from the Session Manager Session menu.
   Session Manager logs you out of the dedicated account and displays the DECwindows login box.
7. Log back in to the dedicated account.

To test your changes, log in to the dedicated account from the DECwindows login box. Bookreader and Session Manager should start up by default, and you should not be able to start any other application. To log out, choose End Session from the Session Manager menu.

If you decide to make the account nondedicated again, or if you want to make changes in a dialog box that you have removed from the system menu bar, delete or rename the file VUE$PROFILE.VUE$DAT in the dedicated account's SYS$LOGIN directory.

4.4.8 Creating a Custom Bookreader Directory

When you start Bookreader, the system uses the logical name DECW$BOOK to locate the file LIBRARY.DECW$BOOKSHELF. By default, the logical name DECW$BOOK equates to SYS$SYSROOT:[DECW$BOOK]. You can create a private directory containing the file LIBRARY.DECW$BOOKSHELF.

To do this, you need to create the directory and then define a global symbol in the DECW$PRIVATE_APPS_SETUP.COM file.

To create a private Bookreader directory called SYS$COMMON: [DECW$BOOK_LOCAL], you need to:

1. Create the directory, giving the world read access as in the following example:

   $ CREATE/DIRECTORY/PROTECTION=WORLD:R - _$ SYS$COMMON:[DECW$BOOK_LOCAL]

2. Copy the Bookreader LIBRARY.DECW$BOOKSHELF file to the new directory.

   $ COPY SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF - _$ SYS$COMMON:[DECW$BOOK_LOCAL]/LOG

3. If the SYS$MANAGER directory does not contain the DECW$PRIVATE_APPS_SETUP.COM command file, copy the template file to a command file.

   $ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE - _$ SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM/LOG

4. Edit the file and define the global symbol DECW$BOOK to point to your personal Bookreader directory.
   Add the following line:

   $ DECW$BOOK == "SYS$COMMON:[DECW$BOOK_LOCAL]"

5. Restart DECwindows Motif, as follows:

   $ @SYS$MANAGER:DECW$STARTUP RESTART