BuildForge Help

Running the Agent on System i

Note: The standard Build Forge agent port (5555) may be preassigned on a System i server. In this case, change the Build Forge agent port to an unassigned port before starting the agent. You can edit the BFAgent.conf file directly or use another method. For details, see Changing the Agent Port.
You need to run the agent as a specified user. From the desired login context, run the agent standalone:
bfagent -s

To allow for authentication, configure the the magic_login setting in the BFAgent.conf file. (Do not run the agent as the QSECOFR user.)

The agent runs as an i5/OS PASE program. PASE (Portable Application Solution Environment) is an environment included in i5/OS that allows the execution of AIX binaries and commands. It usually is installed by default.
Commands in a step are interpreted by the PASE shell. You can also execute native commands using the following syntax:
system -biOE "<native commands>"
Important: Each system command in a step executes in its own process. This has implications for commands that work only within their own process.
For example, if you want to set library lists for a set of steps:

Although you cannot set library lists for just a step, set of steps, or project, you can set them in the agent configuration. Doing so sets the library lists for all projects and steps. To set library lists, use a job description for the agent that has the needed library lists defined. The following example shows a job description that specifies FLGHT400 and FLGHT400M in the library list:

10    UTLIB                                                              
20    QGPL                                                               
30    QTEMP                                                              
40    FLGHT400                                                           
50    FLGHT400M 
The agent specifies this job description in its startup routine. For example, if it were named BFAJOBD, the line in the system startup routine would be as follows:
ADDAJE SBSD(BFAGENT/BFAGENT) JOB(BFAGENT) JOBD(BFAGENT/BFAJOBD)
Note: This solution affects all commands (from any step and project) that are run on the Server resource associated with this agent.