Overview of the samu Operator Utility

The samu operator utility requires a display terminal that displays a minimum of 24 lines by 80 characters wide. The utility includes the following features:

• Displays that enable you to monitor Sun QFS and SAM-QFS devices and file system activity

• Commands that enable you to select displays, set display options, control access to and the activity of devices, and take snapshots of display windows

• Commands that enable you to tune a running file system

The display windows shown in this section are representative examples. The format and amount of information displayed on your terminal can be different depending on your terminal model and the devices configured in your environment.

The following sections describe how to start and stop samu, interact with the utility, access the help windows, and view operator displays.

How to Start the samu Utility

• To start the operator utility, type the samu command from the command line.

  # samu

  The system starts samu and shows the help display, which is the default initial display. To view a different samu display, follow the steps in How to Display a samu Screen.

  To change the default initial display, see samu(1M) in Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual.

  ---

  Note - samu , like the vi editor, is based on the curses(3CURSES) routine. If you have trouble invoking samu, make sure that your terminal type is defined correctly.

  ---

How to Display a samu Screen

The samu command accepts options on its command line for displaying different samu screens.

1. Type a colon (:) character.

   The following command line appears in the lower left corner:

   Command:

2. Type the letter that corresponds to the display you want to view and press the Return key.

   For example, to view the Automated Library Catalog Display, type a v character and press Return.

   For a complete list of the displays and the letters that correspond to the displays, type h for the Help Display.

How to Stop samu

• To exit samu, type one of the following:

  • q

  • :q

    The samu operator utility exits and returns you to the command shell.

Interacting With samu

The samu utility is similar the UNIX vi editor with respect to paging forward or backward, entering commands, refreshing the display, and quitting the utility.

For each operator display, the description includes the control key sequences you use to navigate in that display. The samu(1M) man page summarizes the control key sequences.

The last line of the display window shows any error messages. If a command error occurs, automatic display refreshing halts until the next operator action.

Identifying a Device

Each device included in the Sun QFS environment is assigned an equipment number (for example, 10) in the mcf file. Many samu commands require you to identify a specific device using its equipment number. To see a list of the devices and their equipment numbers, access the (c) - Device Configuration Display

Accessing Online Help

When you start samu, the default display is the first page of the online Help. The Help provides a summary of the samu displays.

To access the Help display at any time, type :h. To navigate in the online Help, press Ctrl-F to move to the next page, or Ctrl-B to move to the previous page. To return to the help display at any time, press the h key.