Creating destination aliases with a server management request

You can use server management requests to create and modify destination aliases.

For more information about destination aliases, see Destination aliases.

For an overview of how to use server management requests, including how to authenticate and schedule them, see Introduction to server management requests.

To create a destination alias, send a server management request in which the client name is the name of the destination alias and the following properties are specified. The group is identified by the group, address, and nativeConnection properties. Members of the group are specified with the member property.

<prop>
  <client>simpleGroup</client>
  <name>ianywhere.connector.nativeConnection</name>
  <value>ianywhere.message.connector.group.GroupConnector
  </value>
</prop>

Property

Description

ianywhere.qa.group

Set this property to Y to indicate that you are configuring a destination alias. For example:

<prop>
  <client>simpleGroup</client>
  <name>ianywhere.qa.group</name>
  <value>Y</value>
</prop>

ianywhere.connector.address

Specify the client ID of the destination alias. For example:

<prop>
  <client>simpleGroup</client>
  <name>ianywhere.connector.address</name>
  <value>simpleGroup</value>
</prop>

ianywhere.connector.nativeConnection

Set to ianywhere.message.connector.group.GroupConnector. For example:

<prop>
  <client>simpleGroup</client>
  <name>ianywhere.connector.nativeConnection</name>
  <value>ianywhere.message.connector.group.GroupConnector
  </value>
</prop>

ianywhere.qa.member.client-name\queue-name

Specify Y to add a member or N to remove a member. You can also optionally specify a delivery condition. See Condition syntax. For example, to add client1 to the destination alias simpleGroup, set the property as follows. The queue-name is optional. Repeat this property for every client you want to add:

<prop>
  <client>simpleGroup</client>
  <name>ianywhere.qa.member.client1\queue1</name>
  <value>Y</value>
</prop>

For more information about server management requests, see Introduction to server management requests.

See also
Example

The following server management request creates a destination alias called simpleGroup with members called client1 and client2\q11. This example starts the destination alias so that it immediately begins handling messages.

<?xml version="1.0" encoding="UTF-8"?>
<actions>
  <SetProperty>
    <prop>
      <client>simpleGroup</client>
      <name>ianywhere.qa.group</name>
      <value>Y</value>
    </prop>
    <prop>
      <client>simpleGroup</client>
      <name>ianywhere.connector.address</name>
      <value>simpleGroup</value>
    </prop>
    <prop>
      <client>simpleGroup</client>
      <name>ianywhere.connector.nativeConnection</name>
      <value>ianywhere.message.connector.group.GroupConnector</value>
    </prop>
    <prop>
      <client>simpleGroup</client>
      <name>ianywhere.connector.logLevel</name>
      <value>4</value>
    </prop>
    <prop>
      <client>simpleGroup</client>
      <name>ianywhere.qa.member.client1</name>
      <value>Y</value>
    </prop>
    <prop>
      <client>simpleGroup</client>
      <name>ianywhere.qa.member.client2\q11</name>
      <value>Y</value>
    </prop>
  </SetProperty>
  <OpenConnector>
    <client>simpleGroup</client>
  </OpenConnector>
</actions>

Adding and removing members in a destination alias