2.19.1 create-jms-host

Synopsis

asadmin [asadmin-options] create-jms-host [--help] --mqhost mq-host
    --mqport mq-port --mquser mq-user --mqpassword mq-password
    [--target target] [--force={false|true}] jms_host_name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The create-jms-host subcommand creates a Java Message Service (JMS) host within the JMS service.

This subcommand is supported in remote mode only.

Precondition

DAS has to be in a running state.

Arguments

--help | -?

Displays the help text for the subcommand.

--mqhost mq-host

Specifies the host name for the JMS service.

Type: String

The following values can be specified:

• Name of the host

Default value: localhost

--mqport mq-port

Specifies the port number used by the JMS service.

Type: Integer

The following values can be specified:

• 1 to 65535

Default value: 7676

--mquser mq-user

Specifies the user name for the JMS service.

Type: String

The following values can be specified:

• Specify user name

Default value: admin

--mqpassword mq-password

Specifies the password for the JMS service.

Type: String

The following values can be specified:

• Specify user password

Default value: admin

--target target

Creates a JMS host only for the specified target.

Type: String

The following values can be specified:

• server

  Creates a JMS host for the default server instance. This is the default value.

• configuration-name

  Creates a JMS host in the specified configuration.

• cluster-name

  Creates a JMS host for every server instance in the specified cluster.

• instance-name

  Creates a JMS host for every server instance in the specified cluster.

Default value: server

--force={false|true}

Specifies whether the subcommand overwrites the existing JMS host of the same name.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

jms_host_name

Specifies a unique identifier for the JMS host to be created.

Type: String

The following values can be specified:

• Unique name for JMS host

Default value: N/A

asadmin create-jms-host --target instance1 --mqhost pigeon.example.com --mqport 7677
--mquser admin --mqpassword admin MyNewHost

Exit Status

Exit Status	Explanation
0	command executed successfully.
1	error in executing the command.