background image

Running i!-EquipmentMonitor

5

i!-EquipmentMonitor

Pop3SetServer ('mail.mydomain.com')

Or

Pop3SetServer ('192.168.12.175')

Next, you need to setup the user and password for the email account you will be retrieving email 

from. Your email administrator should supply you with a user name and password for an email 

account that can receive email. Once you have these, call 

Pop3SetUser()

 and supply these values 

like this:

Pop3SetRefresh(300,1)                 // How often the check email server in 
Seconds and should I delete?

Supplying a refresh time of 0 seconds disables automatic email retrieval. If you decide you want to 

retrieve email manually, all you need to do is call 

Pop3GetEmail()

Pop3GetEmail()

 takes 1 

parameter: a flag (1 or 0) indicating if you want email deleted from the server. You can call 

Pop3GetEmail()

 even if you have setup for automatic email retrieval to force email to be retrieve.  

You might supply the user with a button to force email to be retrieved like this:

BUTTON_EVENT[dvPanel,6]

{

  PUSH:

    Pop3GetEmail(0);

}

You can check for the email to arrive by waiting for the offline message from the 

dvPop3Socket

 

device. i!-EquipmentMonitor makes the emails available to you in three different variables: 

sPop3EmailMessage

nPop3QtyMail

 and 

nPop3TotalMail

nPop3QtyMail

 and 

nPop3TotalMail

 tell you how many email messages were retrieved (up to 

POP3_MAX_EMAILS

default = 20) and how many emails were on the server when i!-EquipmentMonitor last logged in. 

Up to 

POP3_MAX_EMAILS

 are downloaded and all other emails, if any, remain on the server until 

you retrieve them again.

sPop3EmailMessage

 is an array of structures containing the actual emails. The structure contains 

the following items:

The subject and body are the items you need most in the structure. The count of file attachments 

tells you the total number of files attached but the 

cAttachments

 containing up to 

POP3_ATTACH_MAX

 (default is 5) file names. The attached files are not saved. Only the file names 

are supplied for reference.

LmsgSize

The number of bytes in the email message.

cFrom[]

A string containing the senders email address.

cFromPersonal[]

The friendly name of the sender (if one was supplied).

cTo[]

A string containing the recipient's email address or addresses.

cToPersonal[]

The friendly name of the recipient if one was supplied.

cDate[]

A string containing the data and time the email was sent.

cSubject[]

The subject of the email.

cMessage[]

The body of the email.

NattachCount

The number of attachments to the email.

cAttachments[][]

The names of the files attached.

Continued

Summary of Contents for i!-EquipmentMonitor

Page 1: ...instruction manual integration Solutions i EquipmentMonitor ...

Page 2: ... any accompanying hardware This limited warranty gives you specific legal rights You may have others which vary from state country to state country NO LIABILITY FOR CONSEQUENTIAL DAMAGES In no event shall AMX Corporation be liable for any damages whatsoever including without limitation damages for loss of business profits business interruption loss of business information or any other pecuniary lo...

Page 3: ...Minimum PC Requirements 1 Installing i EquipmentMonitor 2 Running i EquipmentMonitor 3 Sending Email 3 Receiving Email 4 Configuring for Timezone 6 i EquipmentMonitorOut axi 7 Constants 7 Structures 8 Variable 8 Functions 8 i EquipmentMonitorIn axi 11 Constants 11 Structures 11 Variables 11 Functions 12 ...

Page 4: ...ii i EquipmentMonitor Table of Contents ...

Page 5: ...onitorTest axs is a test program using both i EquipmentMonitorIn axi and i EquipmentMonitorOut axi Supported Operating Systems Windows 95 98 with at least 48 MB of installed memory Windows NT 4 0 Workstation or Server service pack 6 B or greater with at least 64 MB of installed memory Windows 2000 Professional or Server running on a Pentium 233 MHz processor minimum requirement 300 MHz or faster r...

Page 6: ...se all Windows programs before going any further Click Next to proceed 4 In the Select i EquipmentMonitor Install Location dialog use the Browse button to navigate to a directory other than the default install directory if desired Click Next 5 In the i EquipmentMonitor Shortcut Creation dialog select Install Shortcut Icons for the installed components on your desktop if desired 6 Click Next in the...

Page 7: ...calling SmptSetServer You need the name or IP address of your local SMPT server which you can obtain from you Network administrator Using a name for the server is acceptable if you have DNS properly configured on the NetLinx Master Otherwise you need an IP address Make sure to use the SMPT server value here Often the email server refers to the POP3 server most likely this is not what you need Once...

Page 8: ...e is 2000 but you can override it if necessary The last parameter is an attachment file name If you supply a value for this parameter i EquipmentMonitorOut attempts to open this file from the Master s file system and include it as an attachment to the email Binary files are not supported at this time so the file must be ASCII text only If the file does not exist or cannot be opened an error is pri...

Page 9: ...in three different variables sPop3EmailMessage nPop3QtyMail and nPop3TotalMail nPop3QtyMail and nPop3TotalMail tell you how many email messages were retrieved up to POP3_MAX_EMAILS default 20 and how many emails were on the server when i EquipmentMonitor last logged in Up to POP3_MAX_EMAILS are downloaded and all other emails if any remain on the server until you retrieve them again sPop3EmailMess...

Page 10: ...elete any emails you like by calling Pop3ClearEmailMessage or Pop3ClearAllEmailMessages Pop3ClearEmailMessage allows you to delete one email at a time Pop3ClearAllEmailMessages allows you to delete all the emails at once Configuring for Timezone The i EquipmentMonitorOut axi file can read the time zone information from i TimeManager and includes this information in email and notifications Simply i...

Page 11: ...clude file SMTP_PORT IP Port that the SMTP server is listening on default 25 SMTP_SERVER_TO Timeout in 1 10 for contacting the SMTP server default 1200 SMTP_URL_MAX Maximum length for e mail server name default 1000 SMTP_USER_MAX Maximum length for e mail addresses default 500 SMTP_LINE_MAX Maximum length for date subject and attached file default 256 SMTP_MAX_EMAILS Maximum length for number of q...

Page 12: ...File SmtpQueMessage has these arguments Source String containing the senders e mail address Dest String containing the recipients e mail address or addresses Subject String containing the subject of the e mail Message String containing the message body of the e mail File String containing the ASCII text only file name to attach to the e mail SmtpQueMessage returns these values 1 If the message was...

Page 13: ... 9 00 0800 Hong Kong SAR UTC 8 00 0700 Bangkok Hanoi Jakarta UTC 7 00 0300 Baghdad Kuwait Riyadh UTC 3 00 0200 Israel UTC 2 00 0600 Mexico City Tegucigalpa UTC 6 00 0600 Central America UTC 06 00 0200 Jerusalem UTC 2 00 0300 Nairobi UTC 3 00 Example SmtpSetTimeOffset 0600 Remarks SmtpSetTimeOffset should be called to configure i EquipmentMonitor to send emails with the correct time Some SPAM detec...

Page 14: ...he senders email address Dest String containing the recipients email address or addresses Subject String containing the subject of the email ConfigNotify does not return a value Example ConfigNotify user2 test com user1 test com Equipment Notification Room 301 Remarks ConfigNotify should be called in DEFINE_START of your application You must also call the SmtpSetServer Function The To parameter ca...

Page 15: ...of message retrieved from server VOLATILE Integer nPop3TotalMail Number of total messages on server VOLATILE CHAR bPop3Debug Set to 1 to debug i EquipmentMonitorIn axi Constants dvPop3Socket The IP device number for sending e mails default 0 11 0 POP3_VERSION Version number of the include file POP3_PORT IP Port that the POP3 server is listening on default 110 POP3_BUFFER_MAX Maximum size of buffer...

Page 16: ...nvalid the e mail was deleted successfully Example Pop3ClearEmailMessage 1 Remarks Pop3ClearEmailMessage should be called when you want to delete a message from the internally stored e mail list Deleting an e mail from the internally stored list will most likely affect message ordering Pop3ClearEmailMessage updates nPop3QtyMail and nPop3TotalMail accordingly This function does not delete an e mail...

Page 17: ...tically retrieved from the server By default e mail is not retrieved from the server automatically Pop3SetServer Sets Your POP3 Server Name for your use Syntax Pop3SetServer CHAR Server Pop3SetServer has these arguments Server String containing the name or IP of your e mail POP3 server Example Pop3SetServer mail amx com Remarks Pop3SetServer should be called in DEFINE_START of your application Pop...

Page 18: ...ive richardson TX 75082 USA 469 624 8000 800 222 0193 fax 469 624 7153 technical support 800 932 6993 033 004 2549 6 05 2005 AMX Corporation All rights reserved AMX the AMX logo the building icon the home icon and the light bulb icon are all trademarks of AMX Corporation AMX reserves the right to alter specifications without notice at any time In Canada doing business as Panja Inc ...

Reviews: