LOGON_NAME

The LOGON_NAME string tag is used to uniquely identify a CAS instance within a NET SatisFAXtion domain. This tag is used when calling the LOGON function when logging on to a SatisFAXtion connection router. Logon names must be unique within a domain.

XML Interface:

This tag is not used in the CAS XML Interface.

Type

Max Size

Multiple Allowed

String

64K

No

Example:

function LogOn( OpenSessionToo )
{
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

    if (OpenSessionToo)
      {
        // By providing a remote logon name now, a session with
        // the remote will be opened as part of the LOGON

      CAS.AddTag(Tl,"REMOTE_LOGON_NAME","NETSATISFAXTION");
      }

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

    if (StatusNum == 0)
      {
        // The CAS instance is now logged on to the domain's
        // connection router. If REMOTE_LOGON_NAME was included
        // with the LOGON, then a session is now open with the
        // server. We could open/close sessions as needed now
        // that we're logged on, but for this example we'll just
        // log off.

      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