Submitting JCL contained in a build system data set

You can submit JCL contained in a data set on the target build system using the Rational® Build Agent. The Job Monitor will submit the job to JES and report the results of the request. You can then view build results through the Rational Team Concert™ for System z® client.
  1. Create a data set member containing the following JCL. Note that this job contains inline COBOL source code that will be compiled and link-edited. Customize the data set names contained in this job to values appropriate to your target system.
    //HELLO    JOB ,NOTIFY=DEARTH                         
    //*                                                   
    //* COBOL COMPILATION                                 
    //*                                                   
    //COBOL    EXEC PGM=IGYCRCTL,PARM='NODECK,OBJECT,LIB' 
    //STEPLIB  DD DSN=COBOL.V4R1M0.SIGYCOMP,DISP=SHR      
    //SYSIN    DD *                                       
           IDENTIFICATION DIVISION.                       
           PROGRAM-ID. HELLO.                             
           PROCEDURE DIVISION.                            
           MAIN.                                          
               DISPLAY 'HELLO, RTCZ.'.                    
               STOP RUN.                                  
    /*                                                    
    //SYSLIN   DD DSN=DEARTH.SAMPLE.OBJ(HELLO),DISP=SHR   
    //SYSPRINT DD SYSOUT=*                                
    //SYSUT1   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))                   
    //SYSUT2   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))                   
    //SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))                   
    //SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))                   
    //SYSUT5   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))                   
    //SYSUT6   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))                   
    //SYSUT7   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))                   
    //*                                                             
    //LINKEDIT EXEC PGM=IEWBLINK,PARM='LIST,LET,MAP,XREF,REUS,RENT' 
    //SYSLIN   DD *                                                 
     INCLUDE SYSLIB(HELLO)                                          
     NAME HELLO(R)                                                  
    /*                                                              
    //SYSLIB   DD DSN=DEARTH.SAMPLE.OBJ,DISP=SHR                    
    //         DD DSN=CEE.SCEELKED,DISP=SHR                         
    //SYSLMOD  DD DSN=DEARTH.SAMPLE.LOAD(HELLO),DISP=SHR            
    //SYSPRINT DD SYSOUT=*                                          
    //SYSUT1   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))                
    //*
  2. Create a build definition using the Rational Team Concert for System z client.
    1. In the Team Artifacts view, right-click the Build Engines node and select New Build Engine.
    2. Specify the Build Engine ID as RationalBuildAgent, choose a Project or Team Area, and click Save.
    3. In the Team Artifacts view, right-click the Builds node and select New Build Definition.
    4. Click Next.
    5. Specify a Build Definition ID and select Rational Build Agent as the build template.
    6. Click Next.
    7. Clear the Pre Build Command line box and click Next.
    8. Clear the Post Build Command line box and click Finish.
    9. On the Overview tab, select RationalBuildAgent as the Supporting Build Engine.
    10. The build agent tab should contain the following values:
      1. Hostname: Your build machine IP address or hostname.
      2. Port: 5555, or the port number you configured in your bfagent.conf file.
      3. User name: the z/OS® RACF® user ID of the builder on the target build machine.
      4. Password and Confirm Password: The z/OS RACF password.
    11. Specify the following values on the Build Command Line tab:
      1. Enter this command line. Replace <PDS(MEMBER)> with the data set you created previously. Note that the command begins with a leading period.
        .submitJCL <PDS(MEMBER)>
      2. Set the working directory to a fully qualified USS path on the build machine. This directory will be used as a work directory by the build process. It must exist before you can request a build.
    12. Click Save.
    13. Request a build.
      1. In the Team Artifacts view, select the build definition, right-click, and select Request Build.
      2. Click Submit.
      3. If a message like the following is displayed, click OK to submit the request: The build engine does not appear to be processing requests.
      4. In the Builds view, check the status periodically. Click Update to refresh the view.
    14. When the build is completed, double-click the build result to view the build log.

Feedback