SirScan scan specification - Revision history

Dme: /* Screen input fields */

2018-03-09T20:49:51Z

Screen input fields

← Older revision		Revision as of 20:49, 9 March 2018
Line 115:		Line 115:
	If an interval is not specified, data is formatted up to the current time (or until I/O limits are reached). In addition, by leaving this time blank, <var class="product">SirScan</var> runs in [[SirScan browsing of the journal#autoref\|auto-refresh mode]], so the data being scanned is constantly refreshed to reflect any new audit trail data that was generated after the initial data was collected.</p></td></tr>		If an interval is not specified, data is formatted up to the current time (or until I/O limits are reached). In addition, by leaving this time blank, <var class="product">SirScan</var> runs in [[SirScan browsing of the journal#autoref\|auto-refresh mode]], so the data being scanned is constantly refreshed to reflect any new audit trail data that was generated after the initial data was collected.</p></td></tr>

	<tr><th>Input journal</th>		<tr id="inputJournal"><th>Input journal</th>
	<td>By default, this is the journal currently in use by the Online in which you are working, and it is indicated by a blank value or by the word <code>CURRENT</code>.		<td>By default, this is the journal currently in use by the Online in which you are working, and it is indicated by a blank value or by the word <code>CURRENT</code>.
	<p>		<p>

JAL: add link

2017-06-06T22:06:47Z

add link

← Older revision		Revision as of 22:06, 6 June 2017
Line 5:		Line 5:
	You are presented with a scan specification screen, which lets you specify the journal data to be retrieved and the format in which it should be displayed.		You are presented with a scan specification screen, which lets you specify the journal data to be retrieved and the format in which it should be displayed.

	In RKWeb, selecting the Monitor > Journal Scan option displays an equivalent menu.		In [[RKWeb]], selecting the <code>Monitor > Journal Scan</code> option displays an equivalent menu.

	<p class="caption" style="width:430px">Journal scan criteria screen</p>		<p class="caption" style="width:430px">Journal scan criteria screen</p>

JALWiccan: Automatically generated page update

2017-06-06T22:01:10Z

Automatically generated page update

← Older revision		Revision as of 22:01, 6 June 2017
Line 217:		Line 217:

	==Commands and function keys==		==Commands and function keys==
	The following commands and PF keys are valid on the ~~3270~~ scan specification screen. Typical browser controls provide comparable functionality in RKWeb.		The following commands and PF keys are valid on the TN3270 scan specification screen. Typical browser controls provide comparable functionality in RKWeb.

	<table class="thJustBold">		<table class="thJustBold">
Line 246:		Line 246:

	==Setting scan display colors==		==Setting scan display colors==
	You can change the colors in the display of the journal scan you are defining. Pressing the F6 key in the ~~3270~~ interface invokes the <b>Set Display Colors</b> screen with which you can specify the colors for the various journal entry types in the SirScan output. In RKWeb, clicking the journal entry type opens a color-picking tool.		You can change the colors in the display of the journal scan you are defining. Pressing the F6 key in the TN3270 interface invokes the <b>Set Display Colors</b> screen with which you can specify the colors for the various journal entry types in the SirScan output. In RKWeb, clicking the journal entry type opens a color-picking tool.

	<p class="caption" style="width:450px">Set Display Colors</p>		<p class="caption" style="width:450px">Set Display Colors</p>

JAL: /* Using bookmarks */ mention RKWeb

2017-05-22T21:40:13Z

Using bookmarks: mention RKWeb

← Older revision		Revision as of 21:40, 22 May 2017
Line 259:		Line 259:
	==Using bookmarks==		==Using bookmarks==
	Bookmarks let you save multiple consecutive scans in a virtual array for the duration of your Online session. Bookmarks are numbered, and new bookmarks numerically follow the number of the last one previously created. You can revisit any of these bookmarked scans, in any order you want, navigating by PF key or command line.		Bookmarks let you save multiple consecutive scans in a virtual array for the duration of your Online session. Bookmarks are numbered, and new bookmarks numerically follow the number of the last one previously created. You can revisit any of these bookmarked scans, in any order you want, navigating by PF key or command line.

			Bookmarks are not available in the RKWeb interface.

	If you set the <b>Bookmark</b> option (in the <b>Format Entry Types</b> section) to <code>Y</code>, then each time you invoke a scan, a solid horizontal line is displayed near the top of the [[SirScan browsing of the journal\|formatted output screen]], marking the beginning of a bookmarked scan and saving that scan with the previous bookmarked scans in the session. Below the bookmark line are the usual content lines of the scan, extending to the current time.		If you set the <b>Bookmark</b> option (in the <b>Format Entry Types</b> section) to <code>Y</code>, then each time you invoke a scan, a solid horizontal line is displayed near the top of the [[SirScan browsing of the journal\|formatted output screen]], marking the beginning of a bookmarked scan and saving that scan with the previous bookmarked scans in the session. Below the bookmark line are the usual content lines of the scan, extending to the current time.

JAL: mention RKWeb equivalents

2017-05-17T01:11:21Z

mention RKWeb equivalents

← Older revision		Revision as of 01:11, 17 May 2017
Line 2:		Line 2:
	<var class="product">SirScan</var> should be installed as a [[Application Subsystem development#Security options\|private Application Subsystem]] in order to use the I/O limits assigned to each [[SCLASS]].		<var class="product">SirScan</var> should be installed as a [[Application Subsystem development#Security options\|private Application Subsystem]] in order to use the I/O limits assigned to each [[SCLASS]].

	To access the system, enter <code>SIRSCAN</code> (or the name of the subsystem you have installed)		To access the system, enter <code>SIRSCAN</code> (or the name of the subsystem you have installed) on the <var class="product">Model 204</var> command line.
	on the <var class="product">Model 204</var> command line.		You are presented with a scan specification screen, which lets you specify the journal data to be retrieved and the format in which it should be displayed.
	You are presented with a scan specification screen, which lets you specify the journal data to be retrieved
	and the format in which it should be displayed:		In RKWeb, selecting the Monitor > Journal Scan option displays an equivalent menu.

	<p class="caption" style="width:430px">Journal scan criteria screen</p>		<p class="caption" style="width:430px">Journal scan criteria screen</p>
Line 217:		Line 217:

	==Commands and function keys==		==Commands and function keys==
	The following commands and PF keys are valid on the scan specification screen:		The following commands and PF keys are valid on the 3270 scan specification screen. Typical browser controls provide comparable functionality in RKWeb.

	<table class="thJustBold">		<table class="thJustBold">
	<caption>Commands</caption>		<caption>Commands</caption>
Line 245:		Line 246:

	==Setting scan display colors==		==Setting scan display colors==
	You can change the colors in the display of the journal scan you are defining. Pressing the F6 key invokes the <b>Set Display Colors</b> screen with which you can specify the colors for the various journal entry types in the SirScan output.		You can change the colors in the display of the journal scan you are defining. Pressing the F6 key in the 3270 interface invokes the <b>Set Display Colors</b> screen with which you can specify the colors for the various journal entry types in the SirScan output. In RKWeb, clicking the journal entry type opens a color-picking tool.

	<p class="caption" style="width:450px">Set Display Colors</p>		<p class="caption" style="width:450px">Set Display Colors</p>
Line 251:		Line 252:

	<p>		<p>
	~~You can set display colors by entry type for both the 3278/3279 display and for the web version of SirScan.~~ The <b>sample</b> column lists the valid 3278/3279 colors you can use. The F1 Help text describes the web-version colors you can specify and the three ways you can specify them. </p>		The <b>(sample)</b> column lists the valid 3278/3279 colors you can use. The F1 Help text describes the web-version colors you can specify and the three ways you can specify them. </p>
	<p>		<p>
	The F1 Help also contains the definitions of the various entry types.		The F1 Help also contains the definitions of the various entry types.
Line 263:		Line 264:
	To the right of the bookmark starting line is a label that identifies the bookmark ID number and time range for that scan period. The time range begins according to the screen's <b>Start time</b> field value and ends at the current time:		To the right of the bookmark starting line is a label that identifies the bookmark ID number and time range for that scan period. The time range begins according to the screen's <b>Start time</b> field value and ends at the current time:

	<p class="code">~~______________________________________________________~~ BookMark 1: 19:59:37.23 - 19:59:58.90		<p class="code">___________________________________________________ BookMark 1: 19:59:37.23 - 19:59:58.90
	</p>		</p>

	The current (active) bookmark is shown in green, while older bookmarks are red. The bookmarks are sequentially numbered, and the message line (red, non-solid) at the bottom of the screen shows the latest bookmark ID. For example, if you have bookmarked four scans, the bottom message line is:		The current (active) bookmark is shown in green, while older bookmarks are red. The bookmarks are sequentially numbered, and the message line (red, non-solid) at the bottom of the screen shows the latest bookmark ID. For example, if you have bookmarked four scans, the bottom message line is:

	<p class="code">~~---~~------------------------------------------------------------------ -- Latest Bookmark: 4		<p class="code">------------------------------------------------------------------ -- Latest Bookmark: 4
	</p>		</p>
	<p>		<p>

JAL at 22:50, 4 May 2016

2016-05-04T22:50:04Z

← Older revision		Revision as of 22:50, 4 May 2016
Line 126:		Line 126:
	<td>The audit trail data can be formatted for any line width from one less than the screen width to 255. The minimum output line width is 131 for <var>[[MODEL parameter\|MODEL]]</var> 5 terminals, and it is 79 for all other terminal types.		<td>The audit trail data can be formatted for any line width from one less than the screen width to 255. The minimum output line width is 131 for <var>[[MODEL parameter\|MODEL]]</var> 5 terminals, and it is 79 for all other terminal types.
	<p>		<p>
	If you set a value greater than your screen width, left and right scrolling with the PF10 and PF11 keys is available to view all the audit trail data. </p></td></tr>		If you set a value greater than your screen width, left and right scrolling of the journal with the PF10 and PF11 keys is available to view all the audit trail data. </p></td></tr>

	<tr><th nowrap>Read extra <br>SCANTIME seconds</th>		<tr><th nowrap>Read extra <br>SCANTIME seconds</th>

JAL: add link

2016-05-04T20:13:18Z

add link

← Older revision		Revision as of 20:13, 4 May 2016
Line 146:		Line 146:
	In the case of very busy systems, set <b>Max I/O's</b> to a relatively small number, such as 100 or 1000, to avoid accidentally scanning too much of the journal if an inappropriate time interval is specified.</p>		In the case of very busy systems, set <b>Max I/O's</b> to a relatively small number, such as 100 or 1000, to avoid accidentally scanning too much of the journal if an inappropriate time interval is specified.</p>
	<p>		<p>
	Though you may specify here a larger number, the maximum value allowed for this field is determined by your subsystem user class (SCLASS). The value can be viewed and set using the SirAdmin subsystem (within the <b>SirScan SCLASS settings</b> option). As of version 7.5, if the value you enter exceeds the value recorded in SirAdmin, these actions follow: </p>		Though you may specify here a larger number, the maximum value allowed for this field is determined by your subsystem user class ([[SCLASS]]). The value can be viewed and set using the SirAdmin subsystem (within the <b>SirScan SCLASS settings</b> option). As of version 7.5, if the value you enter exceeds the value recorded in SirAdmin, these actions follow: </p>
	<ul>		<ul>
	<li>The value is automatically reset to the maximum allowable. </li>		<li>The value is automatically reset to the maximum allowable. </li>
Line 156:		Line 156:
	<td>The maximum number (no more than seven digits) of journal records to be formatted by <var class="product">SirScan</var>. It is recommended that you set <b>Max records</b> to a reasonably small number, such as 10000, to avoid accidentally building an unmanageably large list of formatted records.		<td>The maximum number (no more than seven digits) of journal records to be formatted by <var class="product">SirScan</var>. It is recommended that you set <b>Max records</b> to a reasonably small number, such as 10000, to avoid accidentally building an unmanageably large list of formatted records.
	<p>		<p>
	Though you may specify here a larger number, the maximum value allowed for this field is determined by your subsystem user class (SCLASS). The value can be viewed and set using the SirAdmin subsystem (within the <b>SirScan SCLASS settings</b> option). As of version 7.5, if the value you enter exceeds the value recorded in SirAdmin, these actions follow: </p>		Though you may specify here a larger number, the maximum value allowed for this field is determined by your subsystem user class ([[SCLASS]]). The value can be viewed and set using the SirAdmin subsystem (within the <b>SirScan SCLASS settings</b> option). As of version 7.5, if the value you enter exceeds the value recorded in SirAdmin, these actions follow: </p>
	<ul>		<ul>
	<li>The value is automatically reset to the maximum allowable. </li>		<li>The value is automatically reset to the maximum allowable. </li>

JAL: add link

2016-05-04T19:41:45Z

add link

← Older revision		Revision as of 19:41, 4 May 2016
Line 207:		Line 207:

	<tr><th>Bookmarks</th>		<tr><th>Bookmarks</th>
	<td>Creates extra lines in the resulting display listing that mark the time range for each scan. This feature is available with version 7.5 or higher.		<td>Creates extra lines in the resulting display listing that mark the time range for each scan. This feature is available with version 7.5 or higher. See [[#Using bookmarks\|Using bookmarks]], below.
	<p class="note"><b>Note:</b> Bookmarks are only active if the <b>Interval (Minutes)</b> field is left blank.</p>		<p class="note"><b>Note:</b> Bookmarks are only active if the <b>Interval (Minutes)</b> field is left blank.</p>
	</td></tr>		</td></tr>

JAL: add scrolling remark

2016-04-27T21:57:40Z

add scrolling remark

← Older revision		Revision as of 21:57, 27 April 2016
Line 124:		Line 124:

	<tr><th>Line Width</th>		<tr><th>Line Width</th>
	<td>The audit trail data can be formatted for any line width from one less than the screen width to 255. The minimum output line width is 131 for <var>[[MODEL parameter\|MODEL]]</var> 5 terminals, and it is 79 for all other terminal types.</td></tr>		<td>The audit trail data can be formatted for any line width from one less than the screen width to 255. The minimum output line width is 131 for <var>[[MODEL parameter\|MODEL]]</var> 5 terminals, and it is 79 for all other terminal types.
			<p>
			If you set a value greater than your screen width, left and right scrolling with the PF10 and PF11 keys is available to view all the audit trail data. </p></td></tr>

	<tr><th nowrap>Read extra <br>SCANTIME seconds</th>		<tr><th nowrap>Read extra <br>SCANTIME seconds</th>

JAL: add info re exceeding max value

2016-04-27T19:56:38Z

add info re exceeding max value

← Older revision		Revision as of 19:56, 27 April 2016
Line 140:		Line 140:

	<tr><th>Max I/O's</th>		<tr><th>Max I/O's</th>
	<td>The maximum number of full-track journal reads <var class="product">SirScan</var> will perform when scanning the journal~~. The maximum value allowed for this field is determined by the user's subsystem SCLASS~~.		<td>The maximum number of full-track journal reads <var class="product">SirScan</var> will perform when scanning the journal.
	<p>		<p>
	In the case of very busy systems, set <b>Max I/O's</b> to a relatively small number, such as 100 or 1000, to avoid accidentally scanning too much of the journal if an inappropriate time interval is specified.</p></td></tr>		In the case of very busy systems, set <b>Max I/O's</b> to a relatively small number, such as 100 or 1000, to avoid accidentally scanning too much of the journal if an inappropriate time interval is specified.</p>
			<p>
			Though you may specify here a larger number, the maximum value allowed for this field is determined by your subsystem user class (SCLASS). The value can be viewed and set using the SirAdmin subsystem (within the <b>SirScan SCLASS settings</b> option). As of version 7.5, if the value you enter exceeds the value recorded in SirAdmin, these actions follow: </p>
			<ul>
			<li>The value is automatically reset to the maximum allowable. </li>

			<li>An informational message is displayed on the "message line" near the bottom of this screen. </li>
			</ul></td></tr>

	<tr><th>Max records</th>		<tr><th>Max records</th>
	<td>The maximum number of journal records to be formatted by <var class="product">SirScan</var>. ~~The maximum value allowed for this field~~ is ~~determined by the user's subsystem SCLASS~~.		<td>The maximum number (no more than seven digits) of journal records to be formatted by <var class="product">SirScan</var>. It is recommended that you set <b>Max records</b> to a reasonably small number, such as 10000, to avoid accidentally building an unmanageably large list of formatted records.
	<p>		<p>
	~~Set~~ <b>~~Max records~~</b> ~~to a reasonably small number~~, ~~such as 10000~~, to ~~avoid accidentally building an unmanageably large list~~ of ~~formatted records~~. </p></td></tr>		Though you may specify here a larger number, the maximum value allowed for this field is determined by your subsystem user class (SCLASS). The value can be viewed and set using the SirAdmin subsystem (within the <b>SirScan SCLASS settings</b> option). As of version 7.5, if the value you enter exceeds the value recorded in SirAdmin, these actions follow: </p>
			<ul>
			<li>The value is automatically reset to the maximum allowable. </li>

			<li>An informational message is displayed on the "message line" near the bottom of this screen. </li>
			</ul>
			</td></tr>

	<tr><th>Display</th>		<tr><th>Display</th>