Components of an interfaces file entry

Table 5-2 describes the components of an interfaces file entry.

Table 5-2: Components of an interfaces file

Component

Value

servername

Name of Adaptive Server or Backup Server. Requirements for a server name are:

  • The name cannot be more than 30 characters long.

  • The first character must be a letter (ASCII a through z, A through Z).

  • The characters that follow must be letters, numbers, or underscores (_).

retry_attempts (optional)

Number of times you want the client to try to connect to a server after initial failure. Default is 0.

delay_interval (optional)

Number of seconds between connection attempts. Default is 0.

service_type

Type of service defined by entry. Must be one of the following:

  • master

  • query

  • debug (connection for use by Sybase Technical Support only)

api

Application programming interface available to the network.

protocol

Name of the network protocol. Protocol types available are:

  • TCP/IP, represented by the letters “tcp”

  • SPX, represented by the letters “spx”

network

Name of the network; not currently used by Adaptive Server. srvbuild enters “ether” as a placeholder.

host

Network name or address of server’s host machine.

  • For TCP/IP, use either the host name or Internet address. Maximum size of entry is 32 bytes.

    To determine the host name of a machine, log in to that machine and enter:

    /bin/hostname
    
  • For DECnet, use the node name. Maximum size of entry is 6 bytes.

machine

Network name or address of server’s host machine.

  • You can use either the host name or Internet address. Maximum size of entry is 32 bytes.

    To determine the host name of a machine, log in to that machine and enter:

    /bin/hostname
    

device

The network device endpoint.

  • For TCP networks, it varies according to the vendor supplying the networking software. Check the vendor-specific documentation for the name of the device. Your network may provide multiple streams devices corresponding to different protocols in the TCP protocol suite. Choose the TCP streams device. Common TCP streams devices include /dev/tcp, /dev/ito, and /dev/inet/tcp.

  • For the IPX protocol, the value is always /dev/nspx.

address for a TCP protocol entry

Address consists of:

  • Address prefix, “\x” for tli.

  • Network type, always 0002.

  • Port number converted to four digits, hexadecimal. Must be between 1025 and 65535. Must be unique. Check the /etc/services file on each machine on the network to see what port numbers are in use. Enter the Adaptive Server port number in a new section of /etc/services labeled “Sybase specific services.” You do not have to make this entry for the operating system to function properly, but the presence of the port number in the file may prevent other users from using the port number.

  • IP network node address of the host machine converted to eight digits, hexadecimal.

  • Trailing zeros, optional, 16 digits.

address for an SPX protocol entry

Address consists of:

  • Address prefix, “\x” for tli

  • Network address, 8 digits

  • Node address, 12 digits

  • Socket number, 4 digits

port/object number

  • For TCP/IP networks, port is a unique port number between 1025 and 65535. Check the /etc/services file on each machine on the network to see what port numbers are in use. Enter the Adaptive Server port number in a new section of /etc/services labeled “Sybase specific services.” You do not have to make this entry for the operating system to function properly, but the presence of the port number in the file may prevent other users from using that number.

  • For DECnet networks, object is an object number between 128 and 253. The number must be unique to the node on which the server is running.

port

A unique port number between 1025 and 65535. Check the /etc/services file on each machine on the network to see what port numbers are in use. Enter the Adaptive Server port number in a new section of /etc/services labeled “Sybase specific services”. You do not have to make this entry for the operating system to function properly, but the presence of the port number in the file may prevent other users from using that port number.