Missra Decoder Userguide Pod

#######################################################################
#
# D O C U M E N T A T I O N
#
# ( in POD format )
#
#######################################################################
# Make html doc with 'pod2html' like so:

# c:\>pod2html --title="MISSRA Mark Decoder User Guide" --header
--infile=missra_decoder_userguide_pod.txt --outfile=missra_decoder_userguide.html
=pod
=head1 MISSRA Mark Decoder
=head2 Download and update info
=begin html
<h3><a href="http://unix.epa.ericsson.se/~epajsb/tools/missra.zip">Download MISSRA

Mark Decoder (zip file) Version 3.0.5</a></h3>
<h4><a href="http://unix.epa.ericsson.se/~epajsb/tools/missra304.zip">Download old
MISSRA Mark Decoder (zip file) Version 3.0.4</a></h4>
=end html
If you are having difficulties installing or running this tool,

would like to report faults, would like to suggest improvements
or want an earlier version,
please contact James Baker (EPAJSB). james.baker@ericsson.com
You can also visit my web page http://unix.epa.ericsson.se/~epajsb/
=head2 New & Changed In This Release (version 3.0.5)
=over
=item *
Update for MSC MC-A 2 & 3 MISSRA mark format change
Changed from 2Mxxxxxxxxxxxxx & 3Mxxxxxxxxxxxxx
to M2xxxxxxxxxxxxx & M3xxxxxxxxxxxxx
=back
=head1 Summary
The MISSRA mark is used to accurately record the

software level of an AXE node. It is implemented using dummy corrections in
block MISSRA, whereby the CIs are an encoded record of the correction level.
MISSRA mark usage is defined for
=over 4
=item *
GSM/WCDMA Application Systems
=begin html
A full description of the MISSRA mark as implemented in the Core Network (Wireline
and GSM/WCDMA) can be found
in document
<A HREF="http://cdmweb.ericsson.se/WEBLINK/ViewDocs?DocumentName=EDD%2FXY-
04%3A0098&Latest=true">
EDD/XY-04:0098 Uen. </A>
=end html
This version of MISSRA Mark Decoder is based on rev AB of this document

plus recent changes to MCA mark for MSC nodes..
=item *
BSC Application Systems
=begin html
A full description of the MISSRA mark as implemented in BSC can be found in

document .
<A HREF="http://cdmweb.ericsson.se/WEBLINK/ViewDocs?DocumentName=EAB%2FRJT-
05%3A0262&Latest=true">
EAB/RJT-05:0262 Uen </A>
=end html
MISSRA Mark Decoder version 3.0.0 is based on rev Y of this document.
=item *
Wireline Application Systems
Advice from Wireline PLM was that MISSRA mark is not maintained in Wireline
systems.
MISSRA Mark Decoder does not handle Wireline MISSRA Mark
=back
The purpose of the MISSRA decoder tool is:
=over 4
=item *
to provide a quick and easy way to decode the MISSRA mark
=item *
to provide a quick and easy way to modify or make a new MISSRA mark
=back
=head2 Installation Guide

MISSRA Decoder comes as a zip file and may be downloaded from the Ericsson
intranet:
http://unix.epa.ericsson.se/~epajsb/tools/missra.zip
Make a directory where you want the tool to live. Use any path & name you like
(I will use c:\data\missra in this example).
Unzip the file into this directory. It should look like this:
=begin html
<xmp>
C:\data\missra\
| missra.exe
|
+---data
| debug.txt (NOTE: this file will be made at run time)
|
+---lib
| AutoUpdate.pm
| FunLib.pm
| missra splash.gif
| missra.pl
| missra_decode_cfg.txt
| missra_info_cfg.txt
| MissraDecode.pm
| missraico.ico
| upgrade.bat
|
|
\---docs
front_page.txt
missra_decoder_userguide.html
missra_decoder_userguide_pod.txt
</xmp>
=end html
B<IT IS VERY IMPORTANT THAT ALL FILES AND DIRECTORIES ARE PRESENT AS SHOWN>
=head3 Important Note
The first time you run MISSRA Mark Decoder, it may be slow to start up.
This is because it is building the cache. Please be patient.
If the application appears to hang, there are a couple of possible causes.
=over 4
=item 1
The cache has become corrupted.
This happens from time to time, I don't know why. I suspect that it can happen if
you
get impatient and kill the application before it has cached properly.
In this case, delete the cache directory and restart the tool. The cache directory
is:
"c:\Documents and Settings\<userid>\Local Settings\Temp\par-<userid>"
where: userid is your userid. I would use

"c:\Documents and Settings\epajsb\Local Settings\Temp\par-EPAJSB"
=item 2
The server is slow to respond at start up when the tool checks for updates.
Just be patient !!
=back
=head2 User Guide
=head3 Main Window
=over 4
=item 1
Use 'Load SWR' button to load a PCORP or SWR (SRH or INT format) OR
paste it in with ctrl-v. File contents will appear in this window.
Note: Only MISSRA part is actually required.
=item 2
Use 'Decode' button to decode the MISSRA mark.

The Result will be written into the GUI window
(i.e. PCORP or SWR is overwritten).
=item 3
Use 'Multi Decode from Folder' to decode more than one PCORP or SWR in one
operation. All the input files must be in one folder.
Results all written to this window. Useful for network audit.
=item 3
Use 'Save Result' button to save the result to file

(or cut and paste into a text editor).
=item 4
Use 'Modify' button to open up another window for modifying the

decoded MISSRA mark.
Note: Opening up the modify window WITHOUT decoding a MISSRA mark

will allow you to make a new MISSRA mark from scratch.
=item 5
Use 'Reset' button to clear the window ready to start again.
=item 6
Use 'Help' button to display this document.

=back
=head3 Modify Window
=over 4
=item 1
The decoded MISSRA mark will be displayed in the window when it is opened,
in the form of text entry boxes for the ACA, MCA, ECA & CN marks and
as rows of numbered buttons for the EPA, IPA, PMA & UPA marks.
=item 2
The numbers on the buttons are the package numbers for each package type.
So, if button '3' is depressed in the EPA section, that inticates that
EP-A 3 is loaded.
=item 3
To modify the MISSRA mark, make the required changes then click the
'Generate MISSRA Mark' button.
The new ASA code will be written into the main window, and the Modify
window will be closed.
You can repeat this process as many times as necessary.
=back
=head2 Input File Requirements
Input file must be one of the following.
=over 4
=item *
PCORP:BLOCK=MISSRA; (or PCORP:BLOCK=ALL;)
Note: The tool processes the whole PCORP, but only the
MISSRA part is actually required.
=item *
Software record, either in INTERNAL or SRH format.
Note: The tool processes the whole SWR, but only the
MISSRA part is actually required.
=back
=head1 ABOUT
MISSRA decoder version 3.0.5 released on 23 November 2010.
MISSRA decoder is written using Perl.

GUI implemented using Perl/Tk.
MISSRA is designed and written by James Baker (EPAJSB), james.baker@ericsson.com
=head1 Known BUGS
=over 4
=item 1
Decoding of Wireline MISSRA mark is NOT implemented. Advice is that

wireline are not updating the MISSRA mark in their systems.
No plans to include encoding of Wireline MISSRA mark unless requested.
=back
=head1 REVISION HISTORY
-------------------------------------------------------------------------
REVISION HISTORY (latest on top)
-------------------------------------------------------------------------
Rev User Date
Changes made
-------------------------------------------------------------------------
3.0.5 2011-11-23 James Baker (EPAJSB) james.baker@ericsson.com
Change to new format MC-A 2 & 3 for MSC
Change from 2Mxxxxxxxxxxxxx & 3Mxxxxxxxxxxxxx

to M2xxxxxxxxxxxxx and M3xxxxxxxxxxxxx
-------------------------------------------------------------------------
Update for MSC MC-A 2 & 3 MISSRA mark format change
Fault fix: wrong ASA addresses for some new mark generation cases
Fault Fix : Uselog info for decoding execution was missing
-------------------------------------------------------------------------
Fault Fix : New format MC-A not showing packages loaded in the report
Auto-update function updated to get rid of false error messages.
-------------------------------------------------------------------------
Fault Fix : New format MC-A not showing packages loaded in the report
-------------------------------------------------------------------------
Fault Fix : MSC release not printed in report
Fault Fix : New format MC-A found if CN mark present

-------------------------------------------------------------------------
Total re-write from scratch
Encoding of new marks works properly now
Full BSC mark decoding and encoding

- Flexible To marks (FMA and FTI)
- Market Packages
- Upgrade Mark
New format MSC MC-A mark decoding/encoding
-------------------------------------------------------------------------
Update for core networks to handle up to and including MSC R14.0 (MSS 6.0)
Update for BSC to handle up to and including R11B
-------------------------------------------------------------------------
Add strings for BENT reports at the end of the text report.
Fixed the Save Report button. Now it actually saves the report...
-------------------------------------------------------------------------
- trial version with special text strings included at the end for BENT
Info (redundant) in a single line so it can be copy/pasted

in the BENT report for base & target level.
Currently BENT asks for:

Application Version From: xxx
Application Version To: xxx
Application Correction From: xxx
Application Correction To: xxx
Example text added to the end of the report:
Text for BENT reports:

Application Version: R12.1 CNG0
Application correction: IPA: 1-11 EPA: 1,3,6-10,12-17,19-27
The last 2 lines can be cut & pasted direectly into the BENT report.
-------------------------------------------------------------------------
- bug fix
Fatal error in Modify window when decoding MSC R11 (and probably BSC too).
-------------------------------------------------------------------------
- Fault fix in module MissraDecode.pm :
Fix error too many characters in EPA & IPA marks.

Sub _EncodeXPA
line: my ($binary, $hex) = 0;
changed to: my ($binary, $hex) = '';
- Update module MissraDecode.pm for R13 (variable definitions)
- Update config files missra_info_cfg.txt & missra_aca_decode_cfg.txt:
Update for R13, according to:

MSC: EDD/XY-04:0098 Uen Rev N
BSC: EAB/RJT-05:0262 Uen Rev PG3
-------------------------------------------------------------------------
BSC MISSRA mark decoding

(Upgrade mark decoding for BSC not implemented yet)
'Modify' GUI updated to change depending on whether MSC or BSC.
Bug Fixes
---------
1.
When decoding from SRH format SWR, the market code can be wrong due
to may lines looking like the MCA and ECA marks.
Fix:
Only look at lines between the MISSRA header and the next block
(including the MISSRA header).
-------------------------------------------------------------------------
Encoding function implemented

CN decoding implemented
-------------------------------------------------------------------------

Andrew Doty (EANDDOT) andrew.doty@ericsson.com
First release.
Decoding functionality only operational.

Encoding functionality in progress.
Initial Coding - used modular format to make updates easier (in theory!)
This file ('missra.pl') contains:

- GUI definition & callbacks
- Uselog and auto update functions
- clean up GUI definitions
Module .\lib\MissraDecode.pm contains:

- main decoding program and related subroutines
- main encoding subroutine and related subroutines
Module .\lib\FunLib.pm contains generic functions used by

James & Andrew's other applications (dbcompare etc...)
Module .\lib\AutoUpdate.pm contains the Auto Update function.
-------------------------------------------------------------------------
=cut

Missra Decoder Userguide Pod

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Missra Decoder Userguide Pod

Hochgeladen von

Copyright:

Verfügbare Formate

#######################################################################

# Make html doc with 'pod2html' like so:

=head1 MISSRA Mark Decoder

=head2 Download and update info

<h3><a href="http://unix.epa.ericsson.se/~epajsb/tools/missra.zip">Download MISSRA

If you are having difficulties installing or running this tool,

You can also visit my web page http://unix.epa.ericsson.se/~epajsb/

=head2 New & Changed In This Release (version 3.0.5)

Update for MSC MC-A 2 & 3 MISSRA mark format change

Changed from 2Mxxxxxxxxxxxxx & 3Mxxxxxxxxxxxxx

to M2xxxxxxxxxxxxx & M3xxxxxxxxxxxxx

The MISSRA mark is used to accurately record the

MISSRA mark usage is defined for

This version of MISSRA Mark Decoder is based on rev AB of this document

BSC Application Systems

A full description of the MISSRA mark as implemented in BSC can be found in

MISSRA Mark Decoder version 3.0.0 is based on rev Y of this document.

Wireline Application Systems

The purpose of the MISSRA decoder tool is:

to provide a quick and easy way to decode the MISSRA mark

=head2 Installation Guide

=head3 Important Note

If the application appears to hang, there are a couple of possible causes.

The cache has become corrupted.

"c:\Documents and Settings\<userid>\Local Settings\Temp\par-<userid>"

where: userid is your userid. I would use

=head2 User Guide

=head3 Main Window

Use 'Decode' button to decode the MISSRA mark.

Use 'Save Result' button to save the result to file

Use 'Modify' button to open up another window for modifying the

Note: Opening up the modify window WITHOUT decoding a MISSRA mark

Use 'Reset' button to clear the window ready to start again.

Use 'Help' button to display this document.

=head3 Modify Window

You can repeat this process as many times as necessary.

=head2 Input File Requirements

Input file must be one of the following.

PCORP:BLOCK=MISSRA; (or PCORP:BLOCK=ALL;)

Software record, either in INTERNAL or SRH format.

MISSRA decoder version 3.0.5 released on 23 November 2010.

MISSRA decoder is written using Perl.

MISSRA is designed and written by James Baker (EPAJSB), james.baker@ericsson.com

=head1 Known BUGS

Decoding of Wireline MISSRA mark is NOT implemented. Advice is that

No plans to include encoding of Wireline MISSRA mark unless requested.

=head1 REVISION HISTORY

Change to new format MC-A 2 & 3 for MSC

Change from 2Mxxxxxxxxxxxxx & 3Mxxxxxxxxxxxxx

Update for MSC MC-A 2 & 3 MISSRA mark format change

Fault Fix : Uselog info for decoding execution was missing

Fault Fix : MSC release not printed in report

Fault Fix : New format MC-A found if CN mark present

Total re-write from scratch

Encoding of new marks works properly now

Full BSC mark decoding and encoding

New format MSC MC-A mark decoding/encoding

Update for BSC to handle up to and including R11B

2.1.3 2008-07-14 James Baker (EPAJSB) james.baker@ericsson.com

2.1.2 2008-07-07 James Baker (EPAJSB) james.baker@ericsson.com

Info (redundant) in a single line so it can be copy/pasted

Currently BENT asks for:

Example text added to the end of the report:

Text for BENT reports: