PORT_STATUS

The PORT_STATUS integer tag appears in port information taglists retrieved from the server with the GET_PORTS_INFO function. This tag describes a port's ability to function, based the availability of the line and stability of the firmware.

The PORT_STATUS tag can be set to any combination of the following bit values:

DOWNLINE_BUSY 1 A device connected to the port's downline is using the line

DATAMODEM_BUSY 2 The port's datamodem is busy.

DEFECTIVE 4 The port's firmware is not responding

RELOADING_FIRMWARE 8 The port's firmware is currently being reloaded

RESETTING 16 The port's firmware is currently resetting

Type

Max Size

Multiple Allowed

Integer

4 bytes

No

Example:

function LookForDefectivePorts()
{
var Tl, Count, Index, Config;

Tl = CAS.New();
CAS.AddTag(Tl,"GET_PORTS_INFO","");
CAS.AddTag(Tl,"REGISTERED_NAME",REGISTERED_NAME.value);
CAS.AddTag(Tl,"REGISTERED_PASSWORD",REGISTERED_PASS.value);
    // Send on this already open session
Tl = CAS.Send(Instance,Tl);

if ((Count = parseInt(CAS.GetTag(Tl,"NUMBER_OF_PORTS",0))) > 0)
    {
    for ( Index=0; Index<Count; Index++)
      {
      Sl = CAS.OpenSection(Tl,"PORT_NAME["+Index+"]");
        Config = parseInt(CAS.GetTag(Sl,"PORT_STATUS",0));
        if (Config & 4)
          {
          ErrString += CAS.GetTag(Sl,"PORT_NAME",0) + " is defective";
          }
      CAS.CloseSection(Sl);
      }
    }
}

See Also: