Submitting a compile request from TSO Client

Use the pbf parameterized build request to submit a COBOL program to the z/OS® system for compiling.

About this task

The pbf parameterized build request compiles and links a COBOL source program. Your ClearCase® administrator can modify the parameterized build scripts to make build available for any language file your site supports. The pbf command is not valid for view-private files.

Procedure

To submit a pbf request, do these steps:
  1. On the option line of the TSO Client Main Menu, type 4.
  2. On the left side of the Dataset Action panel, under DSLIST, type s beside one or more of the data sets in the list to select a data set.
  3. On the left side of the View Files List panel, under the ClearCase file name, do one of the following actions:
    • Type pbf next to the file name. The build request is submitted.
    • Type s next to the file name and press Enter. The File Actions panel displays. Type pbf on the option line, press Enter, and press PF3 END to return to the View Files List panel. The build request is submitted.

Results

Assuming that the sample build script is modified as shown below, the output listing file is saved to a preallocated PDS named USERID.TSC.LIST(PBTEST1). 
//SYSPRINT DD DSN=$mfid.TSC.LIST($mem),DISP=SHR
You can view the output listing from panel 4 if an environment definition mapping statement has been specified. The output object file is located in PDS USERID.XOBJLIB on the z/OS system. The output link control file is located in PDS USERID.XLOADLIB on the z/OS system. 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 send 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.jcl
Allocates a PDS and uploads the COBOL source from ClearCase.
compile_sourceFile.jcl
Compiles COBOL program.
devprint_sourceFile.jcl
Generates the link load file used for link edit.
lnkbatch_sourceFile.jcl
Performs the link edit.
The following output files generated by the build process are located in the VOB directory.
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.
Assuming USER1 is the TSO login ID used to form the PDS name, the following are the files uploaded to the host and the output files generated after a successful build. The name of the PDS for the output load module is specified in the variable $loadlib defined by the attribute ZCCENV.
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 compile.
USER1.XLOADLIB(YOURFILE)
The output link control file, where YOURFILE is the name of the source file submitted for compile.
USER1.CA.PARMBLD.LOAD(YOURFILE)
The output load module, where YOURFILE is the name of the source file submitted for compile.
An error message is issued under the following conditions:
  • The file selected is not on a Windows® platform.
  • The PARMBUILD_SCRIPTS environment variable is not specified in the environment definition file.
  • The file selected is a view private file.