44/461

## create-jms-host

creates a JMS host

Synopsis

    create-jms-host [--help]
    --mqhost mq-host --mqport mq-port
    --mquser mq-user --mqpassword mq-password
    [--target target]
    jms_host_name

Description

Creates a Java Message Service (JMS) host within the JMS service.

This subcommand is supported in remote mode only. Remote `asadmin` subcommands require a running domain administration server (DAS).

Options

`--help`
`-?`

  Displays the help text for the subcommand.

`--mqhost`

  The host name for the JMS service.

`--mqport`

  The port number used by the JMS service.

`--mquser`

  The user name for the JMS service.

`--mqpassword`

  The password for the JMS service.

`--target`

  Creates the JMS host only for the specified target. Valid values are as follows:

  `server`

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

  configuration-name

    Creates the JMS host in the specified configuration.

  cluster-name

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

  instance-name

    Creates the JMS host for the specified server instance.

Operands

jms_host_name

  A unique identifier for the JMS host to be created.

Examples

Example 1 Creating a JMS host using a non-default port

  The following command creates a JMS host named `MyNewHost` on the system `pigeon`.

      asadmin> create-jms-host --mqhost pigeon.example.com --mqport 7677
      --mquser admin --mqpassword admin MyNewHost
      Jms Host MyNewHost created.
      Command create-jms-host executed successfully.

Exit Status

0

  subcommand executed successfully

1

  error in executing the subcommand

See Also

list-jms-hosts(1), delete-jms-host(1), jms-ping(1)

asadmin(1M)