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.