Installing the z/OS Agent

To install the z/OS agent, perform these steps:

  1. Obtain the z/OS Agent files and copy or FTP (binary mode) the installation files, install.sh and install.tar, to the temp directory you created for the installation in the z/OS Unix file system.

  2. Change to the directory where you downloaded the installation files.

  3. Log on to TSO or ISPF.

    When you log on, be sure to allocate at least two MB of memory (SIZE=2048000) for your session. This amount of memory is required during installation and is needed anytime the agent is started.

  4. Invoke the USS shell from TSO (do not use rlogin).

    You must be a user with Superuser authority (UID=0) and change to the directory you created for the agent or the directory where the agent is already installed.

    Example: READY OMVS IBM

    Licensed Material - Property of IBM

    5647-A01 (C) Copyright IBM Corp. 1993, 2000

    (C) Copyright Mortice Kern Systems, Inc., 1985, 1996.

    (C) Copyright Software Development Group, University of Waterloo, 1989.|

    All Rights Reserved.

    U.S. Government users - RESTRICTED RIGHTS - Use, Duplication, or Disclosure restricted by GSA-ADP schedule contract with IBM Corp.

    IBM is a registered trademark of the IBM Corp.

    => cd /opt/<temp directory>

  5. Change mode on install.sh so it can be executed.

    chmod 755 install.*

  6. Run the installation script by entering:

    ./install.sh

    After starting the installation script, you may have to wait a few moments. Do not press ENTER.

    You will see a banner and a message about making a current backup before installing new software. If you have not backed up your files before beginning the installation, quit the installation by typing n and back up your files. To proceed with the installation, type y.

    Note: Throughout this installation, default responses to prompts are shown in brackets.

  7. Enter the name of the user who will own the agent files (agent owner).

  8. Enter the directory location where the files should be installed. It is recommended that default location (/TIDAL/Agent) be used. Entering y will begin installing the agent files.

    Information on the files being installed is displayed. Once the files are installed, the Agent Configuration Menu is displayed with options for adding, editing, and deleting agent instances.

    Note: You must add at least one agent instance and configure it.

  9. Enter a name for the agent, a port number and the directory path to the Java binaries directory after selecting the option to add an agent instance (1).

    Note: It is recommended to use the default port number, 5912, if possible. If you have used the default locations when installing, you can just press ENTER.

    Note: Once you confirm the selections, you are returned to the Agent Configuration Menu. Quit the Agent Configuration Menu by typing Q and pressing ENTER.