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:
- You must have all object (*ALLOBJ) and job control (*JOBCTL) special authorities to run this command.
| 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 |