xrw,xsw(1M) — Series 300/400/700

NAME

xrw,xsw - Graphical user interface to RemoteWatch programs and data.

SYNOPSIS

/usr/bin/X11/xrw
/usr/bin/X11/xsw

DESCRIPTION

xrw and xsw are the same program. In earlier releases of RemoteWatch, the name xrw was used. The name xsw is now used, to indicate that RemoteWatch is a subsystem of the HP Support Watch product. This program provides an OSF/Motif based graphical interface between the user and RemoteWatch data and programs. It is used to display reports, display archived e-mail messages, collect current configuration data on HP-UX clusters or standalone HP-UX workstations, display LAN and disk statistics, display security reports, view log file monitor reports, view core file check reports, and other miscellaneous information. It can be used to adjust the customizable parameters of RemoteWatch. The program can run on any node in an HP-UX cluster or on a standalone system. By default, the program accesses the RemoteWatch data and programs on the local cluster/standalone system. It can also be set up to access RemoteWatch on remote HP-UX clusters and standalone systems by using the cluster/standalone map. The program may also access a machine running RemoteWatch across a modem connection. See remotewatch(1M) for a complete description of RemoteWatch.

STARTUP

The DISPLAY shell variable must be set to the correct setting. Typically the correct setting is "<hostname>:0" where <hostname> is the name of the local workstation and 0 is the display number. xsw is an X Window application. It can be located on any HP-UX workstation on the network (including the local machine) and its output can be sent to the local workstation display. If xsw is running on a machine other than the local workstation, xhost(1) must be run on the local machine to give access permission to the remote machine. See X documentation for further details. To start xsw from any node in a cluster or from a standalone system, type the following command in an hpterm window: /usr/bin/X11/xsw If /usr/bin/X11 is already in your search path, you can just type "xsw". See sh(1), csh(1), or ksh(1) for instructions on setting your PATH variable (your search path). When xsw is started, first a blank window is opened; this window is the display window. The display window is used as the output screen for xsw. After a short delay, a second window opens. This window contains the icon map for describing the cluster or standalone workstation, as appropriate. Together, these two windows give the appearance of a single window with the icon map occupying the upper portion of the window and the display screen, the lower portion. The upper screen is also used to display the cluster/standalone map as described later.

MAIN DISPLAY

The icon map visually describes the configuration of a cluster or standalone system. The configuration includes server and client nodes, disks, tape, CD-ROM, and printers. In addition to the icon map, the display includes: the title area of the HP OSF/Motif Window Manager, which displays the complete name of the xsw program and copyright information; a main menu bar; and a status line, which indicates the name of the displayed system (or the name of the system in the icon map), the HP-UX Operating System version, the version of HP Support Watch (or the earlier HP RemoteWatch running on the displayed system), the date and time the map was generated, and the connection mode between xsw and the displayed system. In some cases, a workstation icon may contain an additional label with the words OLD DATA or NO DATA. The OLD DATA label indicates that only old data is available for that node. This occurs if the client node had been turned off during the night or if the client node was removed from the cluster without its RemoteWatch files being removed. The NO DATA label will appear on a client workstation icon if RemoteWatch has never run on the client node. If this situation does not automatically clear itself up after a day, then a RemoteWatch installation error on the client node is likely. When xsw is waiting for the response to a command, the cursor in the xsw screen changes into a little watch. Until the watch turns back into a normal arrow cursor, other xsw commands should not be executed. The main menu bar includes the menu items General, Collect, Reports, Archives, Statistics, Setup, Predictive, and Help. All these menu items are present when the selected node is a Series 800 system. (RemoteWatch can access RemoteWatch programs and data on a remote machine running HP Support Watch for Series 800. Refer to the HP Support Watch for Series 800 User’s Guide for information on using the "Predictive" pull-down menu choices.) The "Predictive" menu item does not appear in the menu bar when the selected node is a Series 300, 400 or 700 system. General Menu
The General pull-down menu performs most operations relating to the entire cluster or standalone system. These operations include setup, maintenance, and printing of icon maps, print logging, modem datacommunications setup, file system functions (log file monitor and core file check), displaying boot messages for the selected server or client node, and security functions. Commands to clear the display window and to exit from xsw are also available in the General pull-down menu.

Collect Menu
This menu item includes a pull-down menu from which the user can obtain current configuration information on the spu, clients, disks, lan, printers, kernel, and devices associated with the selected server or client. Server and client nodes are selected by pointing to the desired node with the mouse cursor and pressing the left mouse button. The server is automatically selected when the map is first displayed. Reports Menu
This menu item includes a pull-down menu from which the user can select and view configuration reports on the spu, clients, disks, lan, printers, kernel, and devices associated with any node for any day during the configured report storage period. Archives Menu
This menu item permits viewing the stored e-mail messages, generated on any of the days in the configured period, for the selected node. Statistics Menu
This menu item permits viewing of the lan and disk usage statistics. RemoteWatch stores lan usage statistics nightly (frame counts, unknown protocol errors, and so on). It also keeps statistics on the disk space usage per file system. A report on the current disk usage is available. Setup Menu
This menu item includes a pull-down menu which permits the user to customize RemoteWatch operational parameters interactively. To run the customize portion of setup, the user must have superuser capability. Predictive Menu
This menu item is only displayed when the selected system is a Series 800. There are two submenu choices: Display Action Reports and Predictive Configuration Both these items will be non-operational unless HP Support Watch for Series 800 is installed on the system. Help Menu
This menu item provides two levels of help. The first type of help, Message Help, allows the user to obtain on-screen information regarding e-mailed or archived messages and appropriate actions to take on any of the RemoteWatch messages. The second type of help is Indexed Help to provide the user with help information pertaining to the current operation or associated window. Additionally, the dialog and list boxes displayed as a result of xsw operation include Help buttons to access help text pertinent to the displayed box.

CLUSTER/STANDALONE SYSTEM MAP

The xsw interface can be used to provide convenient access to multiple HP-UX clusters and standalone systems. A cluster/standalone map must first be created using the Cluster/Standalone Map Functions selection of the General pull-down menu. Once the map is created, xsw automatically displays the cluster/standalone map when started. The cluster/standalone map contains an icon representing each of the HP-UX clusters and standalone systems entered on the map by the user. Selecting one of the cluster or standalone icons brings up the icon map of the cluster or standalone. A button is provided to return to the cluster/standalone map.

REMOTE ACCESS

xsw may be used to access a machine running RemoteWatch across a modem connection. All information obtained in Network/daemons mode can be obtained in datacomm and serial modes. When connected to the remote machine, log in to a non-superuser account. The login: prompt appears in the display window; communication with the remote system is through the display window. After completely logging in, select Load Icon Map in the Icon Map Functions menu of General. All of the functionality of RemoteWatch is available when logged onto remote systems. To return to the local node, log off the remote system by entering exit at the remote system prompt, then bring up the DataComm Screen in the General pull-down menu. Select Network/daemons to return to local operation.

AUTHOR

xsw was developed by the Hewlett-Packard Company.

FILES

/usr/lib/X11/app-defaults/RWi - Resources
/usr/remwatch/bin/rwiDCOM - DataComm Task
/usr/remwatch/bin/rwiPrint - ICON Map Print Task

Museum

Related Articles