RECEIVER_ADDRESS

The RECEIVER_ADDRESS string tag appears in taglists prepared for the SEND_MESSAGE function, and message taglists retrieved from the server with the GET_Q_ENTRIES_INFO function. This tag specifies a destination address for the message. A companion tag, RECEIVER_NAME, specifies the friendly name associated with the address.

If a message has only a single destination, the RECEIVER_ADDRESS tag (along with other recipient tags, such as RECEIVE_NAME) can be provided among the root tags of a message taglist. If a message has more than one address, the RECEIVER_ADDRESS tag must be the first tag in a section of tags within the message taglist, with one RECEIVER_ADDRESS section for each recipient. Within the RECEIVER_ADDRESS section additional tags should be provided to include all attributes of the address.

For new messages, the Validation Server component of NET SatisFAXtion examines every RECEIVER_ADDRESS during the execution of the SEND_MESSAGE function. If all addresses fail validation, the message is not submitted and the server returns an error. The processing performed by the Validation Server is configurable with the Validation Editor. Typical processing includes blocking invalid numbers, verifying that a fax number includes an acceptable number of digits, and applying prefixes such as "9,".

In addition to fax destinations, messages can be sent to NET SatisFAXtion users by providing a RECEIVER_ADDRESS tag set to the name of a user, for example, "postmaster". Also, messages can be routed to gateways that are connected to the fax server by prefixing the address with "gateway name!", for example, "SMTPPost!user@domain.com". When a message reaches a gateway, it is translated according to the gateway's underlying message system or protocol. NET SatisFAXtion includes gateways for SMTP/POP3, Exchange Server, Exchange 2000, Lotus Notes and cc:Mail mail systems.

Type

Max Size

Multiple Allowed

String

512

Yes, but only in RECEIVER_ADDRESS sections

Example:

function SendFaxCover()
{
var Tl, StatusNum;

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);
CAS.AddTag(Tl,"SUBJECT","Subject");

Sl = CAS.CreateSection(Tl,"RECEIVER_ADDRESS","555-123-1234");
    CAS.AddTag(Sl,"RECEIVER_NAME","Recipient 1");
    CAS.AddTag(Sl,"RECEIVER_COMPANY","Company Name");
CAS.CloseSection(Sl);

Sl = CAS.CreateSection(Tl,"RECEIVER_ADDRESS","555-456-1234");
    CAS.AddTag(Sl,"RECEIVER_NAME","Recipient 2");
CAS.CloseSection(Sl);

Sl = CAS.CreateSection(Tl,"CONTENT_PART",2); // Cover Message
    CAS.AddTag(Sl,"CONTENT_TYPE",1);            // File Type ASCII
    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));
CAS.Delete(Tl);

return(StatusNum);
}