SMS Editor

The program SMS_Editor from LUTEUS is used for creating SMS messages. SMS Editor allows manual creation of SMS messages by a user through a simple graphical interface or automatically by any third party Windows programs with a command line call.

SMS messages created by SMS Editor are stored into the queue of the SMS Dispatch Manager program. SMS Dispatch Manager is responsible to send the messages sequentially in the queue. Be aware that SMS Dispatch Manager is a program that operates either within our monitoring tool LoriotPro as a plugin or independently (launcher). Thus SMS Dispatch Manager can be sold separately and it is not necessary to buy a LoriotPro License to run it.

As we mention before, the advantage of this program is to use all types of Windows applications to send SMS from a simple command line.

The Windows program creator of the SMS program must call the SMS_Editor program in command line mode (CLI) and pass two parameters, the name of the destination list and the SMS  text message itself. A destination list consists of 1 or more recipients and optionally of their position in the chain of escalation.

The following example explains how to set up the Task Scheduler of Windows for sending SMS on receipt of a particular Windows event in the event log.

Introduction

SMS_Editor the program simply creates a file with a particular name and a particular format (XML) in a particular file directory. This directory is used by the SMS Dispatch Manager program as a source of SMS to send.

The SMS message can be deposited by SMS_Editor from a remote machine in the directory. For this a windows share on the SMS installation directory Dispatch Manager will be required.

Usage of the SMS_Editor program

The launch of the SMS_Editor program without an option simply displays a window of launch aid.

The launch of the program is either done in CLI mode or graphical mode.

Launched in command mode (CLI)

SMS_Editor /rl  Recipient List /msg SMS message /p Path /qn Queue Name

Recipient List est la liste de destinataire et doit être défini dans SMS Dispatch Manager

SMS message est le texte du SMS à envoyer

Exemple : "This is a text message with a quote \""

Path   (option) Le chemin vers le répertoire ou est installé SMS Dispatch Manager. Ce peut être un chemin local ou réseau. Par défaut le chemin est le répertoire ou se trouve SMS_Editor. Si celui-ci est dans /bin les chemins utilisés par défaut seront corrects.

Exemple :   "C:\\LoriotPro\\bin"

Queue Name (option) Le nom du répertoire dans lequel sont déposés les fichiers. Si aucune valeur n’est précisée, le répertoire sms_queue est utilisé. Le répertoire est situé dans /bin le répertoire d’installation du lanceur de SMS Dispatch Manager.

NOTE: All values of these parameters must be specified in double quotes if they contain spaces. Special characters must be preceded by the backslash (ESCAPE), the quote and the backslash, for example.

Example : "This is a text message with a quote \""

Launched in graphical mode.

SMS_Editor /g

The GUI is displayed

The default options are already set, the path to the directory of SMS Dispatch Manager and the name of the subdirectory's default queue.

You must then choose from the drop down lists a list Recipient (Recipient List). If this list is empty you should first define them with the SMS Dispatch Manager setup.

Enter the text of the message to send. A maximum of 160 characters including space

Remote creation through network connection

The message can be deposited from a remote machine in the directory. For this a windows share on the SMS installation directory Dispatch Manager is required.

Here is an example of the configuration GUI for filing messages on the remote machine named ADES.

When clicking on Add to Message Queue Directory a file is created in the directory /bin/sms_queue as an xml file.

Example of  xml file generated by SMS Editor in the sms_queue directory

<?xml version="1.0" ?>
<SMS>
         <RECIPIENT_LIST>adminlist</RECIPIENT_LIST>
         <MSG>test taskManager</MSG>
  </SMS>

Example of Sms_queue directory with files waiting to be handled by SMS Dispatch Manager.

The SMS are well created and SMS Dispatch Manager should now send them. If messages stay there it means that SMS Dispatch manager is not started and do not process them. You must then check SMS Dispatch Manager settings.