Use the Parameterized Build > Upload Copybook
Member to Host and Parameterized Build > Compile requests
to submit a COBOL program to the z/OS® system
for compiling with a copybook.
Before you begin
This task refers to sample programs shipped with ClearCase® z/OS extensions.
To use the sample programs, you need to ensure that your ClearCase administrator has set up a test
environment, and you need to be connected to the test VOB and have
created a project under the test VOB.
About this task
If the source program selected to be compiled or built contains
any copybook that has changed since the last compile request, the
updated copybook needs to be uploaded to mainframe before the build
request is submitted.
Procedure
To submit a Parameterized Build > Upload Copybook
Member to Host request for a program with a copybook,
do these steps:
- Expand the project containing the sample programs.
- Edit copyone.cpy as needed.
- Right-click copyone.cpy and click Parameterized
Build > Upload Copybook Member to Host.
A
message window shows the upload request is executing.
- Verify the copybook member is uploaded in USERID.XCOPYLIB(COPYONE).
- Right-click pbtest2.cbl and click Parameterized
Build > Compile.
- Right-click the project name and click Refresh to
verify the output for the build request.
Results
The copybook member is saved in a PDS on the remote system
named USERID.XCOPYLIB(YOURCOPY),
where USERID is the TSO login ID of the user making
the request and YOURCOPY is the name of the copybook.
This PDS is searched first for the copybook during the compilation.
The output log yourcopy.cpy_uploadcopybook.log,
where yourcopy.cpy is the name of the copybook,
is located in the project. The BCL upload.bcl for
uploading the file is located in the VOB/userid directory
on the ClearCase server,
where VOB is the path of the VOB and userid is
your TSO user ID. The following example shows the BCL generated by
an upload request:9 //* ------------------------------------------------------------------
10 //UPLOAD EXEC PGM=IEFBR14
11 //* ----
12 //* ---- IEFBR14 - Upload and Allocate Copybook Files
13 //* ----
14 //UPLD1 DD DSN=JHUANG.XCOPYLIB(COPYONE),RCCEXT=CPY,
15 // DISP=SHR