End Agent Services (ENDAGTSRV)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The End Agent Services (ENDAGTSRV) command ends all of the active 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 ended. 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 restart the agent services by running the Start Agent Services (STRAGTSRV) command.

Restrictions:

Top

Parameters

Keyword Description Choices Notes
PREFDIR Preferences file directory Path name, *DFT Optional
Top

Preferences file directory (PREFDIR)

Specifies the directory that contains the preferences files that define the agent services to be ended and how they are ended. 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 end the agent services.
Top

Examples

Example 1: Ending with Shipped Default Values

ENDAGTSRV

This command ends 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/'.

Example 2: Ending with User-Specified Values

ENDAGTSRV   PREFDIR('/qibm/userData/OS400/able/test/')

This command ends all of the running 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/'.

Top

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 will end the batch jobs where the agent services are running. The following error messages could be signaled from this batch job:

CPF4B03
Java Virtual Machine(JVM) exception has occurred.
CPF4B04
Unable to finish ending agent services. Reason code &1
Top