How to Enable Web Services › How to Enable STC Definitions for Web Services › Define the Started Task for Web Services

Define the Started Task for Web Services

Web Services uses started tasks that are started by the CAICCI SPAWN facility to communicate with the CA Endevor SCM API. You define these tasks to the spawn facility by adding a spawn parameter DD statement (ndvspawn) to the ENF procedure for CAICCI services. The ndvspawn DD statement specifies the name of the started task JCL (based on WSEWSSTC in CSIQJCL) for the CA Endevor SCM API. The WSEWSSTC procedure JCL must be edited to specify the high-level and second-level qualifiers for the CA Endevor SCM data sets. The WSEWSSTC copy is initiated as a started task.

Follow these steps:

1. Customize the ENF Procedure by adding the Web Services spawn parameter file name to the SPNPARMS DD in the ENF PROC JCL. You can find the ENF procedure in the initial CAI.CAIPROC library. However, your system administrator may have copied the procedure to the system PROCLIB. The following JCL is shown as an example to indicate the two lines you must add to the JCL.

   //ENF PROC OPTLIB='SYS2.CA90S.PARMLIB',
   //                   ENFDB='SYS2.CA31.ENFDB',
   //                   ENFPARM=ENFPRM31,
   //                   SPNPAR1=SPWNSNMP,
   //                   SPNPARn=ndvspawn,
   //                   CCIPARM=CCIPCA31,
   //                   ENFCMDS=ENFCMD31,
   //ENF      EXEC PGM=CAS9MNGR,TIME=1440
   //CASRT01  DD UNIT=SYSDA,SPACE=(CYL,(5,1))
   //CASRT02  DD UNIT=SYSDA,SPACE=(CYL,(5,1))
   //CASRT03  DD UNIT=SYSDA,SPACE=(CYL,(5,1))
   //CASRT04  DD UNIT=SYSDA,SPACE=(CYL,(5,1))
   //CASRT05  DD UNIT=SYSDA,SPACE=(CYL,(5,1))
   //SPNPARMS DD DISP=SHR,DSN=&OPTLIB(&SPNPAR1)
   //         DD DISP=SHR,DSN=&OPTLIB(&SPNPARn)
   //SPNPRINT DD SYSOUT=X
   //SPNDEBUG DD SYSOUT=X
   //SRVDEBUG DD SYSOUT=X
   //ENFDB DD DISP=SHR,DSN=&ENFDB
   //ENFPARMS DD DISP=SHR,DSN=&OPTLIB(&ENFPARM)
   //         DD DISP=SHR,DSN=&OPTLIB(&CCIPARM)
   //ENFCMDS  DD DISP=SHR,DSN=&OPTLIB(&ENFCMDS)
   //SYSPRINT DD SYSOUT=X
   

   SPNPARn

   Specifies a symbolic for a CAIENF parameter member. Change n to the next available sequential number in the list of parameter files.

   ndvspawn

   Specifies the spawn parameter file. This member contains the CAICCI SERVICE and PROCESS statements. The SERVICE statement identifies the CA Endevor SCM API. The PROCESS statement identifies the JCL procedure that executes the CA Endevor SCM API.

2. Customize the spawn parameters by editing the CAICCI SERVICE and PROCESS statements in the ndvspawn file. Then save the appropriate file in your site specific CA90S.PARMLIB as member NDVSPAWN.

   Important! For sample CCI definitions for Web Services, see the member WSEWSCCI supplied in the installation source library iprfx.iqual.CSIQOPTN.

   SERVICE statement

   Identifies the CA Endevor SCM API (host application).

   PROCESS statement

   Identifies the JCL procedure that executes the CA Endevor SCM API.

   PROCNAME=WSEWSSTC

   Specifies the name of the procedure associated with the CA Endevor SCM API host application that is started by the CAICCI SPAWN service during Web Services processing. The WSEWSSTC value is the name of the started task procedure that is initiated by a SPAWN request.

   Note: By default, the name of the procedure associated with this started task is WSEWSSTC; however, this name is often changed, for example, to meet site-specific naming or security standards. If you do not know the procedure name at your site, check to see if the default name was retained or consult your system administrator.

   Important! Keep the statements in the exact format provided, maintaining spaces and column alignments. For more information about defining and using CAICCI statements, see the CA Common Services documentation.

3. Customize the WSEWSSTC started task procedure. Change the parameters as appropriate for your site.

   Note: A sample WSEWSSTC procedure is located in the CSIQJCL library delivered with CA Endevor SCM.

   Note: If you change the WSEWSSTC member name, be sure to update the PROCNAME value in the CCI PROCESS statement of the SPNPARn file to reflect the new procedure name.

   Note: The wsewsstc value is specified in the JOBNAME parameter of the configuration file.

4. Copy WSEWSSTC into a PROCLIB defined to JES. WSEWSSTC is initiated as a started task.
5. If this is your initial install of these CAICCI components, you do not need to IPL your system after installation. If this is a subsequent install, you may need to IPL your system. For more information, see the CA Common Services for z/OS documentation.