ASA Database Administration Guide
  Connection and Communication Parameters
    Network communications parameters

Host communication parameter [IP]

Usage 

TCP/IP, SPX (all platforms) Server and client sides

Values 

String

Default 

No additional machines.

Description 

HOST specifies additional machines outside the immediate network to be searched by the client library. On the server, the search is carried out to avoid starting a server with a duplicate name.

For TCP/IP, the HOST value the hostname or a dot-separated IP address may be used. You may optionally specify a PORT value as well.

For SPX, an address of the form a:b:c:d:e:f/g:h:i:j is used, where a:b:c:d:e:f is the node number (Ethernet card address) of the server, and g:h:i:j is the network number. You may optionally specify a PORT value.

The server prints addressing information to the database server window during startup if the -z option is used. In addition, the application writes this information to its logfile if Debug is set to true and LogFile is specified.

You can use a comma-separated list of addresses to search for more than one machine. You can also append a port number to an IP address, using a colon as separator. Alternatively, you can specify the host and server ports explicitly, as in HOST=a:b:c:d:e:f/g;h:i:j;PORT=k.

To specify multiple values for a single parameter, use a comma-separated list. When you specify multiple ports and servers, you can associate a particular port with a specific server by specifying the port in the HOST (IP) communication parameter instead of the PORT parameter.

IP and HOST are synonyms when using TCP/IP. For SPX, you must use HOST. PORT and ServerPort are synonyms for both protocols.

Examples 

• The following connection string fragment instructs the client to look on the machines kangaroo and 197.75.209.222 (port 2369) to find a database server:

  LINKS=tcpip(IP=kangaroo,197.75.209.222:2369)

• The following connection string fragment instructs the client to look on the machines my_server and kangaroo to find a database server. A connection is attempted to the first host that responds.

  LINKS=tcpip(HOST=my_server,kangaroo;PORT=2639)

• The following connection string fragment instructs the client to look for a server on host1 running on port 1234 and for a server on host2 running on port 4567. The client does not look on host1 on port 4567 or on host2 on port 1234.

  LINKS=tcpip(HOST=host1:1234,host2:4567)

See also 

ClientPort communication parameter [CPORT]