This document describes the hotfix installation procedure for the OS/400 agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host.
A three-figure abbreviation is provided for each supported OS/400 version. It is part of the agent's file name and is described in the Terminology (O41 for OS/400 version V4R1M0 and later).
Terminate the agent before you start the update installation.
The OS/400 agent is supplied as a binary SavFile. This file is found in the subdirectory IMAGE:AGENTS\AS400.
File name AE CD |
Description |
---|---|
ucxjo41.bin |
OS/400 agent (binary SavFile) |
Content: |
|
IRSTRJOB |
Utility program for generating jobs |
UCXBO41C |
|
UCXJO41 |
Agent |
UCXJO41M |
Messenger program for the OS/400 agent |
CLLE |
CL source files for starting and ending the agent |
INI |
INI file |
MSL |
Message library |
TMP |
Empty text file |
STRUCAGENT | Program that starts the agent |
ENDUCAGENT | Program that ends the agent |
MAKEMSL | Program that generates the message library |
COMPRESS, GSS, LIBCPPRNT | Service programs (libraries) for the agent, the CallAPI and the MAKEMSL program |
The CallAPI files and its implementation are described in a separate document.
![]() |
1. | Transferring the file to the hostComputer, target system. |
---|
CRTLIB LIB(UC4TMP)
CRTSAVF FILE(UC4TMP/UC4)
CRTLIB LIB(UC4AUSL) TYPE(*PROD) TEXT('Automation Engine version 11.0.0')
ftp <MY.AS400>
<USER>
<PASSWORD>
cd UC4TMP
bin
put UCXJO41.bin UC4
quit
![]() |
2. | Creating the library |
---|
RSTOBJ OBJ(*ALL) SAVLIB(UC4AUSL) DEV(*SAVF) SAVF(UC4TMP/UC4)
DLTLIB LIB(UC4TMP)
RNMOBJ OBJ(QSYS/UC4AUSL) OBJTYPE(*LIB) NEWOBJ(UC4)
There are two different methods that can be used to start the agent. Variant 1 requires a CL routine per agent that should start (more complex). Variant 2 starts or ends the agent via separate programs.
![]() |
4. | Creating the start and end programs |
---|
UC4/CLLE(UCEX_RUN) - starts the agent
UC4/CLLE(UCEX_END) - ends the agent
![]() |
5. | Starting or ending the Agent |
---|
![]() |
4. | Including the library in the library listShows entities in a grid view |
---|
ADDLIBLE UC4
adds the library to the library list
or:
CHGCURLIB UC4
changes the current library for the particular jobAn Automation Engine object type for a process that runs on a target system. to UC4
![]() |
5. | Starting or ending the Agent |
---|
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.
ENDUCAGENT LIB(UC4) OPTION(*IMMED)
Aborts the agent that has been started from the library with ENDJOB.
For further information about commands, see: KnowledgeBase.
Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support |
Copyright © 2016 Automic Software GmbH |