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®.
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:
|
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:
|
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 |