Release notes for SirScan V7.5: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
m (→‎New QT scan line option: add feature description)
 
(51 intermediate revisions by 4 users not shown)
Line 1: Line 1:
This document lists the changes that have been made for <var class="product">SirScan</var> version S7.5. It requires <var class="product">Model 204</var> release 7.5 or higher.
This document lists the changes that have been made for <var class="product">[[SirScan]]</var> version 7.5. It requires <var class="product">Model 204</var> version 7.5 or higher.


== Scan Select Screen (SCANSEL) ==
<var class="product">SirScan</var> is a member of the <var class="product">[[RKTools]]</var> product family; see also the [[Release notes for RKTools V7.5|release notes for RKTools version 7.5]].


== Field changes ==
The previous version of <var class="product">SirScan</var> was 707, available in March, 2010.


=== Bookmarks ===
==Scan criteria screen (ScanSel/SS)==


Bookmarks are a new feature.  When turned on (value "Y"), a bookmark line will
===Layout changes===
be created in the display on the SCANLIST page for each successive scan request.  
The screen layout has changed slightly: the <b>Users</b> field is now first. Also, the labels of the field prompts consistently use a colon (<tt>:</tt>) rather than the more verbose <code>==></code>.
The line looks like:


<p class="code">______________________________________________________ BookMark 4: 19:59:37.23 - 19:59:58.90
===Field changes===
</p>


It shows the bookmark number and the time range for that scan. The bookmarks
====New scan-line color option====
are sequentially numbered and the message line at the bottom of the screen shows
By setting <b>Use Color</b> to <code>Y</code>, the color of the scan lines is based on the entry types. The colors can be changed by using [[#PF6 - SetColors|PF6, SetColors]] which invokes the [[#Set Colors screen (SetColors/SC)|Set Colors screen]].
the lasted bookmark id, for example:


<p class="code">--------------------------------------------------------------------- -- Latest Bookmark: 4
====New QT scan line option====
</p>
A QT line is added to the set of [[SirScan browsing of the journal#Journal entry types|journal entry types]], that is, types of information lines obtained from the journal and displayed in SirScan. A QT line shows the output of a Horizon thread, for example, an SQL SELECT statement.


Bookmarks are saved for the session. Hence if SirScan is exited and re-entered
You indicate you want SirScan displays to include QT lines by setting the <b>QT</b> field to <code>Y</code> in the <b>Format Entry Types</b> section of the [[SirScan scan specification|Journal scan criteria screen]] (as well as making sure the <b>Entry Type</b> field in the <b>Display</b> section is also <code>Y</code>.
during the same session, the previous bookmarks are retained and can be
re-displayed.  The new bookmark id's will follow on from the last one previously
created.  This provides an alternative to noting down the time of a scan in
cases where the information needs to be re-displayed. Also it is possible to
change the Display and Format Entry Types on this screen and re-display the
journal lines for a previous bookmark period.


====New Bookmarks option====
When the new <b>Bookmarks</b> feature is set on (value <code>Y</code>), a bookmark line is created in the display on the ScanList page for each successive scan request.
<p class="note"><b>Note:</b> Bookmarks are only active if the <b>Interval (Minutes)</b> field is left blank. </p>


See [[#Bookmark lines|Bookmark lines]] below for more details.


See xxx for more details.
====Start Time changes====
The <b>Start time (HH:MM:SS)</b> field newly accepts periods(<tt>.</tt>) as separators. As a result, these are valid formats for this field: <i>HH</i>:<i>MM</i>:<i>SS</i>, <i>HH</i>.<i>MM</i>.<i>SS</i>, or <i>HHMMSS</i>.


====Max I/O's and Max records changes====
<ul>
<li>The size of <b>Max records</b> has increased to seven digits. </li>


<li>The <b>Max I/O's</b> and <b>Max records</b> fields are changed to recognize, reset, and report the situation where the values entered are greater than the maximum allowable. The maximum allowable values for the <b>Max I/O's</b> and <b>Max records</b> fields can be viewed and/or set using the SirAdmin subsystem (within the <b>SirScan SCLASS settings</b> option). 
<p>
If the <b>Max I/O's</b> and/or <b>Max records</b> values entered on the scan specification screen exceed those recorded in SirAdmin, these actions follow: </p>
<ul>
<li>The values are automatically reset to the maximum allowable. </li>


==Scan List Screen (SCANLIST)==
<li>An informational message is displayed on the "message line" (second line from the bottom of the screen). </li>
</ul></li>
</ul>
 
===Function key changes===
 
====PF4 - Reset Time====
Reset the date and time to the selected journal's initialization
date and time. 
 
====PF6 - SetColors====
This function key navigates to the <b>Set Display Colors</b> screen, which lets you change the color of the journal display lines per entry type.
 
==Set Display Colors screen (SetColors/SC)==
This new screen lets you set the colors for the various Entry Types. The screen looks like this:
<p class="figure">[[File:SScanSetColors.png|450px]]</p>
 
==Scan List screen (ScanList/SL)==
 
===Field changes===
 
====New bookmarking command====
A command in format .<i>bookmarkID</i> navigates directly to that [[#Bookmark lines|bookmark]]. For example:
 
<p class="code">.22</p>
 
Omitting the <i>bookmarkID</i> value in the command (that is, entering just <code>.</code>), navigates to the latest bookmark.
 
====Left/Right scrolling====
If the [[SirScan scan specification|scan specification screen]] <b>Line Width</b> is set to a value greater than your screen width, right and left scrolling with the PF10 and PF11 keys is now fixed and available to view all the audit trail data.
 
===Screen display changes===
 
====Bookmark lines====
The new <b>Bookmarks</b> option in the <b>Format Entry Types</b> section of the scan specification screen lets you save one or more scans in a session for later re-display. The function keys F5 (<b>Prev Bkmk</b>) and F6 (<b>Next Bkmk</b>) and a command line command (<var>.<i>bookmark</i></var>) let you view the bookmarked scans consecutively or in any order you want.
 
See [[SirScan scan specification#Using bookmarks|Using bookmarks]] for more information.
 
===Function keys===
 
====PF5/PF6 - Previous/Next Bookmark (or refresh)====
As stated above in [[#Bookmark lines|Bookmark lines]],
the PF5 and PF6 keys help you view any bookmarked scans saved in your Online session. For more information, see [[SirScan scan specification#Navigating your bookmarks|Navigating your bookmarks]].
 
====PF7/PF8 - cursor sensitive scrolling====
The scrolling has been enhanced to scroll based on the position of the
cursor when the cursor is in the listing area:
<ul>
<li>If F8 is pressed, the page scrolls so the line on which the cursor was placed becomes the top line. </li>
 
<li>If F7 is pressed, the line on which the cursor was placed becomes the bottom line. </li>
</ul>
In either case, the cursor is reset to the command-line field, so
subsequent scrolling is for full pages.

Latest revision as of 23:01, 5 July 2016

This document lists the changes that have been made for SirScan version 7.5. It requires Model 204 version 7.5 or higher.

SirScan is a member of the RKTools product family; see also the release notes for RKTools version 7.5.

The previous version of SirScan was 707, available in March, 2010.

Scan criteria screen (ScanSel/SS)

Layout changes

The screen layout has changed slightly: the Users field is now first. Also, the labels of the field prompts consistently use a colon (:) rather than the more verbose ==>.

Field changes

New scan-line color option

By setting Use Color to Y, the color of the scan lines is based on the entry types. The colors can be changed by using PF6, SetColors which invokes the Set Colors screen.

New QT scan line option

A QT line is added to the set of journal entry types, that is, types of information lines obtained from the journal and displayed in SirScan. A QT line shows the output of a Horizon thread, for example, an SQL SELECT statement.

You indicate you want SirScan displays to include QT lines by setting the QT field to Y in the Format Entry Types section of the Journal scan criteria screen (as well as making sure the Entry Type field in the Display section is also Y.

New Bookmarks option

When the new Bookmarks feature is set on (value Y), a bookmark line is created in the display on the ScanList page for each successive scan request.

Note: Bookmarks are only active if the Interval (Minutes) field is left blank.

See Bookmark lines below for more details.

Start Time changes

The Start time (HH:MM:SS) field newly accepts periods(.) as separators. As a result, these are valid formats for this field: HH:MM:SS, HH.MM.SS, or HHMMSS.

Max I/O's and Max records changes

  • The size of Max records has increased to seven digits.
  • The Max I/O's and Max records fields are changed to recognize, reset, and report the situation where the values entered are greater than the maximum allowable. The maximum allowable values for the Max I/O's and Max records fields can be viewed and/or set using the SirAdmin subsystem (within the SirScan SCLASS settings option).

    If the Max I/O's and/or Max records values entered on the scan specification screen exceed those recorded in SirAdmin, these actions follow:

    • The values are automatically reset to the maximum allowable.
    • An informational message is displayed on the "message line" (second line from the bottom of the screen).

Function key changes

PF4 - Reset Time

Reset the date and time to the selected journal's initialization date and time.

PF6 - SetColors

This function key navigates to the Set Display Colors screen, which lets you change the color of the journal display lines per entry type.

Set Display Colors screen (SetColors/SC)

This new screen lets you set the colors for the various Entry Types. The screen looks like this:

Scan List screen (ScanList/SL)

Field changes

New bookmarking command

A command in format .bookmarkID navigates directly to that bookmark. For example:

.22

Omitting the bookmarkID value in the command (that is, entering just .), navigates to the latest bookmark.

Left/Right scrolling

If the scan specification screen Line Width is set to a value greater than your screen width, right and left scrolling with the PF10 and PF11 keys is now fixed and available to view all the audit trail data.

Screen display changes

Bookmark lines

The new Bookmarks option in the Format Entry Types section of the scan specification screen lets you save one or more scans in a session for later re-display. The function keys F5 (Prev Bkmk) and F6 (Next Bkmk) and a command line command (.bookmark) let you view the bookmarked scans consecutively or in any order you want.

See Using bookmarks for more information.

Function keys

PF5/PF6 - Previous/Next Bookmark (or refresh)

As stated above in Bookmark lines, the PF5 and PF6 keys help you view any bookmarked scans saved in your Online session. For more information, see Navigating your bookmarks.

PF7/PF8 - cursor sensitive scrolling

The scrolling has been enhanced to scroll based on the position of the cursor when the cursor is in the listing area:

  • If F8 is pressed, the page scrolls so the line on which the cursor was placed becomes the top line.
  • If F7 is pressed, the line on which the cursor was placed becomes the bottom line.

In either case, the cursor is reset to the command-line field, so subsequent scrolling is for full pages.