Example of Using IWMDINST to Install a Service Definition
Suppose you have coded an application to define and edit a service
definition mapped by the IWMSERVD mapping macro.
To install the service definition onto the WLM couple data set, do
the following:
- Check the service definition data structure and whether there
are any storage overlay problems. If there are any problems, have
the macro return the location of the error in the service definition.
- Specify that the service definition is to be installed only if
the service definition installed on the WLM couple data set has not
changed since the last extract.
To install the service definition, you specify:
IWMDINST SERVD_AREA=(R4),
PRODUCT_ID=ProductIdArea,
QRY_BASEID=(R5),
VALCHECK_RSN=ValcheckRsn,
VALCHECK_OFFSET=ValcheckOffset,
COND=YES,
TYPE=HEX,
RETCODE=Module_Rc,
RSNCODE=Module_Rsn,
MF=E
With the following defined:
ProductIdArea DS CL32 My application product identifier
ValcheckRsn DS 1F The validation check reason code
ValcheckOffset DS 1F The validation check offset
Module_Rc DS 1F The return code
Module_Rsn DS 1F The reason code
- To check the service definition data structure, use the VALCHECK_RSN
and VALCHECK_OFF parameters. If IWMDINST finds any error, it will
provide the reason code in the VALCHECK_RSN parameter, and the
offset to the error in the VALCHECK_OFF parameter. Look up the
reason code in Appendix B. Application Validation Reason Codes for more information about the
error and help in locating it in IWMSERVD.
- To specify that the service definition is to be installed only
if the service definition installed on the WLM couple data set has
not changed since the last extract, use the COND=YES parameter. If
the service definition base identifier has not changed since the service
definition was extracted from the WLM couple data set, then IWMDINST
continues with the installation.
|