-id option

Specifies the ID of the client message store that the QAnywhere UltraLite Agent is to connect to.

Syntax
qauagent -id id ...
Default

The default value of the ID is the device name on which the Agent is running. In some cases, device names may not be unique, in which case you must use the -id option.

Remarks

Each client message store is represented by a unique sequence of characters called the message store ID. If you do not supply an ID when you first connect to the message store, the default is the device name. On subsequent connections, you must always specify the same message store ID with the -id option.

The message store ID corresponds to the MobiLink remote ID. It is required because in all MobiLink applications, each remote database must have a unique ID. See Creating and registering MobiLink users.

If you are starting a second instance of the qauagent on a device, the -id option must be used to specify a unique message store ID.

You cannot use the following characters in an ID:

  • double quotes
  • control characters
  • double backslashes

The following additional constraints apply:

  • The ID has a limit of 120 characters.
  • You can use a single backslash only if it is used as an escape character.
  • If your client message store database has the quoted_identifier database option set to Off, then your ID can only include alphanumeric characters and underscores, at signs, pounds, and dollar signs.
See also