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.
Job Monitor will submit the job to JES and report the results of the request. You can then view build results through the z/OS® 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 Eclipse client.
    1. In the Team Artifacts view, expand the project area folder in which you want to create a build definition.
    2. Right-click Builds > New Build Definition.
    3. Select Create a new build, then click Next.
    4. In the General Information window, enter a build definition ID and a brief description of the build definition and select Command Line - Rational Build Agent from the Available Templates menu. Click Next.
    5. In the Pre-Build window, deselect Pre-Build Command Line and click Next.
    6. In the Post-Build window, deselect Post-Build Command Line and click Next.
    7. In the Additional Configuration window, select both General and Properties, and then click Finish. The build definition you created opens in the Build Definition editor.
    8. On the Overview tab, under Supporting Build Engine, click Create.
    9. In the General Information window of the New Build Engine wizard, enter a build engine ID and a brief description of the build engine and select Rational Build Agent from the Available Templates menu. Click Finish.
    10. In the Build Definition editor, 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.
    11. Click Save.
  3. 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.
  4. When the build is completed, double-click the build result to view the build log.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki