Collection Contents Index FOR statement FROM clause pdf/chap9.pdf

Reference Manual
   CHAPTER 9. SQL Statements     

FORWARD TO statement


Function 

To send native syntax to a remote server.

Syntax 1 

FORWARD TO server-name { sql-statement }

Syntax 2 

FORWARD TO [ server-name ]

Permissions 

None

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.

Description 

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 remote server's native syntax. The command or group of commands is enclosed in curly brackets ({}).

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.

Standards and compatibility 

Example 


Collection Contents Index FOR statement FROM clause pdf/chap9.pdf