## Installation instructions for usermod TPFA001 for IBM WebSphere Developer for z/OS (FMID HHOP700)

The usermod is shipped as file ibm.hhop700.tpfa001

### Overview of the installation steps

Steps required to install the usermod:

1. Allocate host data set for the usermod.
2. Upload the usermod from your workstation to z/OS.
3. Perform SMP/E RECEIVE and APPLY.
4. Customize the host configuration for the usermod

### Allocate host data set for the usermod

A sequential data set must be allocated on the z/OS system to receive the usermod that you will upload from your workstation. You can do this by submitting the job below. Add a job card and modify the parameters to meet your site's requirements before submitting.

    //ALLOC    EXEC PGM=IEFBR14
    //*
    //FTPALLOC DD DSN=hlq.IBM.HHOP700.TPFA001,
    //            DISP=(NEW,CATLG,DELETE),
    //            DSORG=PS,
    //            RECFM=FB,
    //            LRECL=80,
    //            UNIT=SYSALLDA,
    //*            VOL=SER=volser,
    //*            BLKSIZE=6160,
    //            SPACE=(TRK,(1,1))
    //*

### Upload the usermod from your workstation to z/OS

Upload the file in binary format from your workstation to the z/OS data set. On a Windows system, you can use FTP from a command prompt to upload the file. In the sample dialog shown below, commands or other information entered by the user are in bold, and the following values are assumed:

User enters: | Values
--- | ---
`mvsaddr` | TCP/IP address of the z/OS system
`tsouid` | Your TSO user ID
`tsopw` | Your TSO password
`d:` | Your drive containing the usermod files
`hlq` | High-level qualifier that you used for the data set that you allocated in the job above

    C:\>ftp mvsaddr
    Connected to mvsaddr.
    220-FTPD1 IBM FTP CS V2R8 at mvsaddr, 04:43:52 on 2002-03-15.
    220 Connection will close if idle for more than 60 minutes.

    User (mvsaddr:(none)): tsouid

    331 Send password please.
    Password: tsopw
    230 tsouid is logged on.  Working directory is "tsouid.".

    ftp> cd ..
    250 "" is the working directory name prefix.

    ftp> cd hlq
    250 "hlq." is the working directory name prefix.

    ftp> binary
    200 Representation type is Image

    ftp> put c:\ibm.hhop700.tpfa001 ibm.hhop700.tpfa001
    200 Port request OK.
    125 Storing data set hlq.ibm.hhop700.tpfa001
    250 Transfer completed successfully
    51520 bytes sent in .32 seconds

    ftp> quit
    221 Quit command received. Goodbye.

### Perform SMP/E RECEIVE and APPLY

SMP/E RECEIVE and APPLY the usermod.

### Customize the host configuration for the usermod

The WebSphere Developers Fault Analyzer tech preview usermod requires 2 modifications to the WebSphere Developer host setup.

Steps required to activate the usermod:

1. rsed.envvars must include FAMiner.jar in its CLASSPATH configuration.
2. minerFile.dat must be updated to include FAMiner.

#### rsed.envvars must include FAMiner.jar in its CLASSPATH configuration

rsed.envvars must include FAMiner.jar in its CLASSPATH configuration. This can be done by adding the following lines to the END of rsed.envvars:

    #=============================================================
    # Fault Analyzer tech preview (usermod TPFA001)
    #=============================================================
    CLASSPATH=$CLASSPATH:$RSE_LIB/FAMiner.jar

Note: rsed.envvars resides by default in the RSE install path (default: /usr/lpp/wd4z/rse/lib), but could have been copied to a different location to avoid overwriting customizations when applying maintenance.

#### minerFile.dat must be updated to include FAMiner

minerFile.dat must be updated to include FAMiner. A rexx program, TPFA001.active, is installed by this usermod to check if FAMiner is enabled, and to enable (-e) or disable (-d) the change to minerFile.dat

Give the following commands in the RSE install path (default: /usr/lpp/wd4z/rse/lib) to display the current status, to enable Fault Analyzer or to disable it:

    $ ./TPFA001.active
    Fault Analyzer is NOT enabled in minerFile.dat

    $ ./TPFA001.active -e
    Enabling Fault Analyzer in minerFile.dat
    Fault Analyzer is enabled in minerFile.dat

    $ ./TPFA001.active -d
    Disabling Fault Analyzer in minerFile.dat
    Fault Analyzer is NOT enabled in minerFile.dat