SIRFACT command

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 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 SirFact Reference Manual.

The SIRFACT subcommands are summarized below and described in detail in the 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.