IBM SC34-6814-04 - Manual (Page 718)

by the overseer program and passed back to DFHWOS as input to the OPEN,
CLOSE, READ, QJJS, and TERM macros.
DFHWOSM FUNC=BUILD macro
The DFHWOSM FUNC=BUILD macro must be issued by the overseer program to
initialize its communication with DFHWOS. No other macro can be issued by the
overseer program until DFHWOS FUNC=BUILD has completed successfully.
Input
The TOKEN value is the ENTRY token that was passed to the sample overseer
program when it was first invoked by DFHWOS.
Output
Register 1
Contains the BUILD token value, which must be returned as an input
value by the overseer program on certain subsequent requests. This
value is returned to register 1 only if register 15 has a return code of ‘0’.
Register 15
Contains one of the following completion codes:
0 Communication successfully initialized between the overseer
program and DFHWOS
4 Incorrect TOKEN value supplied
8 Insufficient storage.
DFHWOSM FUNC=CLOSE macro
The DFHWOSM FUNC=CLOSE macro terminates access to the CAVM data sets
for a named generic applid.
Input
The PARM value is a pointer to the address of the generic applid whose
associated CAVM data sets are no longer to be accessed by the overseer
program.
The TOKEN value is the BUILD token.
Output
Register 15
Completion codes:
0 CLOSE request was successful and the CAVM data sets
associated with this generic applid can no longer be accessed
by the overseer program.
4 Incorrect TOKEN value supplied.
8 Access to CAVM data sets for the named generic applid had
not been initialized.
label DFHWOSM FUNC=BUILD
[,TOKEN={token register|14}]
label DFHWOSM FUNC=CLOSE
[,PARM={parm address|1}]
[,TOKEN={token register|14}]
696 Customization Guide