Admin: 1 revision

2016-11-01T20:29:11Z

1 revision

← Older revision	Revision as of 20:29, 1 November 2016
(No difference)

JAL: typo

2016-11-01T19:04:53Z

typo

New page

__NOTOC__
The SirFile main menu (File Monitor) is presented on entering <var class="product">SirFile</var> any time
but the first. The File Monitor screen is called the "main menu" because it provides access to all the SirFile screens, and it is also presented when the PF3 key is pressed from most <var class="product">SirFile</var> screens.

The first time you enter <var class="product">SirFile</var>, the [[SirFile#Getting started|System Default thresholds screen]]
is presented, an initial database load is performed, then the SirFile main menu is presented.

File Monitor screen
[[File:SfileMainMenu.png|475px]]

==Using the main menu==
As many as 64 files are shown at once on the File Monitor screen. If any file has a warning or prediction posted against it, it is color-highlighted and a pointer (<code>=></code>) is placed to the left of its file name.

===Command line options===
The following commands are allowed:
<table>
<tr><th>n</th>
<td>Where n is any number. Scrolls the display forward the specified number of files.</td></tr>

<tr><th>-n</th>
<td>Where n is any number. Scrolls the display backward the specified number of files.</td></tr>

<tr><th><var>F</var> filename <var>or / </var>filename</th>
<td>Searches forward in the file list for the requested file name.</td></tr>

<tr><th><var>-F</var> filename <var>or -/ </var>filename</th>
<td>Searches backward in the file list for the requested file name.</td></tr>

<tr><th><var>Top</var></th>
<td>Moves the display to the top of the file list.</td></tr>

<tr><th><var>Bottom</var></th>
<td>Moves the display to the bottom of the file list.</td></tr>

<tr><th><var>M</var></th>
<td>When using the PF7 key or the PF8 key, scroll up or down to the top or bottom of the list of files.</td></tr>

<tr><th><var>ADD</var> filename</th>
<td>Add the specified file to the database. <var class="product">SirFile</var> attempts to open the file; if the file cannot be opened, you are prompted for a password.

Once the file is open, <var class="product">SirFile</var> analyzes the file tables, stores a file record, and returns to this File Monitor screen, where the new file is added to the list.</td></tr>

<tr><th nowrap><var>REFRESH</var> filename</th>
<td><code>REFRESH</code> performs the same function as the <var>ADD</var> command if the specified file is not already in the database.
If the file is in the database, a [[SirFile refresh process#Two types of refresh|one-time refresh]] is performed to check the file's status against the thresholds in effect. If the specified number of days has passed since the last sample, or if a threshold has been exceeded, a record is stored for the file.</td></tr>

<tr><th><var>OPEN</var> filename</th>
<td>Opens a file. As data can only be collected for files that <var class="product">SirFile</var> already knows about, or files that are currently open by any user, you may want to manually open a file before running a refresh to guarantee the file is included in the sample.</td></tr>

<tr><th><var>CLOSE</var> filename</th>
<td>Closes a file. Any file that you have open can be closed, except SIRFILE, SIRLOCAL, and CCASYS (the required application subsystem files for <var class="product">SirFile</var>).</td></tr>

<tr><th nowrap><var>DELETE</var> filename</th>
<td>Removes the file from the <var class="product">SirFile</var> database. It is rarely necessary to delete a file from <var class="product">SirFile</var>, but if a file is obsolete or is never allocated to the Online region, the <var class="product">SirFile</var> administrator may find it inconvenient to be prompted for passwords when the file cannot be opened during a refresh.

<code>DELETE</code> removes all records associated with the file: warnings, history, and thresholds.</td></tr>

<tr><th><var>TIME</var> xxxx yy</th>
<td>Puts the screen into auto-refresh mode. The screen will refresh xxxx times every yy seconds.

This command does not invoke the refresh process each time it wakes up, so it is only useful if a background task (or some other user) is running occasional refreshes,
and this screen is used to view the changed information.</td></tr>
</table>

===Function keys===
These are the function keys for this screen.
<table class="thJustBold">
<tr><th>PF1</th>
<td>Accesses full-screen help.</td></tr>

<tr><th>PF2</th>
<td>Accesses the [[SirFile Background File Monitor screen]]. This screen controls background monitoring, and it specifies actions taken when the monitor notices file-full-pending conditions.</td></tr>

<tr><th>PF3</th>
<td>Return to command level or to the [[RKTools#Integrating RKTools with other subsystems|RKTools main menu]].</td></tr>

<tr><th>PF4</th>
<td>Accesses a [[SirFile file tables screen|tables screen]] that displays the table-full status of files currently open by any user or subsystem.</td></tr>

<tr><th>PF6</th>
<td>Accesses a [[SirFile messages screen|screen of messages]] posted to the file. The only messages posted are predictions for when a file will fill.

Only files whose names are color-highlighted and preceded by a pointer (<code>=></code>) on the SirFile main menu have messages posted to them. If a file is highlighted and has no messages posted to it, then it has already exceeded some table threshold,
and the file detail screen (see PF10) displays the status of the file.</td></tr>

<tr><th>PF7</th>
<td>Scrolls the list of files upward.</td></tr>

<tr><th>PF8</th>
<td>Scrolls the list of files downward.</td></tr>

<tr><th>PF9</th>
<td>Repeats the last command-line command.</td></tr>

<tr><th>PF10</th>
<td>The cursor must be on a file name for this key to work. You are presented with a [[SirFile file detail screen|file detail screen]] that shows the current state of the file, including the current rate of growth for a wide variety of file statistics.

If the file requires a password to open, and the file is not already open in the region, you are prompted for the password before the detail display can be shown.</td></tr>

<tr><th>PF11</th>
<td>If the cursor is on a file name when the key is pressed, you access a [[SirFile single file thresholds|threshold screen]] for viewing or modifying that file's threshold information. If the cursor is not on a file when the key is pressed, you are presented with the [[SirFile#Getting started|system thresholds screen]], showing defaults used by any file whose thresholds you have not modified.</td></tr>

<tr><th>PF12</th>
<td>Invokes a <var class="product">SirFile</var> [[SirFile refresh process#Two types of refresh|one-time database refresh]] operation.</td></tr>
</table>

==See also==
{{Template:SirFile topic list}}

[[Category:SirFile]]

SirFile main menu - Revision history

Admin: 1 revision

JAL: typo