FORWARD TO statement

Description

Sends native syntax to a remote server.

Syntax

Syntax 1

FORWARD TO server-namesql-statement } 

Syntax 2

FORWARD TOserver-name ]

Examples

Example 1

Shows a passthrough session with the remote server ase_prod:

FORWARD TO aseprod
SELECT * from titles
SELECT * from authors
FORWARD TO

Usage

The FORWARD TO statement enables users to specify the server to which a passthrough connection is required. The statement can be used in two ways:

When establishing a connection to server-name on behalf of the user, the server uses:

If the connection cannot be made to the server specified, the reason is contained in a message returned to the user.

After statements are passed to the requested server, any results are converted into a form that can be recognized by the client program.

server-name is the name of the remote server.

sql-statement is a command in the native syntax of the remote server. The command or group of commands is enclosed in curly braces ({}) or single quotes.

When you specify a server_name, but do not specify a statement in the FORWARD TO query, your session enters passthrough mode, and all subsequent queries are passed directly to the remote server. To turn passthrough mode off, issue FORWARD TO without a server_name specification.

NoteThe FORWARD TO statement is a server directive and cannot be used in stored procedures, triggers, events, or batches.


Side effects

The remote connection is set to AUTOCOMMIT (unchained) mode for the duration of the FORWARD TO session. Any work that was pending prior to the FORWARD TO statement is automatically committed.

Standards

Permissions

None.

See also

CREATE SERVER statement