SirMon custom screens

From m204wiki
Revision as of 21:45, 6 June 2017 by JAL (talk | contribs) (TN prefix for 3270)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Option U on each of the SirMon TN3270 system, user, file, subsystem, and task monitor menus lets a SirMon administrator define and maintain custom monitor screens. Once defined, custom screens appear on the appropriate menu exactly as the predefined screens supplied with SirMon, and they support the same prefix and command-line commands.

Option A allows each user to create their own private "adhoc" screen within each category. Such a screen is saved between SirMon sessions.

In RKWeb, selecting the Performance > Custom menu of the Monitor tab displays a page that lets you define custom views containing the statistics you want displayed.

Updating a monitoring menu

When option U is selected on the System, User, File, Subsystem, or Task Monitor menu, a screen is displayed that contains all the statistic displays currently available from that menu. For example, SIRMON 3.U entered from an RKTools command prompt produces:

Menu customization screen

SmonCustom.png

The updating commands

Each non-protected display line on a customizing screen has two input areas. The two-character input area to the left of each menu selection number is what you use to indicate an action to be taken. The input area to the right of the menu selection number lets you maintain a descriptive name for the custom screen.

The input areas associated with the predefined screens provided with SirMon are protected, preventing modifications.

Only one administrator at a time may modify a particular menu.

The following action commands can be placed to the left of an item number:

A Add a new entry to the menu. You must provide a name for the entry in the input area to the right of the item number. You may only enter an A on a line that does not have an existing menu definition. If you press the Enter key, you advance to the parameter selection screen.For more information, see Adding a new item to the monitoring menu, below.
C Change an existing menu entry. You may only enter a C on a line that already contains a menu entry. C indicates that you intend to update the list of selected parameters. If you press the Enter key, you advance to the parameter selection screen.
D Delete an existing menu entry. You may only enter D on a line that has an existing menu entry defined. If you press the Enter key, the menu entry is deleted from the menu, and its parameters are discarded.
U Change the descriptive text of the indicated menu entry, without changing the contents of its displayed screen. Enter U in the input area, type over the existing descriptive text, and press the Enter key. The new name is then available.
nn Move the indicated menu entry to a different location on the menu. The number you enter is the desired new location for the current menu entry.

If you move an entry "up," all entries from the target value (nn) to just before the current entry are moved down one.

If you move an entry "down," all entries starting one past the current entry and ending at the target value (nn) are moved up one.

You may update only one line at a time, and you cannot change the position of any predefined SirMon screens.

The customized menu will not contain any embedded blank entries. If an entry is deleted from the middle of the menu, subsequent entries move up one position.

Adding a new item to the monitoring menu

As described in the table above, you add an item to monitor by using the A command and entering the name of the item:

Adding an entry

SmonCustomAddCrop.png

The parameter selection screen provides the list of statistics available for that selected view (system, user, file, subsystem, or task):

Custom parameter selection screen

SmonCustomSelectStat.png

You select statistics by typing their names into the labeled input areas in the upper portion of the screen. The PF11 key toggles the display of selectable statistics between a simple list of statistic names and a list of statistics with associated descriptions.

Viewing statistic descriptions

SmonCustomSelectStat2crop.png

The custom screen can be previewed at any time with the PF2 key. The custom screen definition can be saved with the PF12 key.

The screen allows as many as 16 statistics to be added to any screen definition. When the screen is invoked, SirMon examines the type of the current user's terminal to see how many of the statistics fit on the physical screen, and it limits the display accordingly. Model 5 TN3270 displays, for instance, can display as many as 132 characters across the screen. If the last statistic defined for a screen is procedure name (PNAME), SirMon will fit as many of the names as it can on the screen, truncating the name if necessary.

The SirMon Help facility is automatically generated for a custom screen, including descriptions of each displayed statistic.

Statistics as rates or totals

With a few exceptions, viewable statistics fall into five categories: literal values (like procedure and file names), percentages (such as BFULLP), rates, totals, or differences. Most statistics viewable as rates can also be viewed as totals. Statistics that can be viewed as either a rate or a total default in SirMon to rate displays.

To specify that a statistic should be presented as a total in a custom screen, you append a number sign (#) to the statistic name (for example, DKIO#). SirMon warns you if the statistic cannot be displayed as a total, and it does not allow the screen to be previewed or saved.

A statistic may be specified as both a rate and a total on the same screen. For example, a file statistics screen could be defined that presents MSTRADD (records added to table B master areas) as both a rate and a total. Users of the screen would see both the MSTRADD total value as well as the rate of change for MSTRADD in all displayed files at each interval refresh.

See also