2.23.5 set-batch-runtime-configuration
Configures the batch runtime.
Synopsis
asadmin [asadmin-options] set-batch-runtime-configuration [--help] [--target target] [--datasourcelookupname datasource-lookup-name] [--executorservicelookupname executor-service-lookup-name]
Storage location
Application Server installation directory/javaee/glassfish/bin
Function
The set-batch-runtime-configuration subcommand of asadmin configures the batch runtime. The runtime uses a data source and a managed executor service to execute batch jobs. Batch runtime configuration data is stored in the config element in domain.xml.
Precondition
Domain Administration Server (DAS) is running.
Files
Batch runtime configuration data is stored in the config element in domain.xml.
Arguments
- --help | -?
-
Displays the help text for the subcommand.
- --target target
-
Specifies the target for which the batch runtime is to be configured.
Type: String
The following values can be specified:
-
server
Configures the batch runtime for the default server instance server and is the default value.
-
cluster-name
Configures the batch runtime for every server instance in the cluster.
-
instance-name
Configures the batch runtime for a particular server instance.
Default value: server
-
- {--datasourcelookupname | -d} datasource-lookup-name
-
Specifies the JNDI lookup name of the data source to be used to store job information. The default data source is jdbc/__BatchPool.
If the data source must be changed, stop and restart the domain and then make the change before any jobs are started or restarted. However, once the data source has been changed, information stored in the previous data source becomes inaccessible.
Type: String
The following values can be specified:
-
Name of the JNDI lookup name
Default value: jdbc/__BatchPool
-
- {--executorservicelookupname | -x} executor-service-lookup-name
-
Specifies the JNDI lookup name of the managed executor service to be used to provide threads to jobs.
Type: String
The following values can be specified:
-
JNDI lookup name of the managed executor service
Default value: concurrent/__defaultManagedExecutorService
-
Examples
The following example configures the batch runtime for the server instance instance1 to use an existing managed executor service named concurrent/myExecutor.
asadmin set-batch-runtime-configuration --target instance1 --executorservicelookupname concurrent/myExecutor
Exit Status
Exit Status |
Explanation |
---|---|
0 |
subcommand executed successfully. |
1 |
error in executing the subcommand. |