handling the timing of MVS builds is to start the MVS build server only at night and ensure that the MVS builders do not have short timeout values.

Writing an MVS build script

The best starting point for an MVS build script is an existing JCL fragment that is used for transforming inputs into outputs. For example, suppose you want to create a builder that compiles a C source ®le into an OBJECT ®le using IBM's C/370 compiler. You probably already have JCL that can be submitted as a batch job that does this.

When you create a build script for the MVS environment, you specify JCL statements with additional TeamConnection syntax. This build script is parsed by the build server. From the parsed results, TeamConnection allocates the speci®ed ddnames and data sets; it then determines and executes the programs dynamically. The MVS build server uses the specialized TeamConnection syntax in the JCL to determine where to store the parts involved in an MVS build.

All statements in the MVS build script except for comments and inline data stream must start with two forward slashes (//).

Before you start writing your build script, refer to the manuals for the compiler, linker, or other transformation program to determine the data set requirements. Pay particular attention to the DCB attributes for LRECL, BLKSIZE, and RECFM.

Sample build scripts shipped with TeamConnection can be installed on MVS. Page 305 lists the sample build scripts. For instructions on installing these samples, refer to the Administrator's Guide

If you are debugging a build script, these manuals are also the ®rst place to look for problems.

For more information about JCL syntax, refer to the JCL User's Guide and JCL Reference for your version of MVS. (These are listed in the bibliography at the back of this book.)

The following sample MVS build scripts are shipped with TeamConnection:

fhbmasm.jcl

Calls the MVS assembler

fhbcobm.jcl

Calls the MVS COBOL compiler

fhbmpli.jcl

Calls the PL/1 MVS compiler

Chapter 13. Working with MVS build scripts and builders 163

Page 183
Image 183
IBM SC34-4499-03 manual Writing an MVS build script, Fhbmasm.jcl, Fhbcobm.jcl, Fhbmpli.jcl