DOMAIN_NAME

The DOMAIN_NAME string tag is used in taglists prepared for the LOGON function, to identify the NET SatisFAXtion domain that a CAS instance will logon to. The domain name format is as follows: \\<domain name>\<server name>. The default installation value for <domain name> is the name of the computer that the server is installed on, but this is not required. The domain name is treated as case sensitive, but it is not recommended that names with only case differences be used as this is incompatible with some network transports. The domain name is used for logically grouping servers. There can be a maximum of 20 unique domains per local area network, with a maximum of 20 servers per domain.

XML Interface:

The DOMAIN_NAME tag is included in the XML for all function taglists in the CAS XML Interface. See CAS XML Communications for more information.

Type

Max Size

Multiple Allowed

String

64

No

Example:

function LogOn()
{
var CAS_instance;

    // Logon to the connection router

if (CAS_instance = CAS.Open(6,"",1000000))
    {
    var Tl, UniqueName, StatusNum;

    Tl = CAS.New();
    CAS.AddTag(Tl,"LOGON","");
    UniqueName = "XYZ-"+ parseInt(Math.random()*
                                  100000000000+100000000000);
    CAS.AddTag(Tl,"LOGON_NAME",UniqueName);
    CAS.AddTag(Tl,"DOMAIN_NAME","\\\\CASDEV\\NETSATISFAXTION");
    CAS.AddTag(Tl,"PROTOCOL",2); // IP

    Tl = CAS.Send(CAS_instance,Tl);
    StatusNum = parseInt(CAS.GetTag(Tl,"STATUS_NUM",0));
    CAS.Delete(Tl);

    if (StatusNum == 0)
      {
        // We are now successfully logged on to the domain, and we
        // can open/close sessions with CAS servers in the domain
        // as many times as needed. But for this example, we'll
        // just logoff now.

      Tl = CAS.New();
      CAS.AddTag(Tl,"LOGOFF","");
      Tl = CAS.Send(CAS_instance,Tl);
      CAS.Delete(Tl);
      }

    CAS.Close(CAS_instance);
    }
}

See Also:

LOGON, OPEN_SESSION, CLOSE_SESSION, LOGOFF