AMX i!-EquipmentMonitor manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of AMX i!-EquipmentMonitor, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of AMX i!-EquipmentMonitor one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of AMX i!-EquipmentMonitor. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of AMX i!-EquipmentMonitor should contain:
- informations concerning technical data of AMX i!-EquipmentMonitor
- name of the manufacturer and a year of construction of the AMX i!-EquipmentMonitor item
- rules of operation, control and maintenance of the AMX i!-EquipmentMonitor item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of AMX i!-EquipmentMonitor alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of AMX i!-EquipmentMonitor, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the AMX service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of AMX i!-EquipmentMonitor.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the AMX i!-EquipmentMonitor item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    instruction manual integr ation!Solutions i!-EquipmentMonitor[...]

  • Page 2

    Software Limited Agreement LIMITED W ARRANTY LIMITED W ARRANTY . AMX Cor poration warrants that the SO FTW ARE will pe rf or m substantially in accordance with the accompanying written mater ials f or a per iod of ninety (90) days from the date of receip t. Any implied warranties on the SOFTW ARE and hardware are limited to ninety (90) da ys and on[...]

  • Page 3

    T able of Contents i i!-EquipmentMon itor T able of Contents Introduction ............. ................ .......................................... ............................ ............ 1 Supported Operating Systems .............................................. ............................................ 1 Minimum PC Requirements ............[...]

  • Page 4

    ii i!-Equipm entMonitor T able of Contents[...]

  • Page 5

    Intr oduction 1 i!-EquipmentMon itor Intr oduction i!-EquipmentMonitor ™ is an application that allows you to send and receive e-mail directly from a NetLinx ™ Control System. i!-E quipmentMonitor is pr imarily used to send and receiv e NetLinx Control System e-mails, su ch as sending e-mail notifications for system problems or equipment troubl[...]

  • Page 6

    Introduction 2 i!-Equipm entMonitor Installing i!-EquipmentMonitor 1. In Explorer , double-click i!-EquipmentMonito rSetup.exe from the directory window where you downloaded the i!-EquipmentMonitor i nstall program. 2. After reading the Licens e Agreement, select I Agr ee and Ne xt to proceed. 3. The W elcome T o i!-EquipmentMonitor Set up dialog a[...]

  • Page 7

    Running i!-Equipme ntMonitor 3 i!-EquipmentMon itor Running i!-EquipmentMonitor V ery little work is required to add e-mail support to your exis ting NetLinx code. Recei ving and sending e-mail are independent of each other; each one will be covere d in it's o wn section. Y ou do not need to add support for sending and recei vi ng if only one [...]

  • Page 8

    Running i!-Equipm entMonitor 4 i!-Equipm entMonitor Now , all you need to do is call the function that se nds an email. If you want to send an email ev ery time someone presses a button on a touch panel, your code would look like this: BUTTON_EVENT[dvTP,1] { PUSH: { SmtpQueMessage('fromAddress@mydomain.com', 'toAddress@mydomain.com &[...]

  • Page 9

    Running i!-Equipme ntMonitor 5 i!-EquipmentMon itor 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. Y our email administrator should supply you with a user name and password for an email account that can[...]

  • Page 10

    Running i!-Equipm entMonitor 6 i!-Equipm entMonitor Y ou can use the following code to loop through the do wnloaded emails whenev er ne w email arri ves: DATA_EVENT[dvPop3Socket] { OFFLINE: { STACK_VAR INTEGER nLoop Integer nLoop1 For (nLoop=1;nLoop<=nPop3QtyMail;nLoop++) { SEND_STRING 0,'i!Email Test-Print Message' SEND_STRING 0,&apos[...]

  • Page 11

    Running i!-Equipme ntMonitor 7 i!-EquipmentMon itor i!-EquipmentMonitorOut.axi Constants The following table lists i!-EquipmentMonitorOut.axi constants. i!-EquipmentMonitorOut.axi Constant s dvSmtpSocket The IP device n umber for sending e-mails (default = 0:10:0}. SMTP_VERSION The version n umber of the include file. SMTP_PORT IP P or t that the S[...]

  • Page 12

    Running i!-Equipm entMonitor 8 i!-Equipm entMonitor Structures The following def ines an i!-EquipmentMonitorOut.axi structure: Structure _sSMTPMessage { CHAR cDate[SMTP_LINE_MAX]; CHAR cSource[SMTP_USER_MAX]; CHAR cDest[SMTP_USER_MAX]; CHAR cSubject[SMTP_LINE_MAX]; CHAR cMessage[SMTP_MSG_MAX]; CHAR cFile[SMTP_LINE_MAX]; } Va r i a b l e The followi[...]

  • Page 13

    Running i!-Equipme ntMonitor 9 i!-EquipmentMon itor i!-EquipmentMonitorOut.axi Funct ions (Cont.) SmtpSetTimeOff- set(CHAR Offset[]) Call this to configure the local timezone SmtpSetTimeOffset has these arguments: Offset String containing the local timezone offset. This str ing is f or matted as "+/- HHMM" where "+/=" is "+[...]

  • Page 14

    Running i!-Equipm entMonitor 10 i!-Equipm entMonitor i!-EquipmentMonitorOut.axi Func tions (Cont.) SmtpSetUser Call this to configure the username and pass word for SMTP ser v er authentication to send outbound emails. SmtpSetUser(CHAR LogInName[],CHAR LogInPass[]) SmtpSetUser has these arguments: LogInNameString containing the user name f or the S[...]

  • Page 15

    Running i!-Equipme ntMonitor 11 i!-EquipmentMon itor i!-EquipmentMonitorIn.axi Constants The following table lists the i!-EquipmentMonitorIn.axi constants. Structures The following describes an i!-EquipmentMonitorIn.axi structure: Structure _sEmailMessage { Integer nMsgNum; Char cUniqueID[POP3_USER_MAX]; long lMsgSize; Char cFrom[POP3_USER_MAX]; Ch[...]

  • Page 16

    Running i!-Equipm entMonitor 12 i!-Equipm entMonitor Functions The following table lists i!EmailIn.axi functions. i!-EquipmentMonitorIn.axi Fu nctions P op3ClearAllEmail Messages Deletes all e-mails from the inter nally stored email list. Syntax: Pop3ClearAllEmailMessages() Pop3ClearAllEmailMessages has no arguments. Example: Pop3ClearAllEmailMessa[...]

  • Page 17

    Running i!-Equipme ntMonitor 13 i!-EquipmentMon itor i!-EquipmentMonitorIn.axi Fu nctions (Cont.) P op3SetRefresh Sets the refresh time the include file checks f or new e-mails and whether they should be deleted form the ser v er. Syntax: Pop3SetRefresh(Integer Refresh, CHAR Delete) Pop3SetRefresh has these arguments: Refresh: Integer containing th[...]

  • Page 18

    AMX reserves the right to alter specif ications with out notice a t any time. brussels • dallas • los ang eles • mexico city • philad elphia • shanghai • sing apor e • tampa • toronto* • yo rk 3000 research drive, richardson, TX 75082 USA • 469.624.8000 • 800.222.0193 • fax 469.624.7153 • technical support 800.932.6993 033[...]