Defining the WLM environment and JCL startup procedure for C language XML schema repository stored procedures

The XML schema validation stored procedures that are written in C require their own WLM environment and a JCL procedure for starting that WLM environment.

About this task

The C language stored procedures that use this WLM environment and JCL procedure are XSR_ADDSCHEMADOC, XSR_REGISTER, and XSR_REMOVE.

One of the tasks that installation job DSNTIJRW performs is to call a program that installs a WLM environment with the default name of DSNWLM_XML. The installation process configures DSNWLM_XML so that you can use it to run the XML schema repository stored procedures. One of the tasks that installation job DSNTIJMV performs is to install a WLM startup procedure named ssnmWLMX for that WLM environment.

Follow this process if the predefined settings do not work for you, and you need to make changes to the WLM environment or startup procedure.

Procedure

To define the WLM environment and JCL startup procedure for C language XML schema repository stored procedures:

In a TSO session, start the IWMARIN0 utility.
For example, in the ISPF Command Shell, type:
```
EXEC 'SYS1.SBLSCLI0(IWMARIN0)'
```
In the WLM ISPF Choose Service Definition menu, choose option 1 or option 2, depending on your current WLM service definition setup. See the WLM documentation on service definitions for details.
In the WLM ISPF Definition Menu panel, choose option 9: Application Environments.
In the Application Environment Selection List panel, type 3 (Modify) next to DSNWLM_XML.

In the Modify an Application Environment panel, you see values like these.

                     Modify an Application Environment              
 Command ===> ____________________________________________________________
                                                                          
 Application Environment Name . : DSNWLM_XML                              
 Description  . . . . . . . . . . DB2-SUPPLIED WLM ENVIRONMENT            
 Subsystem Type . . . . . . . . . DB2                                     
 Procedure Name . . . . . . . . . DSNWLMX                                 
 Start Parameters . . . . . . . . DB2SSN=&IWMSSNM,APPLENV='DSNWLM_XML'    
                                  ________________________________________
                                  ___________________________________     
                                                                          
 Starting of server address spaces for a subsystem instance:              
 1   1.  Managed by WLM                                                   
     2.  Limited to a single address space per system                     
     3.  Limited to a single address space per sysplex

The meanings of the parameters are:

Subsystem Type: Specify DB2.
Procedure Name: Specify a name that matches the name of the JCL startup procedure for the stored procedure address spaces that are associated with this application environment.
Start Parameters: If the Db2 subsystem in which the stored procedure runs is not in a sysplex, specify a DB2SSN value that matches the name of that Db2 subsystem. If the same JCL is used for multiple Db2 subsystems, specify DB2SSN=&IWMSSNM. Specify an APPLENV value that matches the value that you specify in the Application Environment Name field.
Starting of server address spaces for a subsystem instance: Specify 1 (Managed by WLM) or 2 (Limited to a single address space per system).

Modify the JCL startup procedure for the stored procedure address spaces that are associated with the WLM application environment.
The default JCL startup procedure for DSNWLM_XML looks like this one.
```
//DSNWLMX PROC APPLENV=DSNWLM_XML,                         1 
// DB2SSN=DSN,RGN=0K,NUMTCB=40                             2 
//IEFPROC EXEC PGM=DSNX9WLM,REGION=&RGN,TIME=NOLIMIT,  
// PARM='&DB2SSN,&NUMTCB,&APPLENV'  
//STEPLIB DD DISP=SHR,DSN=CEE.SCEERUN                      3 
// DD DISP=SHR,DSN=DSND10.SDSNEXIT  
// DD DISP=SHR,DSN=DSND10.SDSNLOAD  
//CEEDUMP DD SYSOUT=A  
//SYSPRINT DD SYSOUT=A  
```
Notes:
- 1 In this line, the procedure name must be the same as the Procedure Name value in the Create an Application Environment or Modify an Application Environment panel. The APPLENV value must be the same as the Application Environment Name value in the Create an Application Environment or Modify an Application Environment panel. If the Start Parameters field in the Create an Application Environment or Modify an Application Environment panel contains an APPLENV parameter, the APPLENV parameter value in the Start Parameters field value overrides the value in the JCL startup procedure. NUMTCB should be in the range 40–60.
- 2 In this line, the DB2SSN value must be the same as your Db2 for z/OS® subsystem name. NUMTCB should be in the range 40–60.
- 3 STEPLIB specifies the data sets that are necessary for running the stored procedures. At a minimum, you need the Language Environment® run time data set, SCEERUN, and the SDSNLOAD data set, which contains the DSNX9WLM program and the load modules for the C language XML schema repository stored procedures.