Dfhwosm Func=Oscmd Macro; Dfhwosm Func=Read Macro - IBM SC34-6814-04 Customization Manual

A register 15 return code value of '0' through '5' indicates that a DFHWOSM
FUNC=READ macro can now be issued. A return code value of '6' or above
indicates that the OPEN has failed and that the overseer program will not be able to
access the CAVM data sets.

DFHWOSM FUNC=OSCMD macro

The DFHWOSM FUNC=OSCMD macro is used to issue MVS commands. (The
overseer program restarts a failed region in place by issuing this macro.) The text of
the required MVS command is provided as input to the macro, and the OSCMD
service issues an SVC 34 specifying this command text. In addition, the OSCMD
service issues an MVS WTO request so that a copy of the command text appears
on the MVS console to keep the operator informed of what is about to happen. This
copy has the comment '(BY IOP)' appended to show that the command is going to
be issued by an overseer program. A second copy of the command text is sent to
the console when the MVS command is issued.
label DFHWOSM FUNC=OSCMD
[,PARM={parm address|1}]
[,TOKEN={token register|14}]
Input
Output

DFHWOSM FUNC=READ macro

The DFHWOSM FUNC=READ macro returns information about a named generic
applid from its associated CAVM data sets.
label DFHWOSM FUNC=READ
[,PARM={parm address|1}]
[,TOKEN={token register|14}]
8 Access already initialized for this generic applid or for this
ddname
9 Version numbers of the named CAVM data sets do not match
C Data set open failure
10 SHOWCB failure.
The PARM value is a single address that points to a "command area". The
command area is made up of a 4-byte length field followed by the command
data. The length field contains the length of the whole command area. The
command data must be in write-to-operator (WTO) command format.
The TOKEN value is the ENTRY token.
Register 0
Completion code set by SVC 34 as a response to the MVS command
that was issued by the macro.
Register 15
Response to the macro itself. A return code of '16' indicates that the
OSCMD has failed.
Chapter 26. The extended recovery facility overseer program
699