Adding an artifact to Rational Team Concert™ involves
taking an artifact you created using Rational® Developer for System z® and making it available to Rational Team Concert source
control management.
For this example, you create COBOL program using Rational Developer for System z and add it to your Rational Team Concert repository
for source control. You can add MVS™ subproject
members from Rational Developer
for System z to Rational Team Concert using
the Share members as zFiles wizard.
Complete the following steps. (These steps use examples from the
tutorial as illustrations.)
- 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.
- 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, we named
the new program Goodbye. Your
new COBOL program appears in the same data set as your HELLO.cbl program.
- 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.
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 Rational
Team Concert source control yet.
Complete the following steps to add the program to Rational Team Concert source
control:
- From the MVS subproject in
the z/OS Projects view, right-click BGREEN.BLD.COBOL(GOODBYE.cbl) and
select zComponent > Share Members as zFiles.
- By default, the name of the program being added is preselected
on the first panel of the Share members as zFiles wizard.
Click Next.
- Select the zComponent project to which you want to share the new
program and click Next. You can also create
a zComponent project, but for this example we are using the project
created in ../../com.ibm.team.concert.tutorial.doc/topics/tut_rtcz_scen6.html.
- On the Share zComponent Project to Jazz Repository panel,
select the same component that contains the HELLO.cbl program.
Click Next.
- From the Specify Build Context panel, click Browse and
select a build definition. For this example, select Mortgage
Team Build. Click OK
> Next. The build definition is associated with the Rational Team Concert 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.
- 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 teamz.scm.dataset.prefix from
the Build Properties list and click Edit.
- On the Select Property Type panel, select String from
the list of new property types and click OK.
- On the Edit Build Request Property panel
change the value from MASAO.BLD to your prefix
and click OK. (For this example, we changed
the value 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.
- 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).

Complete the following steps to change the association:
- On the Associate Data Set Definitions panel,
click the <...> button under the Browse heading.
- Select the COBOL data set definition and
click OK.
- 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.
- On the updated Associate Data Set Definitions panel,
verify that the repository data set definition is correct. For this
example, it is COBOL.
- 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.
- 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.
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.