Setting up a test environment

Before you begin

Previous step: Customizing the build scripts

About this task

The parameterized build samples include several COBOL applications that you can use to set up a test environment for your configuration and that ClearCase® developers can use to become familiar with the parameterized build scripts.
The following COBOL source programs are provided.
  • pbtest1.cbl - hello world
  • pbtest2.cbl - source program uses copybook
  • pbtest.cbl - source program calls subprogram
  • pbtest3.cbl - subprogram called by pbtest.cbl
  • copyone.cpy - copybook
  • pbmain.link - sample link control file

Procedure

  1. Set the type attribute LANG to the value COBOL2 for each of the COBOL source programs listed above as described in Configuring the view elements.
  2. Set the type attribute LNKDECK to the value PBMAIN for the pbtest.cbl source program listed above as described in Configuring the view elements.
  3. If you want to test parameterized build from a TSO Client environment, you need to add the PARMBUILD_SCRIPTS environment variable to your TSO Client environment definition. The environment variable should specify the location of the build script, such as: PARMBUILD_SCRIPTS \\CCHOSTNAME\ccstg_d\Triggers. Where CCHOSTNAME is the hostname and ccstg_d\Triggers is the directory where the build script is installed. See Profile parameters for instructions.
  4. If you want to test parameterized build from a Rational® Developer for System z® environment, you need to configure parameterized build for Rational Developer for System z, which involves the following steps:
    1. Setting the Parameterized Build preference in Rational Developer for System z to point to the directory where the parameterized build scripts are installed, such as: C:\ccstg_d\Triggers.
    2. Creating a ClearCase-enabled project in Rational Developer for System z that has the same location as the ClearCase VOB directory where the provided sample source programs are stored.
    Instructions for completing these steps are in Using parameterized build with Rational Developer for System z.
  5. If you want ClearCase developers to be able to use these sample programs, place them in a shared directory.

Results

After you have set up the test environment, you can run the following test scenarios:

From the ClearCase Explorer or Windows® Explorer:

From the TSO Client:

From the IBM® Rational Developer for System z or Eclipse platform:

What to do next

For information on next steps, return to the main parameterized build setup topic.