TotalNET Advanced Server 5.2 Reference Manual

tnsname

This command allows you to configure a static set of NetBIOS names with associated network addresses for a transport. You can list, read attribute values of, create, modify, and delete the static names.

The TAS NetBIOS-over-TCP/IP transport offers the capability to specify a set of static NetBIOS names--with associated IP addresses--for sites that do not wish to use the dynamic mechanisms for translating remote NetBIOS names to IP addresses. These static names may supplement the dynamically-determined NetBIOS names. Currently, only TCP/IP transports support static names.

Location

TNHOME/usr/sbin

Usage

tnsname [-L -n transport]
tnsname [-R [-n transport [-s static_name [{-a attribute}]]]]
tnsname [(-A|-M) -n transport -s static_name [{-a attribute=value}]]
tnsname -D -n transport -s static_name

Options

-n transport

Specify the transport. 

-s static-name

Static NetBIOS names, similar to service names, consist of two parts separated by a colon (:). A valid service name for the LM-NT-OS/2 realm precedes the colon. A hexadecimal number (made up of digits and lowercase letters a through f, with no leading zeroes) that gives the physical service type follows the colon. It has the same meaning as the type attribute of a service type object (refer to the "tnstype""tnstype command).

TAS supports Static NetBIOS names only for the tcpip transport. 

Attribute

address

This attribute specifies the address associated with the given static name. The tcpip transport uses an IP address. Other transports do not have static names.

Usage:

tnsname -R -n tcpip -s static_name -a address=IP-address

Examples

  1. Use one of the commands below to list all available transports and static NetBIOS names. This returns a hexadecimal output of the type code for static names.


    tnsname
    tnsname -L

    Sample Output:

    tnipx 

    tnnbu 

    tcpip 

     

    mth:0x20 

  2. Use the following command to list static NetBIOS names for the tcpip transport:


    tnsname -L -n tcpip

    Sample Output:


    mth:0x20
  3. Use the following command to list the value of the attribute address for the static name mth:32 of the tcpip transport:


    tnsname -R -n tcpip -s mth:32 -a address

    Sample Output:


     address=204.242.6.122
  4. Use the following command to add the value of the attribute address=204.242.8.123 for the static NetBIOS name mth:32 to the tcpip transport:


    tnsname -A -n tcpip -s mth:32 -a address=204.242.8.123
  5. Use the following command to delete the static NetBIOS name mth:32:


    tnsname -D -n tcpip -s mth:32