SirMon custom screens
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.
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:
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 |
|C||Change an existing menu entry. You may only enter a |
|D||Delete an existing menu entry.
You may only enter |
|U||Change the descriptive text of the indicated menu entry, without changing the contents of its displayed screen. Enter |
|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.
As described in the table above, you add an item to monitor by using the A command and entering the name of the item:
The parameter selection screen provides the list of statistics available for that selected view (system, user, file, subsystem, or task):
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.
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
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.
- SirMon application structure
- SirMon main menu
- SirMon System Overview screen
- SirMon threshold setting
- SirMon background monitor
- SirMon System Monitor menu
- SirMon User Monitor menu
- SirMon File Monitor menu
- SirMon Subsystem Monitor menu
- SirMon Task Monitor menu
- SirMon Janus Monitor menu
- SirMon custom screens
- SirMon critical-file-resource monitoring
- SirMon user-initiated capturing of statistics
- System statistics displayed in SirMon
- User statistics displayed in SirMon
- File statistics displayed in SirMon
- Subsystem statistics displayed in SirMon
- Task statistics displayed in SirMon
- Critical File Resource statistics displayed in SirMon
- SirMon date processing