NewsHdrLeftSpacer.gif (132 bytes)
Welcome to Inventive Labs

  
Try out our new .NET Telephony Toolkit called CTI32.  It is easy to build telephone applications using VB.NET or C#.  NO PORT ROYALTIES.
NewsHdrEnd.gif (910 bytes)
NewsHdrBottom.gif (973 bytes)

NTpageSendPage()


NTpageSendPage( AreaCode, AccessNumber, MaxCharsPerBlock, Baud, ConnectTime, PagerID, PageType, Email, EmailOnError, Routing, From, Subject, Msg, PageDelay, Retmsg)  

Description:
Sends a message to a pager and/or email address specifying all necessary parameters. No information needs to be pre-defined at the NT server. This will generate on-the-fly messages to any paging terminal and pager.

Parameters:
AreaCode - The area code portion of the phone number of the paging carriers TAP port. Include this even if it is a local call. The NTpage Server has logic on how to make the call. Do not include 9 for outside line just the area code

AccessNumber - The rest of the phone number to the TAP port at the paging terminal.   

MaxCharsPerBlock - Your paging carrier will limit you on how many characters you send in one page. This parameter specifies what this limit is. If the message is longer than the limit, NTpage will split the message into multiple pages for you.   

Baud - The modem's baud rate at which to connect with the paging terminal.   

ConnectTime - How long to wait for a successful connection to the paging company.   

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. See RetMsg for details.   


© Copyright 2001-2009  Inventive Labs Corporation  All rights reserved.