Providing JCL through a Rational Build Agent step command

You can specify JCL inline as part of a Rational® Build Agent step command. With this job submission method, you can use substitution parameters to specify values like the HLQ of the source data sets. The parameters will be replaced with values specified on the Build Definition properties tab prior to job submission.

  1. Make sure you have data sets defined that will contain the object decks and load modules that result from COBOL compilation and link-editing.
  2. Verify that you have defined a Rational Build Agent build engine.
    Note: You must complete the build engine and build engine ID steps in Submitting JCL contained in a build system data set before you can verify the Rational Build Agent build engine.
  3. Create a build definition using the Rational Team Concert™ for System z® client.
    1. In the Team Artifacts view, right-click the Builds node and select New Build Definition.
    2. Click Next.
    3. Specify a build definition ID and select Rational Build Agent as the build template.
    4. Click Next.
    5. Clear the Pre Build Command Line box and click Next.
    6. Clear the Post Build Command Line box and click Finish.
    7. On the Overview tab, select Rational Build Agent as the Supporting Build Engine.
    8. On the Properties tab, create a new property called HLQ. This property will be used throughout the JCL to specify the high-level qualifier to be used for source and output data sets on the target build system.
      1. Click Add.
      2. Select String as the property type and click OK.
      3. Specify HLQ as the name.
      4. Enter the HLQ of the target data sets and click OK.
    9. 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.
    10. Specify the following values on the Build Command Line tab:
      1. Enter this command line into the Command input box. Using the option –c with the .submitJCL command allows you to specify JCL as part of the command. Any occurrence of ${HLQ} will be replaced with the value specified on the Properties tab of the build definition. Note that the command begins with a leading period. Be sure to verify that data set definition (DD) statements in the JCL contain values appropriate for your target system.
        .submitJCL -c
        //HELLO    JOB ,NOTIFY=${HLQ}
        /*JOBPARM S=*
        // SET HLQ=\'${HLQ}\'
        //*                                                              
        //* 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=&HLQ..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                                                      
        //*                                                               
        //LINKEDIT EXEC 
        PGM=IEWBLINK,PARM='LIST,LET,MAP,XREF,REUS,RENT'   
        //SYSLIN   DD *                                                    
        INCLUDE SYSLIB(HELLO)                                             
        NAME HELLO(R)                                                    
        /*                                                                
        //SYSLIB   DD DSN=&HLQ..SAMPLE.OBJ,DISP=SHR                          
        //    DD DSN=CEE.SCEELKED,DISP=SHR                           
        //SYSLMOD  DD DSN=&HLQ..SAMPLE.LOAD(HELLO),DISP=SHR                  
        //SYSPRINT DD SYSOUT=*                                            
        //SYSUT1   DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))                     
        //*
      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.
    12. 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 dialog is displayed that states that the build engine does not appear to be processing requests, click OK to submit the request.
      4. In the Builds view, check the status periodically. Click Update to refresh the view.
    13. When the build is completed, double-click the build result to view the build log.

Feedback