Hitachi

Hitachi Application Server V10 Command Reference Guide (For UNIX® Systems)


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.