SirFact: Difference between revisions
m (add all SirFact info from PDF) |
m (add link) |
||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
<var class="product">SirFact</var> is a post hoc debugging tool made up of two distinct components: | <var class="product">SirFact</var> is a [[SirFact_post_hoc_debugging#Ad_hoc_versus_post_hoc_debugging|post hoc debugging]] tool made up of two distinct components: | ||
<ul> | <ul> | ||
<li>A collection of <var class="product">Model 204</var> object code enhancements. Prior to version 7.5 of Model 204, | <li>A collection of <var class="product">Model 204</var> object code enhancements. Prior to version 7.5 of Model 204, | ||
these enhancements are distributed as | these enhancements are distributed as | ||
components of the <var class="product">[[ | components of the <var class="product">[[Sirius Mods]]</var>.</li> | ||
<li>A collection of <var class="product">SOUL</var> procedure files that are distributed | <li>A collection of <var class="product">SOUL</var> procedure files that are distributed | ||
with the <var class="product">RKTools</var> products. These files include: | with the <var class="product">[[RKTools]]</var> products. These files include: | ||
<ul> | <ul> | ||
<li>A <code>SIRFACT</code> file, which contains code | <li>A <code>SIRFACT</code> file, which contains code | ||
| Line 22: | Line 22: | ||
<var class="product">SirFact</var> requires the installation of both of these: | <var class="product">SirFact</var> requires the installation of both of these: | ||
<ul> | <ul> | ||
<li><var class="product">Model 204</var> 7.5 or higher (or the <var class="product"> | <li><var class="product">Model 204</var> 7.5 or higher (or the <var class="product">Sirius Mods</var> if a lower version of <var class="product">Model 204</var>). | ||
<p> | <p> | ||
See the [[Model 204 installation]] page. </p></li> | See the [[Model 204 installation]] page. </p></li> | ||
| Line 39: | Line 39: | ||
<var class="product"><b>[[SirLib]]</b></var> might prove useful to handle | <var class="product"><b>[[SirLib]]</b></var> might prove useful to handle | ||
change control and fix distribution issues related to post hoc (and even | change control and fix distribution issues related to post hoc (and even | ||
ad hoc) debugging. | [[SirFact_post_hoc_debugging#Ad_hoc_versus_post_hoc_debugging|ad hoc]]) debugging. | ||
Though <var class="product">SirFact</var> provides a powerful post hoc debugging facility, | Though <var class="product">SirFact</var> provides a powerful post hoc debugging facility, | ||
| Line 55: | Line 55: | ||
See also: | See also: | ||
<ul> | <ul> | ||
<li> | <li>[[List of Model 204 messages#msir|MSIR. messages]] for information about product error messages. </li> | ||
<li>The [[List of $functions]] for documentation for all $functions except the SirFact-specific $functions, which are documented in [[SirFact $functions]].</li> | <li>The [[List of $functions]] for documentation for all $functions except the SirFact-specific $functions, which are documented in [[SirFact $functions]].</li> | ||
<li>[[Terminal MODEL 6 support]] for information about customizing your workstation's screen geometry. </li> | |||
</ul> | </ul> | ||
===SirFact topic list=== | ===SirFact topic list=== | ||
{{Template: SirFact topic list}} | {{Template: SirFact topic list}} | ||
[[Category: SirFact]] | [[Category: SirFact]] | ||
Latest revision as of 18:46, 18 May 2017
SirFact is a post hoc debugging tool made up of two distinct components:
- A collection of Model 204 object code enhancements. Prior to version 7.5 of Model 204, these enhancements are distributed as components of the Sirius Mods.
- A collection of SOUL procedure files that are distributed
with the RKTools products. These files include:
- A
SIRFACTfile, which contains code useful for looking at SirFact dumps. - The definitions for the
FACTsubsystem, which is useful for looking at SirFact dumps.
No other RKTools products are required to run SirFact, though SirPro makes it more convenient to look at a list of dumps and to select one to be viewed from the
FACTsubsystem. - A
Product installation
SirFact requires the installation of both of these:
- Model 204 7.5 or higher (or the Sirius Mods if a lower version of Model 204).
See the Model 204 installation page.
- RKTools, the version of which must be the same as or lower than that of Model 204.
See the RKTools installation page.
Related products
You can use SirPro to invoke the FACT subsystem, which is used for looking at SirFact dumps.
SirPro also provides a good user interface
for scanning lists of dumps and programs.
SirFact does not address issues with tracking and distributing fixes to bugs once they are written. SirLib might prove useful to handle change control and fix distribution issues related to post hoc (and even ad hoc) debugging.
Though SirFact provides a powerful post hoc debugging facility, the Rocket Model 204 Janus Debugger and the Rocket Model 204 TN/3270 Debugger are interactive debugging facilities that are useful for debugging code while it is being developed.
SirScan can also be useful for debugging certain applications, especially those that are not associated with a terminal; for example, Janus or Connect★ bugs.
SirFact topics
The SirFact documentation consists of the pages listed below. This list is also available as a "See also" link from each of the pages.
See also:
- MSIR. messages for information about product error messages.
- The List of $functions for documentation for all $functions except the SirFact-specific $functions, which are documented in SirFact $functions.
- Terminal MODEL 6 support for information about customizing your workstation's screen geometry.