|
| |
NTpageSendPage() with predefined service
|  |
| NTpageSendPage( ServiceName, PagerID, PageType, Email, EmailOnError, Routing, From, Subject, Msg, PageDelay, Retmsg)
| | |
Description:
Sends a message to a pager and/or email address specifying parameters for the user BUT selecting a pre-defined paging carrier record already defined at the NTpage server.
Parameters:
ServiceName - The name of the paging service as defined at the NTpage Server.
PagerID - The pagers Alpha PIN number or phone number.
PageType - A=Alphanumeric pager, B=Numeric (Beeper) type of pager. Normally set this parameter to "A". If you are sending to a numeric pager, we recommend that you use the NTpageSendBeeperPage() function.
Email - This is the e-mail address of where to send a copy of the message going out. This address is only used if specified by the Routing parameter below.
EmailOnError - The e-mail address of where to send information in the event the page was unsuccessful or otherwise could not be sent.
Routing E=Email-Only, P=Page Only, B=Both Email/Page. This specifies how to route the message.
From - Optional field. NTpage allows for routing a message to an e-mail address as well as to a pager. This is the from field on the e-mail message. It is also possible to configure the NTpage server to format and send the from to the pager as part of the message. If you do not want to use this field, please pass the empty string.
Subject - Optional field. The subject on the e-mail message. It is also possible to configure the NTpage server to format and send the subject to the pager as part of the message. If you do not want to use this field, please pass the empty string.
Msg - The message to send.
PageDelay - Optional field. This allows you to have the message be held at the server until the specified date and time. This could be used for reminder systems. It is like sending a message "in the future", but sending it now. The format for this field is YYYY-MM-DD HH:MM:SS of when you want the message sent. If you want the page sent immediately, pass the empty string.
RetMsg - The result of the Page. Successful or error message depending on the return code
Return Values:
>0 Successful. The NTpage server returns the MsgID or message handle of the message being submitted. You can use this MsgID later to check the status of the page or to re-submit / re-send the message.
-1 Error. Possibly invalid ServiceName. (See RetMsg for details)
|