Rebuilding a project or subproject

Use the Rebuild Project or Rebuild Subproject action to create a load module.

About this task

You can use two actions for building projects and subprojects:
  • Use Rebuild Project when you want to build a project with several load modules contained in multiple subprojects.
  • Use Rebuild Subproject to build a single load module.
    Restriction: For subprojects that are shared in a Engineering Workflow Management repository, all resources in the subproject must be shared. If some resources in a subproject are not shared, the Rebuild Subproject action is disabled.
When you use these actions to create a load module, the load module name is assigned by either of the following methods:
  • The name of the program that is nominated as the entry point for the load module. This method is the default.
  • A load module name that you specify during the build operation. This method is available for rebuilding subprojects only.
Load module names, and the method for assigning them, are associated with a subproject. If you build a project with multiple load modules, therefore, the load module name that is used for each subproject is the one that is associated with that subproject.

Information specific to Windows Local COBOL and PL/I builds that use the native COBOL and PL/I compilers are supported only on Windows platforms and in the Developer for z/OS® Enterprise Edition edition of the product.

Procedure

To create a load module by building a project or subproject:

  1. To nominate a file as the entry point, right-click that file and click Nominate as Entry Point.
  2. Right-click the project or subproject you want to build and click Rebuild Project or Rebuild Subproject.
    • For a Rebuild Project operation for a single load module, the build request executes. The load module name is the name of the member that is nominated as the entry point.
    • For a Rebuild Project operation for multiple load modules, the build request executes. The load module name is the name of the member that is nominated as the entry point or specified on the Load Module Member Name window.
    • For a Rebuild Subproject operation, the Load Module Member Name window opens.
  3. Optional: To change the load module name for a Rebuild Subproject operation, type a member name in the Member Name field and click OK.
    You can disable this window by using the z/OS Solutions preference page.
    The build request executes.

Results

If the job executes successfully, this action generates and submits JCL that compiles and links the source, producing a load module that you can run or debug. The JCL generated by this action does not produce a GO step. Build errors are presented as entries in the Remote Error List view.
If a JCL error occurs or the job ends abnormally, an error message displays to help you solve the problem. From this message window, you can do one of the following actions:
  • Open the job output to view the error messages and return codes.
  • Open the property group that is associated with the file to view the build properties currently in use.
Click an entry to open the source file in which the related error was found.