SIRFACT command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 1: Line 1:
<p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to Version 7.5 of <var class="product">[[Model 204]]</var>.</p>
<p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to Version 7.5 of <var class="product">[[Model 204]]</var>.</p>


The SIRFACT command invokes the [[SirFact]] post hoc debugging facility.
The <var>SIRFACT</var> command invokes the [[SirFact]] post hoc debugging facility.
SIRFACT has a set of several subcommands that lets you tailor, trap early,
<var>SIRFACT</var> has a set of several subcommands that lets you tailor, trap early,
and otherwise maximize the error information dumped for <var class="product">Model 204</var>
and otherwise maximize the error information dumped for <var class="product">Model 204</var>
debugging purposes.
debugging purposes.


SIRFACT commands can also be issued
<var>SIRFACT</var> commands can also be issued
as operator commands, that is, on the Online virtual console under VM or
as operator commands, that is, on the Online virtual console under VM or
as the response to the HALT message under OS/390.
as the response to the <var>HALT</var> message under OS/390.


The SIRFACT command is described in detail in the [http://sirius-software.com/maint/download/factr.pdf SirFact Reference Manual].
The <var>SIRFACT</var> command is described in detail in the <var class="book">[http://m204wiki.rocketsoftware.com/images/f/fb/FactrNew.pdf Rocket M204 SirFact Reference Manual]</var>.


===SIRFACT command syntax===
===SIRFACT command syntax===
<p class="syntax">SIRFACT subcomm operands </p>
<p class="syntax">SIRFACT <span class="term">subcomm operands</span> </p>
where
Where:
<dl>
<dl>
<dt>subcomm
<dt><var class="term">subcomm</var>
<dd>One of the subcommands listed below.
<dd>One of the subcommands listed below.
<dt>operands
<dt><var class="term">operands</var>
<dd>One or more operands specific to the SIRFACT subcommand invoked.
<dd>One or more operands specific to the SIRFACT subcommand invoked.
These are described in detail in the ''SirFact Reference Manual''.
These are described in detail in the <var class="book">Rocket M204 SirFact Reference Manual</var>.
</dl>
</dl>


The SIRFACT subcommands are summarized below and described in detail
The <var>SIRFACT</var> subcommands are summarized below and described in detail
in the ''SirFact Reference Manual''.
in the <var class="book">Rocket M204 SirFact Reference Manual</var>.
You invoke a subcommand with the
You invoke a subcommand with the
&ldquo;SIRFACT&rdquo; prefix (for example, SIRFACT CANCEL, SIRFACT MAXDUMP).
<code>SIRFACT</code> prefix (for example, <var>SIRFACT CANCEL</var>, <var>SIRFACT MAXDUMP</var>).
<dl>
<dl>
<dt>CANCEL
<dt>CANCEL
<dd>Indicates which return codes from $functions should result in request
<dd>Indicates which return codes from $functions should result in request
cancellation.
cancellation.
Can be abbreviated &ldquo;CAN&rdquo;.
Can be abbreviated "CAN".
<dt>DISPLAY
 
<dd>Shows the currently active SIRFACT subcommands.
dt>DISPLAY
Can be abbreviated
<dd>Shows the currently active <var>SIRFACT</var> subcommands.
&ldquo;DISP.&rdquo;.
Can be abbreviated "DISP".
 
<dt>DUMP
<dt>DUMP
<dd>Indicates which request cancellations should cause a [[SirFact]] dump to
<dd>Indicates which request cancellations should cause a [[SirFact]] dump to
be taken and where the dump is to go.
be taken and where the dump is to go.
<dt>IGNORE
<dt>IGNORE
<dd>Indicates which request cancellation
<dd>Indicates which request cancellation
error messages are not to produce ''SirFact'' dumps.
error messages are not to produce SirFact dumps.
Can be abbreviated
Can be abbreviated "IGN".
&ldquo;IGN.&rdquo;.
 
<dt>MAXDUMP
<dt>MAXDUMP
<dd>Places limits on the number of ''SirFact'' dumps that will be taken.
<dd>Places limits on the number of SirFact dumps that will be taken.
The
The
default system limit is 0 so a SIRFACT MAXDUMP '''must''' be issued
default system limit is 0 so a <var>SIRFACT MAXDUMP</var> '''must''' be issued
to get '''any''' SIRFACT dumps.
to get '''any''' <var>SIRFACT</var> dumps.
Can be abbreviated &ldquo;MAXD&rdquo;.
Can be abbreviated "MAXD".
 
<dt>NOCANCEL
<dt>NOCANCEL
<dd>Indicates that certain return codes from $functions should not result in
<dd>Indicates that certain return codes from $functions should not result in
request cancellation.
request cancellation.
Cancels out the effect of a SIRFACT CANCEL command.
Cancels out the effect of a <var>SIRFACT CANCEL</var> command.
Can be abbreviated &ldquo;NOCAN&rdquo;.
Can be abbreviated "NOCAN".
 
<dt>NODUMP
<dt>NODUMP
<dd>Indicates that certain request cancellations should not result in
<dd>Indicates that certain request cancellations should not result in
''SirFact'' dumps being produced.
SirFact dumps being produced.
Cancels out the effect of a SIRFACT DUMP command.
Cancels out the effect of a <var>SIRFACT DUMP</var> command.
 
<dt>NOIGNORE
<dt>NOIGNORE
<dd>Indicates that certain request cancellation
<dd>Indicates that certain request cancellation
error messages are to produce ''SirFact'' dumps.
error messages are to produce SirFact dumps.
Cancels out the effect of a SIRFACT IGNORE command.
Cancels out the effect of a <var>SIRFACT IGNORE</var> command.
Can be abbreviated &ldquo;NOIGN&rdquo;.
Can be abbreviated "NOIGN".
 
<dt>QUIESCE
<dt>QUIESCE
<dd>Facilitates updates of APSY subsystem procedures
<dd>Facilitates updates of APSY subsystem procedures
while the subsystem is up and in use.
while the subsystem is up and in use.
<dt>RECNDUMP
<dt>RECNDUMP
<dd>Establishes the number of record numbers from each
<dd>Establishes the number of record numbers from each
found set or LIST to be dumped.
found set or LIST to be dumped.
Can be abbreviated
Can be abbreviated "RECND".
&ldquo;RECND.&rdquo;.
 
<dt>RESUME
<dt>RESUME
<dd>Stops the effect of a SIRFACT QUIESCE command
<dd>Stops the effect of a <var>SIRFACT QUIESCE</var> command
and returns the subsystem to normal operation.
and returns the subsystem to normal operation.
<dt>SNAP
<dt>SNAP
<dd>Requests that a ''SirFact'' dump be taken for another thread.
<dd>Requests that a SirFact dump be taken for another thread.
</dl>
</dl>


[[Category:System administrator commands]]
[[Category:System administrator commands]]
[[Category:Commands]]
[[Category:Commands]]

Revision as of 19:13, 2 July 2014

Note: This is a Sirius Mods-only command prior to Version 7.5 of Model 204.

The SIRFACT command invokes the SirFact post hoc debugging facility. SIRFACT has a set of several subcommands that lets you tailor, trap early, and otherwise maximize the error information dumped for Model 204 debugging purposes.

SIRFACT commands can also be issued as operator commands, that is, on the Online virtual console under VM or as the response to the HALT message under OS/390.

The SIRFACT command is described in detail in the Rocket M204 SirFact Reference Manual.

SIRFACT command syntax

SIRFACT subcomm operands

Where:

subcomm
One of the subcommands listed below.
operands
One or more operands specific to the SIRFACT subcommand invoked. These are described in detail in the Rocket M204 SirFact Reference Manual.

The SIRFACT subcommands are summarized below and described in detail in the Rocket M204 SirFact Reference Manual. You invoke a subcommand with the SIRFACT prefix (for example, SIRFACT CANCEL, SIRFACT MAXDUMP).

CANCEL
Indicates which return codes from $functions should result in request cancellation. Can be abbreviated "CAN". dt>DISPLAY
Shows the currently active SIRFACT subcommands. Can be abbreviated "DISP".
DUMP
Indicates which request cancellations should cause a SirFact dump to be taken and where the dump is to go.
IGNORE
Indicates which request cancellation error messages are not to produce SirFact dumps. Can be abbreviated "IGN".
MAXDUMP
Places limits on the number of SirFact dumps that will be taken. The default system limit is 0 so a SIRFACT MAXDUMP must be issued to get any SIRFACT dumps. Can be abbreviated "MAXD".
NOCANCEL
Indicates that certain return codes from $functions should not result in request cancellation. Cancels out the effect of a SIRFACT CANCEL command. Can be abbreviated "NOCAN".
NODUMP
Indicates that certain request cancellations should not result in SirFact dumps being produced. Cancels out the effect of a SIRFACT DUMP command.
NOIGNORE
Indicates that certain request cancellation error messages are to produce SirFact dumps. Cancels out the effect of a SIRFACT IGNORE command. Can be abbreviated "NOIGN".
QUIESCE
Facilitates updates of APSY subsystem procedures while the subsystem is up and in use.
RECNDUMP
Establishes the number of record numbers from each found set or LIST to be dumped. Can be abbreviated "RECND".
RESUME
Stops the effect of a SIRFACT QUIESCE command and returns the subsystem to normal operation.
SNAP
Requests that a SirFact dump be taken for another thread.
Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=SIRFACT_command&oldid=69899"