Common Screen Elements [ Using the Node Management Services (NMS) Utilities ] MPE/iX 5.0 Documentation
Using the Node Management Services (NMS) Utilities
Common Screen Elements
The screen shown in figure 2-1 illustrates the common elements found in
NMMGR screens. Each of these elements is described below.
Figure 2-1. Common Screen Elements
Header
The screen header is located at the top of the screen (the top three
lines), and contains five elements, each of which is described below.
The five elements are:
* Program name (NMMGR/3000) and version number
* Screen number and title
* Data flag
* Message field
* Command window
Program Name and Version Number.
The program name and version number are always displayed in a protected
field at the top of the screen. (Protected means that information cannot
be typed into the field.)
Screen Number and Title.
To the right of the program name and version number is the screen number
followed by the screen title. Each screen number is unique for that
screen. There is no significance to the order of the numbers. They are
strictly for convenience in referencing information about a screen in
various reference documents.
Screen titles are also unique for each screen and will generally indicate
the purpose and content of the screen.
Data Flag.
The data flag is a Yes or No indicator located in the upper-right corner
of screens that contain data entry fields. The data flag indicates
whether or not a data record has already been created for the screen.
The data flag is an important indicator in cases where default
information is supplied in the fields of a screen when a new
configuration file is created. The information in the fields has not yet
been saved, even though it may appear that the information on the screen
is complete. If you want the information on the screen to become a part
of the configuration, you must press the Save Data function key to create
the actual data record. The data flag will change from N to Y, verifying
that the data has been made part of the configuration file.
Once a data record has been created for a screen, the data flag is set to
Y whenever you return that screen.
Message Field.
The message field is the second line of the header and may contain one of
two types of information:
* The action that this screen requires
* An NMMGR error message
This line is a full-bright inverse video line that is used only for
displaying information. You can obtain more information about the errors
that may appear in this field by using the Error Information screen,
which is described later in this chapter.
Command Window.
Each screen includes a field labeled Command: that is located below the
message field. This field, called the command window, accepts commands
rather than accepting data. This is an unprotected field and is
displayed in half-bright inverse video. You can enter the following
types of commands in this window:
* NMMGR commands. The valid screen mode commands and their meanings
are shown in table 2-1. You can enter each command using the full
command name or you can abbreviate the command by entering only
the portion to the left of the bracket as shown in the table.
* MPE commands.
* NMMGR path commands. Direct path branching and brother branching
are described in this chapter.
To enter a command, position the cursor at the Command: window by
pressing the Home key (the key on your terminal with the diagonal arrow
or the word "Home" on it). You can also use the [TAB] or cursor (arrow)
keys to move the cursor to the command window. Once you are there, type
in the command and press [ENTER].
NOTE You must press [ENTER], not [RETURN], to execute the command.
When there is a command in the command window, pressing [ENTER] executes
only the command in the window. It will not send other data on the
screen to the computer.
Some NMMGR commands transfer you directly to other screens.
The NMMGR command set includes the colon (:). You can execute any
programmatically executable MPE command from the command window by
prefacing it with a colon. For example, you could type :LISTF and press
[ENTER]. When MPE is finished processing your command, it prompts you to
press [RETURN] to return to the screen interface.
You can process only one command in the command window at a time.
Table 2-1. NMMGR Screen Mode Commands
-----------------------------------------------------------------------------
| |
| NMMGR Command Action |
| |
-----------------------------------------------------------------------------
| |
| @path Branches to the screen whose path name is given |
| in path. |
| |
| :MPECommand Executes MPECommand. MPECommand must be a |
| programmatically executable MPE command. |
| |
| COM[PRESS] Transfer to the Compress screen. |
| |
| CON[FIGURATION] or @ Transfers to the Main screen. |
| |
| COP[YSUB] Transfers to the Configuration Subtree Copy |
| screen. |
| |
| ER[RORS] Displays the Error Information screen. |
| |
| EX[IT] Exits from NMMGR (same as QUIT). |
| |
| H[ELP] or ? Calls up help function. (See "Getting Help" in |
| this chapter.) |
| |
| M[AIN] Transfers to the Main screen. |
| |
| NET[DIR] (NS Only) Transfers to the Network Directory Main screen. |
| (You must already have opened the network |
| directory file.) Refer to the NS manuals for |
| more information. |
| |
| NEX[T] Transfers to a brother screen. (See "Branching" |
| in this chapter.) |
| |
-----------------------------------------------------------------------------
Table 2-1. NMMGR Screen Mode Commands (continued)
-----------------------------------------------------------------------------
| |
| NMMGR Command Action |
| |
-----------------------------------------------------------------------------
| |
| NIG[UIDE] (NS Only) Transfers to the Guided HP Configuration screen. |
| Refer to the NS manuals for more information. |
| |
| NIU[PDATE] (NS Only) Transfers to the Guided HP Configuration screen. |
| Refer to the NS manuals for more information. |
| |
| NM[MGRCMD] Transfers to the maintenance mode interface. |
| |
| OP[EN] Transfers to the Open Configuration/Directory |
| File screen. |
| |
| OU[TPUT] Transfers to the Output Configuration File |
| screen. |
| |
| P[RIOR] Returns to the previous screen. Same as |
| pressing Prior Screen. |
| |
| Q[UIT] Exits from NMMGR (same as EXIT). |
| |
| R[EFRESH] Refreshes the current screen. |
| |
| ST[OP] Stops the guided configuration process. |
| |
| SU[BGUIDE] (NS Only) Transfers to the Guided HP Configuration screen. |
| Refer to the NS manuals for more information. |
| |
| U[TILITY] Transfers to the Utility screen. |
| |
| VA[LIDATE] Transfers to the Validate Configuration File |
| screen. |
| |
| VE[RSION] Displays version information. |
| |
-----------------------------------------------------------------------------
Main Window
The major portion of each screen lists menu choices, displays information
and selection choices, and presents fields for entering or displaying
information. With the exception of data entry fields, the information on
the screen is protected against modification.
Path Name.
On most screens that can be reached by direct path branching, the path
name used to reach the screen is displayed in the upper-left corner of
the main screen window. The path name consists of all the screen names
between the root (top of the structure) and the current screen, with the
names separated by periods.
Data Fields and Menu Choices.
Data can be entered only into unprotected fields. For screens with more
than one unprotected field, the cursor automatically moves to the next
unprotected field when you reach the end of the present field or if you
press [TAB].
Generally, you use the [TAB] key to step through the fields from the top
of the screen to the bottom. If you need to back up to a previous field,
the keys to use depend on the type of terminal. Use the [SHIFT][TAB] key
combination for HP 262X terminals. For more information, consult you
terminal reference manual.
When menu choices are presented on the screen, they are usually
associated with one of the function keys at the bottom of the screen. To
select the menu item, press the function key that corresponds to the
item.
Other screens, sometimes referred to as select screens, present a list of
configured items in protected data fields. They also contain a data
entry field into which you can type the name of one of the configured
items and select it for modification. Alternatively, you can type in a
new name for an item to be added to the list. You then press a function
key that lets you perform an action on the selected item (add, modify,
delete, rename). Pressing the function key will cause the action to be
performed and often will cause a new screen to be displayed, allowing you
to modify or define the selected item.
Configuration File Name.
NMMGR displays the name of the configuration file that you are working on
in the area called File: at the bottom of each screen. This name
is shown as filename.group.acct in figure 2-1. On an actual
screen, the name of the file you created or opened at the Open
Configuration/Directory File screen is displayed at this location on the
screen. The file name is not an input field; to change your working
file, you must use the Open Configuration/Directory File screen.
Function Keys
Each NMMGR screen has a set of eight softkeys, or function keys, which
vary in function from screen to screen. Some screens may use only a few
function keys, while others have functions assigned to all eight keys.
The Prior Screen and Help function keys are present in nearly all
screens. Other softkeys are also present, depending on the purpose of
the screen you are viewing. Some of the more common function keys are
described below. For many screens, you can find information on that
screen's function keys in the Help information associated with the
screen.
Prior Screen Key.
Except for a limited number of screens, such as the Error Information
screen and the Guided Configuration screen, the Prior Screen key is the
right-most function key, [f8].
With a few exceptions (listed below), the screen displayed when Prior
Screen is pressed will always be the screen most recently visited prior
to the current screen, regardless of the manner in which you reached the
current screen. In order to show the correct screen, NMMGR maintains a
prior screen list, which is a sequential list of the screens that have
been displayed. Pressing Prior Screen displays the most recent screen in
the prior screen list and removes that screen from the list.
The most recent screen in the list is the screen that was visited just
prior to the current screen, with five exceptions:
* When you display the Error Information screen, NMMGR does not put
this screen in your prior screen list. Thus, pressing Prior
Screen never transfers you to the Error Information screen, even
if it was the latest screen you displayed.
* After reaching the Validate screen in guided configuration, the
prior screen becomes the screen with which you began the guided
configuration.
* If you use the command window to return to a screen already
visited, NMMGR drops any screens visited after this screen from
the prior screen list.
* If you use the Help key to display a help information screen, the
help screen will not appear in the prior screen list.
* Using the NEXT command does not update the prior screen list.
Help Key.
Most NMMGR screens have a Help key as the second key from the right.
Pressing this key displays a help information screen. The help
information relates specifically to the screen from which you pressed the
Help key. It describes screen usage, parameters, and function key
operation for that screen. See "Getting Help" in this chapter for more
information on the NMMGR Help system.
Save Data Key.
Screens with data entry fields have a Save Data key, usually as the third
key from the right-hand side. Pressing this key creates or modifies the
data record and causes the data entered in the screen to be transferred
to the configuration file. If the Data Flag is "N", pressing Save Data
will cause the Data Flag to change to "Y".
"Go to" Keys.
Some keys take you to a specific screen. There may be one or more keys
on the screen that tell NMMGR to "go to" a new screen. For example, the
Go to OUTPUT key on the Utility screen takes you directly to the Output
Configuration File screen.
Next Page/Prev Page Keys.
Some NMMGR screens contain data or display sets of items that will not
fit in a single screen. When this occurs, the screen data is continued
on one or more "pages". The screens will include function keys that
allow you to move back and forth between the pages of the screen. Next
Page moves you to the subsequent page of data. Prev Page moves you to
the prior page of data. Some multiple page screens also include First
Page and Last Page keys, that take you to the first or last page of the
data.
Refreshing the Screen
If you have entered data or changed values on a data screen and decide
not to make the changes before you have entered them into the
configuration file, you can refresh the screen to return it to the state
it was in before you made the changes. Simply enter REFRESH (or the
abbreviation R) in the command window and press [ENTER]. NMMGR will warn
you that the screen has changed since you last updated it. Enter REFRESH
again; NMMGR refreshes the screen and shows its current configuration
file data. In addition, refreshing the screen resets the terminal strap
settings.
You can also use the REFRESH command to "clean up" the screen after a
"TELL" message or other interference has appeared on the screen.
MPE/iX 5.0 Documentation