USER_NAME

The USER_NAME string tag appears in taglists returned from the GET_USERS_INFO function, and is also used in taglists prepared for and returned by the GET_Q_ENTRIES_INFO function.  This tag contains a fax server user name.  

When the USER_NAME tag is provided as input to the GET_Q_ENTRIES_INFO function, the fax server will only retrieve messages belonging to the specified user.  For example, an administrative application would provide the same REGISTERED_NAME and REGISTERED_PASSWORD of a fax server supervisor in all requests to GET_Q_ENTRIES_INFO, and provide a different USER_NAME specific to the user of interest for each request.

 
  Type Max Size Multiple Allowed
String 32 No

Example:
function GetReceivedMessages()
  {
  var Tl, Sl;
  var Msg = "";

  Tl = CAS.New();
  CAS.AddTag(Tl,"GET_Q_ENTRIES_INFO","");
  CAS.AddTag(Tl,"REGISTERED_NAME","Fred");
  CAS.AddTag(Tl,"REGISTERED_PASSWORD","");
  CAS.AddTag(Tl,"USER_NAME","User2");
  CAS.AddTag(Tl,"Q_ID","Q_ID_RECEIVED"");

  Sl = CAS.CreateSection(Tl,"RESPONSE_INCLUDE_ONLY","");
   CAS.AddTag(Sl,"SUBMIT_TIME",0);
   CAS.AddTag(Sl,"MESSAGE_COMPLETION_CODE","");
   CAS.AddTag(Sl,"RECEIVER_CSID","");
   CAS.AddTag(Sl,"PAGE_COUNT","");
  CAS.CloseSection(Sl);
   
    // Get messages on this already open session
  Tl = CAS.Send(Instance,Tl);
  
  if ( CAS.GetTag(Tl,"STATUS_NUM",0) == 0 )
    {
      // The number of messages is in the root of the reply taglist
    QueueCount = CAS.GetTag(Tl,"NUMBER_OF_Q_ENTRIES",0);
    
      // Each message is in it's own sub-section
    for ( a = 0; a < QueueCount; a++)
      {
      var st;

      Sl = CAS.OpenSection(Tl,"MESSAGE_HANDLE[" + a + "]");
        st = new Date(parseInt(CAS.GetTag(Sl,"SUBMIT_TIME",0)));
        Msg += CAS.GetTag(Sl,"MESSAGE_HANDLE",0) + ",";
        Msg += st + ",";
        Msg += CAS.GetTag(Sl,"MESSAGE_COMPLETION_CODE",0) + ",";
        Msg += CAS.GetTag(Sl,"RECEIVER_CSID",0) + ",";
        Msg += CAS.GetTag(Sl,"PAGE_COUNT",0) + "\r\n";
      CAS.CloseSection(Sl);
      }
    }
  else
    {
      // Return the error
    Msg = CAS.GetTag(Tl,"STATUS",0);
    }

  CAS.Delete(Tl);

  return(Msg);
  }

See Also:
GET_Q_ENTRIES_INFO, GET_USERS_INFO