Perform the steps described in this topic to install and
configure the file agent Remote System Explorer (RSE) miner.
Procedure
- Configure the sample JCL member BLZCRSYM in
hlq SBLZSAMP, where hlq is the
high-level qualifier you specified during the SMP/E installation.
This job creates a symbolic link directory in your jazz
config directory, normally /etc/jazz/ccm,
and contains symbolic links to all the .jar files in the buildtoolkit directory.
Submit the modified JCL and check the job log to make sure the job
finishes with return code 0. The SYSTSPRT portion
of the job output lists the .jar file name and the symbolic link you
created; for example, one of the lines might look like the following:
jar.6=com.ibm.team.filesystem.client_2.1.0.v20101021_0811.jar
sym.6=jar6.jar
- Locate the rsed.envvars file in the RSE
configuration directory. See rsed.envvars, RSE in
the Rational Developer
for System z Host Configuration
Guide for instructions.
- Save a copy of this file using the following command: cp
rsed.envvars rsed.envvars.org
- If you use OMVS, edit the rsed.envvars file
using the ISPF 3.17 oedit command (oedit
rsed.envvars), or the Rational Developer
for System z editor if
you use RSE.
- You must designate class path statements, library path
statements, and a working directory location. Find the CLASSPATH assignment, CLASSPATH=.:$CLASSPATH,
in the rsed.envvars file. For Java
1.6, immediately ahead of the CLASSPATH assignment,
copy the sample member BLZENVAR from hlq.SBLZSAMP.
For Java 1.5, following the CLASSPATH assignment,
copy the sample member BLZENV15 from hlq.SBLZSAMP.
For both members, hlq is the high-level qualifier
specified during the SMP/E installation. The members contains lists
of Rational Team Concert™ CLASSPATH assignments. For both levels
of Java, the sample members also contain stubbed declarations of both
the LIB_PATH and SCM_WORK environment
variables. For clarification on what to set these environment variables
to, review the comments in rsed.envvars file.
Note: Apply
the class path statement additions for Rational Team Concert to every
instance of the RSE server for which you want to run Rational Team Concert. After
performing the configuration steps, you must recreate any RSE connections
that existed previously in your Rational Developer
for System z clients.
The following is an example of the Java 1.6 rsed.envvars file.
It includes modification prompts to show you how and where to customize
your own rsed.envvars file, according to your
build environment.#
# Insert the following Classpath allocation in the rsed.envvars file,
# just prior to the CLASSPATH=.:$CLASSPATH statement
#
# Rational Team Concert
#
CLASSPATH=$CLASSPATH:'/etc/jazz/ccm/symlinks/*'
# Uncomment and update the following statement to reference the install
# path for RTC
#LIBPATH=$LIBPATH:@pathPrefix@/usr/lpp/jazz/v3.0/buildsystem/buildtoolkit
# Uncomment and update the following statement to reference the working
# directory.
# Working directories are typically stored in /u/jazz. You can change
# this directory.
#SCM_WORK=@workPath@
The following
is an example of the Java 1.5 rsed.envvars file.
It includes modification prompts to show you how and where to customize
your own rsed.envvars file, according to your
build environment.#
# Insert the following Classpath allocation in the rsed.envvars file,
# just prior to the CLASSPATH=.:$CLASSPATH statement
#
# Rational Team Concert
#
RTC=/etc/jazz/ccm/symlinks
CLASSPATH=$CLASSPATH:$RTC/jar1.jar
CLASSPATH=$CLASSPATH:$RTC/jar2.jar
CLASSPATH=$CLASSPATH:$RTC/jar3.jar
CLASSPATH=$CLASSPATH:$RTC/jar4.jar
CLASSPATH=$CLASSPATH:$RTC/jar5.jar
CLASSPATH=$CLASSPATH:$RTC/jar6.jar
CLASSPATH=$CLASSPATH:$RTC/jar7.jar
CLASSPATH=$CLASSPATH:$RTC/jar8.jar
CLASSPATH=$CLASSPATH:$RTC/jar9.jar
CLASSPATH=$CLASSPATH:$RTC/jar10.jar
CLASSPATH=$CLASSPATH:$RTC/jar11.jar
CLASSPATH=$CLASSPATH:$RTC/jar12.jar
CLASSPATH=$CLASSPATH:$RTC/jar13.jar
CLASSPATH=$CLASSPATH:$RTC/jar14.jar
CLASSPATH=$CLASSPATH:$RTC/jar15.jar
CLASSPATH=$CLASSPATH:$RTC/jar16.jar
CLASSPATH=$CLASSPATH:$RTC/jar17.jar
CLASSPATH=$CLASSPATH:$RTC/jar18.jar
CLASSPATH=$CLASSPATH:$RTC/jar19.jar
CLASSPATH=$CLASSPATH:$RTC/jar20.jar
CLASSPATH=$CLASSPATH:$RTC/jar21.jar
CLASSPATH=$CLASSPATH:$RTC/jar22.jar
CLASSPATH=$CLASSPATH:$RTC/jar23.jar
CLASSPATH=$CLASSPATH:$RTC/jar24.jar
CLASSPATH=$CLASSPATH:$RTC/jar25.jar
CLASSPATH=$CLASSPATH:$RTC/jar26.jar
CLASSPATH=$CLASSPATH:$RTC/jar27.jar
CLASSPATH=$CLASSPATH:$RTC/jar28.jar
CLASSPATH=$CLASSPATH:$RTC/jar29.jar
CLASSPATH=$CLASSPATH:$RTC/jar30.jar
CLASSPATH=$CLASSPATH:$RTC/jar31.jar
CLASSPATH=$CLASSPATH:$RTC/jar32.jar
CLASSPATH=$CLASSPATH:$RTC/jar33.jar
CLASSPATH=$CLASSPATH:$RTC/jar34.jar
CLASSPATH=$CLASSPATH:$RTC/jar35.jar
CLASSPATH=$CLASSPATH:$RTC/jar36.jar
CLASSPATH=$CLASSPATH:$RTC/jar37.jar
CLASSPATH=$CLASSPATH:$RTC/jar38.jar
CLASSPATH=$CLASSPATH:$RTC/jar39.jar
CLASSPATH=$CLASSPATH:$RTC/jar40.jar
CLASSPATH=$CLASSPATH:$RTC/jar41.jar
CLASSPATH=$CLASSPATH:$RTC/jar42.jar
CLASSPATH=$CLASSPATH:$RTC/jar43.jar
CLASSPATH=$CLASSPATH:$RTC/jar44.jar
CLASSPATH=$CLASSPATH:$RTC/jar45.jar
CLASSPATH=$CLASSPATH:$RTC/jar46.jar
CLASSPATH=$CLASSPATH:$RTC/jar47.jar
CLASSPATH=$CLASSPATH:$RTC/jar48.jar
CLASSPATH=$CLASSPATH:$RTC/jar49.jar
CLASSPATH=$CLASSPATH:$RTC/jar50.jar
CLASSPATH=$CLASSPATH:$RTC/jar51.jar
CLASSPATH=$CLASSPATH:$RTC/jar52.jar
CLASSPATH=$CLASSPATH:$RTC/jar53.jar
CLASSPATH=$CLASSPATH:$RTC/jar54.jar
CLASSPATH=$CLASSPATH:$RTC/jar55.jar
CLASSPATH=$CLASSPATH:$RTC/jar56.jar
CLASSPATH=$CLASSPATH:$RTC/jar57.jar
CLASSPATH=$CLASSPATH:$RTC/jar58.jar
CLASSPATH=$CLASSPATH:$RTC/jar59.jar
CLASSPATH=$CLASSPATH:$RTC/jar60.jar
CLASSPATH=$CLASSPATH:$RTC/jar61.jar
CLASSPATH=$CLASSPATH:$RTC/jar62.jar
CLASSPATH=$CLASSPATH:$RTC/jar63.jar
# Uncomment and update the following statement to reference the install
# path for RTC
#LIBPATH=$LIBPATH:@pathPrefix@/usr/lpp/jazz/v3.0/buildsystem/buildtoolkit
# Uncomment and update the following statement to reference the working
# directory.
# Working directories are typically stored in /u/jazz. You can change
# this directory.
#SCM_WORK=@workPath@
- Stop and restart the RSE server and daemon.
What to do next
Create a file agent file called FileAgentConfiguration.dat in
the same directory where rsed.envvars is saved.
This .dat file must contain comma-separated entries that identify
a Rational Team
Concert for System z Jazz™ repository URL, a file agent
user ID you will use to authenticate to the Jazz repository, and either a cleartext password
or the full path name of an encrypted password file for that user
ID; for example:
https://myexample.jazz.repository.com:9443/jazz, myrepouserid, /pathToMyEncryptedPasswordFile
Note: The
repository URL that you specify in the FileAgentConfiguration.dat file
must resolve to the same IP address as the repository URLs you specified
in the client.
For information about creating an encrypted
password file, see ../../com.ibm.team.build.doc/topics/t_rtcz_pw_file.html.