You are on page 1of 12

www.iQsim.

com

UNDERSTANDING THE HBS FEATURE

iQsim SA 2014

Understanding the HBS feature v1.00

Page 1/12

General information
Copyright
Notice

2014 Copyright iQsim SA


Edited in France, December 2014.
All rights reserved. This product and its related documentation are protected by copyright and
distributed under iQsim licenses to its authorized users only. Authorized users who have purchased one
or more iQsim products described herein can download and print a copy of this publication.
No part of this product or its related documentation may be reproduced, adapted or translated without
prior written authorization of iQsim. The information contained herein is subject to change without
prior notice.
iQsim SA
Les algorithmes, Aristote A
2000 route des lucioles
06410 Biot
France
Phone: +33 4 97 04 19 30
Fax:
+33 4 97 04 19 31
URL:
http://www.iqsim.com
E-mail: info@iqsim.com

Trademarks

All other products mentioned herein may be trademarks or registered trademarks of their respective
companies and are hereby acknowledged.

Disclaimer

Information contained herein supersedes preliminary specifications or data sheets of the product as well
as earlier versions of this publication, if any.
While every effort has been made to ensure the accuracy of this publication, iQsim assumes no liability
for omissions or editorial errors contained herein. iQsim reserves the right to revise the information
herein at any time without prior notice. Changes and improvements will be incorporated into the new
version of this publication.
This publication is provided as is without warranty of any kind. iQsim SA hereby disclaims all
warranties, either express or implied, including but not limited to, all warranties OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, and those ARISING FROM A COURSE OF DEALING, USAGE OR
TRADE PRACTICE.
IN NO EVENT SHALL iQsim BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL OR INCIDENTAL
DAMAGES, INCLUDING but not limited to, all damages resulting from LOSs of use, data or PROFITS
ARISING OUT OF THE USE of OR INABILITY TO USE THIS product, EVEN IF ADVISED OF THE POSSIBILITY
OF SUCH DAMAGES.

About this
document

iQsim SA 2014

This document aims to give a complete description of how the Human Behavior Simulation (HBS)
feature works on Iron SIM Server One (ISSO), Iron Suite or M800 solutions.

Understanding the HBS feature v1.00

Page 2/12

Contents
1. __ HBS basics ............................................................................................................................................................................... 5
2. __ Templates of HBS Scenario..................................................................................................................................................... 9
2.1

Template #1 ................................................................................................................................................................ 9

2.2

Template #2 .............................................................................................................................................................. 11

iQsim SA 2014

Understanding the HBS feature v1.00

Page 3/12

Document revision
Version

Date

Author

1.00

1/12/2014

XLE

iQsim SA 2014

Content
st

1 version

Understanding the HBS feature v1.00

Page 4/12

Overview

This document aims to give a complete description of how the Human Behavior Simulation (HBS) feature
works on Iron SIM Server One (ISSO), Iron Suite or M800 solutions.
The HBS is a software application running on Iron SIM Manager for Iron Suite, or embedded into Iron SIM
Server One (ISSO) or M800 solutions.

How and why


to use HBS?

The HBS is part of the different features available for SIM cards protection: it helps in giving the SIM cards a
more standard, or human being-like, profile of usage.
The Iron SIM Server One (ISSO), Iron Suite or M800 devices can be used for call termination or/and bulk
SMS termination applications: as a result, the SIM cards are mostly used for outgoing traffic only, and to
thousands of different called numbers.
The main purpose of using the HBS is to complete the one-way and single-type of traffic going through the
iQsim gateways, with additional types of traffic on both directions, outgoing and incoming.
The other purpose of using the HBS is to generate an additional traffic to a restricted list of known-call
numbers.

Reference document: IRON Suite V2 Administration Interface (IRON-AG-02.00.pdf)

What is a HBS
event?

A HBS Event is a particular call or SMS generated by the HBS application itself: the type of HBS Event and its
frequency of generation are to be programmed by the Iron SIM Server One (ISSO), Iron Suite or M800
administrator.
The HBS is designed to generate 3 types of HBS Events.
-

Call: the HBS will use the SIM card to place a call. The destination number can be the one of any other
SIM card managed by the Iron SIM Server One (ISSO), Iron Suite or M800 (internal call type) or can be
any number (external call type).

SMS: the HBS will use the SIM card to send a text message. The destination number can be the one of
any other SIM card managed by the Iron SIM Server One (ISSO), Iron Suite or M800 (internal call type)
or can be any number (external call type).

Call to the voicemail: the HBS will use the SIM card to call the mobile provider voicemail service number,
and to play the DTMF script defined into the HBS Scenario menu.

A HBS Call (or SMS) to an internal phone number (SIM cards subscriber number) can make 2 GSM ports busy
if the call is connected: the GSM port used to place the call (outgoing call or SMS), and the GSM port used to
receive the call or SMS (incoming call or SMS).
A HBS Call (or SMS) to an external phone number can make 1 GSM ports busy if the call is connected: the
GSM port used to place the call (outgoing call or SMS).
A HBS Call to the Voicemail can make 1 GSM ports busy if the call is connected: the GSM port used to place
the call (outgoing call).

iQsim SA 2014

Understanding the HBS feature v1.00

Page 5/12

When are the


HBS Events
played?

The HBS Events can be generated based on a real-time basis (eg. 4 HBS call every 60 minutes), or based on
billed-time basis.
Billed-time basis means the HBS Events are played based on pending termination traffic (Calls or SMS) on the
GSM gateway, and the frequency of HBS Events generation depends on the quantity of traffic: so no live
traffic means no HBS Event played, low live traffic means a few HBS Events played, and huge live traffic
means HBS Events played more often.
Into HBS menu > Scenario tab, for Range Time Simulation parameter, tick Registered Real Time only box for
HBS to play the HBS Events based on real-time, or leave Registered Real Time only box empty for HBS to play
the HBS Events accordingly to the pending live traffic.
st

For every SIM card, the 1 HBS Event of each type (Call, SMS and Call to the VoiceMail) is computed in
advanced, regarding the type of Range Time Simulation set: they are all listed into the HBS\Pending Events
menu.
See into the Remaining Time column:
[CT] means Range Time Simulation = Call Termination (used for SMS Termination as well)
[RT] means Range Time Simulation = Real Time

Every time a termination call is hang up or a termination SMS is sent, the SIM Manager running on the Iron
SIM Server One (ISSO), Iron Suite or M800 devices updates all the counters of minutes or SMS into the
system database.
According to these new figures, if the Remaining Time reaches 0, then the corresponding HBS Event is played
immediately from the given SIM card if:

the destination number is an external number

the destination number is an internal number of a SIM card registered and available

the destination number is the one of a friend SIM card.

In all other cases, the HBS Event is considered as failed (HBS Error).
Once a HBS Event is played or failed, then it is deleted from the database and the next HBS Event of the
same type is generated into the list of Pending Events.
If several SIM cards are registered and available when the HBS Events is to be played, then one of them is
selected randomly.

iQsim SA 2014

Understanding the HBS feature v1.00

Page 6/12

Subscriber
numbers

The HBS Events generation to an internal number requires the given SIM card phone numbers to be defined
into the Iron SIM Server One (ISSO), Iron Suite or M800 database first.
They are listed into SIM Cards menu, into the Subscriber Number column.
Two options are available to collect those subscriber numbers automatically.

If available, the USSD service of the mobile provider can be used. To automatically collect
the subscriber number and to store it into the database, the proper USSD request must
be sent from the GSM port where the SIM card is registered. Then, the USSD response
from the mobile provider can be analysed and the subscriber number extracted from it.
This script must be programmed into SIM Plan\Activation menu as described into the
snapshot below:

The second option to automatically collect the subscriber number and to store it into the
database, is to send a SMS from the GSM port where the SIM card is registered to a
known number of an other registered SIM card of the system.
Obviously, this solution requires to know the subscriber number of one of the SIM cards
at least, and to enter it manually into the Iron SIM Server One (ISSO), Iron Suite or
M800 database (from SIM Cards menu > Edit SIM Card > Subscriber number field)
This script must be programmed into SIM Plan\Activation menu as described into the
snapshot below:

Reference document: How to automatically collect the Subscriber Numbers (How to automatically collect
the Subscriber Numbers.pdf)

iQsim SA 2014

Understanding the HBS feature v1.00

Page 7/12

HBS usage
restrictions

A HBS Event has the highest priority on live termination traffic: if there is a pending call or SMS sending when
a HBS Event is planned to be played from a given SIM card, then GSM port where this SIM card is registered
is reserved.
For the time of the HBS Event to be executed, the given GSM port is considered as not available by the for
call termination traffic routing.
So the more HBS Events are played, the less GSM ports are available for call termination traffic.
When a HBS Call is played, SMS termination is possible on the GSM port(s) in use simultaneously.

A HBS Call is to be considered as a normal call: it means the number of HBS Calls and corresponding calls
duration are included into all counters about calls into the Iron SIM Server One (ISSO), Iron Suite or M800
web interface:

SIM Cards > Remaining minutes (Peak, Off Peak, Bonus), Daily (min & call), Used minutes,

SIM Plan > SIM Protection > Maximum Calling Time & Maximum Call Attempts

Allocation Rule > Maximum Allocated Calling Time & Maximum Calls,

A HBS SMS is to be considered as a normal SMS: it means the number of HBS SMS is included into all
counters about SMS into the Iron SIM Server One (ISSO), Iron Suite or M800 web interface:

SIM Cards > Remaining SMS (Peak, Off Peak, Bonus), Daily (SMS), SMS sent,

SIM Plan > SIM Protection > Maximum SMS To Send

So the number of expected HBS Events to be played must be taken into account into all settings done
for SIM card restriction of use.

Also, because the HBS Events have to be considered as normal calls or normal SMS, they are charged by the
mobile provider when they are connected or sent with success. This means that the balance available on the
SIM card is partially used for HBS Events generation.
So the number of expected HBS events to be played must be taken into account into the return on
investment calculation. The more HBS Events played, the less balance for termination traffic is available.

Internal HBS Calls or SMS requires the subscriber number of all the SIM cards to be defined into the Iron SIM
Server One (ISSO), Iron Suite or M800 databases first.
HBS SMS requires the mobile provider SMS Service Center number cards to be defined into the Iron SIM
Server One (ISSO), Iron Suite or M800 databases first.

When a HBS Call is connected, a .wav file is played by the gateway to simulate a voice conversation, in a loop
manner until the call is hang up.
This file can be recorded and customized at the users convenience: the file name is pleasewait_eng.wav
located into /iQsim/Gateway/VOICE folder on M400 gateway, or PWAIT.WAV file located into /VAR/GSM
folder on M100 gateway and M800 device.
It must be recorded within CCITT law A WAV format.

iQsim SA 2014

Understanding the HBS feature v1.00

Page 8/12

Introduction

This part of the document aims to give some usual templates of HBS configuration.
It helps in understanding how the HBS Events are computed and when they are played, depending on the
HBS Scenario settings.

2.1 TEMPLATE #1
Template #1

st

For this 1 template, the HBS Scenario settings are the following:

Range Time Simulation (mm and SMS): 60


Registered Real Time only (mn): ticked
Number of outbound calls: 4
Number of SMS to send: 6
Number of VoiceMail connection: 2
Randomly Decrease Range Time (%): 0

For every SIM cards set with the SIM Plan for which this given HBS Scenario is selected, 1 HBS Event of each
type is created and scheduled with the formula: Range Time Simulation/ Number of events.
They are listed into Pending Events menu.
So, as shown into the figured below, 1 HBS Call is scheduled to be played within 15 minutes, 1 HBS SMS is
scheduled to be played within 10 minutes, and 1 HBS call to Voicemail is scheduled within 30 minutes.
The real time when the corresponding HBS Event is played depends on the SIM card availability (SIM card
registered and free of traffic), so it can be later than the scheduled time initially planned.

iQsim SA 2014

Understanding the HBS feature v1.00

Page 9/12

Once the corresponding HBS Event is played, it is removed from the list of Pending Events, and the next HBS
Event of the same type is created and scheduled on its turn. And so on in loop, as shown into the figure
below:

iQsim SA 2014

Understanding the HBS feature v1.00

Page 10/12

2.2 TEMPLATE #2
Template #2

nd

For this 2 template, the HBS Scenario settings are the following:

Range Time Simulation (mm and SMS): 60


Registered Real Time only (mn): ticked
Number of outbound calls: 4
Number of SMS to send: 6
Number of VoiceMail connection: 2
Randomly Decrease Range Time (%): 50

The Randomly Decrease Range Time setting is used here to make the HBS Event to be played in a less
predictive manner, based on a random period of time.
Here, it means that 50% additional events (so 2 more calls, 3 more SMS and 1 Call to the VoiceMail
more) could be randomly played within the same period of time.
Intermediately, it means that, compared to template #1 with configuration Randomly Decrease Range
st
Time = 0% , the 1 HBS events of each type could be played within a random period of time in advance
on theoretical calculated time.

For every SIM cards set with the SIM Plan for which this given HBS Scenario is selected, 1 HBS Event of each
type is created and scheduled with the formula: Range Time Simulation/ Number of events.
They are listed into Pending Events menu.
So, as shown into the figured below, 1 HBS Call is scheduled to be played within a random 10 to 15 minutes
time range, 1 HBS SMS is scheduled to be played within a random 6 minutes 36 seconds to 10 minutes time
range, and 1 HBS call to Voicemail is scheduled within a random 20 to 30 minutes time range.
The real time when the corresponding HBS Event is played depends on the SIM card availability (SIM card
registered and free of traffic, so it can be later than the scheduled time initially planned.

iQsim SA 2014

Understanding the HBS feature v1.00

Page 11/12

Once the corresponding HBS Event is played, it is removed from the list of Pending Events, and the next HBS
Event of the same type is created and scheduled on its turn. And so on in loop, as shown into the figure
below:

iQsim SA 2014

Understanding the HBS feature v1.00

Page 12/12