Sunteți pe pagina 1din 5

1 (5)

Prepared (also subject responsible if other) No.

Rob Larsson 1000-abc 123 45/1 Uen


Approved Checked Date Rev Reference

2014-03-09 A

Manual HPSDFOA Compare V0.0.2

1 General ............................................................................................. 1
2 HPSDFOAFILE info ........................................................................... 1
3 Revision Information .......................................................................... 1
4 Requirements .................................................................................... 2
5 Compatibility ...................................................................................... 2
6 Performance ...................................................................................... 2
7 Installing the tool ............................................................................... 2
8 Running the tool ................................................................................ 2
9 Error Types ....................................................................................... 4
10 Error Messages ................................................................................. 5
11 No Warranty ...................................................................................... 5
12 Feedback .......................................................................................... 5

1 General
This program compares two different HPSDFOA file outputs and printout any
difference to a result file

2 HPSDFOAFILE info
An AXE HLR has a built in function called ‘HLR File Output’. By use of the
command HGPFI (see the COD for syntax), all or part of the HLR subscriber data
base can be dumped out to a file. The file is a composite file named
HPSDFOAFILE. The file is binary and needs to be decoded to be readable. The
format and what data that is included in the file, can be found in the POD
HPSDFOAFILE for the corresponding SW release.

The size of the file depends on the number of subscribers, which data that is
requested to be outputted and also the amount of supplementary services per
subscribers, etc.

3 Revision Information
2 (5)
Prepared (also subject responsible if other) No.

Rob Larsson 1000-abc 123 45/1 Uen


Approved Checked Date Rev Reference

2014-03-09 A

V0.0.1 (Beta) First Beta Release

4 Requirements
 The tool runs on either 32/64 bit Windows

 The tool required that 'MSISDN' is used as command parameter in


HGPFI.

5 Compatibility
The program's decoding algorithm is according to the following PODs:

 12B - 1/190 83-CNT 238 0072 Uen Y

The tool should be backward compatible will all prevoius versions of the
POD, however it's not been verified.

6 Performance
Approx 500K subscribers records per minute (tested on i7-2600K). Speed could
very much vary depending on amount of data per subscriber.

7 Installing the tool


The decoder needs no installation. Simply put the EXE file on a unique directory
and run it.

8 Running the tool


Once per day the tool will ask if you would like to check for updates. Note here
that the updates are only accepted if requested within an Ericsson Domain! Once
a check is done successfully, you will reset the validation time back to zero. To
check for updates regularly avoids that the tool are forced to check for validation.
3 (5)
Prepared (also subject responsible if other) No.

Rob Larsson 1000-abc 123 45/1 Uen


Approved Checked Date Rev Reference

2014-03-09 A

If a newer version exists, you will be asked if you would like to update the current
version. The new version will be automatically replaced and used next time you
run the program. If for some reason the new version gets incompletely
downloaded, the original version will be stored as "OldExecutable.bak" on the
same directory as the executing version.

Figure 1. Program Layout.

HPSDFOA1/HPSDFOA2: Is the HPSDFOAFILE files that you would like to


compare.

Result File: Is the file that stores the detailed Error information.

Compare Red flag: Tick in this option if you want to check the consistency of the
RED (Redundant Flag). With this option, if both HPSDFOA files for the same
subscriber have no RED flag (RED-1) or both files have a RED flag, then it's
seen as an Error and outputted in the result flag.
4 (5)
Prepared (also subject responsible if other) No.

Rob Larsson 1000-abc 123 45/1 Uen


Approved Checked Date Rev Reference

2014-03-09 A

If this option is not ticked, if RED flag is found, it's simply removed before
checking the Subscriber Data (SUD).

Check Location Data: Tick in this option if you want to also compare the
Location Data for the subscribers. Note that as a live HLR Red pair always has a
few subscribers that are pending to be updated, there will always be a few
inconsistencies in the compare results.

Note that "Location Data" is in the SS Tag! E.G if you have a mismatch in VLR
data for a subscriber, the error output is "SS_MISMATCH".

Skip SS Data: Tick in this option if the tool should ignore errors in the
Supplementary Services. The reason to ignore this is the same as for the location
option.

Decode: Press this button to start the decoding and compare the files. During the
decoding you will see the number of subscriber records that have been decoded.
You will also see if the Error counter stepping if any faults found.

Stop: Should be self explanatory.

9 Error Types
The following Error Types can be presented in the result file.

MSISDN_MISSING: MSISDN is missing in the file indicated.

IMSI_ERROR: MSISDN-IMSI Error (same MSISDN has 2 different IMSIs)

AMSISDN_ERROR: The MSISDN has inconsistency either in missing AMSISDN


or different BC.

SUD_MISMATCH: The Permanent Subscriber Data (SUD) has a mismatch.

SS_MISMATCH: The Supplementary Services (SS) has a mismatch.

RED_MISSING: The MISISDN is defined as Primary in both HLR (only outputted


if the "Compare RED Flag" option is ticked in.

RED_DUBLICATE: The MISISDN is defined as Redundant in both HLR (only


outputted if the "Compare RED Flag" option is ticked in.
5 (5)
Prepared (also subject responsible if other) No.

Rob Larsson 1000-abc 123 45/1 Uen


Approved Checked Date Rev Reference

2014-03-09 A

Figure 1. Result file example

10 Error Messages
If a decoding error is detected, then a pop up window will inform what kind of fault
that was detected. The last decoded MSISDN will also be displayed. Depending
on the fault also some error messages might be written to the result file.

In case of a decoding error, please send the HPSDFOAFILE zipped to the email
below and I will update the program.

11 No Warranty
THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHOR
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

12 Feedback
Please send feedback, suggestions or comments to Rob Larsson.