SirFact: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (merge see also items)
m (add link)
 
(4 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&nbsp;204</var> object code enhancements. Prior to version 7.5 of Model 204,  
<li>A collection of <var class="product">Model&nbsp;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">[[SirMods]]</var>.</li>
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&nbsp;204</var> 7.5 or higher (or the <var class="product">SirMods</var> if a lower version of <var class="product">Model&nbsp;204</var>).
<li><var class="product">Model&nbsp;204</var> 7.5 or higher (or the <var class="product">Sirius Mods</var> if a lower version of <var class="product">Model&nbsp;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>The [[:Category:Sirius_Mods_messages]] for information about product error messages. </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>

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 SIRFACT file, which contains code useful for looking at SirFact dumps.
    • The definitions for the FACT subsystem, 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 FACT subsystem.

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:

SirFact topic list