Barring on the Ericsson BP250

[Belinda Frick]

Barring is done on extensions and account codes for the Ericsson BP250.

Required:

The Ericsson BP250/BP50 PABX unit and the PC:

BP 50 or a BP 250 Release 15
Ericsson CLI format must be set to "CLI Hotel 3".

PC with BMS 3.3 installed as a service.
Please note: This first time you connect please do so manually. Take note
of the connection time to use in the configuration of the

dtxEricssonService.ini:
ConnectionIntervalMinutes=5
SystemLoadTimeoutMinutes=10
This will be dependant on the 'size' of the system (aswell as the
processing speed of the PC it is running on), see explanation below:

ConnectionIntervalMinutes.
This is how often the Service will try and login to the BMS. Don't
make this to little as it takes a long time to login and you don't
want the service to be logged in most of the time, as it will lock
the port for remote access.
SystemLoadTimeoutMinutes=5
If the login process has started and it has not finished the loading
of the PBX information after 5 minutes, the Service will disconnect
and try again in "ConnectionIntervalMinutes" minutes. Try and login
manually first and time how long it takes for the full system load
to take. The SystemLoadTimeoutMinutes value needs to be more than
the time it takes to load the data other wise it will always time out
before the load is complete.

The PC must have 2 COM ports to run both TOPAZ and the BMS(if the BMS doesn't utilize a
network connection)
1 X TMS port setup for TOPAZ
1 X programming port
Extension barring:
The bar and unbar level(COS) used in TOPAZ must be setup on the PABX unit.
The bar and unbar level(COS) used in TOPAZ must work from the PABX unit.
The Ericsson technician can test this with the interface connected to the
Ericsson BP250 PABX unit.

Account Code barring (Virtual extensions):

On the TOPAZ CD in the docs\Topaz\Ericsson folder is a detailed WORD
document with screenshots explaining how to setup the account code barring.
See summary below:

The PABX must be set to use a portable class of service, to change the
facility cost on the extension.

While the trail license is running, create 100 mobile
extensions.
Give them fictive numbers. Use these numbers to do portable
COS.
Setup the rest of the extensions to only dial speed-dial
numbers. In other words create speed-dials to be used as account
codes.
Speed-dial overrides the barring, therefore need to change the
facility COS to block it.
Then program the string into a speed-dial number:
*72*pin code*extension#.
Set facility cost on trunks (this will allow dialing with
speed-dial, without using an account code to dial).

TOPAZ:
Extensions: version 1.5.0.4 or newer
Accounts: version 1.7.0.7 or newer
PABX3
PABX3 plugin: PEricssonBP_CIL3HotelFormat9V6R14.dll, version 2005.12.9.0 (or newer)
EriccsonService.exe
Available on the TOPAZ CD under the Ericsson folder. It installs in the PABX3 folder.

Install:

Note: If all applications in this install list runs on the same PC, please use 'IP 127.0.0.1'.
If you use 'IP 127.0.0.1' for an application, do not mix it with the use of the actual IP.
PABX3.

PABX3 must send call data live to TOPAZ:
IN '[PABX3 -> Options -> Network ]' Menu
Tick 'Network Enable'
Enter the TOPAZ IP under 'TOPAZ IP'.
Enter the TOPAZ port under 'Port'.
Ensure that the Listen on Port under 'TOPAZ Networking' section is set to 25101.

PABX3 must use the certified BP plugin with the standard output:
IN '[PABX3 -> Options -> File Paths ]' Menu
Select for 'PABX DLL' the 'PEricssonBP_CIL3HotelFormat9V6R14.dll' plugin.
See PABX3 Plugin: Ericsson BP settings to use Topaz.

TOPAZ.

Once PABX3 is receiving data and TOPAZ imports it, ensure that
the following is setup in TOPAZ:

TOPAZ must receive call data live from PABX3:

In [TOPAZ -> Setup' -> 'Properties' -> 'Network/FrontOffice'] in the 'Network' section.
for 'PABX3 Interface'
Enter the IP address of the Ericsson BMS PC as 'IP Address'.
Enter the PABX3 'port' number, the default is 25001. This must match what is
setup for LISTEN_PORT in the EricssonService.ini.
Tick 'enable'.for 'TOPAZ'
Enter the TOPAZ 'port' number, the default is 25000.
Tick 'enable'.
TEST: Make a test call and check in TOPAZ under ENQUIRIES if the call is
updated live.

Please note that you cannot use the normal check for 'live' data,
since we are using a different port in PABX3 to communicate with
the EricssonService (there needs communication between PABX3 and
TOPAZ for the information update). Therefore [TOPAZ -> Setup' -> 'Properties' -> 'PABX']
under the 'Get PABX' button, the information block will show "UNKNOWN".
ALSO SEE How do I update my TOPAZ calls live?.

The budget must be setup per user and linked to the Extension or Account code:

In '[TOPAZ -> DATA -> USERS]':
The User in TOPAZ must be linked to the Extension / Acount code.
If the user exceeds the budget the extension will be barred. Therefore
this setup is very important. Do this in [TOPAZ -> DATA -> USERS].
The extensions and account codes will be added automatically. You need to
add the user names and setup the budget for each user. For the Ericsson we
use the Ericsson service for barring on extensions only instead of TAPI.
The same budget setup is used. See, How do I setup and use the budget facility?.

In [TOPAZ -> Setup -> Filters and Defaults -> Budget Enabled]:
Once you have setup the budget and barring option (as explained in SSL document
refered to above), ensure that 'Buget Enabled' is ticked.

In [TOPAZ -> Setup -> Filters and Defaults -> CG Budget Type]:
Extensions: Select "E".
Account codes: Select "A".
TEST: Use one user to test with. Setup the budget for R1,00. Make a
test call. First step is that the budget must subtract the call cost from
the R1,00 budget. If so and the budget is exceeded, then the barring will
be triggered. Check in the TOPAZ.log file if the COS was sent to the
EricssonService for barring.

PABX3 and TOPAZ must be runnig with the configuration above. Only once this
is in place, proceed with installing the Ericsson Service and running it,
else it will not open port 25001.

The Datatex Ericsson Service.

Info
This service is written for the BMS web server V 3.1.0.6
on the Ericsson BP250/BP50 PABX. This service is specific to
this version of the BMS web server because of the format
of the commands.

Setup
The install file is named, dtxEricssonService-install-1.2.0.12.exe (or newer).

To install the service, double click on the exe to extract the files in
'C:\Program Files\Datatex\Topaz\'. Double-click on the install.bat file.

The installer will prompt you with the ini file next.
eg. dtxEricssonService.ini
[CONNECTION]
SERVER=127.0.0.1 //IP of the BMS web server
LISTEN_PORT=25001 //Port that Topaz is sending to
USERNAME=admin //User name for log-in
PASSWORD=default //Password for log-in
SYSTEMNAME=ERICSSON //System name that was configured on Pabx
ConnectionIntervalMinutes=10
SystemLoadTimeoutMinutes=5
[BARTYPE]
TCD=0

Save your changes and close the ini file and follow the instructions.

STOP and START the Ericsson Service. The service is listed as "ErcSrv" in
START -> CONTROL PANEL -> ADMINISTRATIVE TOOLS -> SERVICES.

It will create a log folder in the folder from where the service was run,
in this example 'C:\Program Files\Datatex\Topaz\'. The log file should have
an entry for starting the service.

dtxEricssonService.log:
[2008-08-07 19:14:49] Service Started.
[2008-08-07 19:14:49] Starting Cmmand Queue Timer
[2008-08-07 19:14:49] Service running

You can use the log file to see the communication with the BMS.

It will give a couple of "CONNECTION TIMEOUTS" until it finally connects.
Once connected you can also get a couple of "REFRESH" message before it
is active.

The installation is complete. Now make some test calls. Setup a budget of R1. Make
a phone call for this user. The budget must decrease (In TOPAZ -> DATA -> USER -> Budget).
Once negative TOPAZ.log will have a COS entry for sending the bar instruction to the
Ericsson Service. Check the dtxEricssonService.log for this entry. If present the BMS
must now bar this extension or 'account code' for this user.

Make sure that:

your Topaz is started up and
In [TOPAZ -> Setup' -> 'Properties' -> 'Network/FrontOffice'].
configured with the IP of the pc that the service is running on.
One of the settings on the left hand side will be 'PABX3 interface'.
Change the IP address to the pc that the ericsson service is running
on.
Make sure that the port numbers of Topaz and what was configured
in the service's ini file correspond.
Ericssonservice.ini:
LISTEN_PORT=25001 //Port that Topaz is sending to
This is the PABX3 port.
Make sure that the BMS server has been started and logged in.
Extension barring:
If TCD is false(0), then only field P0101 gets changed
Account Code barring:
If TCD is true(1), then fields P0103 and P0104 change to the new COS

Note: The 'SYSTEMNAME' cannot have spaces in it, it must be one word.

Unbar an extension/account code:

How do I unbar one extension in TOPAZ:

Log into TOPAZ with the "admin" login.
Select [DATA -> USERS]
Search for the user to unbar:
Enter the user name next to the "Find" button, click on find.
Change the "Available amount".
Click on "Reset Barlevel".
How do I unbar all extensions in TOPAZ:

Log into TOPAZ with the "admin" login.
Select [SETUP -> PROPERTIES -> FILTERS & DEFAULTS]
Click on "Reset All".