This document guides you through the new installation of an 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.
The following guide describes how to install an 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. More detailed information is provided in the document Advanced Security.
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.
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 |
Auxiliary 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 CallAPI 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('UC4')
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 down 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 |