ajsqlsetup
- Organization of this page
Format
- For JP1/AJS3 - Manager
ajsqlsetup [-h logical-host-name] [-F scheduler-service-name] [-nc] [[-m][-a]]|[-r]|[-u]- For JP1/AJS3 - Agent
ajsqlsetup [-h logical-host-name] [-a]|[-u]
Description
Sets up a queueless job execution environment. This command cannot be used for JP1/AJS3 - Agent Minimal Edition.
The following shows the information set by this command.
- Service registration
-
Register the following services used by queueless job execution:
|
Service |
JP1/AJS3 - Manager |
JP1/AJS3 - Agent |
|---|---|---|
|
JP1/AJS3 Queueless Agent service |
Y#1 |
Y#1 |
|
JP1/AJS3 Queueless File Transfer service |
Y#2 |
-- |
- Setting between service dependency
-
Set the dependency between JP1/AJS3 services and the queueless agent service or the queueless file transfer service.
|
Services on which JP1/AJS3 service depends |
JP1/AJS3 - Manager |
JP1/AJS3 - Agent |
|---|---|---|
|
JP1/AJS3 Queueless Agent service |
Y#3 |
-- |
|
JP1/AJS3 Queueless File Transfer service |
Y#2 |
-- |
- Setting communication ports
-
Registers the following communication ports used for queueless job execution in the services file:
|
Communication port (service-name:port-number) |
JP1/AJS3 - Manager |
JP1/AJS3 - Agent |
|---|---|---|
|
Queueless job execution (jp1ajs2qlagt: 20300) |
Y |
Y |
|
Queueless file transfer (jp1ajs2qlftp: 20301) |
Y |
Y |
- Setting environment setting parameters
-
Set environment setting parameters used for executing queueless jobs.
|
Settings |
JP1/AJS3 - Manager |
JP1/AJS3 - Agent |
|
|---|---|---|---|
|
Definition key |
Environment setting parameters |
||
|
[JP1_DEFAULT\JP1AJSMANAGER]#6 |
"QLMANCHARCODE"=UTF-8 |
Y#4 |
-- |
|
[JP1_DEFAULT\JP1AJSMANAGER\scheduler-service-name] or [logical-host-name\JP1AJSMANAGER\scheduler-service-name]#6 |
"QUEUELESSMULTIREQ"=dword:00000001 |
Y#2 |
-- |
|
[JP1_DEFAULT\JP1QLAGENT]#6 |
|
Y#1 |
Y#1 |
|
Y#1 |
Y#1 |
|
|
"AJSQL_TRACELOGFILE"=#5 |
Y |
Y#1 |
|
|
[JP1_DEFAULT\JP1QLAGENT] or [logical-host-name\JP1QLAGENT]#6 |
"AJSQL_LOGFILE"=#5 |
Y#1 |
Y#1 |
|
"AJSQL_LOGSIZE"=dword:00002000 |
Y#1 |
Y#1 |
|
|
"AJSQL_STATFILE"=#5 |
Y#1 |
Y#1 |
|
|
"AJSQL_STATSIZE"=dword:00000800 |
Y#1 |
Y#1 |
|
- Creation of job ID management file
-
Creates a file for managing the job IDs to be added to the queueless jobs to be executed.
|
File name |
JP1/AJS3 - Manager |
JP1/AJS3 - Agent |
|---|---|---|
|
Y#2 |
-- |
- Legend:
-
Y: Supported
--: Not supported
- #1
-
This is set only when the agent function is used with JP1/AJS3 - Manager or JP1/AJS3 - Agent and the -a option is specified.
- #2
-
This is set only when the manager function is used with JP1/AJS3 - Manager and the -m option is specified.
- #3
-
This is set only when the agent function is used with JP1/AJS3 - Manager and the -a option is specified.
- #4
-
This is set only when the manager function is used with the Linux edition of JP1/AJS3 - Manager and the -m option is specified.
- #5
-
The value varies depending on the environment. For details about environment setting parameter, see 20.10 Setting up the queueless job execution environment in the JP1/Automatic Job Management System 3 Configuration Guide.
- #6
-
If you want to change the value of an environment setting parameter that has been set, we recommend that you use the jajs_config command. Because this command validates the specified environment parameter name and other values, you can use this command to ensure that correct values are set. For details on the jajs_config command, see jajs_config in 2. Commands Used during Setup.
If you want to change multiple environment setting parameter values at the same time, make sure that you use the jbssetcnf command. For details on the jbssetcnf command, see the JP1/Base User's Guide.
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 logical host name (logical host name set by JP1/Base) to be set up and used in the cluster environment.
If you omit this option, the system assumes the physical host. If, however, environment variable JP1_HOSTNAME is specified, the system assumes the host set in the variable.
To specify a physical host explicitly, specify JP1_DEFAULT in this option.
This option is valid when you specify the -m, -a, or -r option.
-F scheduler-service-name
Specify the name of the scheduler service to be set up.
You can specify this option only with JP1/AJS3 - Manager, not with JP1/AJS3 - Agent.
If you omit this option, the system assumes the default scheduler service. If, however, environment variable AJSCONF is specified, the system assumes the scheduler service set in the variable.
This option is valid when you specify the -m or -r option.
-nc
If this option is specified, the command neither creates a job ID management file nor checks whether the file exists on the shared disk. Specify this option only when you set up the secondary node in a cluster environment. This option is valid only when you specify the -m option.
-m
Sets up the queueless job management function.
You can specify this option only with JP1/AJS3 - Manager; not with JP1/AJS3 - Agent.
You cannot specify this option together with the -r or -u option in the same command.
-a
Sets up the queueless job agent function.
You cannot specify this option together with the -r or -u option in the same command.
-r
If this option is specified, the command stops the JP1/AJS3 service, and disables the queueless job manager function for the scheduler service specified in the -F option or the AJSCONF environment variable. A scheduler service for which the manager function is disabled cannot send queueless jobs.
You can specify this option only with JP1/AJS3 - Manager, not JP1/AJS3 - Agent.
You cannot specify this option together with the -m, -a, or -u option in the same command.
-u
If this option is specified, the command stops the JP1/AJS3 service, and deletes the queueless job execution environment settings from the JP1/AJS3 service.
For Windows, from the list of services in Windows Administrative Tools, delete the queueless agent service (JP1/AJS3 Queueless Agent) and the queueless file transfer service (JP1/AJS3 Queueless File Transfer).
You cannot specify this option together with the -r, -m, or -a option in the same command.
Notes
-
Before you specify the -m option to set up the manager function or specify the -a option to set up the agent function, make sure that the JP1/AJS3 service has stopped. If the queueless agent service and queueless file transfer service have already been registered by using the ajsqlsetup command, you must also make sure that these services have stopped.
-
Before you specify the -r option to disable the queueless job manager function or specify the -u option to delete the queueless job execution environment settings, make sure that JP1/AJS3 operation has stopped. The command does not wait until JP1/AJS3 operation stops before disabling the queueless job manager function or deleting the queueless job execution environment settings. Therefore, if you do not stop JP1/AJS3 operation, it might be affected by the command execution.
-
If you omit the option specifying the setting type (-m, -a, -r, or -u), the system assumes the following options:
-
For JP1/AJS3 - Manager: -m, -a
-
For JP1/AJS3 - Agent: -a
-
-
To run JP1/AJS3 - Manager or JP1/AJS3 - Agent using the same options as 07-50, perform the following procedure:
-
Copy ajs2ql_0750.conf.model to ajs2ql_0750.conf.
-
Edit ajs2ql_0750.conf as necessary.
-
Execute the jbssetcnf command.
Example:
jbssetcnf ajs2ql_0750.conf
-
-
Before you execute this command on a computer running Windows, make sure that you open the Command Prompt window as an administrator. If the UAC function is disabled, you do not need to open the Command Prompt window as an administrator.
Return values
|
0 |
Normal end |
|
Values other than 0 |
Abnormal end |