Parameterized build scripts

The following table lists the parameterized build scripts shipped for Windows® and describes each. You can use these sample scripts as a starting point for developing your own approach to automating Remote Build scripts. These sample scripts are provided as-is and require customization and alteration before they can be used in your z/OS® Extensions environment. Click the link in the Customization required? column for instructions.

Note: Many of the following scripts are Perl scripts, which are run using the ccperl.exe interpreter shipped with ClearCase®.
Table 1. Sample scripts for parameterized build
File name Description Customization Required?
bccPmbld_main.pl The main script for executing the parameterized build process. This script is called for every build request. It determines what type of element has been requested to be built (that is, COBOL or other programming languages) and then calls the appropriate build script. It can execute a mass compile of varying element types. This script can process any number of requests in a single call based on an element list that is passed to it. Yes
bccPmbld_tsoc.pl The main script for executing the parameterized build process from a TSO Client. This script is called for every build request. It determines what type of element has been requested to be built (that is, COBOL or other programming languages) and then calls the appropriate build script. Yes
bccPmbld_rdz.pl The main script for executing the parameterized build process from the Rational® Developer for System z® or Eclipse platforms. This script is called for every build request. It determines what type of element has been requested to be built (COBOL is the only supported programming language for this platform) and then calls the appropriate build script. Yes
bccpbmod.pm A set of common routines that the build engine uses for all element types. It contains the following common routines:
Userid Table
Maps the distributed ClearCase user ID to the mainframe user ID.
SetEnvironmentVar
Maps the ClearCase environment to the mainframe infrastructure or environment.
Writefile
Generates the BCL necessary for compiling.
Devprint
Creates a developer's footprint used in the executable's IDRDATA.
Getcatattrs
Extracts metadata from the ClearCase repository and populates global variables with this metadata.
Testserver
Determines if all systems are operating and functioning correctly.
Cleanup
Cleans up temporary files and working BCL files.
Yes
bldcobol.pl The build COBOL script. This script generates all the JCL necessary to compile COBOL elements. It automatically determines the components needed for the compile process (such as DB2®, CICS®, and so on) and executes the build. It checks for status codes at every step of the process to ensure a proper execution. Yes
bldcobol_rdz.pl The build COBOL script. This script generates all the JCL necessary to compile COBOL elements. It automatically determines the components needed for the compile process (such as DB2, CICS, and so on) and executes the build. It checks for status codes at every step of the process to ensure a proper execution. Yes
bldcobol_tsoc.pl The build COBOL script for TSO Client. This script generates all the JCL necessary to compile COBOL elements. It automatically determines the components needed for the compile process (such as DB2, CICS, and so on) and executes the build. It checks for status codes at every step of the process to ensure a proper execution. This file has SYSPRINT that will send the output list file to USERID.TSC.LIST. Yes
ciCobol.pl A checkin trigger used to map COBOL copybooks to the appropriate copybook library on the mainframe, based on the environment of the copybook that is being modified. This script can be modified to support any type of element according to your site's needs. Yes
compileCC.reg Creates the Compile, Compile Multiple COBOL Programs, Compile Xpediter, Upload Copy Member to Host, and Submit Link Job items on the ClearCase Explorer context menu. Yes
compileWin.reg Creates the Compile, Compile Multiple COBOL Programs, Compile Xpediter, Upload Copy Member to Host, and Submit Link Job items on the Windows Explorer context menu. Yes
copybook_main.pl The top of the call sequence for uploading copybook members to the mainframe. Yes
copybook_rdz.pl The top of the call sequence for uploading copybook members to the mainframe from Rational Developer for System z or Eclipse platforms. Yes
copybook_tsoc.pl The top of the call sequence for uploading copybook members to the mainframe from the TSO Client. Yes
Import_attr.pl Reads a flat file of element attributes and assigns them to the elements that have been migrated to ClearCase, one element at a time. No
linkSubmit.pl Submits the link job. Yes
linkSubmit_rdz.pl Submits the link job from the Rational Developer for System z or Eclipse platforms. Yes
linkSubmit_tsoc.pl Submits the link job from the TSO Client. Yes
sampleAttr.xls Excel spreadsheet holding the element names and their associated attribute values. It must be converted to a tab-delimited CSV file before being as input to the Import_attr.pl program. Yes
SetZCCEnvAttr.pl Sets the project-level attributes that map to the z/OS infrastructure or environments. The following attributes are assigned:
  • SYSLIB concatenation for both compile and link
  • Target load libraries
  • Environment names
  • A mapped life cycle
  • DB2 subsystems to use based on environment, hostname, and port address
Yes
testperl.pl A Perl utility program that calls ciCobol.pl. Yes
uploadCopybook.pl Uploads a copybook the user has changed from the distributed system to the mainframe. Yes
uploadCopybook_rdz.pl Uploads a copybook the user has changed from the Rational Developer for System z platform to the mainframe. Yes
Userid A user ID table used to map a user's Windows ID to the TSO login ID used to log in to the Remote Build server. Yes