ajsatsetup
- Organization of this page
Format
ajsatsetup {-a [-p broadcast-agent-IP-address-or-host-name]|-m|-g|-u}
Format 1 (setup on a relay agent)
ajsatsetup -m
Format 2 (setup on a destination agent)
ajsatsetup -a
Format 3 (setup on a broadcast agent)
ajsatsetup -g
Format 4 (setup on a broadcast destination agent)
ajsatsetup -a -p broadcast-agent-IP-address-or-host-name
Format 5 (cancellation of all functions that are set up)
ajsatsetup -u
Description
Performs setup or unsetup of the execution environment for flexible jobs. In addition, sets up the broadcast execution function. Note that this command cannot be used for JP1/AJS3 - Agent Minimal Edition. The following shows the information set by this command.
- Registering services
-
Registers the following services:
Service name to be registered
-m option
-a option
(including the -p option)
-g option
JP1/AJS3 Autonomous Agent service
--
Y
Y
JP1/AJS3 Autonomous Agent Messenger service
Y
Y
Y
- Setting the communication port
-
Registers the following communication ports in the services file:
Communication port (service name: port number/protocol)
-m option
-a option
-g option
No other options specified
-p option
jp1ajs2atmsg: 22251/tcp
Y
Y
Y
Y
jp1ajs2atmsg: 22251/udp
--
--
Y
Y
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
-m
Sets up the function of the requester of the flexible job.
If you do not use a relay agent, specify this option on JP1/AJS3 - Manager. If you use a relay agent, specify this option on the relay agent.
This option cannot be specified together with the -a, -u, or -g option.
-a
Sets up the function of the request target of the flexible job.
Specify this option on the destination agent.
This option cannot be specified together with the -m, -u, or -g option.
-p broadcast-agent-IP-address-or-host-name
Sets up the host as a broadcast-execution destination agent.
Specify the IP address or host name of the broadcast agent to which you want to send a heartbeat. You can specify a character string of 1 to 128 bytes.
You can specify this option only if the -a option is specified.
If you specify an unresolvable host name or incorrectly formatted IP address, this command terminates abnormally with the KAVS8143-E or KAVS8114-E message.
-u
Cancels setup of the execution environment for flexible jobs, including the functions of broadcast execution. Also, deletes the JP1/AJS3 Autonomous Agent service and the JP1/AJS3 Autonomous Agent Messenger service. However, registration of the communication port (jp1ajs2atmsg: 22251) in the services file is not deleted.
This option cannot be specified together with the -m, -a, or -g option.
-g
Sets up the agent as a broadcast agent.
This option cannot be specified together with the -m, -a, or -u option.
Notes
-
Execute this command when neither the JP1/AJS3 Autonomous Agent service nor JP1/AJS3 Autonomous Agent Messenger service is running. If either of these services, or both, is running, the command might terminate abnormally.
-
Do not execute this command from multiple different terminals at the same time.
-
If this command is executed with the options below specified while internal processing of the broadcast execution function is executing in the background, command processing is suspended until the background internal processing is completed. Therefore, processing might require a long time.
-
-a -p option
-
-g option
-
-u option
-
-
You cannot specify localhost when using the -a -p option. If the local host is the broadcast agent, specify the IP address or host name of the local host for the -a -p option.
Return values
0 |
Normal end |
A value other than 0 |
Abnormal end |