Modifying the DTXINST JCL

The DTXINST JCL job is used to create the IBM® Transformation Extender UNIX System Services (USS) runtime environment.

Run this job if you have not yet run it to deploy the installed files on USS and only after you have installed one or more of the following features:

  • JDTXnn2 IBM Transformation Extender for Application Programming
  • JDTXnn3 IBM Transformation Extender for Integration Servers
  • JDTXnn4 IBM Transformation Extender with Launcher
where nn is the release number. An example is JDTX904, the IBM Transformation Extender with Launcher V9.0 feature.

Before you run the DTXINST JCL, make the following modifications:

  1. Modify the SET INSTHOME statement in the JCL to define the location of your IBM Transformation Extender - Common Components base feature installation if it is different than the default location settings. The default location is: /usr/lpp/dtx/VnRnMn/IBM/common.
  2. Update the JAVA_HOME_DIR environment variable in the STDENV DD statement of the INSTALL job step. Change the javahome variable to the directory location of the IBM Runtime Environment, Java™ Technology Edition for your system. See the product release notes for the required version of IBM Runtime Environment, Java Technology Edition.
    For example, change
    JAVA_HOME_DIR=javahome
    to
    JAVA_HOME_DIR=/usr/lpp/java/IBM/J1.6
  3. Update the BIT_PREFERENCE keyword in the STDENV DD statement of the INSTALL job step. Change the BITS variable to the word length of the installation run-time library and binary file selections. The BITS variable is one of the following:
    Option Description
    64 64-bit library and binary files
  4. Modify the SET CRTHOME statement in the JCL to define the location of the directory structure where you want the UNIX System Services (USS) runtime environment for the optional features you installed to be created if it is different than the default location settings. The default location is: /u/dtxuser/dtx.
When you run the DTXINST JCL, it will run the SET commands, and then run the following two steps: MAKEDIR and INSTALL.