Adding artifacts to Engineering Workflow Management

Adding an artifact to IBM® Engineering Workflow Management involves taking an artifact that you created using IBM Developer for z/OS® and making it available to IBM Engineering Workflow Management source control management.

For this example, you create COBOL program using IBM Developer for z/OS and add it to your Engineering Workflow Management repository for source control. You can add MVS subproject members from IBM Developer for z/OS to Engineering Workflow Management using the Share members as zFiles wizard.

Complete the following steps. (These steps use examples from the tutorial as illustrations.)

  1. From the Remote Systems view, select the COBOL program you created in the load part of the example, right-click, and select Create PDS Member.
    Menu from Remote System Explorer showing "Create PDS Member"
  2. Enter a name for your new COBOL program in the Member Name field of the New PDS Member panel and click Finish. For this example, the name of the new program is Goodbye.
    Create PDS Member panel showing new COBOL program name "Goodbye" in the Member Name field.
    Your new COBOL program appears in the same data set as your HELLO.cbl program.
    Remote System Explorer showing new "GOODBYE.cbl" in the same data set as "HELLO.cbl"
  3. Add the new program to your MVS subproject by dragging it from the Remote Systems view and dropping it onto the subproject in the z/OS Projects view.
    z/OS Project view showing new "GOODBYE.cbl" in the same MVS subproject as "HELLO.cbl."
    Note: The new program BGREEN.BLD.COBOL(GOODBYE.cbl) does not have the gold file decorator that BGREEN.BLD.COBOL(HELLO.cbl) has because it is not under Engineering Workflow Management source control yet.
Complete the following steps to add the program to Engineering Workflow Management source control:
  1. From the MVS subproject in the z/OS Projects view, right-click BGREEN.BLD.COBOL(GOODBYE.cbl) and select Team > Share Members as zFiles.
    z/OS Project view showing menu for selecting "Share Members as zFiles"
  2. By default, the name of the program being added is preselected on the first panel of the Share members as zFiles wizard. Click Next.
  3. Select the zComponent project to which you want to share the new program and click Next. You can also create a zComponent project, but this example uses the project created in Using an Ant with Enterprise Extensions build to compile a COBOL application.
    "Choose a zComponent" project panel showing the existing zComponent project and the option to create a zComponent project
  4. On the Share zComponent Project to Jazz Repository panel, select the same component that contains the HELLO.cbl program. Click Next.
    "Share zComponent Project to Jazz Repository" panel showing the Jazz repository and component in an existing repository workspace
  5. From the Specify Build Context panel, click Browse and select a build definition. For this example, select Mortgage Team Build.
    "Select build definition" panel showing build definition named "Mortgage Team Build"
    Click OK> Next. The build definition is associated with the Engineering Workflow Management repository workspace.
    Note: After you run either the Load zFiles to z/OS wizard or Share members as zFiles wizard and you choose a build definition for a repository workspace, the build definition will be associated to that repository workspace. Any subsequent runs of the wizards display the associated build definition details, but you cannot change them. You can clear the build context by disconnecting all the members.
  6. A build definition normally specifies the prefix that the team build uses. To make sure that you can work on your artifacts in isolation, change the prefix that is specified in the build definition to your own prefix. To modify the prefix, select team.enterprise.scm.resourcePrefix from the Build Properties list and click Edit.
  7. On the Select Property Type panel, select String from the list of new property types and click OK.
    "Select Property Type panel" showing list of options for type of new property
  8. On the Edit Build Request Property panel, change the value from your team build prefix to your prefix and click OK. (For this example, the value changes to BGREEN.BLD.)
    "Edit Build Request" panel showing value changed to BGREEN.BLD
    Important: Make sure that the credentials you used to make the RSE connection to the host have the authority to create and modify a data set with the prefix you set in the value field.
  9. Click Next.

When the new program is added to the zComponent project it is placed into a zFolder. That zFolder must be associated to a data set definition.

You can change data set definition associations. The panel used for this example shows the correct data set name (BGREEN.BLD.COBOL), but an incorrect repository data set definition (BMS).
"Associate Data Set Definitions" panel showing incorrect repository data set definition "BMS"
Complete the following steps to change the association:
  1. On the Associate Data Set Definitions panel, click the <...> button under the Browse heading.
  2. Select the COBOL data set definition and click OK.
    "Select a data set definition" panel showing "COBOL" selected as data set definition option
  3. You can also associate language definitions when you associate data set definitions. If you do not associate language definitions here, you must associate language definitions for all the files you want built before requesting a build.
  4. On the updated Associate Data Set Definitions panel, verify that the repository data set definition is correct. For this example, it is COBOL.
    "Associate Data Set Definitions" panel showing correct repository data set definition "COBOL"
  5. On the last page of the Share members as zFiles wizard, you have the option of copying or moving members. If you choose copy, the member stays in its original data set and a copy is placed in the new location specified by the data set definition and prefix. If you choose move, the member is moved and deleted from the original data set.
  6. Click Finish.

Verifying that the share was successful

From the Project Explorer, confirm that the GOODBYE.cbl program has been added to the zComponent project.
"Project Explorer" view showing "GOODBYE.cbl" in the zComponent project
Tip: If the Share members as zFiles wizard ends in error, open the .log file in the metadata folder in your Eclipse workspace for additional information.