VisualGSM Enterprise User Guide
Visualtron Software Corporation
55
Figure 4.23 : Service Manager Tab.
4.2.5.2 Log Tab
This is a very detailed log file depicting the entire process of
sending and receiving SMS messages as well as any errors
and successful deliveries. The following is a list of the features:
- All; it lists all the log parameters.
- Have Tried; it lists all the log files that were sent out.
- Send Successfully; it lists the log files of all the messages
that were successfully sent out.
- Delete; deletes the selected log item, regardless of
whether it is sent or still pending.
- Delete All Sent Messages; deletes all successfully sent
messages in the log.
- Export; export the log data into text file format. For
example:-
VisualGSM Enterprise User Guide
Visualtron Software Corporation
56
Backup time: 2002-07-25 22:05:14.05
SEQNO#USERID#SERVICEKIND#SOURCE#DESTINATION#CONTENT#TRIED#SUCCEED#ERR
ORMSG#ORIGINALNUMBER#KEYWORD#FLASH#BLINK#RECTIME#SENTTIME#PORTNO
909##0##+905363696386#dddd
From:makcay@tgv.org.tr#1#1####0#0#25/07/2002 20:24:48#25/07/2002 20:24:48#-1#
908##0##+905337324382#BoOoOOOoooOO
ICQ um acik. Senin yada benim bir isim cikmazsa yazisiriz :)
From:makcay@tgv.org.tr#1#1####0#0#25/07/2002 20:24:30#25/07/2002 20:24:30#-1#
907##0##+905337324382#Icq da her zamanki gibi seni bekliyorum kediyusum.
Simdilik isim yok ama cikarsa soylerim. BoOOoOO
From:makcay@tgv.org.tr#1#1####0#0#24/07/2002 22:01:04#24/07/2002 22:01:04#-1#
906##0##+16048055863#ÄãºÃ†á©t ÎҺܺéo ÖxÖx©u How are you? I am fine thanks.
Each message record will contain message content,
destination mobile number, information on transmission
success/failure, basic error report, time/date of actual
transmission/reception, and scheduled transmission
time/date.
Messages that are queued for sending will appear in the
log as a new record. After it is successfully sent out, the
fields TRIED and SUCCEED will be set to 1. If the
transmission is not successful, SUCCEED will be set to 0.
Check ERRORMSG field for the cause of failure. A more
detailed error log can be found on sms_server_log.txt
found in programfiles/Visualtron/visualgsm/vgsmlog/ by
default setup.
Tip: clicking on “Delete All SENT Messages” will only delete
messages not yet sent out. To delete such messages, you
will need to click on “Delete” individually. “Resend”
button will resend a message that has been sent. Toggle
on the “Auto Fresh”, and then click on Search to let
VisualGSM Enterprise Manager refresh the records every X
secs.
Tip: you can set auto-refresh and then click on search to
allow the log display table to automatically refresh every x
seconds.
VisualGSM Enterprise User Guide
Visualtron Software Corporation
57
Figure 4.24 : Log Tab.
4.2.5.3 Keyword Tab
This allows users to add new keywords. Keywords are used for
interactive SMS information services, and can be used to
create many innovative mobile applications if used to the
fullest.
Note: keywords are non-case sensitive.
The actions involved are listed below:
this feature allows the user to check whether or not
the keyword type that has been added works correctly or
not from the Enterprise Manager by simulating an
incoming SMS bearing the keyword and optional
parameters. This feature aids rapid development.
this feature allows the user to create a new
keyword.
this feature allows the user to delete an existing
keyword.
this feature allows the user to modify an existing
keyword entry.
VisualGSM Enterprise User Guide
Visualtron Software Corporation
58
Parameters
The following parameters can be used in the configuration
parameters and messages of all keyword types. They can
be used in any form input to represent the respective
values in the message:
{M}: Incoming SMS message contents.
{M1…M30}: Incoming SMS message contents, split into
sections by a pre-defined delimiter (Maximum 30 sections),
as defined in this section:
. If no delimiter
is defined, the default is “space”.
Note: multiple delimiters can be added, e.g. #*!. If you
add a delimiter, for example #, and you want to have
space included, you need to add a “space” in that
delimiter box. “Space” will not be included by default in
this case. The control for delimiter between keyword and
{M1} is defined under a separate form, Console
Configuration (Special Tab). It is also “space” by default.
{N}: Originating Mobile Number (of the Sender).
{SMSC}: Short Message Service Centre (of the Sender).
{KEYWORD}: Keyword name (first word in a short message).
{PORT}: The COM port which the incoming SMS came from,
e.g. COM1, COM2…COMx.
{NAME}: OWNERNAME of sender if sender is found in
VisualGSM Enterprise User Guide
Visualtron Software Corporation
59
phonebook.
{SEQNO}: Record sequence number (LOGLOG.SEQNO) of
message in LOGLOG table.
{SENDFROM}: Returns the value of LOGLOG.SENDFROM for
that incoming message.
{COMMMETHOD}: Returns the communication method
name on which the sms was routed (applies to SMPP
connection, e.g. SMPP-1).
Note: for example, if short message is “Hi how are you”,
{KEYWORD} = ”Hi”, {M} = “how are you”, {M1} = “how”, {M2}
= “are”, etc.
Keyword Values
The definition of keyword is the first word of an incoming
SMS message.
Actions to be performed for each incoming SMS message
containing a keyword can be setup for each keyword. A
specific keyword cannot be assigned to more than 1
action. For such a requirement, it will be more practical to
use HTTP or COMMAND EXE actions.
For actions to be performed on all incoming messages
whose keyword do not correspond to any of the keywords
set-up by the user, users can set up a new keyword action
for the keyword: “NOKEYWORD”. This is useful for capturing
undefined messages. A corrective SMS response can then
be made.
Note:- if you do not want the server to respond (even a
NOKEYWORD response to a particular set of mobile
numbers, you will need to set the numbers under Console
Configuration
Forbidden Mobile Numbers. This is
especially useful against “botspammers”.
The keyword type can be any of the available types (i.e.:
HTTP URL, Command EXE, Email, Information, Text, SQL
Query) and its configuration is the same as the
configuration procedures for the corresponding keyword
type as described in the later paragraphs.
VisualGSM Enterprise User Guide
Visualtron Software Corporation
60
For ‘NOKEYWORD’, the SMS message content would be
keyword + message. For example, for the incoming SMS
message “Visualtron Software Singapore”, the keyword is
“Visualtron” and message {M} is “Software Singapore”.
Keyword Type and Configuration Parameters
The following describes the keyword type and
configuration parameters:
-
HTTP URL. For this type of keyword, the URL field should be
the URL of the web resource, which the user would like to
POST/GET. The keyword name would be the message
that the sender would send to invoke this command. The
parameter field is the specific pre-determined URL-
encoded string of parameter-value pairs passed to the
URL. The URL and Parameter fields can contain the
common parameters ({M}, {M1…M10}, {N},
{SMSC},{NAME},{SEQNO},{PORT}).
If no parameters are configured, the following
parameters will be passed into the specified URL
automatically by default:
Parameter: ORIG
Value: Originating Mobile Number (of the sender)
Parameter: MSG
Value: Incoming SMS Message Contents
Parameter: KEYWORD
Value: Keyword of the incoming SMS message.
Selecting the “Return to User” would prompt the module to
return to the sender via SMS, the content found in that URL
or that is returned by the web resource/scripting.
Selecting “Use Proxy” would command this module to use
the internet proxy server and proxy port that is configured
earlier under “Configuration”.
Using the “Test” button would test the results of the
POST/GET.
In the example shown in Figure 4.25 the keyword “4” will
GET to the URL
VisualGSM Enterprise User Guide
Visualtron Software Corporation
61
RIG=<originating mobile number>&MSG=<incoming
SMS>&KEYWORD=<incoming keyword>. This will send the
result of the information retrieval program retrieve.asp
(written to retrieve information from a web site) to the
sender of the message. For more information, refer to the
Server Interface Guide. Notice that the return to User is
checked, so that the user will receive via SMS the result
(HTTP response) from the ASP program. No proxy is used,
indicating a direct connection.
Figure 4.25: HTTP URL type.
Tips: one useful method of using the HTTP type is to set URL
as
N=%2B6596550205&M={M1}+{M2}…..{M30}. This will allow a
user of the system to message 96550205, by sending a
VisualGSM Enterprise User Guide
Visualtron Software Corporation
62
message that contains that keyword. For example, if the
keyword is John, and the SMS message is “John hi how are
you”, then “hi how are you” is forwarded to
%2B6596550205”. Note that %2B is url encoded form of “+”
sign.
All keyword types/action have the following settings:
Public Access – This option is applicable only when the
“Allow all mobile numbers to access all keywords” option
in Console/Configuration/General tab form is unchecked.
The option enables specific keywords to be exempted
from access controls checks imposed by the Mobile
Security feature – see 4.2.5.5.
Unlimit Credit – This option is enabled by default. Disabling
this option will place a countdown limit on the number of
times the keyword will execute.
Never Expire – This option is enabled by default. Disabling
this option will allow you to set a date after which the
keyword will be deactivated until either the date is pushed
backwards or the option enabled once more.
-
Command EXE. This type of keyword would command a
script or executable (Note: Only command line interface
programs which can be executed on the DOS console
can be invoked by the server) on the server to run upon
receiving this keyword from the sender. After giving this
type of keyword a name, the command field would hold
the command that is associated with this keyword. The
parameter field will hold any additional parameter that
VisualGSM Enterprise User Guide
Visualtron Software Corporation
63
accompanies the command field. The “Succ Return” field
and the “Fail Return” field holds the successful and failed
execution note that is sent back to the invoker of this
command to notify him of the result. Use the “Test” button
to see whether or not the result intended is the one that is
in mind. The Command, Parameter, “Succ Return” and
“Fail Return” fields can contain the common parameters
({M}, {M1…M10}, {N}, {SMSC}).
Note:- success and failure indicate only if the command
line is being executed; it does not indicate whether the
program executed has run properly or successfully. The
limitation of COMMAND EXE is that you cannot capture a
response from the program being executed.
Note:- for some cases, for the server to properly interact
with a COMMAND EXE program that has a GUI, you need
to set VisualGSM service Logon with the ability to
interactive with desktop (see example below).
Figure 4.26 : Allow service to interact with desktop for COMMAND EXE.
