Installing IBM Agent Controller on z/OS

  1. In a UNIX System Services shell, go to the directory where you want to install IBM Agent Controller. You are recommended to install it in the /usr/lpp/ directory.
  2. Issue the following command to extract Agent Controller files (which you downloaded from the WebSphere Business Integration Brokers Support Web page):
    pax -ppx -rzf <IBMRAC_LOCATION>/ibmrac.os390.pax.Z  
    The files will be extracted into a subdirectory called IBMRAC.
  3. After you have installed Agent Controller, change the directory to the installed location's bin directory /usr/lpp/IBMRAC/bin, and run the setup script by typing:
    ./SetConfig.sh
  4. Reply to the following prompts:
    1. IBM Agent Controller installed location: enter the location of Agent Controller, for example, /usr/lpp/IBMRAC.
    2. Specify where the Java Runtime file (java) is located: enter the location of the java file, for example, /usr/lpp/java/IBM/J1.3/bin.
    3. WebSphere Application Server V5 installed location: leave this blank.
    4. Security (yes/no): enter no because the security feature is not supported.
    5. Allow hosts (ALL/LOCAL/CUSTOM): specify which computers can access Agent Controller. To allow only this computer, type LOCAL. To allow any computer to connect, type ALL. To specify a list of computers, type CUSTOM.
    6. Allowed host names (separated by spaces): if CUSTOM is selected, enter the host names that can access Agent Controller. Host names do not have to be fully qualified. You can also specify IP addresses.
  5. To profile programs running on WebSphere Application Server, go to the usr/lpp/IBMRAC/bin directory and issue the command:
    ./makelinks.sh
  6. Make Agent Controller shared object files program controlled by issuing the following command in a UNIX System Services shell. To issue this command, you must have a minimum of READ access to the BPX.FILEATTR.PROGCTL FACILITY class. For more information, refer to the z/OS UNIX System Services Planning book.
    extattr +p /usr/lpp/IBMRAC/lib/*.so
  7. Start the server by logging on as root, opening the /usr/lpp/IBMRAC/bin directory and issuing the command:
    /RAStart.sh
  8. To stop the server, log in as root, open the /usr/lpp/IBMRAC/bin directory, and issue the command:
    ./RAStop.sh
To enable the z/OS broker to connect to the Agent Controller, ensure the lib directory of the installed Agent Controller (for example /usr/lpp/IBMRAC/lib) is part of the LIBPATH in the ENVFILE of the broker. You can add this by stopping the broker, changing the LIBPATH environment variable in the mqsicompcif file, recustomizing, and then restarting the broker.