|
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 | |||
|
|