SIRFACT command: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
m (minor formatting) |
||
| 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 <var>SIRFACT</var> command invokes the [[SirFact]] post hoc debugging facility. | The <var>SIRFACT</var> command invokes the <var class="product">[[SirFact]]</var> post hoc debugging facility. | ||
<var>SIRFACT</var> 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. | |||
<var>SIRFACT</var> commands can also be issued | <var>SIRFACT</var> commands can also be issued | ||
| Line 15: | Line 14: | ||
<p class="syntax">SIRFACT <span class="term">subcomm operands</span> </p> | <p class="syntax">SIRFACT <span class="term">subcomm operands</span> </p> | ||
Where: | Where: | ||
< | <ul> | ||
< | <li><var class="term">subcomm</var> | ||
is one of the subcommands listed below. | |||
< | <li><var class="term">operands</var> | ||
is one or more operands specific to the SIRFACT subcommand invoked. | |||
These are described in detail in the <var class="book">Rocket M204 SirFact Reference Manual</var>. | These are described in detail in the <var class="book">Rocket M204 SirFact Reference Manual</var>. | ||
</ | </ul> | ||
The <var>SIRFACT</var> subcommands are summarized below and described in detail | The <var>SIRFACT</var> subcommands are summarized below and described in detail | ||
| Line 31: | Line 30: | ||
<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 | Can be abbreviated <code>CAN</code>. | ||
dt>DISPLAY | <dt>DISPLAY | ||
<dd>Shows the currently active <var>SIRFACT</var> subcommands. | <dd>Shows the currently active <var>SIRFACT</var> subcommands. | ||
Can be abbreviated | Can be abbreviated <code>DISP</code>. | ||
<dt>DUMP | <dt>DUMP | ||
| Line 44: | Line 43: | ||
<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 <code>IGN</code>. | ||
<dt>MAXDUMP | <dt>MAXDUMP | ||
| Line 51: | Line 50: | ||
default system limit is 0 so a <var>SIRFACT MAXDUMP</var> '''must''' be issued | default system limit is 0 so a <var>SIRFACT MAXDUMP</var> '''must''' be issued | ||
to get '''any''' <var>SIRFACT</var> dumps. | to get '''any''' <var>SIRFACT</var> dumps. | ||
Can be abbreviated | Can be abbreviated <code>MAXD</code>. | ||
<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 <var>SIRFACT CANCEL</var> command. | Cancels out the effect of a <var>SIRFACT CANCEL</var> command. | ||
Can be abbreviated | Can be abbreviated <code>NOCAN</code>. | ||
<dt>NODUMP | <dt>NODUMP | ||
| Line 68: | Line 66: | ||
error messages are to produce SirFact dumps. | error messages are to produce SirFact dumps. | ||
Cancels out the effect of a <var>SIRFACT IGNORE</var> command. | Cancels out the effect of a <var>SIRFACT IGNORE</var> command. | ||
Can be abbreviated | Can be abbreviated <code>NOIGN</code>. | ||
<dt>QUIESCE | <dt>QUIESCE | ||
| Line 77: | Line 75: | ||
<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 <code>RECND</code>. | ||
<dt>RESUME | <dt>RESUME | ||
Revision as of 17:24, 26 February 2016
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 is one of the subcommands listed below.
- operands is 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. - 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.