Submitting a compile request

Use the Parameterized Build > Compile request to submit a COBOL program to the z/OS® system for compiling.

Before you begin

This task refers to sample programs shipped with ClearCase® z/OS extensions. To use the sample programs, you need to ensure that your ClearCase administrator has set up a test environment, and you need to be connected to the test VOB and have created a project under the test VOB.

About this task

The Compile menu item compiles and links a COBOL source program. The output listing file is sent to the ClearCase server in the VOB directory. The output object file is located in PDS USERID.XOBJLIB on the remote system. The output link control file is located in PDS USERID.XLOADLIB on the remote system.

Procedure

To submit a Parameterized Build > Compile request for one or more source files.
  • To submit a single program for compilation, do these steps:
    1. Expand the project containing the sample programs.
    2. Right-click pbtest1.cbl and click Parameterized Build > Compile.
      A message window shows the build request is executing.
    3. Right-click the project name and click Refresh to verify the output for the build request.
  • To submit multiple programs for compilation, do these steps:
    1. Expand the project containing the sample programs.
    2. Select pbtest1.cbl and pbtest2.cbl.
    3. Right-click pbtest1.cbl and click Parameterized Build > Compile.
      A message window shows the build request is executing.
    4. Right-click the project name and click Refresh to verify the output for the build request.

Results

The BCL scripts generated by the build process are located under /VOB/userid directory, where VOB is the path of the VOB and userid is your TSO user ID. The following BCLs are generated and sent to the mainframe to execute the build request during the compilation. In these file names, sourcefile is the name of the file for which the parameterized build command is issued, such as s1alloc_pbtest1.bcl.
s1alloc_sourceFile.bcl
Allocates all PDSs and uploads the COBOL source from ClearCase.
compile_sourceFile.bcl
Compiles COBOL program.
devprint_sourceFile.bcl
Generates the link load file used for link edit.
lnkbatch_sourceFile.bcl
Performs the link edit.

The following output files generated by the build process are located in the project:

userid_sourceFile_COB.sysprint
The output listing file for the COBOL program.
userid_sourceFile_compile.log
The log file for compiling. In this file name, yourfile.cbl is the name of the file for which you submitted the Compile request.
userid_sourceFile_rccbuild.log
The remote build log file.
parmBuild.log
The log file for parameterized build.
parmBuildError.log
The error file for parameterized build.
Assuming USER1 is the TSO login ID used to form the PDS name, the following are the files uploaded to the remote system and the output files generated after a successful build. The name of the PDS for the output load module is determined by a configuration parameter on the ClearCase server: the variable $loadlib defined by the attribute ZCCENV. This configuration parameter is described in the ClearCase z/OS Extensions documentation.
USER1.SOURCE(YOURFILE)
The COBOL source program.
USER1.XOBJLIB(YOURFILE)
The output object file, where YOURFILE is the name of the source file submitted for compilation.
USER1.XLOADLIB(YOURFILE)
The output link control file, where YOURFILE is the name of the source file submitted for compilation.
USER1.CA.PARMBLD.LOAD(YOURFILE)
The output load module, where YOURFILE is the name of the source file submitted for compilation.