SirMon custom screens - Revision history

JAL: TN prefix for 3270

2017-06-06T21:45:49Z

TN prefix for 3270

← Older revision		Revision as of 21:45, 6 June 2017
Line 1:		Line 1:
	Option U on each of the <var class="product">SirMon</var> ~~3270~~ [[SirMon System Monitor menu\|system]], [[SirMon User Monitor menu\|user]], [[SirMon File Monitor menu\|file]], [[SirMon Subsystem Monitor menu\|subsystem]], and [[SirMon Task Monitor menu\|task]] monitor menus lets a <var class="product">SirMon</var> administrator define and maintain custom monitor screens.		Option U on each of the <var class="product">SirMon</var> TN3270 [[SirMon System Monitor menu\|system]], [[SirMon User Monitor menu\|user]], [[SirMon File Monitor menu\|file]], [[SirMon Subsystem Monitor menu\|subsystem]], and [[SirMon Task Monitor menu\|task]] monitor menus lets a <var class="product">SirMon</var> administrator define and maintain custom monitor screens.
	Once defined, custom screens appear on the appropriate menu exactly as		Once defined, custom screens appear on the appropriate menu exactly as
	the predefined screens supplied with <var class="product">SirMon</var>, and they support the same prefix and command-line commands.		the predefined screens supplied with <var class="product">SirMon</var>, and they support the same prefix and command-line commands.
Line 75:		Line 75:
	The custom screen definition can be saved with the PF12 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, <var class="product">SirMon</var> 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 ~~3270~~ displays, for instance, can display as many as 132 characters across the screen.		The screen allows as many as 16 statistics to be added to any screen definition. When the screen is invoked, <var class="product">SirMon</var> 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),		If the last statistic defined for a screen is procedure name (PNAME),
	<var class="product">SirMon</var> will fit as many of the names as it can on the screen, truncating the name if necessary.		<var class="product">SirMon</var> will fit as many of the names as it can on the screen, truncating the name if necessary.

JAL: add link

2017-06-06T20:07:57Z

add link

← Older revision		Revision as of 20:07, 6 June 2017
Line 6:		Line 6:
	within each category. Such a screen is saved between <var class="product">SirMon</var> sessions.		within each category. Such a screen is saved between <var class="product">SirMon</var> 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.		In [[RKWeb]], selecting the <code>Performance > Custom</code> menu of the <code>Monitor</code> tab displays a page that lets you define custom views containing the statistics you want displayed.

	==Updating a monitoring menu==		==Updating a monitoring menu==

JAL: mention RKWeb equivalents

2017-05-11T22:47:30Z

mention RKWeb equivalents

← Older revision		Revision as of 22:47, 11 May 2017
Line 1:		Line 1:
	~~<!--Page automatically generated by CMSTOWIK EXEC and will be~~		Option U on each of the <var class="product">SirMon</var> 3270 [[SirMon System Monitor menu\|system]], [[SirMon User Monitor menu\|user]], [[SirMon File Monitor menu\|file]], [[SirMon Subsystem Monitor menu\|subsystem]], and [[SirMon Task Monitor menu\|task]] monitor menus lets a <var class="product">SirMon</var> administrator define and maintain custom monitor screens.
	automatically replaced -- any manual edits will be lost.
	~~You've been warned. .. (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->~~
	~~<!-- Page name: SirMon custom screens-->~~
	Option U on each of the [[SirMon System Monitor menu\|system]], [[SirMon User Monitor menu\|user]], [[SirMon File Monitor menu\|file]], [[SirMon Subsystem Monitor menu\|subsystem]], and [[SirMon Task Monitor menu\|task]] monitor menus lets a <var class="product">SirMon</var> administrator define and maintain custom monitor screens.
	Once defined, custom screens appear on the appropriate menu exactly as		Once defined, custom screens appear on the appropriate menu exactly as
	the predefined screens supplied with <var class="product">SirMon</var>, and they support the same prefix and command-line commands.		the predefined screens supplied with <var class="product">SirMon</var>, and they support the same prefix and command-line commands.
Line 9:		Line 5:
	Option A allows each user to create their own private "adhoc" screen		Option A allows each user to create their own private "adhoc" screen
	within each category. Such a screen is saved between <var class="product">SirMon</var> sessions.		within each category. Such a screen is saved between <var class="product">SirMon</var> 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==		==Updating a monitoring menu==

JAL: minor wordsmithing

2015-11-03T21:58:56Z

minor wordsmithing

← Older revision		Revision as of 21:58, 3 November 2015
Line 14:		Line 14:
	or Task Monitor menu, a screen is displayed that contains all the statistic displays currently available from that menu. For example, <code>SIRMON 3.U</code> entered from an RKTools command prompt produces:		or Task Monitor menu, a screen is displayed that contains all the statistic displays currently available from that menu. For example, <code>SIRMON 3.U</code> entered from an RKTools command prompt produces:

	<p class="caption" style="width:475px">Menu ~~Customization~~ screen</p>		<p class="caption" style="width:475px">Menu customization screen</p>
	<p class="figure">[[File:SmonCustom.png\|475px]]</p>		<p class="figure">[[File:SmonCustom.png\|475px]]</p>

Line 77:		Line 77:
	The custom screen definition can be saved with the PF12 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, <var class="product">SirMon</var> 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 3270 displays, for instance, can display as many as 132 characters across the screen.		The screen allows as many as 16 statistics to be added to any screen definition. When the screen is invoked, <var class="product">SirMon</var> 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 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),		If the last statistic defined for a screen is procedure name (PNAME),
	<var class="product">SirMon</var> will fit as many of the names as it can on the screen, truncating the name if necessary.		<var class="product">SirMon</var> will fit as many of the names as it can on the screen, truncating the name if necessary.

JAL: misc formatting

2015-11-02T23:31:02Z

misc formatting

Show changes

JAL: reduce size of graphic

2015-09-10T23:08:24Z

reduce size of graphic

← Older revision		Revision as of 23:08, 10 September 2015
Line 16:		Line 16:
	For example, <code>SIRMON 3.U</code> produces:		For example, <code>SIRMON 3.U</code> produces:

	<p class="caption" style="width:~~500px~~">Menu Customization screen</p>		<p class="caption" style="width:475px">Menu Customization screen</p>
	<p class="figure">[[File:SmonCustom.png\|~~500px~~]]</p>		<p class="figure">[[File:SmonCustom.png\|475px]]</p>

	Each display line has two input areas.		Each display line has two input areas.
Line 67:		Line 67:
	available for that selected view (system, user, file, subsystem, or task):		available for that selected view (system, user, file, subsystem, or task):

	<p class="caption" style="width:~~500px~~">Custom parameter selection screen</p>		<p class="caption" style="width:475px">Custom parameter selection screen</p>
	<p class="figure">[[File:SmonCustomSelectStat.png\|~~500px~~]]</p>		<p class="figure">[[File:SmonCustomSelectStat.png\|475px]]</p>

	Statistics are selected by typing their names into the labeled input		Statistics are selected by typing their names into the labeled input

Admin: 1 revision: SirMon pages

2015-09-10T22:05:21Z

1 revision: SirMon pages

← Older revision	Revision as of 22:05, 10 September 2015
(No difference)

JAL: add graphics

2015-09-09T22:45:43Z

add graphics

New page

Option U on each of the system, user, file, subsystem, and task monitor menus
allows a <var class="product">SirMon</var> 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 <var class="product">SirMon</var> 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 <var class="product">SirMon</var> 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, <code>SIRMON 3.U</code> produces:

Menu Customization screen
[[File:SmonCustom.png|500px]]

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
<var class="product">SirMon</var> 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:

<table class="thJustBold">
<tr><th>A</th>
<td>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 <code>A</code> on a line that does not have an existing menu definition. If you press the Enter key, you advance to the parameter selection screen.</td></tr>

<tr><th>C</th>
<td>Change an existing menu entry. You may only enter a <code>C</code> on a line that already contains a menu entry. <code>C</code> indicates that you intend to update the list of selected parameters. If you press the Enter key, you advance to the parameter selection screen.</td></tr>

<tr><th>D</th>
<td>Delete an existing menu entry.
You may only enter <code>D</code> 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.</td></tr>

<tr><th>U</th>
<td>Change the descriptive text of the indicated menu entry, without changing the contents of its displayed screen. Enter <code>U</code> in the input area, type over the existing descriptive text, and press the Enter key. The new name is then available.</td></tr>

<tr><th>nn</th>
<td>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 <var class="product">SirMon</var> screens.</td></tr>
</table>

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
[[File:SmonCustomAddCrop.png|400px]]

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

Custom parameter selection screen
[[File:SmonCustomSelectStat.png|500px]]

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
[[File:SmonCustomSelectStat2crop.png|400px]]

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, <var class="product">SirMon</var> 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),
<var class="product">SirMon</var> will fit as many of the names as it can on the screen, truncating the name if necessary.

The <var class="product">SirMon</var> 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
<var class="product">SirMon</var> to rate displays.

To specify that a statistic should be presented as a total in a custom
screen, you append a number sign (<tt>#</tt>) to the statistic name
(for example, <code>DKIO#</code>).
<var class="product">SirMon</var> 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==
{{Template:SirMon topic list}}

[[Category: SirMon]]