CREATE SERVER Statement

Syntax

CREATE SERVER server-name 
CLASS 'server-class' 
USING 'connection-info' 
[ READ ONLY ]

server-class – { ASAJDBC | ASEJDBC | SAODBC | ASEODBC | DB2ODBC | MSSODBC | ORAODBC | ODBC }
connection-info – { machine-name:port-number [ /dbname ] | data-source-name }

Example 1 – Create a remote server for the JDBC-based Adaptive Server Enterprise server named ase_prod. Its machine name is “banana” and port number is 3025.
```
CREATE SERVER ase_prod
CLASS 'asejdbc' 
USING 'banana:3025'
```
Example 2 – Create a SQL Anywhere remote server named testasa on the machine “apple” with listening on port number 2638.
```
CREATE SERVER testasa
CLASS 'asajdbc'
USING 'apple:2638'
```
Example 3 – Create a remote server for the Oracle server named oracle723. Its ODBC Data Source Name is “oracle723.”
```
CREATE SERVER oracle723
CLASS 'oraodbc'
USING 'oracle723'
```

CREATE SERVER defines a remote server from the SAP Sybase IQ catalogs.

USING clause – if a JDBC-based server class is used, the USING clause is hostname:port-number [/dbname] where:
- hostname—Is the machine on which the remote server runs.
- portnumber—Is the TCP/IP port number on which the remote server listens. The default port number for SAP Sybase IQ and SQL Anywhere is 2638.
- dbname—For SQL Anywhere remote servers, if you do not specify a dbname, the default database is used. For Adaptive Server Enterprise, the default is the master database, and an alternative to using dbname is to another database by some other means (for example, in the FORWARD TO statement).
If an ODBC-based server class is used, the USING clause is the data-source-name. The data-source-name is the ODBC Data Source Name.

READ ONLY clause – the READ ONLY clause specifies that the remote server is a read-only data source. Any update request is rejected by SAP Sybase IQ.

Side Effects

Requires the SERVER OPERATOR system privilege.