[Previous]   [Next]   [Contents]   [Index]   

Understanding and Using Local Clients

Local clients are applications that run directly on the X station rather than on the host. This chapter explains what kinds of local clients are available and how you can set up local clients on your HP X stations.

Topics include:

Understanding Local Clients

If you have not used local clients before, you may want to review the following sections for a brief summary of local clients and the benefits of using them.

What Are Local Clients?

Local clients are programs that are downloaded from the file server and run on the X station. (In comparison, host-based clients run on the login host computer and just display on the X station.)

Provided that your X station has sufficient memory installed, you can use any of the following types of local clients:

About Peer Processes and Local Clients

You can start local clients by an intermediate process, hpxt.*, which is known as a peer. A peer process seeks out specific information in your $HOME directory about your X station, and passes it along to the local client.

For instance, when used to start a local window manager, a peer process such as hpxt.vuerx searches in your home directory for any customized window-manager resource file and provides this information to the local window manager's executable portion.


Note: We recommend you start all local clients using their peer process.

Why Use Local Clients?

You may choose to use local clients for a variety of reasons including:

Using Local Clients to Free Up Host Memory

If your host computer's performance is suffering due to the number of users, you can free host memory by running a window manager and terminal emulators on each X station. (You must ensure that the X stations have enough memory to run the local clients. For specific resource requirements, refer to Using Local Clients and X Station Memory Effectively).

You can use local clients to save host memory effectively only if you are aware that host-based clients can share resources, as can local clients.

For example, terminal emulators have a "code" component, which is sharable, and a "data" component, which is unique to each invocation of the client. When you run a terminal emulator on the host, shared resources make it possible to start more copies of the terminal emulator while increasing the host memory usage by only the data component of the client. When running terminal emulators as local clients, the memory advantage of local terminal emulators is diminished if any user starts a host-based version of the terminal emulator. And because multiple copies of local terminal emulators can share resources, it is a good idea to standardize on one terminal emulator at your site.

If your system has sufficient memory on both the host and on the X stations, it is most memory-efficient to run clients on the host. For example, say that a particular terminal emulator requires 1000 KB for the first invocation, then 300 KB for each subsequent invocation whether running on the host or on an X station. If you have ten X station users, each of whom wants to have two terminal emulators, the total memory used would be as follows:

On the other hand, if your host is fully loaded with memory and performance is inadequate because there are too many demands on the system, it makes sense to offload clients to the X stations.

Using Local Clients to Improve Interactive Performance

Running a local window manager can make significant improvements to operations of moving, resizing and re-arranging windows. The performance boost occurs because data round-trips on the LAN are eliminated for window manager operations.

Using Local Clients to Reduce the Network Load

Many X terminal users choose local clients to reduce the network load. While this can be a benefit, the network load savings are not likely to be noticeable until you reach at least 25% of the LAN's capacity. In general, local window managers provide better network-traffic savings than local terminal emulators.

Using Local Clients for Diagnostic Purposes

You can also use local clients to run terminal emulators that communicate to the X station's serial port or Log Screen. You can use these terminal emulators to display diagnostic messages without the need to go into the configuration screens.

Using a Local Window Manager

You can use a local window manager to control the size, placement and operation of windows on the root window. The local window managers provided with ENWARE 7.0 include the following:

This section covers the following topics:

Starting Local Window Managers

How you start a local window manager depends on which X session manager the host computer runs:

If You Are Running XDM (or Dtlogin/Vuelogin in XDM-Mode)

If you are running XDM (or dtlogin or vuelogin in XDM-mode), complete the following steps.

  1. Edit the .xsession file (or the sys.xsession file)

  2. Change the host-based window manager to the local window manager you want the user to run. Refer to Local Window Managers and Their Peer Processes as necessary.

If You Are Not Running XDM

Local Window Managers and Their Peer Processes

The local window managers and their peer processes are as follows:
VUE/RX:
/usr/bin/X11/700X/hpxt.vuerx
CDE Lite:
/usr/bin/X11/700X/hpxt.dtwmlite
mwm:
/usr/bin/X11/700X/hpxt.mwm
twm:
/usr/bin/X11/700X/hpxt.twm
olwm (Sun):
/usr/bin/X11/700Xhpxt.olwm

For HP-UX 10.x systems, the local window managers and their peer processes are:

VUE/RX:
/opt/hpxt/enware/bin/hpxt.vuerx
CDE Lite:
/opt/hpxt/enware/bin/hpxt.dtwmlite
mwm:
/opt/hpxt/enware/bin/hpxt.mwm
twm:
/opt/hpxt/enware/bin/hpxt.twm

Note: If you log in from an X display which is not an HP X station or if the X station does not have enough memory to run the local window manager, the peer will start a host-based window manager of the same name. This means there is a fallback for hpxt.mwm, hpxt.twm, and hpxt.vuewm.

After You Start a Local Window Manager

When you log on, your .xsession file starts a peer process that invokes the local window manager. When the peer process starts the local window manager, the window manager searches in the user's home directory for any customized window-manager resource file (for example, $HOME/.twmrc, $HOME/.mwmrc, $HOME/.vuerxrc, or $HOME/.vue/vuewmrc).

If these files do not exist, the local window manager uses system default files on the host--the same system default files that the host-based version would use:

For HP-UX 10.x systems, the path for sys.vuewmrc is:


Note:

About mwm and twm

Local versions of mwm and twm behave similarly to their host-based equivalents. However, there are some parameter restrictions that apply to the local versions. Refer to the appropriate man page for details (e.g., man hpxt.mwm or man hpxt.twm.)

About Local vuewm

For information on using local vuewm, consult your HP VUE documentation. You should see no difference in operation between running vuewm on the X station and running a VUE session completely on the host.

About olwm

olwm behaves similarly to its Sun host-based equivalent. Refer to the appropriate man page for details (man hpxt.olwm).

About ENWARE VUE/RX

For information about using this local window manager, refer to Using ENWARE VUE/RX.

About CDE Lite

CDE Lite (dtwmlite window manager) is a local window manager that has been designed to give the look and feel of the full CDE Desktop in a local client version. For more information on this local window manager, refer to Using CDE Lite Local Window Manager.

Using ENWARE VUE/RX

ENWARE VUE/RX is a local window manager that has been specifically designed for HP X stations.

The default control panel contains:


&wwm; Control Panel

Two files define the control panel:

If you want to customize the appearance of ENWARE VUE/RX, do the following:

  1. Copy basepath/vuerx/sys.vuerxrc to your $HOME/.vuerxrc file.

  2. Append basepath/lib/app-defaults/Vuerx to your $HOME/.Xdefaults file.

  3. Update these files in your home directory.

The remainder of this section describes modifications you can make to customize the ENWARE VUE/RX interface. Topics include:

Accessing Additional Information

For further information on ENWARE VUE/RX, you can refer to its online man page by typing:
man vuerx

For information on the ENWARE VUE/RX resource file, you can refer to its online man page by typing:

man vuerxrc

Controlling Windows in the Workspaces

In general, clients started by an .xsession file appear in workspace one and the clients you start manually appear in the workspace in which you start them. However, some clients are so useful that you may want them to appear in more than one workspace.

To control the workspaces in which a client appears, click and hold on the square in the upper-left corner of the window (that is, the portion of the window's title bar that contains a long rectangle). You will see the following entries:


Note: To prevent an accidental loss of a window, you cannot use these menu options to remove a window from all of the workspaces.

Renaming (and Adding to) the Workspaces

The control panel offers four workspaces named 1, 2, 3, and 4. If you want to take advantage of the "virtual displays" offered by workspaces you will probably want to make the workspace names more meaningful. To do this, edit your .Xdefaults file as follows:

  1. If you do not have a .Xdefaults file, refer to Customizing Colors, Fonts and Other Application Defaults.

  2. If you have not already appended Vuerx to your .Xdefaults file, type:
    cat basepath/lib/app-defaults/Vuerx >>.Xdefaults

  3. Find the line that reads:
    Vuerx*workspaceList: 1 2 3 4

    and change the workspace names (1, 2, 3, and 4) to the names that you want. You will see the changes the next time you log in.

For example:
Vuerx*workspaceList: HP Sun Schedules Games
creates four workspaces called HP, Sun, Schedules, and Games as shown in the following figure.

You can add two more workspaces just by specifying two additional names in the workspaceList line.


Modified &wwm; Control Panel

Changing the Color Palette

ENWARE VUE/RX uses approximately 32 different colors. To help you customize these colors, 28 complete color palettes are provided. To change from one palette to another, edit your .Xdefaults file as follows:

  1. If you do not have a .Xdefaults file, refer to Customizing Colors, Fonts and Other Application Defaults.

  2. If you have not already appended Vuerx to your .Xdefaults file, open $HOME/.Xdefaults and append to it basepath/lib/app-defaults/Vuerx

  3. Find the line that reads:
    *colorPalette:              Broica.vp
    
    and change the color palette name as desired. The color palettes you can choose are listed in app-defaults/Vuerx as palette.vp. (For example, you can choose Ashley.vp or Orchid.vp.)

  4. To load your changes into the X server, type:
    xrdb -merge .Xdefaults

  5. To see the changes, log out and log back in again.

Note: On HP-UX 9.0 and later systems, you can test color schemes by running /usr/vue/bin/vuestyle.

If You Have a Color Monitor...

Change the *colorPalette: line to read:
*colorPalette: Dalla.vp

The resulting color scheme is similar to Broica, but the control panel is more blue in color. Try other palettes as well; some of the color schemes are more vibrant than Broica and Dalla.

If You Have a Grayscale X Station...

For the best grayscale display, change the *colorPalette: line to read:
*colorPalette: GrayScale.vp

If You Have a Monochrome X Station...

For the best monochrome display, change the *colorPalette: line to read:
*colorPalette: BlackWhite.vp

Adding a Client to the Tool Box

The default tool box contains :

To add a client to the tool box, follow these steps:

  1. Open your $HOME/.vuerxrc file.

  2. Find the section named BOX LiteToolsSubpanel and define a new control by adding the line:
    CONTROL         litetool5
    

  3. Underneath the CONTROL litetool4 section, add lines similar to the following:
    CONTROL litetool5
    {
      TYPE             button
      IMAGE            tools
      LABEL            "FrameMaker"
      PUSH_ACTION      f.exec "/usr/frame/bin/maker"
      PUSH_RECALL      True
      CLIENT_NAME      FrameMaker
    }
    

When you restart ENWARE VUE/RX, your tool box slide-up will be similar to this:


Modified Tool Box

Launching a Terminal Emulator in ENWARE VUE/RX

To launch a local terminal emulator:

  1. Click on the arrow over the terminal icon.

  2. Click on an icon labeled "ENWARE xterm," "ENWARE vt320," or "ENWARE hpterm."

Note: The vt320 terminal emulator requires that your font path includes:
basepath/fonts/vt340
or one of its sub-directories:
xsmall, small, large, or xlarge.

If the terminal emulator fails to appear, the problem could be that:

You could install the local client peer programs on every host running an X session manager, but a simpler solution is to edit your $HOME/.vuerxrc file as follows:

  1. Find the section of .vuerxrc that contains the line:
    PUSH_ACTION f.exec \
    /usr/bin/X11/700X/hpxt.xterm

    This line directs ENWARE VUE/RX to download a local xterm from the current X session manager.

  2. Change the line to download the local xterm from the file server. The path depends on your system, but the line may be similar to:
    PUSH_ACTION f.exec \
    /nfs/hp720/usr/bin/X11/700X/hpxt.xterm

    For HP-UX 10.x systems:
    /nfs/hp720/opt/hpxt/enware/bin/hpxt.xterm

Setting the Control Panel Clock for Use with XDM

If your system uses XDM, the control panel clock defaults to Greenwich Mean Time. If you don't live in the Greenwich time zone, you'll need to set your clock by following these steps:

  1. To learn the syntax for your time zone, type: env

  2. Look for the line that reports your time zone (TZ).

  3. In your .xsession file, look for the section where environment variables are set.

Note: You can also set the time zone in the remote configuration file. See Remote Configuration Parameter Reference for details.

Using CDE Lite Local Window Manager

CDE Lite (dtwmlite window manager) is a local window manager that has been designed to give the look and feel of the full CDE Desktop with lower memory requirements.
Note: If you want the full functionality of host-based CDE, you can order the HP ENWARE CDE Software optional product. This product gives you a local CDE window manager (dtwm) and a local CDE terminal emulator (dtterm).

To invoke CDE Lite:

  1. As superuser, edit the /usr/vue/config/Xconfig file.

    For HP-UX 10.x systems, edit the /etc/dt/config/Xconfig file.

  2. Set Vuelogin*xdmMode to True.

  3. Save and then quit the file.

  4. Copy the sys.xsession file to $HOME/.xsession

    A sample sys.xsession file is located in:

  5. Edit the .xsession file.

  6. Remove the # from the following line:
            WM="$XTBINDIR/hpxt.dtwmlite"
    

  7. Save and then quit the file.

  8. Log out and then log back into the system.

The CDE Lite panel appears, similar to the following:


CDE Lite Control Panel

The default control panel contains:

For further information, review the following sections:

CDE Lite Host and Memory Requirements

In order to have the full functionality of CDE Lite, the following conditions must be met:

Customizing CDE Lite

For detailed information on customizing your CDE Lite control panel, you can refer to its various online man pages by typing:

The man pages describe in detail the many different customization options available, including:


Note: Any changes you make to CDE Lite are kept in $HOME/.dt in your home directory.

Using a Local Terminal Emulator

A terminal emulator is a window that emulates a complete display terminal. Some common terminal emulators are hpterm, vt320 and xterm. The ENWARE X station software contains versions of these terminal emulators that run on the X station instead of the host.


Note: For 3270 emulation, you can purchase HP ENWARE 3270. This local terminal emulation program gives you access to most of the standard features of an IBM 3270 Information Display System including most IBM 3278 and 3279 terminal models.

There are several ways you can start a local terminal emulator:

Starting from the Preferences Configuration Screen

On startup, the X station reads the modules.ld file and any local terminal emulators listed there become available from the [Preferences] configuration screen.

To start a local terminal emulator from the [Preferences] screen, follow these steps:

  1. Press and hold [F12] to access the configuration screens.

  2. Click on [Preferences] to display the Preferences screen.

  3. In the Local Clients area, click on the desired terminal emulator to highlight it.

  4. Click on [Execute].

  5. Click on [OK]. The terminal emulator appears on your screen.

Starting from a Local Window Manager

When you start a local window manager, it reads the modules.ld file and automatically adds any local clients to its root menu. To start a local terminal emulator from a local window manager:

  1. Move the mouse cursor to the screen's background.

  2. Hold down the left mouse button.

  3. Drag the cursor to the [Local Clients] entry, then move the cursor out of the right side of that entry. A sub-menu appears.

  4. Drag the cursor to the local terminal emulator you want to start, then release the left mouse button. The terminal emulator appears on your screen.

Starting from the Root Menu of a Host-Based Window Manager

If you use a host-based window manager, you can add local terminal emulators to its root menu by editing the window manager's resource file (for example, $HOME/.mwmrc). The resource field entry will be similar to the following:
"Local HPterm"   f.exec "remsh terminalname hpterm &"

(The hpterm accepts the /dev options documented in the modules.ld file. For example:  hpterm -dev /dev/serial  

Starting from a Command Line

You can start a local terminal emulator from a command line by invoking the terminal emulator's script. To start a local xterm, type: /usr/bin/X11/700X/hpxt.xterm

For HP-UX 10.x systems, type: /opt/hpxt/enware/bin/hpxt.xterm

To specify a particular type of operation for a local terminal emulator (either telnet, serial1, serial2, or log operation), use a -dev /dev/ option. For example, if you want to specify a second serial port, use -dev /dev/serial2. The default operation for a local terminal emulator is: -dev /dev/rlogin.

Other examples include:
/usr/bin/X11/700X/hpxt.xterm -dev /dev/log
/usr/bin/X11/700X/hpxt.xterm -dev /dev/rlogin
/usr/bin/X11/700X/hpxt.xterm -dev /dev/telnet
/usr/bin/X11/700X/hpxt.xterm -dev /dev/serial

Controlling Which Local Terminal Emulators Are Available

The modules.ld file lists the local clients available on your file server. When you power on the X station, it reads modules.ld and lists the local clients on the [Preferences] configuration screen. When you start a local window manager, the local window manager also reads modules.ld and lists the local clients in the root menu. To control which local terminal emulators are available, you need to edit the modules.ld file.

The modules.ld file (basepath/bin/modules.ld) contains instructions that show you how to make available local clients that can:

For more information, refer to the man page for your local window manager. For example, type: man hpxt.hpterm or man hpxt.xterm


Note: For any terminal emulator window--local or host-based--the TERM type needs to be set. Set the local xterm to TERM=xterm.

Starting Local Clients Automatically

The [Server] configuration screen's [Login Host] field has an option called [Local Command]. By using Local Command, you can start local clients automatically at startup without using an X session manager.

With Login Host set to Local Command, type in the Login Host field the names of the local clients you want to start, separated by semicolons. For a complete list of the clients that are available, see the modules.ld file. Note that the following aliases are defined:

xterm
xterm (rlogin)
txterm
xterm (TELNET)
sxterm
xterm (serial)
xlog
xterm (log screen)
hpterm
hpterm (rlogin)
thpterm
hpterm (TELNET)
shpterm
hpterm (serial)
loghp
hpterm (log screen)
vt320
vt320 (rlogin)
tvt320
vt320 (TELNET)
svt320
vt320 (serial)

Using Local Applications

The ENWARE X station software contains the following local applications:

Starting Local xclock

Local xclock is a version of xclock that runs on the X station. You can run the clock in digital or analog form:

To start local xclock from a terminal emulator window, start its peer process by typing:
/usr/bin/X11/700X/hpxt.xclock

For HP-UX 10.x systems: /opt/hpxt/enware/bin/hpxt.xclock

Accessing Additional Information

For more xclock options, type:
man hpxt.xclock

Starting Local clock

Local clock is an OpenLook clock that runs on Sun X stations.

To start local clock from a terminal emulator window, type the full path name:
/usr/bin/X11/700X/hpxt.clock

Accessing Additional Information

For more clock options, type:
man hpxt.clock

Starting Local xlock

Local xlock is a version of xlock that runs on the X station. You can use xlock to:

To start local xlock from a terminal emulator window, start up its peer process by typing: /usr/bin/X11/700X/hpxt.xlock

For HP-UX 10.x systems: /opt/hpxt/enware/bin/hpxt.xlock

The following icon appears on your screen:


Note: To lock your X station automatically after 15 minutes, click on the Set Autolock button. To change the time limit, you can use the -autolock option, as described below.

You can add several options to the above command line, including the following:

-password password
specifies the password you need to type to unlock the display. The default is the password of the user who invoked xlock.
-autolock seconds
specifies the time in seconds before your display locks automatically. Note that if you choose this option, there will be no Set Autolock button on the xlock screen icon.
-autologout seconds
specifies the time in seconds before you are automatically logged out. You can use this option only for your own display.
-nowindow
If this option is set along with the autolock and/or the autologout options, the xlock icon will not appear on the screen.
-mode pattern
specifies the pattern that covers the display. You can specify the following patterns:

For a description of these modes, see the man page.

Examples using xlock

Accessing Additional Information

For more xlock options and information, type:
man hpxt.xlock

Starting WhiteBoard

WhiteBoard is an X Window System graphics application that you can run as a local application on your X station:

You can use local WhiteBoard to:

There are three ways to start WhiteBoard:

Accessing Additional Information

For detailed information on using WhiteBoard as a local client, type:
man hpxt.whiteboard

Configuring WhiteBoard to Run Locally in MPower

If you are using MPower, you can run WhiteBoard either locally or from the host. To switch from one to the other, do the following:

  1. Log into an MPower session.

  2. Pull up the Tools icon.

  3. Click on the "General" toolbox.

  4. Double-click on the "X_Terminals" icon.

  5. Double-click on the "Utilities" icon.

  6. Double-click on the "SelectMPower" icon.

  7. For each MPower application, a dialog box appears. It says where you are currently running the application (from the host or from the X terminal), and asks if you want to change this. Select [Yes] or [No] for each application.

Starting SharedX

You can use the local client version of SharedX to share X protocol-based applications between two or more terminals. You (the sender) on one system can send a selected window or windows to a user (the receiver) on another system. You can send one or more windows to several receivers simultaneously.
Note: The sender must have the SXext extension loaded. The receiver does not need SXext to receive a window.

As the sender, you can:

During a SharedX session, you can also choose to use a shared pointing device, called a "telepointer", which can be manipulated by both the sender and all receivers. SharedX also includes a sample address book, font aliases and user preferences.

Before you start SharedX as a local client, make sure you disable the Client Authorize and Access Control parameters from the configuration screens.

There are two ways to start SharedX:


Note: User preferences and address books will only be available if SharedX is running with a peer.

Accessing Additional Information

For detailed information on using SharedX as a local client, type:
man hpxt.SharedX

Configuring SharedX to Run Locally in MPower

If you are using MPower, you can run SharedX either locally or from the host. To switch from one to the other, do the following:

  1. Log into an MPower session.

  2. Pull up the Tools icon.

  3. Click on the "General" toolbox.

  4. Double-click on the "X_Terminals" icon.

  5. Double-click on the "Utilities" icon.

  6. Double-click on the "SelectMPower" icon.

  7. For each MPower application, a dialog box appears. It says where you are currently running the application (from the host or from the X terminal), and asks if you want to change this. Select [Yes] or [No] for each application.

[Previous]   [Next]   [Contents]   [Index]