Installing the Dispatcher on a z/OS operating system

You must install both a binary UNIX tar file and a shell script to install the Dispatcher on a z/OS operating system.

About this task

After the installation of the Dispatcher is complete, verify the startup and shutdown of the Dispatcher. See Start, stop, and restart the Dispatcher service.

Procedure

  1. Locate the delivered Dispatcher or adapter compressed file.
  2. Extract the contents of the compressed file into a temporary directory and navigate to that directory.
  3. From the temporary directory, locate and navigate to the zSystem directory.
  4. Under the zSystem directory, locate the following two files:
    • Dispatcher.tar
    • instDispatcher_zOS.sh
    Note: Dispatcher.tar is a binary UNIX tar file and instDispatcher_zOS.sh is a UNIX shell script.
  5. Transfer the two files to the zOS workstation where the adapter is to be installed. Both files must be copied to the same directory.
  6. Set the execution flag on instDispatcher_zOS.sh:
    chmod +x instDispatcher_zOS.sh
  7. Run the installer by issuing the command:
       ./ instDispatcher_zOS.sh
    The following dialog is displayed.
    Note: The path given in the following example might be different on your system.
    ************************************************
       ITIM RMI Dispatcher Installation Program
    ************************************************
    
    You will prompted to enter the following information:
    
            TDI home directory.
            Your TDI solution directory.
    
    Make sure you have the above information available and
    the Dispatcher.jar is located in the current directory
    before you continue
    
    1. Install
    2. Quit
    
    Please enter choice: 1
    
    Extracting content of Dispatcher...
    
    Enter TDI home directory,
    Hit [Enter] to accept [/usr/lpp/itdi]
    or type new value (full path):
    
    Enter the solution directory name (full path): /u/user2/rmi/soldir
    
    extracting content of Dispatcher.jar...
    setting up solution directory tree /u/user2/rmi/soldir...
    getting files from TDI home directory /usr/lpp/itdi...
    updating /u/user2/rmi/soldir/solution.properties file...
    getting dispatcher files from /u/user2/rmi/Dispatcher...
    updating /u/user2/rmi/soldir/ITIMAd file...
    
    Installation complete, press any key to continue...