SirMon custom screens: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (add graphics)
 
m (1 revision: SirMon pages)
(No difference)

Revision as of 22:05, 10 September 2015

Option U on each of the system, user, file, subsystem, and task monitor menus allows a SirMon administrator to define and maintain custom monitor screens. Once defined, custom screens appear on the appropriate menu exactly as the pre-defined 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, which will be saved between SirMon sessions.

When Option U is selected on either the System, User, File, Subsystem, or Task menu, a panel is presented that displays all the screens currently available from the appropriate menu. For example, SIRMON 3.U produces:

Menu Customization screen

Each display line has two input areas. The two-character input area to the left of each menu selection number is used to indicate an action that should be taken. The input area to the right of the menu selection number allows you to maintain a descriptive name for the custom screen. The input areas associated with the pre-defined 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 in the first input area for a menu screen:

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.
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 are moving an entry "up," all entries from the target value (nn) to just before the current entry will be moved down one.

If you are moving an entry "down", all entries starting one past the current entry and ending at the target value (nn) will be 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.

Selecting items for custom panels

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

Adding an entry

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

Custom parameter selection screen

Statistics are selected 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.

Custom Parameter Selection screen with descriptions

Selecting statistics

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 up to 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 will fit on the physical screen, and limits the display accordingly. Model 5 3270 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.

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 will warn the user if the statistic cannot be displayed as a total, and it will 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 total MSTRADDs and the rate of change for MSTRADD in all displayed files at each interval refresh.

See also