Exercise 3.6: Submitting a build

Before you begin, you must complete Exercise 3.5: Selecting the build style.

Note:
You must have a build style defined for your project before you can compile.

Besides compiling a single member like in Exercise 2.4: Compiling a member, you can compile the project in full. The actual compile behavior depends on the Build Style associated with the project. The default build style for iSeries Projects is the CL Program Build Style.

This build style will generate a COMPILE.CLLE member in a QCLSRC file that will contain a compile entry for each source member in the iSeries project.

You can verify or change the configuration of a build style. You can specify the name of the source file to hold the COMPILE.CLLE member and whether or not you want to automatically push changes and re-generate the COMPILE.CLLE member before a push.

To compile a project in full:

  1. Right-click the iSeries Project and click Remote Actions > Submit Build.
    SUBMIT BUILD

    Now the connection will be activated and you may be prompted for a user ID and password if you disconnected.

  2. Enter your user ID and password.

    The changes are pushed to the iSeries. (For the first time all changes are pushed to the iSeries. Subsequent builds only push changed files.)
    Pushing changes

  3. This action, with the default configuration, will perform all of the following:

    1. Generate the following COMPILE.CLLE member:
      COMPILE.CLLE
    2. Display a Build Job entry in the iSeries Build Job Status View indicating that a build has been submitted. The entry will look like this:
      iSeries Build Job Status

      You can change the Refresh Interval using the side arrow next to the Refresh Interval field shown above.

    3. Push all project changes to the host, including the newly created COMPILE.CLLE member.
    4. Compile COMPILE.CLLE into a program in the QTEMP library.
    5. Run it against the source in the PROJxx project library.
    6. If there where any errors during the submitted build (see PAYROLL), after the job completes, refresh the iSeries Job Status View, then right-click on the entry in the iSeries Job Status View, and select Task Actions > Retrieve Errors.

      This will open the iSeries Error list and you will be able to double-click the error to open the corresponding member.

You have built your iSeries Project and now you are ready to begin Exercise 3.7: Showing remote objects.