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.
- Execute DSPSFWRSC at a command line to see if it is installed.
- Load it from the installation CD if it is not installed, using option
33 of 5722SS1.
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:
- You cannot simply use CHGSYSLIBL or ADDLIBLE as step commands because
they are native commands (not recognized by PASE).
- You cannot use the supported native command syntax (example: system
-biOE "ADDLIBLE FLGHT400") in a step, because it changes the library
list only for the command's own process. Subsequent commands and steps are
not affected by the change.
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.