SIRFACT command

From m204wiki
Revision as of 17:24, 26 February 2016 by JAL (talk | contribs) (minor formatting)
Jump to navigation Jump to search

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.