Ericsson MD110 and Topaz feature list

[Belinda Frick]

WARNING!
If you print this page the commands may be cut off the side of the page.
Ensure that line wrap is on.


Requirements:

Datatex software:

Topaz 1.7.5.4 (or later)
The update is available:
on the TOPAZ CD under the UPDATES folder or
on the internet, www.datatex -> downloads -> software updates -> topaz
PABX3 3.3.3.3 or newer
The update is available:
on the TOPAZ CD under the UPDATES folder or
on the internet, www.datatex -> downloads -> software updates -> topaz
PABX3 Plugin for the Ericsson MD110 version 2005.12.9.0 or newer
Available:
On the internet, www.datatex.co.za -> login -> topaz -> downloads -> ericsson.
The 'plg-ericssonmd110_format4_2-update-2006_8_16_0.exe'
will extract the dll file in the lib folder.
On the TOPAZ CD (version 1.7.7.1 or newer) in the folder PABX3 -> PROFILES -> LIB.
The PEricssonMD110_Format4_2.dll needs to be copied
to C:\Program Files\Datatex\Pabx3\Profiles\Lib.
Topaz Frontoffice Interface version 1.2.0.4 or newer
The update is available:
on the TOPAZ CD under the UPDATES folder or
on the internet, www.datatex -> downloads -> software updates -> topaz

The Ericsson PABX:

The MD110 must have 2 serial ports available to use.
(One for FrontOffice and one for PABX3)
The MD110 CIL output format must comply with the Datatex MD110 Format 4.2
(as described below)
MD110 with Software level 12.1 with Service Pack 7 or newer.
Additional patch: CLOP S105608A (If you are having missing CIL data)
A computer with 2 COM ports or 2 computers that are networked together.



1. How to setup the MD110 to work with Topaz.

NOTE!
These settings are required to be able to use Topaz, Ruby or Amethyst in
conjunction with the MD110.

The MD110 by default doesn't report incoming and outgoing line numbers.
With the following format all the line numbers and account codes are reported:


CLTGE;
CLOHE:FILE=CUSTOMER;
CLODE:FILE=CUSTOMER;

CLFOC:FORM=4,DATA=1-3M&2-4J&3-4P&4-1M&5-5K&6-1M&7-3X&8-2M&9-2I&10-1M&11-5A&12-3S&13-9T1&14-2M&15-9T2;
CLFOC:FORM=4,DATA=16-2M&17-14G&18-2M&19-10E&20-7D&21-6F&22-9T&23-10E1&24-10G1&25-10G2,APPEND=YES;

CLOHI:FILE=CUSTOMER,FORM=4,DMPSIZ=1,LOGABN=YES;
CLODI:FILE=CUSTOMER;

CLFOP;
CLTGI;


Ensure that the resolution is set to 1 second:

ASPAC:PARNUM=122,PARVAL=1;

This will ensure that the call duration is reported in Hour:Minute:Second notation.

2. How to retrieve the list of users from the MD110
and update Topaz with that information.

NOTE!
If Version 1.2.0.0 or newer of the Frontoffice interface and Topaz 1.7.5.6 are used, the extensions
and users will be updated automaticaly in Topaz. This means that your budgets needs to be assigned to
the correct users names as they appear on your PABX. The update file has to be selected in
Topaz -> Setup -> PABX -> User Detail Import.
The user details will be updated into Topaz every night at 00:00:00. A manual request is also possible.


3. How to setup Topaz to bar extensions and
account codes on the Ericsson MD110.

Installation Istructions:

3.1 TOPAZ:

TOPAZ must always be open and importing calls live.

Install Topaz as a normal installation.
Make sure that your budgeting is setup and working. (When a call is made, that the budget is updated.)
ALSO SEE: How to setup and use the Budget Facility in Topaz
ALSO SEE: How do I setup TOPAZ to import calls 'live'?
SETUP -> PROPERTIES -> NETWORK & FRONT OFFICE, please tick
TOPAZ on port 25000
PABX3 on port 25001
FRONTOFFICE on port 25002

3.2 FRONTOFFICE:

FrontOffice must always be open.

Leave all Front Office settings at default value, except for those listed below:

Make sure that the Frontoffice has a shortcut in the startup.
Go to 'Options' -> 'General':
select the 'ERICSSON MD110' as 'Communication format'.
(Restart the frontoffice after changing this option).
The 'User Output file' is were the user list from the PABX is written.
The 'Update Speed' must be set to '1'.
Do not set it to more than 9 or 10 seconds.
Enter your 'login' and 'password'
that would be used to access the programming interface of the MD110.
This option will only appear if you selected 'ERICSSON MD110' as 'Communication format'.
Go to 'Options' -> 'Communications':
un-tick 'Acknowledge'.
Tick 'Disconnect when idle'.
Make sure that the rest of the COM settings are correct.
Go to 'Options' -> 'Network':
Tick 'Network enabled' and
make sure the 'listen on port' is 25002.
Click on SAVE.

frontoffice.prf:
[NETWORK]
ENABLED=1
LOCALPORT=25002
TOPAZIP=127.0.0.1
TOPAZPORT=25000

Please note: To control the 'traffic' of bar/unbar commands, we
'queue' then and then send it to the PABX. Therefore you will experience
a delay of up to 10 minutes. This should not result in more than 1 or 2
calls made after the budget has been reached.

3.3 PABX3:

PABX3 must always be open and receiving calls 'live'.

Go to Options -> Network in the 'Remote Applications' section,
ensure that the 'Frontoffice' option is enabled.
'Frontoffice IP' points to the computer where the Topaz Frontoffice is running.
The default 'Port' is 25002.
Click on 'Save'.
Close PABX3.
Go to 'C:\Program Files\Datatex\Pabx3'.
Open the PABX.PRF (in the PABX3 folder) with Notepad and find the line marked as "[Accounts]".
If it doesn't exist, you must add it at the bottom of the file.
Now below this section, you can add all your account codes in the following format:

[Accounts]
3000=1234=1
4000=1111=8

Note: In the above example
3000 is the value given off by the PABX as the Account in TOPAZ and
1234 is the index and
1 is the class off service for this account.

Format of [Accounts] is CIL=AUTHCODE=CAT

The limits for the codes is as follows:
CIL is 6 digits
Auth code is 7 digits
CAT is 0 to 63.


The class of service is only used when the account code is added to the PABX.
The Account code is removed from the PABX when it is barred.

Open PABX3.

pabx3.prf:
[NETWORK]
ENABLED=1
LOCALPORT=25001
TOPAZIP=127.0.0.1
TOPAZPORT=25000
SENDRUBY=0
TCPPABX=0
TCPPABXConnect=0
TCPPABXPORT=123
TCPPABXIP=127.0.01
TCPPABXLogin=
TCPPABXPassword=
TCPAsterisk=0
TCPFrontOfficePORT=25002
TCPFrontOfficeIP=127.0.0.1
TCPFrontOffice=1


Usage:

When these features are all implemeneted correclty
the Frontoffice interface will be connected to the one comport of the PABX to program the
PABX.
The PABX3 will be connected to another port on the PABX to get the call records.
The CIL data will be passed to Topaz from PABX3.
Topaz will update the budgets
and once the budgets are exceeded, Topaz will instruct the PABX3 to bar the extension or account
code.
The PABX3 will generate the correct barring string, based on the plugin and send it to the
Frontoffice interface.

How do I check if the barring strings is being sent?
Unbar: Account
TOPAZ log entry: 2008-09-18 17:23:14.825 -> CGSendMessage(CG|ALLOW|ACC|3333|).
Sample of unbar string sent from TOPAZ to PABX3 on port 25001:
<-- 127.0.0.1:49533 CG|ALLOW|ACC|3333|
Front Office display under "Processed Data": ACC|3333|0003|9

Bar: Account
TOPAZ log entry: 2008-09-18 17:03:20.824 -> CGSendMessage(CG|DENY|ACC|3333|).
Sample of bar string sent from TOPAZ to PABX3 on port 25001:
<-- 127.0.0.1:49533 CG|DENY|ACC|3333|
Front Office display under "Processed Data": ACC|3333|0003|-1

Note that the bottom right-hand corner of PABX3 and TOPAZ will display the string received.

To test if you are receiving the above strings, you can use the UDPListen
program. It is available on request from support@datatex.co.za. Note that
the program receiving the string must be closed to listen on the port with
UDPListen. For example to test if TOPAZ is sending to PABX3, change the
PABX3 port in TOPAZ under NETWORK & FRONT OFFICE from 25001 to for example
to 25007 and listen on 25007 with UDPListen.