ajsqldetach
- Organization of this page
Format
ajsqldetach [-h logical-host-name] [-k]
Description
The ajsqldetach command detaches (disconnects) a logical host from the queueless agent service.
Execution privileges
In Windows: Administrators privileges
In UNIX: Superuser privileges
Storage directory
- In Windows:
-
JP1/AJS3 - Manager-installation-folder\bin\
JP1/AJS3 - Agent-installation-folder\bin\
- In UNIX:
-
/opt/jp1ajs2/bin/
Arguments
-h logical-host-name
Specify the name of the logical host you want to detach from the queueless agent service.
If you omit this option, the system assumes the physical host.
If you specify the option without specifying its value, the command terminates abnormally.
-k
If there are queueless jobs running on the logical host you want to detach from the queueless agent service, these jobs are forcibly terminated, and then the logical host is detached. (This is called a forced detach.)
If this option is omitted, the logical host is not detached from the queueless agent service until all queueless jobs running on the logical host terminate. (This is called a planned detach.)
Notes
-
Before you execute this command, make sure that the queueless agent service is started and the queueless job execution environment for the relevant logical host is set up. If the queueless job execution environment for the relevant logical host has not yet been set up, set it up by executing the ajsqlsetup command. For details on the ajsqlsetup command, see ajsqlsetup in 4. Commands Used for Special Operation.
-
If an attempt is made to execute a queueless job on a logical host that has not been attached, either the queueless job is executed on the physical host according to the value of the AJSQL_NOATTACHREQ environment setting parameter or the queueless job fails to start. For details about how to set the AJSQL_NOATTACHREQ environment setting parameter, see 20.10 Setting up the queueless job execution environment in the JP1/Automatic Job Management System 3 Configuration Guide.
-
If a forced detach is attempted when many queueless jobs are running on the logical host you want to detach from the queueless agent service, forced termination might take a long time before the logical host is detached.
Return values
0 |
Normal end |
Other than 0 |
Abnormal end |
Example
In this example, the command detaches logical host newhost from the queueless agent service.
ajsqldetach -h newhost