Installing the Agent for OS/400

This topic guides you through the installation of an OS/400 agent in an AE system in which authentication is not used. Additional installation steps are required before the agent can be started and used if you intend to use one of the available authentication methods. For more information, see Agent Authentication.

A three-figure abbreviation is provided for each supported OS/400 version. It is part of the agent's file name.

Requirements

The CallAPI implementation is described in a separate document, see CallAPI for OS/400.

To Install the Agent for OS/400

There are two different methods.

Method 1

  1. Transfer the file to the host, and have the library and INI files adjusted

    • Host
    • Start the installation with the supplied file installer.jar:

      java -jar installer.jar /LIB UC4 /SAVF ucxjo41.bin

      If you do not provide the parameters for system, user and password here, a dialog will open where you can enter these credentials.

      The installer automatically transfers the binaries and adjusts the initial library path of the INI files to the specified library.

    Alternatively, you can manually implement step 1:

    1. Transfer the file to the host.
      • Host
      • Create a library for restoring the Save File:

        CRTLIB LIB(UC4TMP) TYPE(*PROD) TEXT('UC4 Agent')

      • Create an empty Save File.

        CRTSAVF FILE(UC4TMP/UC4)

      • Admin computer
      • Log on to the AS/400 via FTP and transfer UCXJO41.bin to the Save File UC4, library UC4TMP. Example for FTP via the Windows command prompt:

        ftp <MY.AS400>
        <USER>
        <PASSWORD>
        cd UC4TMP
        bin
        put UCXJO41.bin UC4
        quit

    1. Create the library.
      • Host
      • Create a library for restoring the Save File:

        CRTLIB LIB(UC4) TYPE(*PROD) TEXT('Automic Agent')

      • Restore the objects into the UC4 library. If this library contains objects, they will be replaced.

        RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(UC4TMP/UC4) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(UC4)

      • Remove temporary library and Save File:

        DLTLIB LIB(UC4TMP)

    1. Set up the system environment.
      • Server computer
      • The AE system must be running. For more information, see Multi-Server Operation .
      • Host
      • Adjust the INI file (UC4/INI - UCXJO41) of the OS/400 agent. For more information, see Agent OS/400.
      • Admin computer or user computer
      • Adjust the HEADER.OS400, TRAILER.OS400 and RESTART.OS400 if necessary. For more information, see Executing Jobs.

Method 2

  1. Transfer the file to the host, and have the library and INI files adjusted

    • Host
    • Start the installation with the supplied file installer.jar:

      java -jar installer.jar /LIB UC4 /SAVF ucxjo41.bin

      If you do not provide the parameters for system, user and password here, a dialog will open where you can enter these credentials.

      The installer automatically transfers the binaries and adjusts the initial library path of the INI files to the specified library.

    Alternatively, you can manually implement step 1:

    1. Transfer the file to the host.
      • Host
      • Create a library for restoring the Save File:

        CRTLIB LIB(UC4TMP) TYPE(*PROD) TEXT('UC4 Agent')

      • Create an empty Save File.

        CRTSAVF FILE(UC4TMP/UC4)

      • Admin computer
      • Log on to the AS/400 via FTP and transfer UCXJO41.bin to the Save File UC4, library UC4TMP. Example for FTP via the Windows command prompt:

        ftp <MY.AS400>
        <USER>
        <PASSWORD>
        cd UC4TMP
        bin
        put UCXJO41.bin UC4
        quit

    1. Create the libray.
      • Host
      • Create a library for restoring the Save File:

        CRTLIB LIB(UC4) TYPE(*PROD) TEXT('Automic Agent')

      • Restore the objects into the UC4 library. If this library contains objects, they will be replaced.

        RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(UC4TMP/UC4) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(UC4)

      • Remove temporary library and Save File:

        DLTLIB LIB(UC4TMP)

    1. Set up the system environment.
      • Server computer
      • The AE system must be running. For more information, see Multi-Server Operation .
      • Host
      • Adjust the INI file (UC4/INI - UCXJO41) of the OS/400 agent. For more information, see Agent OS/400.
      • Admin computer or user computer
      • Adjust the HEADER.OS400, TRAILER.OS400 and RESTART.OS400 if necessary. For more information, see Executing Jobs.