ALTER REMOTE MESSAGE TYPE statement [SQL Remote]

Use this statement to change the publisher's message system, or the publisher's address for a given message system, for a message type that has been created.

Syntax
ALTER REMOTE MESSAGE TYPE message-system
ADDRESS address
message-system: FILE | FTP | SMTP
address: string
Parameters
  • message-system   One of the message systems supported by SQL Remote. It must be one of the following values:

    • address   A string containing a valid address for the specified message system.

Remarks

The statement changes the publisher's address for a given message type.

The Message Agent sends outgoing messages from a database by one of the supported message links. The extraction utility uses this address when executing the GRANT CONSOLIDATE statement in the remote database.

The address is the publisher's address under the specified message system. If it is an email system, the address string must be a valid email address. If it is a file-sharing system, the address string is a subdirectory of the directory specified by the SQLREMOTE environment variable, or of the current directory if that is not set. You can override this setting on the GRANT CONSOLIDATE statement at the remote database.

Permissions

Must have DBA authority.

Side effects

Automatic commit.

See also
Standards and compatibility
  • SQL/2003   Vendor extension.

Example

The following statement changes the publisher's address for the FILE message link to new_addr.

ALTER REMOTE MESSAGE TYPE file
ADDRESS 'new_addr';