The Dfhwosm Macros; The Dfhwosm Tokens - IBM SC34-6814-04 Customization Manual

the related system name of MROSYS. One of these is not allowed to restart in
place and is indicated by the letter N.

The DFHWOSM macros

The DFHWOSM macros invoke the CICS module DFHWOS to provide services to
the overseer program. The macros are the supported interface to the CAVM data
sets, and are supplied to perform the following functions:
DFHWOSM FUNC=BUILD
DFHWOSM FUNC=CLOSE
DFHWOSM FUNC=DSECT
DFHWOSM FUNC=JJC
DFHWOSM FUNC={JJS|QJJS}
DFHWOSM FUNC=OPEN
DFHWOSM FUNC=OSCMD
DFHWOSM FUNC=READ
DFHWOSM FUNC=TERM
The macros are described in detail in the following sections. For all the DFHWOSM
macros, the following rules apply:
v The "label" field is optional.
v If the macro has an input parameter list, the address of that parameter list must
v If the macro has to supply either a BUILD TOKEN or an OPEN TOKEN to

The DFHWOSM tokens

When DFHWOS first invokes the overseer program, it passes a value in register 1
which is known as the ENTRY token. The ENTRY token value is stored by the
overseer program on entry and is passed back to DFHWOS as input to the BUILD,
OSCMD, JJS, and JJC macros.
The DFHWOSM FUNC=BUILD macro must be the first macro issued by the
overseer program and must complete successfully. The register 1 output from this
macro is a second token called the BUILD token. The BUILD token value is stored
2 The last three entries are for three related MRO regions that are identified by
Open communication with DFHWOS
Terminate access to the CAVM data sets for a named generic applid
Generate required DSECTs
Issue a JES cancel for a named job
Discover current JES JOB status
Initialize access to the CAVM data sets for a named generic applid
Issue MVS commands
Retrieve status information for a named generic applid from the CAVM data
sets
Close communication with DFHWOS.
be supplied as the value of the PARM operand. The address itself may be
specified as a register number or as a label. Register 1 is the default value.
DFHWOS (as described in "The DFHWOSM tokens"), the token must be
provided in the register specified in the TOKEN operand. Register 14 is the
default value.
Chapter 26. The extended recovery facility overseer program
695