Start Agent Services (STRAGTSRV)

The Start Agent Services (STRAGTSRV) command starts all of the agent services on this system that are defined in a preferences file. Another preferences file is also used to help define how the services are started. The preferences files are stream files named ableplatform.preferences and able.preferences that are located in the directory specified for the Preferences file directory (PREFDIR) parameter.

You can use the End Agent Services (ENDAGTSRV) command to end the agent services started by this command.

Restrictions:

You must have all object (*ALLOBJ) and job control (*JOBCTL) special authorities to run this command.

Parameters

Keyword	Description	Choices	Notes
PREFDIR	Preferences file directory	Path name, *DFT	Optional
HOMEDIR	Home directory	Path name, *CURRENT	Optional
CLASSPATH	Additional classpath	Path name, *NONE	Optional
SBMJOBUSER	User profile for SBMJOB	Single values: CURRENT Other values (up to 10 repetitions): Element list*	Optional
	Element 1: Pool identifier	Character value
	Element 2: User profile	Name

Top

Preferences file directory (PREFDIR)

Specifies the directory that contains the preferences files that define the agent services to be started and how they are started. The preferences files must be named ableplatform.preferences and able.preferences.

*DFT: Use the preferences files located in /QIBM/ProdData/OS400/able/.
path-name: Specify the directory that contains the preferences files to be used to start the agent services.

Home directory (HOMEDIR)

Specifies the directory to be used as the home directory of the agent services.

*CURRENT: Use the home directory currently in effect for the job running this command. This is the home directory defined for the current user profile of the job running the STRAGTSRV command.
path-name: Specify the path name of the directory to be used as the home directory for the Java Virtual Machines (JVMs) which are used by the agents running in these services. The services use this directory to find needed resources.

Additional classpath (CLASSPATH)

Specifies the additional classpath to be appended to the classpath setting of each Java Virtual Machine (JVM) to be started to run the agent services.

*NONE: No additional classpath will be appended.
path-name: Specify the path name of the additional classpath to be appended to the classpath setting of each JVM.

User profile for SBMJOB (SBMJOBUSER)

Specifies the user profile to be used for the Java Virtual Machine (JVM) jobs that will run the agent services. You can specify that a particular JVM run under a different profile than the current user profile of the job running the STRAGTSRV command.

You can specify an alternate user profile for up to 10 JVM jobs.

Single values

*CURRENT: All JVM jobs will run under the same user profile as the current user profile of the job running this command.

Element 1: Pool identifier

character-value: Specify an identifier that matches a JVM that is defined in the preferences file specified for the Preferences file directory (PREFDIR) parameter.

Element 2: User profile

name: Specify the name of the user profile to be used on the Submit Job (SBMJOB) commands for the JVMs. The JVM jobs will run under the specified user profile instead of the current user profile of the job running this command.

Examples

Example 1: Starting with Shipped Default Values

STRAGTSRV

This command starts all of the agent services defined in the default ableplatform.preferences file in '/qibm/prodData/OS400/able/' in a way defined in the default able.preferences file in '/qibm/prodData/OS400/able/'. The home directory of each agent service will be set to the Home Directory of the current user. All jobs submitted to run the Java Virtual Machines will run under the current profile.

Example 2: Starting with User-Specified Values

STRAGTSRV  PREFDIR('/qibm/userData/OS400/able/test/')
           HOMEDIR('/qibm/userData/OS400/able/test/')
           CLASSPATH('/qibm/userData/OS400/able/test/test.jar')
           SBMJOBUSER((POOL1 TESTPROF1) (POOL3 TESTPROF3))

This command starts all of the agent services defined in the ableplatform.preferences file in '/qibm/userData/OS400/able/test/' in a way defined in the default able.preferences file in '/qibm/userData/OS400/able/test/'. The home directory of each agent service will be set to '/qibm/userData/OS400/able/test/'. The Java Virtual Machines will have thier classpaths set to include the test.jar Java Archive file in '/qibm/userData/OS400/able/test/'. The jobs submitted to run the Java Virtual Machines for POOL1 and POOL3 will run under the users TESTPROF1 and TESTPROF3 respectivley, all other JVMs will run under the current user profile.

Error messages

*ESCAPE Messages

CPF1890: *ALLOBJ authority required for requested operation.
CPF90FF: *JOBCTL special authority required to do requested operation.

Error messages from submitted job:

This command submits a batch job which, in turn, submits additional batch jobs where the agent services will run. The following error messages could be signaled from this batch job:

CPF4B01: Agent Service not submitted. Reason code &1.
CPF4B02: The Java Virtual Machine(JVM) for the agent service was not started. Reason code &1
CPF4B03: Java Virtual Machine(JVM) exception has occurred.