TRANSFER_TYPE

 CAS Tags
The TRANSFER_TYPE integer tag is provided in taglists prepared for the SEND_MESSAGE function, and included in message taglists returned by the GET_Q_ENTRIES_INFO function.  This tag describes the intended delivery format for the entire contents of a message, either as fax or e-mail.  

When a message is submitted to the fax server, it is ultimately routed to fax ports, gateways, or NET SatisFAXtion users according to the one or more RECEIVER_ADDRESS tags that it contains.  Messages that will be sent by fax ports should have the TRANSFER_TYPE set to 0 (FAX), but messages sent to gateways or fax server users can be sent in their original format (with no fax conversion) by providing a TRANSFER_TYPE of 1 (EMAIL).

The TRANSFER_TYPE tag can be set to one of the following values:
FAX 0 The message contents will be converted for fax or portable document delivery
EMAIL 1 The message contents will remain unchanged

 
  Type Max Size Multiple Allowed
Integer 4 bytes No

Example:
function SendFax()
  {
  var Tl, StatusNum, NewMsgHandle;
  
  Tl = CAS.New();
  CAS.AddTag(Tl,"SEND_MESSAGE","");
  CAS.AddTag(Tl,"REGISTERED_NAME",UserName);
  CAS.AddTag(Tl,"REGISTERED_PASSWORD",UserPassword);
  CAS.AddTag(Tl,"TRANSFER_TYPE",0);  // 1= EMAIL, 0=FAX
  CAS.AddTag(Tl,"SUBJECT","The subject of my fax");

  Sl = CAS.CreateSection(Tl,"RECEIVER_ADDRESS","555-123-1234");
    CAS.AddTag(Sl,"RECEIVER_NAME","My Recipient");
  CAS.CloseSection(Sl);
  
    // Send an ASCII cover message

  Sl = CAS.CreateSection(Tl,"CONTENT_PART",2);
    CAS.AddTag(Sl,"CONTENT_TYPE",1);
    CAS.AddTag(Sl,"CONTENT_DATA","This is my cover text!");
  CAS.CloseSection(Sl);

    // Send message on this already open session
  Tl = CAS.Send(cInst,Tl);
  StatusNum = parseInt(CAS.GetTag(Tl,"STATUS_NUM",0));

  if (StatusNum == 0)
    {
      // If successful, the message handle is in the return taglist
    NewMsgHandle = parseInt(CAS.GetTag(Tl,"MESSAGE_HANDLE",0));
    }

  CAS.Delete(Tl);
  
  return(StatusNum);
  }

See Also:
SEND_MESSAGE, GET_Q_ENTRIES_INFO