Submitting an upload copy member request from TSO Client

Use the pbu parameterized build request to upload a COBOL copybook to the z/OS® system.

About this task

Your ClearCase® administrator can modify the parameterized build scripts to make build available for any language file and allow the related language to upload copybooks, include files, or header files to the z/OS system.

Procedure

To submit a pbu request, do these steps:
  1. On the option line of the TSO Client Main Menu, type 4.
  2. On the left side of the Action Dataset Select panel, under DSLIST, type s beside one or more of the data sets in the list to select a data set.
  3. On the left side of the View Files List panel, under the ClearCase file name, do one of the following actions:
    • Type pbu next to the file name. The upload request is submitted.
    • Type s next to the file name and press Enter. The Select Action panel displays. Type pbu on the option line, press Enter, and press PF3 END to return to the View Files List panel. The upload request is submitted.

Results

The copybook member is saved in a PDS on the z/OS 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, include file, or header file. 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
An error message is issued under the following conditions:
  • The file selected is not on a Windows® platform.
  • The PARMBUILD_SCRIPTS environment variable is not specified in the environment definition file.