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.

This page includes the following:

Requirements

For information about CallAPI files and their implementation, see CallAPI for OS/400.

Installing 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 Operations.
      • 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.

There are two different methods that can be used to start the agent. Method 1 requires a CL routine per agent that should start (more complex). Method 2 starts or ends the agent via separate programs.

  1. Create the start and end programs.

    • Host

    • The CL example programs that start and end the agent are provided in the supplied file member CLLE. They must be adjusted to the installation and the OS before you can compile them.

      Start the agent:

      UC4/CLLE(UCEX_RUN)

      Ends the agent:

      UC4/CLLE(UCEX_END)

  2. Start or end the agent.

    • Host
    • You can use the program UCEX_RUN to start the agent.
      An Agent object is automatically created in the system client 0000 and stored in the HOST folder.
    • The program UCEX_END ends the agent.
    • Admin or server computer
    • Verify that the agent is logged on.
      • Start the AWI for client 0000. Information about agents is available in the Administration perspective. A newly logged-on agent is only visible in client 0000 because it has not yet been assigned to a client. Via the Agent object, you can now assign the new agent including the required rights to the particular clients.

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 Operations.
      • 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.

  1. Include the library in the library list.

    • Host

    • The library (UC4) that includes the programs (such as the agent or CallAPI) must be included in the library list. You can use the following commands for this purpose:

      Add the library to the library list:

      ADDLIBLE UC4

      Change the current library for the particular job to UC4:

      CHGCURLIB UC4

  2. Start or end the agent.

    • Host

    • Start the agent by using the command STRUCAGENT.
      The following examples explain the agent's starting procedure:

      STRUCAGENT LIB(UC4) FILE(UC4/INI) MBR(UCXJO41)
      Starts the agent from the library by using the INI file UC4/INI(UCXJO41).

      STRUCAGENT LIB(UC4) PATH('/user/uc4/ucxjo41.ini')
      Starts the agent from the library by using an INI file that is stored in the IFS file system.

    • The command ENDUCAGENT ends the agent.

      ENDUCAGENT LIB(UC4) OPTION(*CNTRLD)
      Ends the agent that has been started from the library in a controlled manner. This is the same as the ENDJOB command issued on the agent process.

      ENDUCAGENT LIB(UC4) OPTION(*IMMED)
      Aborts the agent that has been started from the library with ENDJOB OPTION(*IMMED).

    For more information, see OS/400 Agent - Commands.