System 800xA Training

Chapter 6 SMS and E-Mail Messaging

TABLE OF CONTENTS

Chapter 6 SMS and E-Mail Messaging ................................................................................................................................... 1

6.1 General Information...................................................................................................................................................... 2
6.1.1 Objectives .............................................................................................................................................................. 2
6.1.2 Legend................................................................................................................................................................... 2
6.1.3 Documentation References ..................................................................................................................................... 2
6.2 SMS/Email Capabilities of System 800xA .................................................................................................................... 3
6.2.1 Short Messaging System (SMS) ............................................................................................................................. 3
6.2.2 E-Mail (SMTP/POP) .............................................................................................................................................. 3
6.2.3 SMS/Email Overview ............................................................................................................................................ 4
6.3 Software Installation ..................................................................................................................................................... 5
6.3.1 SMS and Email Software Installation ..................................................................................................................... 5
6.3.2 SMS and Email Post Installation Procedures ........................................................................................................... 6
6.3.2.1 Messaging Service Post Installation ................................................................................................................. 9
6.3.2.2 Restart the System Messaging Service Event Collector .................................................................................. 10
6.4 SMS and Email Architecture, Objects, and Aspects ..................................................................................................... 11
6.4.1 Messenger Service ............................................................................................................................................... 11
6.4.2 Devices (Communicating Devices) ....................................................................................................................... 12
6.4.2.1 Email Device ................................................................................................................................................. 12
6.4.2.2 SMS / GSM Device Aspects .......................................................................................................................... 14
6.4.3 Message Subscriber Aspects................................................................................................................................. 15
6.4.4 Message Schedule Aspects ................................................................................................................................... 15
6.4.5 Messenger Log Aspect ......................................................................................................................................... 16
6.4.6 Alarm and Event Message Source Aspect ............................................................................................................. 17
6.4.7 Message Handler Aspect ...................................................................................................................................... 18
6.4.8 Manipulating SMS and Email Messaging aspects ................................................................................................. 18
6.5 SMS and Email Configuration Procedures................................................................................................................... 19

Chapter 6 - 1
T313-06 SMS and E-Mail Messaging - RevC

6.1 General Information

6.1.1 Objectives
On completion of this chapter you will be able to:
Describe the hardware setup for various devices involved in SMS
Configure system settings such as source e-mail address and retry for sending e-
mail, text messages, and pages
Configure message sources and formatting for messages

6.1.2 Legend
> Indicates when you go from one menu to a sub-menu
Italic Indicates object and file names
“ “ Indicates dialog box buttons, tabs, menus etc.
Bold Indicates important topics
Indicates start/explanation of student activity

6.1.3 Documentation References

3BSE034678 Industrial IT 800xA – System
800xA System Installation
3BUA000156 Industrial IT 800xA – System
800xA System Post Install
3BDS011222 Industrial IT 800xA – System
800xA System Configuration
3BSE036904 Industrial IT 800xA – System
800xA System Extended Operation

Chapter 6 - 2
 System 800xA Training

6.2 SMS/Email Capabilities of System 800xA

ABB’s 800 Extended Automation System extends the communication capabilities
world-wide. The SMS and Email System utilizes Alarm and Event Lists in your
800xA system as a source of plain-text message types and system is capable of
sending the message to a recipient anywhere on the globe using a wireless mobile
communication network or via the internet using standard email protocols.

6.2.1 Short Message Service (SMS)

Short message service is a mechanism of delivery of short messages over the mobile
telephone networks. It is a store and forward way of transmitting messages to and
from mobiles. The message (text only) from the sending mobile is stored in Short
Message Service Center (SMSC) which then forwards it to the destination mobile.
This means that in the case that the recipient is not available; the short message is
stored and can be sent later.
Each short message can be no longer than 160 characters. These characters can be text
(alphanumeric) or binary Non-Text Short messages.
Since SMS uses signaling channels as opposed to dedicated channels, these messages
can be sent/received simultaneously with the voice/data/fax service over a GSM
network. SMS supports national and international roaming. This means that you can
send short messages to any other GSM mobile user around the world. With the PCS
networks based on all the three technologies, GSM, CDMA and TDMA supporting
SMS, SMS is more or less a universal mobile data service.

In order to use the SMS network, you must have:

A valid and working account with an SMS Service Provider and the hardware to
call and connect to the SMS Provider, such as a GSM or Hayes modem.

6.2.2 E-Mail (SMTP/POP)

The Simple Mail Transport Protocol (SMTP) is used when an email client desires to
send an email to a recipient. It does this by establishing a TCP connection with an
SMTP server. The Email client then forwards the Email (with the message formatted
according to SMTP protocol requirements) to the SMTP server. The SMTP server will
receive the mail and (assuming that the recipient’s email address is not the same as the

Chapter 6 - 3
T313-06 SMS and E-Mail Messaging - RevC

SMTP server the email was sent to) at some set schedule, establish a connection with
one or more SMTP email servers until the message is received at the recipient’s own
SMTP server.

The recipient needs to retrieve the email message from his SMTP server. His email
client uses the Post Office Protocol (POP) to connect to the Email server and retrieve
his messages. To know more about SMTP and how it works, refer
http://www.howstuffworks.com/e-mail-messaging/email3.htm
In order to use the Email functions of the SMS and Email System, you will need:
connectivity from one of the server nodes in your system to a designated SMTP
server which will be responsible for receiving and forwarding the 800xA system-
generated email to the recipient’s Email server.

6.2.3 SMS/Email Overview

The main component of the SMS/Email messaging service is the Messenger Service
assigned to a specific server node in the system; which will be the SMS and Email
Application Server. This service is a process (.exe) which runs on the server and is
responsible for monitoring the configuration set up of various Asset Optimization
SMS/Email System aspects and handles the actual physical communication of
messages being sent from and addressed to the system
In addition to the Messenger Service, several other aspects need to be created and
configured to configure the SMS/Email System.
The Messenger Service must have a method by which it can communicate to the
desired messaging service type such as a modem or connection to an Email server.
This device is defined in a SMS and Email Device aspect type.

Chapter 6 - 4
 System 800xA Training

6.3 Software Installation

The SMS Email Software is loaded according to the “Installation” and “Post
Installation” manuals supplied with your particular version of the 800xA system
product.
Additional information regarding the installation of the SMS Email software package
may also be included in the specific product’s release notes. This documentation is
provided on a compact disk (CD) along with two digital video disks (DVD) which
contain all of the system software installation packages. Up-to-date information
regarding any of the ABB software products is available on ABB’s Solutions Bank
web site (http://solutionsbank.abb.com).
The software can be automatically installed along with the core 800xA system and
other 800xA software packages when the system is initially loaded, or manually.
Detailed training on complete and automated installation 800xA system software is
available via ABB training centers world-wide. This chapter, however, will describe
how to install the SMS and Email software using the manual installation steps.
The default windows security provided on Windows Server operating systems does
not allow for a logged-in user to install software, therefore, you must be logged-on to
a user account which has Administrative rights.
Addition of system extensions into an 800xA system also requires that the user have
System Administration rights within the 800xA system itself. Ensure that the user you
are logged in as during extension loading has the proper 800xA user rights as well.

6.3.1 SMS and Email Software Installation

The SMS and Email Software should be installed on every node in your system.
The software is available on 800xA System DVD 1. The installation is begun from the
DVD’s “autorun” function which may start automatically when the DVD is inserted.
If the “autorun” functionality is disabled, run the Autorun.exe program located in the
root of the DVD to display the autorun opening screen and select the “Manual
Installation” option

The autorun program will present another menu of available 800xA software when
Manual Installation is selected. The SMS Email program installer can be selected from
the available software. The installation launcher for SMS is located under the “Base
Functionalities” menu option.

Chapter 6 - 5
T313-06 SMS and E-Mail Messaging - RevC

There are no user-configurable options when installing the software other than
specifying the directory where the software will be installed. Some systems may have
been configured with non-default installation paths for the base, or core, software; in
that case, specify the appropriate path to the correct installation directory, otherwise
accept all defaults.

6.3.2 SMS and Email Post Installation Procedures

Loading software on a computer does not make that software available to the 800xA
aspect system. If you look at all of the objects and aspects in your 800xA system
before and after the software is loaded, you will not see any changes in your system
until the system’s functionality has been upgraded, or “extended” by the use of system
extensions.
When a software extension is “loaded” into the 800xA system, the system will be able
to find the software loaded on a machine and “import” all of the necessary object
types and aspect types specially designed for that software package into the Aspect
Server’s database (the Aspect Directory) and may even create instantiated objects of
the new object and aspect types.
Extending the 800xA core system to include system extensions is done via the
Configuration Wizard on one of the Aspect Server nodes; usually on the Aspect
Server where the system was first created. This is called the “Primary Aspect Server”.
The Configuration Wizard is program which was loaded along with the base software
and will be available on the ABB Industrial IT section of the start menu.

Chapter 6 - 6
 System 800xA Training

The addition of extensions into the system is accomplished in the “Extension Load”
option in the System Administration area.

All 800xA software that exists on the machine where the Configuration Wizard is
executing will be listed on the left side of the Extension Load screen. The SMS and
Email Messaging extensions should be selected and moved to the right-side table
which lists the extensions that the wizard will load into the running system.

Chapter 6 - 7
T313-06 SMS and E-Mail Messaging - RevC

As the extensions are loaded into the system, the Configuration Wizard will log the
actions taken and the results of those actions into a log file. After the extension is
loaded, review the log file to ensure that no errors and warnings occurred during the
process. The log is stored on the local hard drive as a plain-text file,
afwConfigWizardLog.txt, which can be displayed by clicking the “View Log…”
button on the Configuration Wizard. It can also be reviewed with a standard text
editor, such as notepad, and is located in the C:\Program Files\Industrial IT\Operate
IT\Process Portal A\Log directory.

You should see several new object types in the object type structure.

Additionally, new aspect types were created in the Aspect System Structure.

Chapter 6 - 8
 System 800xA Training

The Configuration Wizard also created some default objects and aspects in our system
which it needs to for SMS and Email Messaging to work correctly. You will find that
a new “Messenger” object called “SMS and e-mail messaging” was created in the
Control Structure.

New Service, Service Group, and Service Provider objects were created for a new
service in the Service Structure called the “Messenger” service. The Messenger
Service represents ABB program running on the computer node designated to handle
SMS and Email Messaging, referred to as the SMS and Email Application Server.
While it is desirable that applications reside on dedicated application server nodes, in
most instances the functionality of application server can be combined on the same
node, Refer to the appropriate site and system planning instructions for your version to
determine what applications can be combined on different node types.

6.3.2.1 Messaging Service Post Installation

Select the node designated to be the SMS Email Application Server from the list of
available nodes in the drop-down box of the “Configuration Tab” of the Service
Provider Definition aspect on the Messenger Service Provider object

The Messaging Service should go to the Service State and, as always, you should
check the System Status Viewer aspect in the Service Structure.

Chapter 6 - 9
T313-06 SMS and E-Mail Messaging - RevC

6.3.2.2 Restart the System Messaging Service Event Collector

The Messenger Service, as is the case with any of the 800xA services, will generate
system events. These events are made available in the System Message service. The
events from the System Message service are collected by one of the system’s event
collectors and are made available to Alarm and Event Lists by the Alarm Manager.
The Event Collector service, however, at this point is not aware of the additional
messages that will be generated by the System Message Service. IT needs to be re-
started in order to get this information. This is accomplished by disabling the Event
Collector service provider(s) and re-enabling.

Chapter 6 - 10
 System 800xA Training

6.4 SMS and Email Architecture, Objects, and Aspects

6.4.1 Messenger Service

As indicated before, the Messenger Service is an actual executable (*.exe) program
running, and as such, is the “brains” behind SMS and Email Messaging.
The Messaging Service is responsible for all actions of SMS and Email such as:
monitoring the assigned Alarm and Event List aspects
generating and format the necessary text messages
initiating communication with the external network
sending messages
receiving responses
The event collector generates events which are handled, according to OPC
specifications, and made available in the System Message Server where they are
collected and displayed by the system on aspects, such as an Alarm and Event List
aspect.
When an event is generated and received by the Event Collector, the system still needs
to attach that particular event with an object in the system; All OPC type
communication occurs on Network objects in the Control Structure and thus, the SMS
and e-mail Messaging object was created for this purpose in the Control Structure.
The SMS and e-mail Messaging object has a pre-configured Alarm and Event List
aspect which will display events received which relate to SMS and e-mail Messaging.

Chapter 6 - 11
T313-06 SMS and E-Mail Messaging - RevC

6.4.2 Devices (Communicating Devices)

Communications from the Messenger Service to the outside world needs to take place
through some sort of a connection to the outside world. This is represented in SMS
and Email Messaging as a “Device”. There are two types of “Device” objects
available depending upon whether you are using internet Email or the SMS global
telephone network.

6.4.2.1 Email Device

The Email Device represents a connection to an SMTP over TCP port 25 where the
message will be forwarded.
Because your 800xA system’s Client/Server Ethernet network will not be connected
directly to the internet, use of the Email device for message transmission can be
accomplished in a variety of ways which involve setting up the necessary network
routes and opening specific ports in firewalls.
Other than to specify that that the SMTP connection uses TCP port 25, the configuring
of an email device is beyond the scope of this lesson and will, in most cases, involve
assistance from your company’s IT professionals or Internet Service Provider’s
Technical Support department.
The 800xA system provides the additional ability for the message being sent be stored
locally on the machine (requires the SMTP service to be installed and running) and be
routinely “picked up” by another SMTP server.
The Email Device holds the email address where a message is being sent TO and an
SMTP server which will receive the message (called a “Relay” server in SNMP
terminology).
The software contains a test utility to test the validity of the connection and the ability
to send mail. This test should be operating satisfactorily before attempting to
configure sending Email messages from your 800xA system using an Email Device.
Open the TestEmailObj.exe program located in C:\Program Files\ABB
IndustrialIT\Operate IT\Messenger\bin directory using Windows Explorer of from the
Start -> Run menu.

Chapter 6 - 12
 System 800xA Training

This test should be run for each and every user who will be using the Email device.
Continue to run the test until satisfactory results are obtained in the RESULTS box
Record the necessary information in a printout of out Table 3 in Appendix C of the
System Configuration manual and keep it in your records

You will need to configure the default values for Email Devices on the Email Device
object in the Aspect System Structure with the information from your tests

Chapter 6 - 13
T313-06 SMS and E-Mail Messaging - RevC

Email Devices will be related to Users in the User Structure and the appropriate TO:
address will be obtained, the “From” and SMTP Server settings will be inherited from
this aspect.

6.4.2.2 SMS / GSM Device Aspects

These types of devices represent the physical connection of hardware device to the
SMS and Email Messaging Server. They are usually connected to a local COM port
on the computer through which the system can communicate to the appropriate service
provider to send the message.
The System Configuration Manual provides extensive in-depth procedures covering
the step-by-step details of configuring SMS/GSM type and is too extensive to be
reproduced in this training document. However, an understanding of the steps
involved will help you through your first configuration.
As with the Email Device, any connection to the Server through which the system will
attempt to communicate should be set up, tested, and verified correct before
attempting to configure messaging within the 800xA system.
ABB has tested a variety of Hardware Devices and Service Providers with the 800xA
system and will continue to do so as new devices and providers are available. Be sure
to check the latest product documentation and the SolutionsBank web site for the
latest and up-to-date listing.
The worksheets are also designed to be used as configuration records. Each one starts
on a new page for ease of copying. Keep these records in a safe place for future
backup/restore or upgrade activities.
The Messenger Server must be disabled before configuring the SMS device, similar to
recycling the Event Collector Service during the Post-Installation steps.
Default settings on the SMS / GSM Device is done on the SMS Device object in the
Aspect System Structure

The configuration of the SMS device involves setting the required COM port and baud
rate settings for the attached device, any required PIN numbers, modem initialization
commands, etc for the particular SMS device. Follow the detailed step-by-step
procedure in the System Configuration manual.
Make sure to restart the Messenger Service in the Service Structure.

Chapter 6 - 14
 System 800xA Training

6.4.3 Message Subscriber Aspects

Message Subscriber aspects define who can subscribe to messages sent by SMS and
Email Messaging and can be located on User or User Group objects in the system’s
User Structure.

Entries into the Message Subscriber’s list consist of a particular SMS and Email
Messaging Device and are configured with a telephone number or email address.
Here is the Email Device aspect when you select a “SMTP/Email” device in the
Message Subscriber aspect before mentioned

The Message Subscriber aspect will subscribe to SMS and Email Messaging Source
aspects which will send the subscriber the message. This aspect will use the assigned
device and setting and send the message on its way to the recipient.
Entries in the list are managed by means of the “New”, “delete” and “Edit” buttons.
Devices in the list can also be sorted by order of priority.

6.4.4 Message Schedule Aspects

The Message Schedule aspect identifies the times of day and days of the week that
users receive event messages on configured user devices. This allows for complete
control of configuring when certain the when messages are to be sent based upon
date/time and day of the week. Message delivery can also be turned off for the specific
Users or User Group where this aspect resides.

Chapter 6 - 15
T313-06 SMS and E-Mail Messaging - RevC

6.4.5 Messenger Log Aspect

The Messenger Event Log is a preconfigured Alarm and Event List that filters out
everything except for the SMS and e-mail Messaging activity. This pre-configured
Alarm and Event list is automatically loaded with the SMS and e-mail Messaging
system extension as Messenger Event Log aspect on the SMS and e-mail Messaging
object in the Control Structure. Multiple instances of the Messenger object, which
includes the Messenger Even Log aspect, can be created. Also, additional instances of
just the Messenger Even Log may be copied and pasted from the preconfigured
Messenger Event Log aspect from the SMS and e-mail Messaging object in the
Control Structure

The Messenger Event Log contains information on how many messages were
successful, why a user did not receive a message (for example, they were not on
schedule), and the reasons why a message was not successfully sent (for example,
wrong PIN, service not accessible, modem not turned on, etc.). It also logs message
receipt confirmation from GSM compatible devices that received the message via the
SMS/GSM Device.

Chapter 6 - 16
 System 800xA Training

6.4.6 Alarm and Event Message Source Aspect

The Alarm and Event Message Source aspect will monitor a specific Alarm and Event
List in the system and create a text message based upon received alarm and events
received in the list. It will locate another aspect, the Message Handler aspect, which
will be configured to send the Alarm List’s messages to the SMS and Email
Messaging Message Subscriber. (The SMS and Email Device will format and transmit
the message to the external network).
Once you understand the concept of how messages are generated, you can understand
why the proper design of your “Grouping” type objects in structures such as the
Functional and Location structures, is important. You should create the grouping
objects and configure them so that you have one (or more) Alarm and Event Lists
which reflect the messages you want to receive, and those alarms and events only.
This aspect should be added to the object that contains the Alarm and Event List to be
monitored for new entries. There are two configuration tabs. The “Alarm List” tab is
where you select one of the Alarm and Event Lists on the same object from the drop-
down-box. In this case, the aspect is at an area level of the Functional Structure.

The “Message Configuration” tab allows you to select the fields from the alarm and
Event list which will be included in the text message to be sent when it is generated.

Chapter 6 - 17
T313-06 SMS and E-Mail Messaging - RevC

6.4.7 Message Handler Aspect

The Message Handler aspect completes the flow of information from the SMS and
Email Messaging Message Source aspect. IT is on this aspect that you will define
which of the Users and Devices configured in the User structure will receive the
message sent from the event list.
On this aspect, you need to configure the SMS and Email Messaging Source aspect
which has the Alarm and Event Data

And you will configure the recipient of the message on the Destination tab by
selecting any of the Message Subscriber aspects you previously configured

6.4.8 Manipulating SMS and Email Messaging aspects

When the various structures are set up as desired, it may become necessary to move
some SMS and e-mail Messaging aspects to other areas in the structures by using the
drag and drop method. Attempting to use the drag and drop method on SMS and e-
mail Messaging aspects while they are active will result in the following loss of
configuration:
• Alarm and Event Message Source: loses reference to Alarm and Event List and
resets it to blank.
• Message Handler: loses reference to Alarm and Event Message Source.
• Message Subscriber: loses reference to TAP/Modem, SMS/GSM, and/or
SMTP/Email Device.
• TAP/Modem, SMTP/Email, and/or SMS/GSM Device: Message Subscriber loses
reference to device.

Chapter 6 - 18
 System 800xA Training

• Message Schedule: No effect.

To avoid these problems, copy and paste the aspects to the desired location, and then
delete them from the original location.
SMS and e-mail Messaging will not stop acting on the previous configuration until the
service is disabled and then enabled

6.5 SMS and Email Configuration Procedures

The following is a typical setup and configuration workflow for SMS and e-mail
Messaging.
1. Set up hardware (one, two, or all).
Set up GSM hardware.
Set up Hayes compatible modem hardware and run test utility.
Run e-mail test utility.
2. Set up system.
Define default telephone number for Central Paging Terminal of paging service
provider (SMS/GMS Device aspect)
Define default e-mail address that appears in from field when users receive
messages and where error messages may be sent. (Email Device aspect)
Create User Groups and add users to groups if required.
Set up message subscriber aspects for each user:
Add devices.
Configure devices.
Assign priority.
Set up Message Schedule for each user.
Set up Messenger Event Log.
Check status of SMS and e-mail Messaging service.
3. Configure system.
Configure Alarm and Event Message Source:
Select Alarm and Event List to monitor.
Set message content and length.
Configure Message Handler:
Select Alarm and Event Message Source and enable/disable source.
Select users and/or groups to send messages to and assign priority.

Chapter 6 - 19