Setting up the System z Jazz Gateway to control SCLM workflow

SCLM has a number of user exit points that can use the information returned by the System z® Jazz™ Gateway server. This topic describes the steps to set up and use SCLM with the System z Jazz Gateway server.

You must have configured the REXX Gateway client to communicate with the System z Jazz Gateway server.

Complete the following steps to set up the System z Jazz Gateway with SCLM:
  1. If your SCLM project is not already invoking CCVFY and PROMOTE user exits, you can start them by modifying the FLMCNTRL macro and rebuilding the project definition. The FLMCNTRL macro will look something like this:
    *                                                                       
    **********************************************************************  
    *                PROJECT CONTROLS                                       
    **********************************************************************  
    *                                                                       
    *                                                                       
             FLMCNTRL ACCT=SCLM.ACCOUNT.FILE,                              C
                   CCVFY=SCLMEXIT,               * CCVFY USER EXIT         C
                   CCVFYCM=TSOLNK,               * METHOD TO CALL EXIT     C
                   CCVFYDS=SCLM.PROJDEFS.SOURCE,                           C
                   PRMVFY=SCLMEXIT,              * PROMOTE VERIFY USER EXITC
                   PRMVFYCM=TSOLNK,              * METHOD TO CALL EXIT     C
                   PRMVFYDS=SCLM.PROJDEFS.SOURCE,                          C
                   MAXVIO=999999,                                          C
                   VIOUNIT=VIO                                              
    *                                                                       
  2. The SCLMEXIT member below contains an invocation of the actual user exit. If your site already has SCLM user exits in place, you can add the SELECT CMD … statement shown in the REXX code below into your existing user exits. If your site does not have SCLM user exits in place, then create a member in your project definition library that contains the code below, and make sure your user exit invocation statements point to it, as shown in the previous figure. You should change BLZ.SBLZSAMP to the data set name where you uploaded the samples.
    /* REXX */                                                 
       ARG parm                                                
       Address ISPEXEC                                         
       "SELECT CMD(EX 'BLZ.SBLZSAMP(BLZSCLM1)' '"parm"') NEST" 
                                                               
    Exit rc                                                
  3. Using the instructions in the sample REXX, configure member BLZSCLM1 in the data set where you uploaded the samples. This member will call the REXX Gateway client to check the work item status. It will then allow or deny the SCLM action through the user exit return codes.
    Remember: If you use an encrypted password file, set the password variable to the literal <file> to instruct the REXX Gateway client to get the password file from your home directory.

Feedback