Installing the file agent RSE miner

Perform the steps described in this topic to install and configure the file agent Remote Systems Explorer (RSE) miner.

Before you begin

Follow the installation and configuration steps for the RSE server and daemon in the IBM Developer for z Systems Host Configuration Guide, (SC23-7658), which can be found at the IBM® Developer for z Systems® Library page.

These steps require that you have already installed the Build System Toolkit for System z®. If you have not finished the installation, see Installing the Build System Toolkit on z/OS® for more information.

About this task

If you are using Rational Developer for System z version 9.5.1 or IBM Developer for z Systems 14.0.0 or later versions:
  1. Locate the IBM® Explorer for z/OS configuration directory. The default location is /etc/zexpl. See the IBM Explorer for z/OS knowledge center for details.
  2. Create a file named idzewm.env in the IBM Explorer for z/OS configuration directory using the contents of sample member BLZENVAR from hlq.SBLZSAMP, where hlq is the high-level qualifier specified during the SMP/E installation. The BLZENVAR member contains the IBM Engineering Workflow Management (EWM) CLASSPATH assignment. The sample member also contains stubbed declarations of both the LIB_PATH and SCM_WORK environment variables. For clarification about how to set these environment variables, review the comments in the new idzewm.env file. Ensure that the file permissions for the new idzewm.env are the same as existing environment variable files.
  3. Restart the IBM Explorer for z/OS RSE daemon. The default name for this started task is RSED.
If you are using Rational Developer for System z version 9.5 or earlier:
  1. Locate the rse.env file in the RSE configuration directory. See rse.env, RSE in the IBM Developer for z Systems Host Configuration Guide for instructions, which can be found at the IBM Developer for z Systems Library page.
  2. Save a copy of this file using the following command: cp rse.env rse.env.org
  3. Edit the rse.env file using the ISPF 3.17, the oedit command in OMVS (oedit rse.env), or the Rational Developer for System z editor if you use Remote Systems Explorer.
  4. You must designate a class path statement, library path statement, and a working directory location. Find the CLASSPATH assignment, CLASSPATH=.:$CLASSPATH, in the rse.env file. Immediately ahead of the CLASSPATH assignment, copy the sample member BLZENVAR from hlq.SBLZSAMP. hlq is the high-level qualifier specified during the SMP/E installation. The member contains the Engineering Workflow Management CLASSPATH assignment. The sample member also contains 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 rse.env file.
    Note:
    • Apply the class path statement addition for Engineering Workflow Management to every instance of the RSE server for which you want to run Engineering Workflow Management. After performing the configuration steps, you must re-create any RSE connections that existed previously in your IBM Developer for z Systems clients.
    • Developers using the IBM Developer for z Systems and Engineering Workflow Management integration feature require write access to the directory pointed to by SCM_WORK (and at least read and execute access to its parent directories).
    The following is an example of the Java™ rse.env file. It includes modification prompts to show you how and where to customize your own rse.env file, according to your build environment.

    #
    # Insert the following Classpath allocation in the rse.env
    # just prior to the CLASSPATH=.:$CLASSPATH statement, then
    # uncomment and update it to reference the install path for EWM
    #
    # Engineering Workflow Management
    #
    #CLASSPATH=$CLASSPATH:@pathPrefix@/usr/lpp/jazz/v7.0/buildsystem/buildtoolkit/*

    # Uncomment and update the following statement to reference the install
    # path for EWM
    #LIBPATH=$LIBPATH:@pathPrefix@/usr/lpp/jazz/v7.0/buildsystem/buildtoolkit

    # Uncomment and update the following statement to reference the working
    # directory.
    # Working directories are typically stored in /u/jazz70. You can change
    # this directory.
    # Make sure that the userId under which the IBM Developer for z Systems
    # Remote Explorer daemon runs has write access permission to this directory
    #SCM_WORK=@workPath@/rdz

  5. Stop and restart the RSE server and daemon.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki