Uploading modified copybooks

Use the Upload Copy Member to Host parameterized build request to upload modified copybooks to the mainframe before submitting a compile request.

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 an Upload Copy Member to Host request, do these steps.
  1. Open a VOB whose elements have been enabled for parameterized build.
  2. Right-click a COBOL copybook and then click Upload Copy Member to Host.
    A command window opens with debug messages showing the status of the upload request.
  3. When the upload has completed successfully, press any key to exit the command window.

Results

The copybook member is saved in a PDS on the mainframe 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 will be 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 VOB directory. The BCL upload.jcl for uploading the file is located in VOB/userid directory in ClearCase®, 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:
//* ------------------------------------------------------------------
//UPLOAD   EXEC PGM=IEFBR14
//*        ----
//*        ---- IEFBR14 - Upload and Allocate Copybook Files
//*        ----
//UPLD1    DD  DSN=JHUANG.XCOPYLIB(COPYONE),RCCEXT=CPY,
//             DISP=SHR