Start the agent platform

After you define the agent platform and optionally secure your platform, you will need to start all the Java™ Virtual Machines associated with your agent services using iSeries™ CL commands.

After you have set up the agent platform and optionally configured security, you need to start the agent platform. Because the platform is made up of one or more Java Virtual Machines, to start the platform you need to start all of the JVMs that make up the platform.

The following instructions provide information on how to start the agent platform on an iSeries server:

Start the agent platform on an iSeries server

The following commands handle the starting and stopping of an agent platform on an iSeries server: Start Agent Services (STRAGTSRV) and End Agent Services (ENDAGTSRV) commands.

Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.

Start Agent Services (STRAGTSRV) command
When you run STRAGTSRV a separate JVM will be started for each pool on the system you are running the command from. This command starts a QAHASBMTER job that will find all of the JVMs (agent pools) that need to be started. When it discovers an agent pool, it will start a separate QAHASBMTEE job for each pool. Once the command has completed successfully, there should be a separate QAHAPLTFRM job in QSYSWRK with a status of SIGW for each pool. STRAGTSRV has the following keywords:
PREFDIR

Sets the location of the following files: able.preferences and ableplatform.preferences. Leaving the PREFDIR parameter at the default value will start or end the platform defined by the ableplatform.preferences and able.preferences file in the /QIBM/ProdData/OS400/able/ directory. Multiple platforms could be started on the same system by using the PREFDIR parameter to point to different directories. When doing this you must be careful that two platforms do not overlap at all by using the same ports on a system.

HOMEDIR

Sets the location of the home directory.

ClASSPATH
Allows you to add any additional classpath that each JVM should include. STRAGTSRV automatically sets the default classpath to:
```
classpath=
/QIBM/ProdData/Java400/:/qibm/proddata/os400/able:
/qibm/proddata/os400/able/ableplatform.jar:
/qibm/proddata/os400/able/able.jar:
/qibm/proddata/os400/able/ablebeans.jar:
/qibm/proddata/os400/able/jas.jar:
/qibm/proddata/os400/able/Jlog.jar:
/qibm/proddata/os400/Java400/ext/ibmjgssiseriesprovider.jar:
/qibm/proddata/os400/jt400/lib/jt400Native.jar:
/qibm/proddata/os400/Java400/ext/db2_classes.jar:
/qibm/proddata/os400/able/auifw.jar:  
```
SBMJOBUSER
Runs a JVM (agent pool) with a different profile than the current profile you are calling the command with:
- PoolIdentifier
- The pool that should run with a different profile.
- User Profile
- The profile you want to use to start the agent pool (PoolIdentifier).
End Agent Services (ENDAGTSRV) command
Ends all of the platform JVMs on this system that are specified as agent pools in the file ableplatform.preferences. This command starts a QAHAPLTEND job that will find and end all agent pools. ENDAGTSRV has the following keywords:

PREFDIR

Sets the location of the following files: able.preferences and ableplatform.preferences. Leaving the PREFDIR parameter at the default value will start or end the platform defined by the ableplatform.preferences and able.preferences file in the /QIBM/ProdData/OS400/able/ directory. Multiple platforms could be started on the same system by using the PREFDIR parameter to point to different directories. When doing this you must be careful that two platforms do not overlap at all by using the same ports on a system.

Note: If you have trouble starting or ending the agent platform, you can turn on tracing for the startup programs by adding or setting the QAHA_TRACE system environment variable to '1'. This will create log files in QUSRSYS/QAAHALOG. Files named QSBR<job number>, QSBE<job number, and QEND<job number> will be created for each QAHASBMTER, QAHASBMTEE, and QAHAPLTEND job that has run.