Professional Documents
Culture Documents
DATAGEN
GSM SOFTWARE RELEASE 7 HALF RATE
GSR7
Half Rate
68P02901W22-Q
GSR7 Half
68P02900W22-Q
SYSTEM INFORMATION
Rate
DATAGEN
GSM SOFTWARE RELEASE 7 HALF RATE
System Information: DataGen
09-Sep-2004
Table
of
Contents
Contents
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q i
09-Sep-2004
Contents
ii 68P02900W22-Q
09-Sep-2004
System Information: DataGen Contents
68P02900W22-Q iii
09-Sep-2004
Contents
iv 68P02900W22-Q
09-Sep-2004
System Information: DataGen Contents
68P02900W22-Q v
09-Sep-2004
Contents
vi 68P02900W22-Q
09-Sep-2004
System Information: DataGen Contents
68P02900W22-Q vii
09-Sep-2004
Contents
viii 68P02900W22-Q
09-Sep-2004
System Information: DataGen Contents
68P02900W22-Q ix
09-Sep-2004
Contents
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-33
Version upgrader (upg) command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-34
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-34
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-34
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-34
Command line options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-34
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35
Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35
Example of upgrading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35
Auto-upgrader command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-36
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-36
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-36
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-36
Command line options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-36
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-37
Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-37
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-37
Country administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-39
Introduction to country administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-39
The Command Line Interface (CLI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-39
Invoking xcadm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-40
Using the xcadm GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-40
The menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-41
Data fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-42
Action buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-42
CADM utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-43
x 68P02900W22-Q
09-Sep-2004
Contents
68P02900W22-Q xi
09-Sep-2004
Contents
xii 68P02900W22-Q
09-Sep-2004
List
of
Figures
List of Figures
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q xiii
09-Sep-2004
List of Figures
xiv 68P02900W22-Q
09-Sep-2004
List of Figures
68P02900W22-Q xv
09-Sep-2004
List of Figures
xvi 68P02900W22-Q
09-Sep-2004
List
of
Tables
List of Tables
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q xvii
09-Sep-2004
List of Tables
xviii 68P02900W22-Q
09-Sep-2004
About
This
Manual
The Offline MIB (OLM) can create new networks and visualise and validate networks before deployment into
a live network. It has a common User Interface (UI) with the online OMC. BSS binary files are used to create
the network which is displayed as a tree-like representation called the Navigation Tree.
In addition, the manual contains information on user and group management using the OMC Admintool. It
describes the procedures used for operating DataGen and associated administrative tasks. It also describes
the procedures used for operating the Offline MIB and provides information on command line tools and
Motorola Customer Data Format (MCDF) tables.
Information on performing Cell Xchange and Network Expansion from the Offline MIB is provided in the
manual Installation & Configuration: GSM System Configuration (68P02901W17) from GSR7.
Users should pay particular attention to any cautions given in this manual and follow the instructions exactly.
Failure to do so could result in problems running the software.
68P02900W22-Q 1
09-Sep-2004
Issue status of this manual
The following shows the issue status of this manual since it was first released.
Version information
The following table lists the versions of this manual in order of issue:
Manual
Date of issue Remarks
issue
C 31 May 1996 Issue C - Software Release 1.4.0.x
D 28 Mar 1997 Issue D - Software Release 1.4.1.x
E 29 Aug 1997 Issue E - GSM Software Release 2
F 27 Apr 1998 Issue F - GSM Software Release 3
G 12 Mar 1998 Issue G - GSM Software Release 4
H 14 Jul 2000 Issue H - GSM Software Release 4.1
J 31 Jul 2001 Issue J - GSM Software Release 5
K 30 Nov 2001 Issue K - GSM Software Release 5.1
L 30 Nov 2002 Issue L - GSM Software Release 6
M 02 May 2003 Issue M - GSM Software Release 6 (Horizon II)
P 13 Nov 2003 Issue P - GSM Software Release 7
Q 09 Sep 2004 Issue Q - GSM Software Release 7 Half-Rate
2 68P02900W22-Q
09-Sep-2004
Issue status of this manual
Service GMR
Remarks
Request Number
1079031 N/A Updated field width of Transcoding Capability in the
Hardware table. Refer to Chapter 6.
1100310 N/A Neighbour PBGT parameter added to MCDF Neighbour
table. Refer to Chapter 6.
1104262 N/A Added PCU as device name for nsei to MCDF Hardware
table. Refer to Chapter 6.
68P02900W22-Q 3
09-Sep-2004
General information
General information
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
• Motorola disclaims all liability whatsoever, implied or express, for any risk of damage, loss
or reduction in system performance arising directly or indirectly out of the failure of the
customer, or anyone acting on the customers behalf, to abide by the instructions, system
parameters or recommendations made in this manual
• If this manual was obtained when attending a Motorola training course, it will not be updated
or amended by Motorola. It is intended for TRAINING PURPOSES ONLY. If it was supplied
under normal operational circumstances, to support a major software release, then corrections
will be supplied automatically by Motorola in the form of General Manual Revisions (GMRs).
Purpose
Motorola cellular communications manuals are intended to instruct and assist personnel in the operation,
installation and maintenance of the Motorola cellular infrastructure equipment and ancillary devices. It is
recommended that all personnel engaged in such activities be properly trained by Motorola.
These manuals are not intended to replace the system and equipment training offered by Motorola, although
they can be used to supplement and enhance the knowledge gained through such training.
Feature references
Most of the manuals in the set, of which this manual is part, are revised to accommodate features released
at Motorola General System Releases (GSRn) or GPRS Support Node (GSNn) releases. In these manuals,
new and amended features are tagged to help users to assess the impact on installed networks. The tags are
the appropriate Motorola Roadmap DataBase (RDB) numbers or Research and Development Prioritization
(RDP) numbers. The tags include index references which are listed in the manual Index. The Index includes
the entry feature which is followed by a list of the RDB or RDP numbers for the released features, with
page references and hot links in electronic copy.
4 68P02900W22-Q
09-Sep-2004
General information
For a list of Roadmap numbers and the RDB or RDP numbers of the features included in this software
release, refer to the manualSystem Information: GSM Overview (68P02901W01), or to the manual System
Information: GPRS Overview (68P02903W01).
Cross references
Throughout this manual, references are made to external publications, chapter numbers and section names.
The references to external publications are shown in italics, chapter and section name cross references
are emphasised blue in text.
This manual is divided into uniquely identified and numbered chapters that, in turn, are divided into
sections. Sections are not numbered, but are individually named at the top of each page, and are listed in
the table of contents.
Data encryption
In order to avoid electronic eavesdropping, data passing between certain elements in the GSM and GPRS
network is encrypted. In order to comply with the export and import requirements of particular countries,
this encryption occurs at different levels as individually standardised, or may not be present at all in some
parts of the network in which it is normally implemented. The manual set, of which this manual is a part,
covers encryption as if fully implemented. Because the rules differ in individual countries, limitations
on the encryption included in the particular software being delivered, are covered in the Release Notes
that accompany the individual software release.
68P02900W22-Q 5
09-Sep-2004
General information
Text conventions
The following conventions are used in the Motorola cellular infrastructure manuals to represent keyboard
input text, screen output text and special key sequences.
Input
Characters typed in at the keyboard are shown like this.
Output
Messages, prompts, file listings, directories, utilities, and environmental
variables that appear on the screen are shown like this.
6 68P02900W22-Q
09-Sep-2004
Reporting safety issues
Whenever a safety issue arises, carry out the following procedure in all instances. Ensure that all site
personnel are familiar with this procedure.
Procedure
68P02900W22-Q 7
09-Sep-2004
Warnings and cautions
The following describes how warnings and cautions are used in this manual and in all manuals of this
Motorola manual set.
Warnings
Definition of Warning
A warning is used to alert the reader to possible hazards that could cause loss of life, physical injury, or ill
health. This includes hazards introduced during maintenance, for example, the use of adhesives and solvents,
as well as those inherent in the equipment.
Do not look directly into fibre optic cables or data in/out connectors. Laser
radiation can come from either the data in/out connectors or unterminated fibre
optic cables connected to data in/out connectors.
Observe all warnings during all phases of operation, installation and maintenance of the equipment described
in the Motorola manuals. Failure to comply with these warnings, or with specific warnings elsewhere in
the Motorola manuals, or on the equipment itself, violates safety standards of design, manufacture and
intended use of the equipment. Motorola assumes no liability for the customer’s failure to comply with
these requirements.
Cautions
8 68P02900W22-Q
09-Sep-2004
Warnings and cautions
Definition of Caution
A caution means that there is a possibility of damage to systems, software or individual items of equipment
within a system. However, this presents no danger to personnel.
Do not use test equipment that is beyond its due calibration date; arrange for
calibration to be carried out.
68P02900W22-Q 9
09-Sep-2004
General warnings
General warnings
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Observe the following specific warnings during all phases of operation, installation and maintenance of
the equipment described in the Motorola manuals:
• Electric shock.
• RF radiation.
• Laser radiation.
• Heavy equipment.
• Parts substitution.
• Battery supplies.
• Lithium batteries,
Failure to comply with these warnings, or with specific warnings elsewhere in the Motorola manuals, violates
safety standards of design, manufacture and intended use of the equipment. Motorola assumes no liability for
the customer’s failure to comply with these requirements.
Warning labels
Warnings particularly applicable to the equipment are positioned on the equipment. Personnel working with
or operating Motorola equipment must comply with any warning labels fitted to the equipment. Warning
labels must not be removed, painted over or obscured in any way.
Specific warnings
Specific warnings used throughout the GSM manual set are shown below, and will be incorporated into
procedures as applicable.
These must be observed by all personnel at all times when working with the equipment, as must any other
warnings given in text, in the illustrations and on the equipment.
10 68P02900W22-Q
09-Sep-2004
General warnings
This equipment operates from a potentially hazardous voltage of 230 V a.c. single
phase or 415 V a.c. three phase supply. To achieve isolation of the equipment from
the a.c. supply, the a.c. input isolator must be set to off and locked.
When working with electrical equipment, reference must be made to the Electricity at Work Regulations 1989
(UK), or to the relevant electricity at work legislation for the country in which the equipment is used.
Electric shock
Do not touch the victim with your bare hands until the electric circuit is broken.
Switch off. If this is not possible, protect yourself with dry insulating material and
pull or push the victim clear of the conductor.
ALWAYS send for trained first aid or medical assistance IMMEDIATELY.
In cases of low voltage electric shock (including public supply voltages), serious injuries and even death,
may result. Direct electrical contact can stun a casualty causing breathing, and even the heart, to stop. It
can also cause skin burns at the points of entry and exit of the current.
In the event of an electric shock it may be necessary to carry out artificial respiration. ALWAYS send for
trained first aid or medical assistance IMMEDIATELY.
If the casualty is also suffering from burns, flood the affected area with cold water to cool, until trained
first aid or medical assistance arrives.
68P02900W22-Q 11
09-Sep-2004
General warnings
RF radiation
Relevant standards (USA and EC), to which regard should be paid when working with RF equipment are:
• ANSI IEEE C95.1-1991, IEEE Standard for Safety Levels with Respect to Human Exposure to
Radio Frequency Electromagnetic Fields, 3 kHz to 300 GHz
• CENELEC 95 ENV 50166-2, Human Exposure to Electromagnetic Fields High Frequency (10
kHz to 300 GHz).
Laser radiation
Do not look directly into fibre optic cables or optical data in/out connectors. Laser
radiation can come from either the data in/out connectors or unterminated fibre
optic cables connected to data in/out connectors.
Lifting equipment
When dismantling heavy assemblies, or removing or replacing equipment, the competent responsible person
must ensure that adequate lifting facilities are available. Where provided, lifting frames must be used for
these operations. When equipment has to be manhandled, reference must be made to the Manual Handling
of Loads Regulations 1992 (UK) or to the relevant manual handling of loads legislation for the country in
which the equipment is used.
12 68P02900W22-Q
09-Sep-2004
General warnings
Parts substitution
Battery supplies
Do not wear earth straps when working with stand-by battery supplies. Use
only insulated tools.
Lithium batteries
Contact your local Motorola office for how to return defective lithium batteries.
68P02900W22-Q 13
09-Sep-2004
General cautions
General cautions
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Observe the following cautions during operation, installation and maintenance of the equipment described
in the Motorola manuals. Failure to comply with these cautions or with specific cautions elsewhere in the
Motorola manuals may result in damage to the equipment. Motorola assumes no liability for the customer’s
failure to comply with these requirements.
Caution labels
Personnel working with or operating Motorola equipment must comply with any caution labels fitted to the
equipment. Caution labels must not be removed, painted over or obscured in any way.
Specific cautions
Cautions particularly applicable to the equipment are positioned within the text of this manual. These must be
observed by all personnel at all times when working with the equipment, as must any other cautions given
in text, on the illustrations and on the equipment.
Fibre optics
Fibre optic cables must not be bent in a radius of less than 30 mm.
Static discharge
14 68P02900W22-Q
09-Sep-2004
Devices sensitive to static
Certain metal oxide semiconductor (MOS) devices embody in their design a thin layer of insulation that is
susceptible to damage from electrostatic charge. Such a charge applied to the leads of the device could
cause irreparable damage.
These charges can be built up on nylon overalls, by friction, by pushing the hands into high insulation packing
material or by use of unearthed soldering irons.
MOS devices are normally despatched from the manufacturers with the leads short circuited together, for
example, by metal foil eyelets, wire strapping, or by inserting the leads into conductive plastic foam. Provided
the leads are short circuited it is safe to handle the device.
In the event of one of these devices having to be replaced, observe the following precautions when handling
the replacement:
• Always wear an earth strap which must be connected to the electrostatic point (ESP) on the
equipment.
• Leave the short circuit on the leads until the last moment. It may be necessary to replace the
conductive foam by a piece of wire to enable the device to be fitted.
• Do not wear outer clothing made of nylon or similar man made material. A cotton overall
is preferable.
• If possible work on an earthed metal surface or anti-static mat. Wipe insulated plastic work
surfaces with an anti-static cloth before starting the operation.
• All metal tools should be used and when not in use they should be placed on an earthed surface.
• Take care when removing components connected to electrostatic sensitive devices. These
components may be providing protection to the device.
When mounted onto printed circuit boards (PCBs), MOS devices are normally less susceptible to electrostatic
damage. However PCBs should be handled with care, preferably by their edges and not by their tracks and
pins, they should be transferred directly from their packing to the equipment (or the other way around) and
never left exposed on the workbench.
68P02900W22-Q 15
09-Sep-2004
Motorola manual set
The Motorola manual sets provide the information needed to operate, install and maintain the Motorola
equipment. Manuals for the GSM, GPRS and UMTS products are available on the following media:
• Printed hard copy.
Each CD-ROM includes all manuals related to a specified main GSM, GPRS or UMTS software release,
together with current versions of appropriate hardware manuals, and has additional navigation facilities. A
snapshot copy of on-line documentation is also included, though it will not be updated in line with subsequent
point releases.
The CD-ROM does not include Release Notes or documentation supporting specialist products such as
MARS or COP.
Use the Motorola 68Pxxxxxxxx order (catalogue) number to order hard copy manuals or CD-ROMs.
All orders must be placed with your Motorola Local Office or Representative.
16 68P02900W22-Q
09-Sep-2004
GMR amendment
GMR amendment
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Changes to a manual that occur after the printing date are incorporated into the manual using General Manual
Revisions (GMRs). GMRs are issued to correct Motorola manuals as and when required. A GMR has the
same identity as the target manual. Each GMR is identified by a number in a sequence that starts at 01
for each manual at each issue.
GMR availability
• Printed hard copy - Complete replacement content or loose leaf pages with amendment list.
◦ Remove and replace pages in this manual, as detailed on the GMR instruction sheet.
GMR instructions
When a GMR is inserted in this manual, the amendment record below is completed to record the GMR.
Retain the instruction sheet that accompanies each GMR and insert it in a suitable place in this manual for
future reference.
68P02900W22-Q 17
09-Sep-2004
GMR amendment
18 68P02900W22-Q
09-Sep-2004
Chapter
1
Overview of DataGen
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q 1-1
09-Sep-2004
Overview of DataGen Chapter 1: Overview of DataGen
Overview of DataGen
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The DataGen tool provides the user with the capabilities for performing offline configuration management of
Motorola GSM network entities (NEs). It comprises a collection of software tools used to produce, edit and
update BSS databases. The database is a binary file containing details specific to a BSS and its configuration.
DataGen is a flexible tool that reduces the time and effort required to produce accurate BSS databases. The
concept is that of front office/back office data management system. The OMC (front office) incorporates the
live data on the GSM network entities and the back office (DataGen) incorporates the offline data. Changes to
the network can be carried out and verified through the Offline MIB (OLM) before deployment to the network.
Overview of DataGen
DataGen converts BSS binary database objects into a specific database format (Informix). The Informix
database contains the following information:
• A representation of the information required to create a SYSGEN script for all supported Base
Station System (BSS) Releases.
Included in this information are details relating to the syntax, parameters and their associated
range values for the Man Machine Interface (MMI) commands in the SYSGEN script.
• Configuration information for a specific BSS area. These areas are identified by
Country/Network, name, software release and configuration number. The configuration
number allows multiple versions to exist within the database.
DataGen functionality
DataGen consists of a suite of tools that operate on BSS databases (refer to Figure 1-1)
1-2 68P02900W22-Q
09-Sep-2004
System Information: DataGen Overview of DataGen
• Generate commands for the Operations and Maintenance Centre (OMC) to apply changes.
The Offline MIB (OLM) can create new networks, visualise and validate networks before deployment into a
live network. It has a common User Interface with the online OMC. The OLM front panel is accessed
from the DataGen main menu (refer to Figure 1-2).
BSS binary files are used to create the network which is displayed as a tree-like representation called the
Navigation Tree. It is possible to update multiple BSS binary files simultaneously, for example, propagating
neighbour changes from one BSS Binary file to another.
68P02900W22-Q 1-3
09-Sep-2004
Overview of DataGen Chapter 1: Overview of DataGen
DataGen and the Offline MIB work together in the following ways (refer to Figure 1-3):
• Binary database object files can be imported from the OMC.
• Multiple binary object files can be imported into the OLM and Radio Frequency planning
can be carried out.
1-4 68P02900W22-Q
09-Sep-2004
System Information: DataGen Overview of DataGen
#
#
$
! " #
#
#%
#
$%
&
$
DataGen and/or the OLM is implemented on either a Sun Ultra 5/10/60 or Sun Netra 440 platform. DataGen
and the OLM use many of the same software tools as the OMC-R, thus maximizing commonality between
the two systems. DataGen should be deployed on a shared Ethernet LAN with the OMC-R to facilitate
data interchange.
68P02900W22-Q 1-5
09-Sep-2004
Overview of DataGen Chapter 1: Overview of DataGen
Hardware
DataGen and the OLM is configured to run on a standalone processor with its own disk storage, tape drive
and CD-ROM drive. The system processor uses a Sun Ultra station which has, at a minimum, a 200 MHz
processor, with 512 Mbyte of RAM.
Software
DataGen and OLM is built around the industry-standard INFORMIX online database engine. This runs on top
of the Solaris UNIX Operating System. The user interface uses the OSF/Motif windowing system. DataGen
software is distributed on CD-ROM together with all third party products.
DataGen NMC
OMC-R
OSI
System
Server
1-6 68P02900W22-Q
09-Sep-2004
System Information: DataGen DataGen database structure
Introduction
DataGen is a collection of software tools used to produce, edit and update BSS databases.
BSS database
A BSS database contains many parameters which describe the configuration of the BSS hardware and
software. A BSS database can have two forms:
The code used by the BSS to convert the SYSGEN script into a binary object is ported to the Sun Ultra
Platform and generates a binary object which can be then downloaded to the OMC (refer to Figure 1-5).
For DataGen applications which are on the same Ethernet network as an OMC, the transfer of the new binary
object is initiated from the OMC using the load_db script. It is also possible for DataGen to access the
binary objects which are stored on the OMC. This allows binary objects which have been uploaded to be
imported into DataGen using Revgen.
68P02900W22-Q 1-7
09-Sep-2004
DataGen database structure Chapter 1: Overview of DataGen
"# "#
"$ $"$
&
!
!
% &
$
!
% "$
$
'
1-8 68P02900W22-Q
09-Sep-2004
System Information: DataGen Loading network information into DataGen
The process for loading network information into DataGen is illustrated in Figure 1-6. To load network
information and import existing input files into DataGen, perform the following steps:
2. Start up DataGen.
68P02900W22-Q 1-9
09-Sep-2004
Loading network information into DataGen Chapter 1: Overview of DataGen
!
The first task is to gather network configuration information for the network. This information is then used to
produce input files which can be read by DataGen. The input files may be entered directly into either
of two computer-based tools:
Both methods involve entering the information into a computer using a custom designed software package.
1-10 68P02900W22-Q
09-Sep-2004
System Information: DataGen Loading network information into DataGen
Figure 1-7 shows a graphical representation of the two methods for creating MCDF files.
DataGen
Network
Information
MCDF Files
MCDF
format
All DataGen input and output files are stored in an area called the DataGen Directory Structure (DDS).
The starting point of the DDS is the directory dg. The directories below dg are then named according to
the country and BSS area being stored.
A further (lower) directory level identifies the configuration number for the BSS area. This allows the storage
of more than one set of database information for each BSS area. The next level down contains the DataGen
input and output file directories. An example of the DataGen directory structure is shown in Figure 1-8.
Directories for DataGen MUST NOT be created manually. DataGen creates the
directories automatically, thus ensuring there are no syntax errors in the directory
names.
68P02900W22-Q 1-11
09-Sep-2004
Loading network information into DataGen Chapter 1: Overview of DataGen
! "# $
Main structure
Where: is:
country replaced by the name of the country.
bss replaced by the name of the base site.
N replaced by the configuration number.
For example:
$HOME/dg/UK/testbss/conf0
All directories must be created by DataGen for each BSS area. Users are strongly advised to leave the
directory creation to DataGen in order to avoid problems with capitalization.
1-12 68P02900W22-Q
09-Sep-2004
System Information: DataGen Loading network information into DataGen
Sub-structure
Inside the conf<N> directory there may be a number of other directories as follows:
The directories below the OLM are created when a user creates a new network configuration in the Offline
MIB, as in Figure 1-9. When a BSS or RXCDR is created, a copy of the binary object file in the Conf<N>
directory is placed in the network directory (refer to Figure 1-8).
Each network configuration can contain up to 128 binary object (.002) files. An example of one Offline
MIB network structure is displayed in Figure 1-10.
Network 2
68P02900W22-Q 1-13
09-Sep-2004
Loading network information into DataGen Chapter 1: Overview of DataGen
Main structure
Where: is:
network_configuration replaced by the network configuration
name which contains .002 files.
Supported platforms
DataGen is configured to run as a standalone processor with its own disk storage, tape drive and CD-ROM
drive. Table 1-1 and Table 1-2 list the hardware configurations supported.
Note that the same configuration is used for Clean Install and Upgrade platforms.
DataGen GSR7 Half Rate is supported on a new “Flexible Platform”. Customers may use any
Sun UltraSPARC machine, provided that it meets a minimum specification set by Motorola. For
more details, refer to Bulletin Number GSM_G_OMCR_050.
1-14 68P02900W22-Q
09-Sep-2004
Chapter
2
User and Group management using the
Admintool
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q 2-1
09-Sep-2004
User and Group management using the Admintool Chapter 2: User and Group management using the Admintool
This chapter describes the procedures required to add new users and groups to the DataGen processor using
the Admintool. The Admintool can be accessed through the Common Desktop Environment (CDE) Manager.
If DataGen is configured as a NIS client, user and group information must be configured on
the NIS server and should not be carried out on the DataGen processor. For details, refer to
Configuring DataGen as a NIS client in the System Administration Guide provided with
Software Release Notes: DataGen (68P02900W76).
The Common Desktop Environment (CDE) Manager provides a desktop environment which can be
customised on a per user basis. It reduces window clutter and provides a graphical front end to the UNIX file
system. It provides an industry standard desktop manager and is available for different SUN workstations. A
batch scheduler is also provided which allows the user to schedule cron jobs from the CDE.
The OMC Admin menu available from the CDE provides a Graphical User Interface (GUI) for performing
routine system administration tasks. It provides access from the front panel of the desktop to the different
SUN administration tools that support Solaris 8.
2-2 68P02900W22-Q
09-Sep-2004
System Information: DataGen User and Group management using the Admintool
Admintool - overview
Admintool is a GUI based utility which is used for managing DataGen users, Informix users and so on, on
the DataGen processor. The utility is run from the Common Desktop Environment (CDE). It can be used to
perform the following management tasks:
• Manage user accounts
• Manage groups
• Manage hosts
• Manage printers
• Manage software
When setting up new DataGen users, it is necessary to use the New DG User option in the OMC
Admin Tool Drawer as environment settings also need to be set up.
Do not use Admintool to create new DataGen users directly.
Procedure list
68P02900W22-Q 2-3
09-Sep-2004
DataGen User management using the Admintool Chapter 2: User and Group management using the Admintool
Admintool is a graphical user interface (GUI) that enables users to manage user accounts on a local system. A
user account enables a user to log on to a system and provides access to a home directory.
Before assigning users to specific groups, ensure that the groups first exist. Before adding user accounts, use
the Admintool to add any groups to which users will be assigned. Refer to "DataGen Group management
using the Admintool" on page 2-13 for more information.
2-4 68P02900W22-Q
09-Sep-2004
System Information: DataGen DataGen User management using the Admintool
• User ID (UID)
This specifies the unique number by which the operating system can identify a user. The
maximum value is 2147483647. It is recommended that UIDs be kept below
60000 to minimize the amount of software incompatibilities. Reserved UIDs
include 60001 (nobody) and 65534 (nobody4).
• Primary Group
This specifies a group ID number or group name that the operating system assigns to files
created by the user. Assuming the correct permissions are set, these files can
then be accessed by users in the same group. Group 10 (staff) is the default
primary group that is appropriate for most users.
• Comment
Enter the user name, as it is to be displayed on the Offline MIB standard GUI.
• Login Shell
This specifies a login shell (Bourne, Korn, or C-shell) for the user. Select Other to specify a
shell not in the list. It is recommended that the C-shell is used for DataGen purposes.
68P02900W22-Q 2-5
09-Sep-2004
DataGen User management using the Admintool Chapter 2: User and Group management using the Admintool
The password option specifies the means by which a user sets up a password. Password options are as follows:
• Cleared until first login
Users are prompted to set their password at initial
login.
• Account is locked
Account is locked. No user may access this account.
• Normal password
Displays the Set Password window, which allows a password
to be assigned to the account when adding the user.
Min Change, Max Change, Max Inactive, Expiration Date and Warning
data fields should NOT be used if the configuration of the DataGen machine
as a NIS client is intended.
• Warning (Optional)
Specifies when users will start receiving warning messages about their password expiring.
2-6 68P02900W22-Q
09-Sep-2004
System Information: DataGen DataGen User management using the Admintool
Other parameters
The following parameters are also available under the Admintool: Users option:
• Create Home directory
Specifies whether to automatically create the user’s home directory.
• Path
Specifies the path for the user’s home directory, for example, /home/omcadmin
or /usr/informix.
From the front panel of the CDE Desktop (Figure 2-1), click the Admin Tool icon (Figure 2-2). The
Admintool: Users window (Figure 2-4) is displayed.
Click the arrow above the Admin Tool icon to open the OMC Admin drawer.
68P02900W22-Q 2-7
09-Sep-2004
DataGen User management using the Admintool Chapter 2: User and Group management using the Admintool
The OMC Admin drawer provides access to the User Administration applications as in Figure 2-3. Click
the arrow again to close the OMC Admin drawer.
Figure 2-3 CDE Desktop Front Panel with open OMC Admin drawer
To display the user accounts for a particular system from the CDE Desktop, click the Admin Tool icon.
The Admintool: Users window (Figure 2-4) is displayed. The default view is a view of all users on the system.
To display information for a particular user, double click on a user name to open an Admintool: Modify
User window as shown in Figure 2-5.
2-8 68P02900W22-Q
09-Sep-2004
System Information: DataGen DataGen User management using the Admintool
68P02900W22-Q 2-9
09-Sep-2004
DataGen User management using the Admintool Chapter 2: User and Group management using the Admintool
4. Enter the required data into the User name, User ID, Primary Group, Comment, and
Secondary Groups (optional) data fields.
Refer to the section User management parameters earlier in this chapter for more
information about data fields. Multiple users may be set up in one Admintool:
Add User session.
5. Ensure that the login shell is set for the C shell option.
6. If the System Administrator has supplied a default password, ensure that the Password scroll
box is set to Normal Password; otherwise, set to Cleared until first login.
2-10 68P02900W22-Q
09-Sep-2004
System Information: DataGen DataGen User management using the Admintool
2. Select the User Account entry to be modified in the displayed Admintool: Users window
(see Figure 2-4).
3. Select Modify from the Edit menu to display the Admintool: Modify User window (as in
Figure 2-5).
6. Click OK.
68P02900W22-Q 2-11
09-Sep-2004
DataGen User management using the Admintool Chapter 2: User and Group management using the Admintool
Password aging may be set up using the Min Change, Max Change, Max
Inactive, Expiration Date and Warning fields. See the section User management
parameters earlier in this chapter for descriptions of each of these fields.
2-12 68P02900W22-Q
09-Sep-2004
System Information: DataGen DataGen Group management using the Admintool
Admintool is a GUI based utility which is used for managing groups on the DataGen processor. The utility is
run from the Common Desktop Environment (CDE). It is used to perform the following group management
tasks:
• Display group account information
• Add a group
• Delete a group
The Admintool: Groups option may be used to manage the group file on the local system.
Before assigning users to specific groups, ensure that the groups first exist. Before adding user accounts, use
the Admintool: Groups option to add any groups to which users will be assigned.
The following parameters are available under the Admintool: Add Group option:
• Group Name
Group Name specifies a name used by the system to identify a user’s group. A
group name contains lowercase alphabetical characters (a-z) and digits (0-9). A
group name can be 1 to 8 characters long.
• Group ID (GID)
Group ID specifies a group identification number used by the system to identify a user’s
primary group. The maximum value is 2147483647. To minimize the amount of
software incompatibilities, GIDs should be kept below 60000. Reserved GIDs
include 60002 (noaccess) and 65534 (nogroup).
68P02900W22-Q 2-13
09-Sep-2004
DataGen Group management using the Admintool Chapter 2: User and Group management using the Admintool
Group administration utilities are similar to user administration utilities (refer to "DataGen User
management using the Admintool" on page 2-4). From the front panel of the CDE Desktop (Figure 2-1),
click the Admin Tool icon (Figure 2-2). The Admintool: Users window (Figure 2-4) is then displayed with
File, Edit and Browse menus.
To display the group accounts for a particular system from the CDE Desktop, click the Admin Tool icon to
open the Admintool: Users window.
Select the Groups option from the Browse menu. The Admintool: Groups window is displayed as in
Figure 2-8.
Group options are defined in the section Group management parameters earlier in this chapter.
2-14 68P02900W22-Q
09-Sep-2004
System Information: DataGen DataGen Group management using the Admintool
Add a group
◦ Group ID
◦ Members List
3. Click OK.
The list of groups displayed in the Admintool: Groups window is updated to include the
new group.
4. Verify that the new group has been added by locating the new group in the Admintool:
Groups window.
68P02900W22-Q 2-15
09-Sep-2004
DataGen Group management using the Admintool Chapter 2: User and Group management using the Admintool
To modify group information such as adding and deleting members, perform the following steps:
1. Highlight the Group to be modified in the Admintool: Groups window.
4. Click OK.
5. Verify that the group has been modified by locating the group information in the Admintool:
Groups window.
Refer to the section Group management parameters earlier in this chapter for a description of
each field in the Admintool: Modify Group window.
2-16 68P02900W22-Q
09-Sep-2004
System Information: DataGen DataGen Group management using the Admintool
Delete a group
4. Click OK.
The selected group is deleted and the group information displayed in the Admintool: Groups
window is updated.
68P02900W22-Q 2-17
09-Sep-2004
DataGen Group management using the Admintool Chapter 2: User and Group management using the Admintool
2-18 68P02900W22-Q
09-Sep-2004
Chapter
3
Operating DataGen
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q 3-1
09-Sep-2004
Overview of operating DataGen Chapter 3: Operating DataGen
This chapter provides an introduction to the DataGen menu structure and a detailed view of the operational
sequences involved in running DataGen. It should be used in conjunction with Chapter 6 - MCDF Tables.
The information in this chapter is aimed primarily at new users of DataGen and the routines are set out in the
order in which they would normally be performed.
The functionality of DataGen revolves around an Informix database. To create this database from scratch
would be an unnecessary waste of existing resources. Therefore, it is assumed that the user will work with an
existing database and perform a variety of DataGen functions to generate a working database.
If the user has been successful in editing or creating new information in the database, then the database should
compile successfully and create a viable BSS script.
The following procedures for operating DataGen should be performed in the order in which they are listed:
1. "Importing existing CM database objects" on page 3-26
3-2 68P02900W22-Q
09-Sep-2004
System Information: DataGen Overview of operating DataGen
68P02900W22-Q 3-3
09-Sep-2004
Defining environment variables Chapter 3: Operating DataGen
Environment variables are variables that the shell or any other program can access in order to get information
unique to a specific user. Several environment variables can be created and used by DataGen.
Certain variables can be set from the DataGen main menu by using the ADMIN - Preferences option. Refer
to "Administration tasks" on page 3-11 for more details.
These standard C shell environment variables must be set up prior to running DataGen.
Two environment variables can be set up to allow users to decide at run time whether they want HEX
or DECIMAL representation.
DG_HEX_CELL_IDS determines in what format GSM cell ids are displayed.
DG_HEX_POINT_CODES determines in what format the elements opc and dpc are displayed. The
format applies to the MMI script and to MCDF.
The variables should be set to yes to display the values in HEX. This can be achieved using the following
commands in the C shell:
setenv DG_HEX_CELL_IDS yes
setenv DG_HEX_POINT_CODES yes
These variables can also be set from the DataGen main menu using the ADMIN - Preferences
option. Refer to "Administration tasks" on page 3-11 for more details.
3-4 68P02900W22-Q
09-Sep-2004
System Information: DataGen Defining environment variables
DG_VERSION_ORDER determines the ordering of the version list in both the Open and New BSS dialog
boxes. If this variable is not set, then DataGen displays the list in ascending order by default. To display the list
in descending order, set DG_VERSION_ORDER to YES by executing the following command in the C shell:
setenv DG_VERSION_ORDER yes
This feature is optional and allows the user greater flexibility in the allocation of time slots. If enabled, RSL
and RTF time slots are retained when modifying a binary object file. Otherwise, the default values are applied.
Retain time slot order equipage is enabled by default. If retaining the order is not required, then disabling this
function will give a significant performance improvement.
To enable time slot order equipage, enter the following command in the C shell:
setenv DG_AGGREGATE_ABIS yes
To disable time slot order equipage, enter the following command in the C shell:
setenv DG_AGGREGATE_ABIS no
This variable can also be set from the DataGen main menu using the ADMIN - Preferences
option. Refer to "Administration tasks" on page 3-11 for more details.
Revgen converts a binary object file into an Informix format. Revgen may be invoked by selecting the
Services option from the Services menu, or by selecting the Revgen button.
To automate the running of Revgen from the Service menu or Revgen button, enter the following command in
the C shell:
setenv DG_AUTO_REVGEN yes
To disable the automated running of Revgen from the Service menu or Revgen button, enter the following
command in the C shell:
setenv DG_AUTO_REVGEN no
68P02900W22-Q 3-5
09-Sep-2004
Defining environment variables Chapter 3: Operating DataGen
This variable can also be set from the DataGen main menu using the ADMIN - Preferences
option. Refer to "Administration tasks" on page 3-11 for details.
From the Service window, it is possible to import binary object files. The default directory path is /usr/omc.
The variable DG_IMPORT_PATH allows a user defined import path. If the variable is set and import object is
selected, then the DG_IMPORT_PATH is displayed, regardless of previous paths selected.
To define an import path, enter the following command in the C shell:
setenv DG_IMPORT_PATH <directory_path>
For example:
setenv DG_IMPORT_PATH /usr/omc/import
This variable can also be set from the DataGen main menu using the ADMIN - Preferences
option. Refer to "Administration tasks" on page 3-11 for more details.
The variable DG_EXPORT_PATH allows binary object files to be exported from the Service window
to an export directory.
To define an export directory, enter the following command in the C shell:
setenv DG_EXPORT_PATH <directory_path>
For example:
setenv DG_EXPORT_PATH /usr/omc/export
This variable can also be set from the DataGen main menu using the ADMIN - Preferences
option. Refer to "Administration tasks" on page 3-11 for more details.
3-6 68P02900W22-Q
09-Sep-2004
System Information: DataGen Defining environment variables
From the Service window it is possible to view MMI scripts and compilation logs. The variable DG_EDITOR
allows the user to define which editor to launch when viewing MMI scripts or compilation logs.
To define a text editor, enter the following command in the C shell:
setenv DG_EDITOR <text_editor>
Where: is:
text editor textedit or vi or xedit
This variable can also be set from the DataGen main menu using the ADMIN -
Preferences option. Refer to "Administration tasks" on page 3-11 for more details.
To define another editor other than three standard editors, refer to "Generating a database
script file" on page 3-76.
When accessing a BSS area that is already in use, a warning message is displayed allowing the opportunity
to unlock the area or cancel.
To automatically unlock the locked area without displaying the warning message, enter the following
command:
setenv DG_OVERRIDE_LOCK yes
To return to the default state and present the warning message when accessing a locked area, enter the
following command:
setenv DG_OVERRIDE_LOCK no
This variable can also be set from the DataGen main menu using the ADMIN - Preferences
option. Refer to "Administration tasks" on page 3-11 for more details.
From the Service window, it is possible to generate a database script file by clicking the MMI button or by
selecting the Generate Script option from the Service menu.
68P02900W22-Q 3-7
09-Sep-2004
Defining environment variables Chapter 3: Operating DataGen
By default, certain elements which are set to their default value are not output to the script.
To output all elements, whether default or not, run the following command:
setenv DG_ALL_CHG_ELEMENT yes
To return to the default state, enter the following command:
setenv DG_ALL_CHG_ELEMENT no
Setting the value to yes may result in compilation failures and should be used only to view
default values.
This variable can also be set from the DataGen main menu using the ADMIN - Preferences
option. Refer to "Administration tasks" on page 3-11 for more details.
3-8 68P02900W22-Q
09-Sep-2004
System Information: DataGen DataGen - startup and shutdown
DataGen has a comprehensive Graphical User Interface (GUI). It is accessed through a main window which
has seven menu options, providing complete DataGen functionality.
This section describes how to start DataGen, access the main window and shut down DataGen.
Startup
To start the DataGen GUI, open an Xterm window and enter the following command:
DataGen
The DataGen main menu is displayed as in Figure 3-1.
The following options can be selected from this menu: NEW, OPEN, UPG, COPY, DEL, DIFF, BATCH,
ADMIN, OLM, HELP, and EXIT. Refer to Table 3-1.
68P02900W22-Q 3-9
09-Sep-2004
DataGen - startup and shutdown Chapter 3: Operating DataGen
Select To
NEW Display windows where a new BSS area can be created.
OPEN Display windows where an existing BSS area can be viewed or
edited.
UPG Display windows where an existing BSS area can be upgraded to
a later version.
COPY Display windows where BSS areas can be copied.
DEL Display windows where an existing BSS area can be deleted.
DIFF Display windows where difference reports between sites and site
elements for BSS areas can be generated.
BATCH Display windows where multiple binary object files may be
Revgened, upgraded or compiled.
ADMIN Display windows where a range of Administration tasks may be
carried out for example Country administration.
OLM Display windows where an Offline MIB (OLM) can be launched.
RF planning and modifications to multiple BSS binary files can
be carried out.
HELP View the following Help message: ’For DataGen Help please
refer to the DataGen manual supplied, OLM On-Line
help is available via the OLM GUI’
EXIT Shut down DataGen.
Shutdown
DataGen can be shut down either from an Xterm window or from the main menu as follows:
Xterm
To shut down DataGen from an Xterm window, first close all DataGen windows. In the Xterm window from
which DataGen was started, run the following command:
exit
DataGen is then shut down and the main menu window is removed.
Main menu
To shut down DataGen from the main menu, select the EXIT option.
All open DataGen windows, including the main menu, are then removed and DataGen is shut down.
3-10 68P02900W22-Q
09-Sep-2004
System Information: DataGen Administration tasks
Administration tasks
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Overview of tasks
The following is a list of tasks that may be carried out by selecting the ADMIN option from the DataGen
main menu:
• Country Admin
This option allows a new country or network configuration to be created.
Refer to "Creating a new country/network" on page 3-27 for more details.
• Permissions
The DataGen user has a standard set of access permissions. This utility changes between
access permitted and access denied states.
• Defragment
To maximise free disk space, it is advisable to defragment or optimise the DataGen database.
• Logfile
Each task carried out within DataGen is monitored and the results are stored in
a logfile. This utility displays the logfile.
• Preferences
Several environment variables can be activated from within the Preferences menu. For
example, the default editor and import path for importing binary object files can be defined.
• Options
Once the binary option object files are copied from tape and uncompressed,
they may be installed by using this feature.
The following options are only available if the user is logged into the DataGen
processor as omcadmin: Permissions, Defragment and Options.
68P02900W22-Q 3-11
09-Sep-2004
Administration tasks Chapter 3: Operating DataGen
Changing permissions
To change or toggle access permissions for a user, carry out the following procedure:
1. Log on to the DataGen processor as omcadmin.
2. Start DataGen from an Xterm window and select ADMIN from the DataGen main menu.
(Refer to "DataGen - startup and shutdown" on page 3-9 for details.)
The Administration menu is displayed as shown in Figure 3-2.
3-12 68P02900W22-Q
09-Sep-2004
System Information: DataGen Administration tasks
Refer to the section on Viewing the log file for more details.
68P02900W22-Q 3-13
09-Sep-2004
Administration tasks Chapter 3: Operating DataGen
2. Start DataGen from an Xterm window and select ADMIN from the DataGen main menu.
(Refer to "DataGen - startup and shutdown" on page 3-9 for details.)
The Administration menu is displayed (refer to Figure 3-5).
After performing a defragmentation, exit the GUI and then re-open it to access
the previously created areas.
3-14 68P02900W22-Q
09-Sep-2004
System Information: DataGen Administration tasks
2. Start DataGen from an Xterm window and select the ADMIN option from the DataGen
main menu.
4. Enter Ctrl+C to exit the logfile and return to the Administration menu.
68P02900W22-Q 3-15
09-Sep-2004
Administration tasks Chapter 3: Operating DataGen
Customising parameters
From the Preferences menu, several different parameters can be customised. To view the preferences
available, run the following commands:
It is not essential to select any of these criteria. If they are not required, simply omit these
steps and DataGen applies default values.
1. Log on to the DataGen processor as omcadmin.
2. Start DataGen from an Xterm window and select ADMIN from the DataGen main menu.
(Refer to "DataGen - startup and shutdown" on page 3-9 for details.)
The Administration menu is displayed (as shown in Figure 3-5).
Several environment variables can be turned on from the Preferences window for the current
session.
3-16 68P02900W22-Q
09-Sep-2004
System Information: DataGen Administration tasks
4. Click the appropriate option buttons to enable the required environment variables. Refer to
"Defining environment variables" on page 3-4 for a detailed description.
Retain Timeslot Order equipage is enabled by default. This retains RSL and RTF
timeslots when modifying the binary file. If retaining the order is not required, then
disable this function to give a significant performance improvement.
textedit or vi or xedit.
If an alternative editor is available, enter the name of the text editor. Refer to
"Generating a database script file" on page 3-76 for details.
6. To define the import path when importing binary object files, enter the path in the Import
Path field.
7. To define a directory where the binary object files will be exported to, enter the path in
the Export Path field.
8. Click Save Defaults to save the settings. Click Close to return to the Administration menu.
9. To retain the standard DataGen default settings, shut down DataGen from an Xterm window
and restart DataGen. Refer to "DataGen - startup and shutdown" on page 3-9 for details.
68P02900W22-Q 3-17
09-Sep-2004
Administration tasks Chapter 3: Operating DataGen
The Option Object files must be copied from tape, uncompressed and stored in a directory on
the DataGen processor. Refer to the section Upgrade procedures in Software Release Notes:
DataGen (68P02900W76) for details.
To install Options Object files, run the following commands:
1. Log on to the DataGen processor as omcadmin.
2. Start DataGen from an Xterm window and select ADMIN from the DataGen main menu.
The Administration menu is displayed (as shown in Figure 3-5).
4. To locate the directory where the Options Object files are located, enter the path in the Filter
field and select the Filter button.
3-18 68P02900W22-Q
09-Sep-2004
System Information: DataGen Administration tasks
9. Click OK to continue. Refer to Viewing the log file for details on how to read the logfile.
68P02900W22-Q 3-19
09-Sep-2004
Database administration tasks Chapter 3: Operating DataGen
The usage script is designed to monitor file system and Informix database capacities. The omcadmin account
has control of the script. The usage script may be executed manually or as a cronjob.
If the usage script is executed as a cronjob, it must be re-started after any upgrade activity
has been carried out on DataGen.
To run the usage script as a cronjob, log on to the DataGen processor as omcadmin. Execute the following
command:
cd /usr/omc/DataGen/current/cron
To run the script, enter the following command:
crontab usage.cron
To check if the usage script has been activated as a cronjob, log on to the DataGen processor as omcadmin.
Execute the following command:
crontab -l
To run the usage script manually, log on to the DataGen processor as omcadmin. Execute the following
command:
cd /usr/omc/DataGen/current/cron
3-20 68P02900W22-Q
09-Sep-2004
System Information: DataGen Database administration tasks
If either the file system or the Informix database reach 85% capacity, the usage script sends a report to all open
DataGen sessions on the DataGen processor. If the error message “Broken Pipe" is received, then system
administration should be undertaken to protect DataGen integrity.
If the usage script is running as a cronjob, a check is performed every two hours.
It is possible to reload the Informix database and retain the current areas. This procedure deletes and then
recreates the tables within the DataGen Informix database (db_dg) that store the area data. Upon completion
of the procedure, it is necessary to run Revgen again for all areas.
68P02900W22-Q 3-21
09-Sep-2004
Database administration tasks Chapter 3: Operating DataGen
6. Enter the following commands to validate the tables and MCDF files:
cd /usr/omc/DataGen/current/bin
valid_load -o c_tables.dat
valid_load -o mcdf.dat
It is possible to destroy and recreate the DataGen Informix database (db_dg). This procedure should be carried
out if the procedure for Reloading the database above was not successful or when the data within the db_dg
database is no longer required and a new database needs to be created.
This procedure will permanently erase the dg_db Informix database and should
be used with caution.
3-22 68P02900W22-Q
09-Sep-2004
System Information: DataGen Database administration tasks
To drop and recreate the db_dg Informix database, carry out the following steps in this order:
1. Unload the OLM netwk_conf table.
68P02900W22-Q 3-23
09-Sep-2004
Database administration tasks Chapter 3: Operating DataGen
To drop and recreate the Informix database, use the following steps:
Where: is:
DataGen hostname name of the DataGen processor
4. Select Exit and in all subsequent menus to return to the Admin prompt.
3-24 68P02900W22-Q
09-Sep-2004
System Information: DataGen Database administration tasks
Where: is:
username name of the DataGen user
68P02900W22-Q 3-25
09-Sep-2004
Importing existing CM database objects Chapter 3: Operating DataGen
Overview
A Configuration Management (CM) database object is a binary format file. Until the development of
DataGen, it was only possible to create such a file by downloading an ASCII format script file into a BSC in
SYSGEN mode.
DataGen has the ability to convert script files into CM database objects and vice versa.
Procedure
Importing a CM database object comprises three separate routines, performed in a defined sequence:
3-26 68P02900W22-Q
09-Sep-2004
System Information: DataGen Creating a new country/network
Existing DataGen users with an earlier DataGen version can use this database to maintain previously created
country/network data. Refer to the section Restore procedures in Software Release Notes: DataGen
(68P02900W76) for information about restoring a database.
New DataGen users must create the required country/network data from the beginning. The procedure for
creating countries and networks in DataGen uses the Country Admin option which is obtained by selecting
ADMIN from the main menu.
Country Admin
To access the Country Admin option for a new country or network, start DataGen from an Xterm window
and select ADMIN from the DataGen main menu. The Administration menu is displayed (as shown
in Figure 3-5).
Select Country Admin from the Administration menu. The Country Administration window is displayed as
shown in Figure 3-9.
If the Country Admin option is already in use, a warning message is displayed. Click OK to return to the
Administration menu.
68P02900W22-Q 3-27
09-Sep-2004
Creating a new country/network Chapter 3: Operating DataGen
The Country Administration window (as in Figure 3-9) enables users to create, update, and edit Country and
Network Administration files as follows:
File menu
The user option is:
• Exit
Use the Exit option to exit from the Country Administration window.
Network menu
The user options are:
• Edit
Select to use GTE to edit the default Network Administration file.
• Generate
Select to generate a Network Administration file from the DataGen database.
• Update
Select to update the DataGen database with the default Network Administration file.
Country and Network menu options may be greyed out, according to which
operations are permitted at the time.
Country menu
The user options are:
• Edit
Select to use GTE to edit the default Country.
• Generate
Select to generate a Country Administration file from the DataGen database.
• Update
Select to update the DataGen database with the default Country Administration file.
For NEW users where no country.std file exists, select Generate from
the Country menu to automatically generate a country.std file in the
/omcadmin/dg/ADMIN/country directory. This also applies to the network.std
file.
3-28 68P02900W22-Q
09-Sep-2004
System Information: DataGen Creating a new country/network
Data fields
The user options are:
• Country File
Displays the default Country Administration file name when the CADM GUI
window is opened.
• Network File
Displays the default Network Administration file name when the CADM GUI
window is opened.
To create a new country using Country Admin option, perform the following steps:
1. Select the Edit option from the Country menu in the Country Administration window
(as in Figure 3-9).
The CADM Country File window shown in Figure 3-10 is displayed.
2. From the Edit menu in the CADM Country File window, select Insert.
Select Insert to display a submenu with Before entry and After entry options. These options
allow the new entry is to be placed before, or after, an existing entry in the displayed list of
countries (if existing).
3. Type the name of the new country, press the Tab key, and then type the MCC number
followed by CR.
68P02900W22-Q 3-29
09-Sep-2004
Creating a new country/network Chapter 3: Operating DataGen
4. Select Store in DDS from the File menu in the CADM Country File window.
5. Select Exit from the File menu to close the CADM Country File window.
6. In the Country Administration window, select Country - Update to save the updated Country
list in the Informix database.
A message window requesting confirmation is displayed as in Figure 3-11.
Editing a country
Once a country has been created, it can be edited using the Edit option from the Country menu on the
Country Administration window.
3-30 68P02900W22-Q
09-Sep-2004
System Information: DataGen Creating a new country/network
A new network entry is created and edited in the same way as a new country entry, using the same sequence of
steps.
1. Select Edit from the Network menu in the Country Administration window (as in Figure 3-9).
The CADM Network File window is displayed as in Figure 3-12.
2. Perform Step 2 as for Country, and enter the required data in the MNC, NCC, Network Name
and Operator Name data fields.
3. Select Store in DDS from the File menu in the CADM Network File window.
5. In the Country Administration window, select Network-Update to save the updated Network
data in the Informix database.
A message window requesting confirmation is displayed as in Figure 3-11.
68P02900W22-Q 3-31
09-Sep-2004
Deleting a country/network Chapter 3: Operating DataGen
Deleting a country/network
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
To delete a country using the Country Administration Tool, the associated BSS area(s) and network must
first be deleted.
The BSS area(s), network and country must be deleted in the following order:
1. BSS area(s)
2. Network
3. Country
To delete a BSS area(s), refer to the section "Deleting a BSS area" on page 3-42 for details.
After deleting the BSS areas(s), the network can then be deleted using the following steps:
1. From the DataGen main menu, select the ADMIN option.
7. From the File menu, select Exit to return to the Country Administration window.
8. From the Country Administration window, select Update from the Network menu.
A message window is displayed requesting confirmation of the update.
3-32 68P02900W22-Q
09-Sep-2004
System Information: DataGen Deleting a country/network
After the BSS areas(s) and its network have been deleted, the country can be deleted using the same sequence
of steps as described above for the network.
On the Country Administration window, select the Edit option from the Country menu and follow Step 4
to Step 9 above to delete the country.
68P02900W22-Q 3-33
09-Sep-2004
Creating a new BSS area Chapter 3: Operating DataGen
This section describes the New BSS Area window and the procedure for creating a new BSS area.
From the DataGen main menu, select NEW (refer to Figure 3-1). The New BSS Area window is displayed as
shown in Figure 3-13.
Country Name
The list of available countries is already present in the window. All other columns are blank at this time.
BSS Area
When a Country Name has been selected, any BSS areas currently configured for that country are displayed.
3-34 68P02900W22-Q
09-Sep-2004
System Information: DataGen Creating a new BSS area
Users can select an existing BSS area or else create a new BSS area by typing the name of the new BSS
area in the text box below the BSS Area column.
Software Version
Once a Country Name has been selected, the software versions available are listed in the Software Version
column. Select the appropriate software version.
Configuration No.
When the software version has been selected, the configuration numbers that already exist are listed in the
Configuration No. column. Three user options are available:
• Enter a new configuration number by typing the number in the text box below the
Configuration No. column.
Area Comment
The Area Comment data field allows users to add useful information or comments which are displayed every
time the BSS area is selected.
When all entries have been made, click Create. DataGen checks the entries and opens the Service Window.
Click Close to exit without creating a new BSS area.
68P02900W22-Q 3-35
09-Sep-2004
Creating a new BSS area Chapter 3: Operating DataGen
2. Click in the text box under the BSS Area column and enter the name of the new BSS area.
The name may have a maximum of 30 characters. If more than 30 characters are entered, a
warning window is displayed as Figure 3-14. Click OK to continue and then enter a BSS
Area name limited to the maximum length.
4. To obtain a configuration number automatically, do not select a number but skip ahead to Step 6.
5. Select a configuration number from the list or enter a number in the data field below the
Configuration No. list box.
If re-using an existing number, a confirmation window is displayed as in Figure 3-15.
3-36 68P02900W22-Q
09-Sep-2004
System Information: DataGen Creating a new BSS area
Click OK to overwrite the existing BSS area or Cancel to return to the New BSS Area window,
and re-enter an alternative number.
The Service window remains open on the DataGen desktop, allowing the user to carry out
most of the remaining DataGen functions.
The Area Comment data field allows the user to add useful comments which are displayed
each time the BSS area is selected.
Note that the Service window shown here has two of the toolbar icons greyed out (these
functions will become available at a later stage). The following section describes the layout
and functionality of the Service window.
68P02900W22-Q 3-37
09-Sep-2004
Opening a BSS area Chapter 3: Operating DataGen
To open an existing BSS area from the DataGen Main window, use the following steps:
1. From the DataGen main menu, select Open.
The Open BSS Area is displayed as shown in Figure 3-17.
2. Select a country from the Country Name list in the Open BSS area window.
3-38 68P02900W22-Q
09-Sep-2004
System Information: DataGen Opening a BSS area
6. Click Open.
After a short delay, the Service window is displayed. Refer to "The Service window" on
page 3-62 for details. The Service window provides options which enable users to view and
edit DataGen input files.
If the BSS area is locked by another user, an information window is displayed as shown in
Figure 3-18.
7. Click OK to override the lock or Cancel to return to the Open BSS Area window.
Information on the user holding the lock may be found in the DataGen.log file.
Refer to "Administration tasks" on page 3-11 for details.
68P02900W22-Q 3-39
09-Sep-2004
Copying a BSS area Chapter 3: Operating DataGen
The Copy function allows a BSS area to be copied to a new area with a new or specified configuration
number. To aid traceability when an area is copied, a default area comment is inserted identifying where the
area was copied from.
To copy a BSS area, carry out the following procedure:
1. From the DataGen main menu, select Copy.
The Copy BSS Area window is displayed as in Figure 3-19.
6. Enter the name of new BSS area in the field below the Target BSS list.
To overwrite an existing BSS area, select the BSS area from the Target BSS list.
3-40 68P02900W22-Q
09-Sep-2004
System Information: DataGen Copying a BSS area
7. Enter a configuration number in the field below the Target Config list.
If the number already exists, DataGen assigns the next available number.
Where: is:
BSS area name of the original BSS
area
Configuration No configuration number of
the original BSS area
All columns in the Table Controller window for the new area are blank because the
structure is copied but not the input tables.
68P02900W22-Q 3-41
09-Sep-2004
Deleting a BSS area Chapter 3: Operating DataGen
2. Select a country from the Country Name list in the Delete BSS Area window.
3-42 68P02900W22-Q
09-Sep-2004
System Information: DataGen Deleting a BSS area
It is possible to return the DataGen main menu while the delete process is running.
If the same BSS area is selected, the following message is displayed:
This area is already being deleted.
When the BSS area is deleted, a second information window displays the name of the
deleted BSS area.
68P02900W22-Q 3-43
09-Sep-2004
Configuring BSS area(s) Chapter 3: Operating DataGen
• Expansion of the basic BSS and its TS by the addition of another Basic Transceiver Site (BTS)
For information about the Motorola Customer Data Format (MCDF) tables referenced in this section, refer
to Chapter 6 - MCDF Tables which comprises a complete list of all the DataGen MCDF tables, including
parameter values and ranges.
Explanation of terms
BSS area
The BSS area means both the GSM Base Station System (BSS) and the GSM Remote Transcoder (RXCDR).
These two sub-systems run the same software.
Each Configuration or Equip function for a BSS uses a MCDF table that is populated with parameters which
may be generic or specified by the user. Table 3-2 lists these functions and their equivalent MCDF table(s).
3-44 68P02900W22-Q
09-Sep-2004
System Information: DataGen Configuring BSS area(s)
68P02900W22-Q 3-45
09-Sep-2004
Creating and configuring a basic BSS with a TS switch Chapter 3: Operating DataGen
Overview
This section describes the procedure for configuring a basic BSS, as shown in Figure 3-22. In this example,
the new basic BSS has a Base Site Controller (BSC) and one Base Transceiver Site (BTS) connected through
a Timeslot (TS) switch.
Preparation
Before configuring the basic BSS, start DataGen and create a new BSS area. Refer to the procedure
"Creating a new BSS area" on page 3-34 for more information.
3-46 68P02900W22-Q
09-Sep-2004
System Information: DataGen Creating and configuring a basic BSS with a TS switch
Once the new BSS area has been created, DataGen checks the entries and opens the Service window as in
Figure 3-23. For more information about the Service window, refer to "The Service window" on page 3-62.
Select Table Control from the Services menu to display a basic Table Controller window (as in Figure 3-24).
This window enables the user to configure a BSS table for the new BSS area. Refer to the section "Using the
Table Controller" on page 3-83 for more information.
Initially, only the BSS file is displayed by the Table Controller (as in Figure 3-24). The remaining
MCDF files are not displayed until the BSS area is defined and the edited bss.mcd file is stored
in the DDS.
68P02900W22-Q 3-47
09-Sep-2004
Creating and configuring a basic BSS with a TS switch Chapter 3: Operating DataGen
To open and configure a new (blank) BSS table, perform the following steps:
1. Select the BSS button in the Table Controller window.
2. Select the File button to open a blank BSS table (bss.mcd) window (as in Figure 3-25).
3. The BSS area data is shown in the first four data fields: Country, BSS Name, Software
Version Desired and BSS ID.
4. Enter the appropriate data in each VALUE field. Refer to BSS table in Chapter 6, MCDF
Tables for more information on the permitted values and ranges.
The BSS Serial value continues to show NOT YET AVAILABLE until a later
DataGen version.
5. When all the required data has been entered, move the cursor to the first RANGE field, then
open the File menu and select Store in DDS.
6. Select Exit from the File menu to close the BSS window and return to the Table Controller
window.
3-48 68P02900W22-Q
09-Sep-2004
System Information: DataGen Creating and configuring a basic BSS with a TS switch
7. Click Validate. A message window displays the following information: Filtering of file(s)
has completed. Close the message window.
8. Select the BSS and click Insert. A message window displays the following information:
Filtering of file(s) was successful database has been updated. Close the message window.
68P02900W22-Q 3-49
09-Sep-2004
Creating and configuring a basic BSS with a TS switch Chapter 3: Operating DataGen
The Table Controller window now displays check boxes for each MCDF file as in Figure 3-26
and Figure 3-27.
3-50 68P02900W22-Q
09-Sep-2004
System Information: DataGen Creating and configuring a basic BSS with a TS switch
9. To configure the parameters for the MCDF tables, continue to the next section.
The procedure for entering configuration parameters for the remaining tables is the same for each table.
The parameters for the following tables may be left blank, and if so, will assume default values (assigned
by the DataGen processor):
• Generics table
• Timer table
• Statistics table
• Specifics table
• Throttles table
68P02900W22-Q 3-51
09-Sep-2004
Creating and configuring a basic BSS with a TS switch Chapter 3: Operating DataGen
Alternatively, users can manually assign their own parameter values to the above tables, using the values
and their ranges for these tables given in Chapter 6 - MCDF Tables.
Configuration procedure
To configure an MCDF table, perform the following steps:
1. Select the MCDF check boxes in the Table Controller window in the order of their appearance
(see Figure 3-26). Once the MCDF table is selected, click the File button to display a blank
<filename.mcd> table.
2. Place the cursor in the top left-hand data field and enter the appropriate value. Refer to Chapter
6 - MCDF Tables for information on table values and their ranges.
3. Continue to enter data until all the relevant data fields have been edited, then move the
cursor back to the first data field.
4. Open the File menu and select the Store in DDS option to store the data.
5. Select Exit from the File menu to close the edited MCDF table.
6. Clear the current MCDF check box in the Table Controller window and select the next required
MCDF check box to display the next <filename.mcd> table.
7. Repeat Step 2 to Step 6 until all required MCDF tables have been edited. Then perform
the next procedure.
3. Close the message window, then open the Select menu again. Choose the Select All Files
option, then click Insert.
The MCDF Files being inserted are displayed in a message window. A second window
then displays the message:
Filtering of file(s) was successful database has been updated
3-52 68P02900W22-Q
09-Sep-2004
System Information: DataGen Creating and configuring a basic BSS with a TS switch
The dashes and crosses under the File, Validate, and Insert buttons in the Table
Controller window are replaced by a tick for each MCDF file successfully
processed.
5. To confirm that the BSS configuration is as expected, select the Topology icon in the Service
window or the Topology option from the Services menu in the Services window to display
the configuration. (Refer to the section "Using the Topology Viewer" on page 3-109
for more information).
68P02900W22-Q 3-53
09-Sep-2004
Basic BSS with TS switch - Expansion Chapter 3: Operating DataGen
Overview
This section describes the procedures used to add another BTS site to the basic BSS described in the previous
section. To expand the basic network, it is necessary to modify the following MCDF tables:
• The bss.mcd table (Site table)
• From the Table Controller window, open each of the tables listed above in turn and modify
their contents.
• Save the file in the DDS, then validate and insert the files.
• Open a Topology window to check that the additional site has been added by the system.
3-54 68P02900W22-Q
09-Sep-2004
System Information: DataGen Basic BSS with TS switch - Expansion
To copy an existing BSS area (such as the Basic BSS in the previous section), perform the following steps:
A BSS area may be copied by selecting Copy from the DataGen main menu. Refer to "Copying
a BSS area" on page 3-40 for details.
1. Open an Xterm window, and enter the command: DGAdmin to obtain the DGAdmin prompt.
2. Copy an existing BSS area to a new BSS area having the same <BSS Area name> but with a
different <config> number by executing the following command in the Xterm window:
ca -source <country name>:<BSS area name>:<configuration
number> [-area <new BSS area name> [-id <new BSS area id>]]
[-config <new configuration number>] [-title <new configuration
title string>]
For example:
ca -source Austria:Area1600:17 -area Area1600 -config 18
A message similar to the following is displayed:
New area successfully copied
Country: Austria
BSS Area name: Area1600
Configuration Number: 18
The BSS area to be copied should be the BSS area that was built using the
procedure in the previous section.
3. Select Open from the DataGen main menu to display a BSS Area window.
The list of available countries is displayed.
4. Select the Country Name of the new BSS area. Then select the new BSS Area name to
display a list of software versions.
5. Select the correct Software Version and the new Configuration Number in the list boxes.
6. Click the Open button. DataGen then checks the entries and opens a Service window for
the new BSS area. For more information about the Service window, refer to "The Service
window" on page 3-62.
68P02900W22-Q 3-55
09-Sep-2004
Basic BSS with TS switch - Expansion Chapter 3: Operating DataGen
The procedure for entering reconfiguration parameters in the tables so as to expand the basic BSS is the same
for each table. The tables to be modified are listed in the overview of this section.
2. Select a <filename> check box, then click the File button in the Table Controller window to
display the <Filename.mcd> table window.
If new columns need to be added before the data can be modified, go to Step 3; otherwise
go to Step 5.
3. Highlight the top right-hand cell of the table, then select Insert from the Edit menu. Select
After entry from the submenu displayed to add another column to the table.
5. Enter the appropriate values in the data fields. Use the Return key to step to the next data
field. Refer to Chapter 6 - MCDF tables for information about values and ranges.
Continue to enter data until all the relevant data fields have been edited.
6. In the window which has been edited, open the File menu and select the Store in DDS option.
7. Select Exit from the File menu to close the edited MCDF table.
8. Clear the current <filename> check box in the Table Controller window and then select
the next required <Filename> check box.
9. Repeat Step 2 to Step 8 until all the relevant MCDF Tables have been edited. Then carry
out the MCDF table(s) insert and validate procedure as detailed in the previous section
"Creating and configuring a basic BSS with a TS switch" on page 3-46.
To confirm that the BSS configuration is as expected, select the Topology icon in the Service window or the
Topology option from the Services menu in the Service window to display the configuration. (Refer to the
section "Using the Topology Viewer" on page 3-109 for more information).
3-56 68P02900W22-Q
09-Sep-2004
System Information: DataGen Basic BSS with TS switch - Expansion
Figure 3-28 shows the topology of the new BSS area with the additional site added.
68P02900W22-Q 3-57
09-Sep-2004
Daisy Chain configuration with TS switch Chapter 3: Operating DataGen
This section describes the procedures used to reconfigure the expanded basic network as a Daisy Chain.
The following procedures are necessary:
• Copy an existing BSS area and assign a different configuration number to the copied BSS area.
• From the Table Controller window, open each of the tables listed above in turn and modify
their contents.
• Save the file in the DDS, then validate and insert the files.
• Open a Topology window to check that the additional site has been added by the system.
Preparation
To configure a BSS area as a Daisy Chain, it is easier to use an existing BSS area (such as the expanded
BSS configuration or another similar existing BSS configuration) by copying the area and then assigning a
different configuration number to the copied BSS area.
A BSS area may be copied using the procedure outlined in the section Basic BSS with TS switch - Expansion
or by selecting Copy from the DataGen Main menu. Refer to "Copying a BSS area" on page 3-40 for details.
Once the BSS area has been copied, select Open from the DataGen main menu to display the BSS Area
window.
The list of available countries is displayed. Select the following: Country Name, BSS Area Name, Software
Version and enter the new configuration number. Click the Open button. DataGen then checks the entries and
opens a Service window for the new BSS area. For more information about the Service window, refer to
"The Service window" on page 3-62.
3-58 68P02900W22-Q
09-Sep-2004
System Information: DataGen Daisy Chain configuration with TS switch
This procedure is used to modify MCDF tables in order to reconfigure (as a Daisy Chain) the copied version
of the expanded BSS (or another BSS version). The files to be modified are:
• The link.mcd table
• Select Table Controller to open a Table Controller window. Refer to the section "Using the
Table Controller" on page 3-83 for more information.
Links table
To modify the Links table:
1. Select the Link check box, then select the File button in the Table Controller window to
display the <link.mcd> table window.
2. Use the cursor to highlight column 3, then open the Edit menu and select Delete to delete
the highlighted column.
3. Starting at the top of column 2 in the MCDF table window, change the data in each data field
as required. For more information about values and ranges, refer to the Links table in
Chapter 6 - MCDF tables.
4. Continue to enter data until all the relevant fields have been edited, then move the cursor
away from the edited data fields.
5. Open the File menu and select the Store in DDS option. Select Exit from the File menu
to close the edited MCDF table.
68P02900W22-Q 3-59
09-Sep-2004
Daisy Chain configuration with TS switch Chapter 3: Operating DataGen
Paths table
To modify the Paths table:
1. Clear the check box in the Table Controller window, and select the Path button to display
the <path.mcd>table.
2. Use the cursor to highlight column 3, then select the Edit menu and choose Delete to delete
the highlighted column.
3. Starting at the top of column 2 in the Paths table window, change the data in each data field
each data field as required. For more information about values and ranges, refer to the
Paths table in Chapter 6 - MCDF tables.
4. Continue to enter data until all the relevant data fields have been edited, then move the
cursor away from the edited data fields.
5. Open the File menu and select the Store in DDS option. Select Exit from the File menu
to close the edited MCDF table.
LAPD table
To modify the LAPD table:
1. Clear the Paths check box in the Table Controller window and select the Lapd button to
display the <lapd.mcd> table.
2. Use the cursor to highlight column 4, then select the Edit menu and choose Delete to delete
the highlighted column.
3. Starting at the top of column 3 in the Lapd table window, change the data in each data field
as required. For more information about values and ranges, refer to the LAPD table in
Chapter 6 - MCDF tables.
4. Continue to enter data until all the relevant data fields have been edited, then using the Return
key, move the cursor away from the edited data fields.
5. Open the File menu and select the Store in DDS option. Select Exit from the File menu
to close the edited MCDF table.
3-60 68P02900W22-Q
09-Sep-2004
System Information: DataGen Daisy Chain configuration with TS switch
Cell table
To modify the Cell table:
1. Clear the Lapd check box in the Table Controller window and select the RTF button
to display the <rtf.mcd> table.
2. Change the data in each data field in the row Primary Path ID as required. For more
information about values and ranges, refer to the RTF table in Chapter 6 - MCDF tables.
3. Continue to enter data until all the relevant data fields have been edited, then move the
cursor away from the edited data fields.
4. Open the File menu and select the Store in DDS option. Select Exit from the File menu
to close the edited MCDF table.
5. Clear the RTF check box in the Table Controller window and continue with the MCDF
table(s) insert and validate procedure as detailed in the section "Creating and configuring
a basic BSS with a TS switch" on page 3-46.
To confirm that the BSS configuration is as expected, select the Topology icon in the Service window or the
Topology option from the Services menu in the Services window to display the configuration. (Refer to the
section "Using the Topology Viewer" on page 3-109 for more information).
68P02900W22-Q 3-61
09-Sep-2004
The Service window Chapter 3: Operating DataGen
The Service window provides several options which enables users to view and edit DataGen input files. When
the Service window opens, details of the current BSS Area selected are displayed as in Figure 3-29. The
Service window contains a menu bar and a toolbar.
The toolbar contains the options which are used most frequently, allowing quicker access.
The Service window toolbar contains six buttons which have the following functionality:
Table Controller
The Table Controller button enables the user to create and edit BSS area data files. This button has the same
functionality as the Table Controller option in the Services menu.
3-62 68P02900W22-Q
09-Sep-2004
System Information: DataGen The Service window
Revgen/Compile
This button has dual functionality. When there is no data in the BSS area, the Revgen function is displayed.
When there is data in the BSS area, the Binary Object Compiler function is enabled.
The Revgen button has the same functionality as the Revgen option, and the Compile button has the same
functionality as the Object Compiler option in the Services menu.
Topology
The Topology button enables the user to view a graphical representation of a BSS area. The Topology button
has the same functionality as the Topology option in the Services menu.
MMI
The MMI button creates a set of MMI command files for the selected area and concatenates them. The MMI
button has the same functionality as the Generate Script option in the Services menu.
Exit
The Exit button closes the Service window and takes the user back to the DataGen main menu.
Help
The Help button displays the following message: ’For DataGen Help please refer to the DataGen
manual supplied, OLM On-Line help is available via the OLM GUI’.
68P02900W22-Q 3-63
09-Sep-2004
The Service window Chapter 3: Operating DataGen
The menu bar provides access to all options available whereas the toolbar provides access to those tools which
are used frequently. There are four main menus:
• File
• Edit
• Services
• Help
File menu
The following options are available from the File menu on the Service window:
• Import Object
• Export Object
• Make Directories
• Save
• History
• Exit
Import object
Selecting Import Object from the File menu in the Service window displays the Database Object window as
shown in Figure 3-30. This window enables users to import .002 object files into DataGen.
To import a file into a BSS area, select the required directory from the Directories scroll box. By default,
the directory Filter is set to /usr/omc.
3-64 68P02900W22-Q
09-Sep-2004
System Information: DataGen The Service window
If the path is changed, the directory Filter is set to the last path used for the current session,
unless DG_IMPORT_PATH is defined. Refer to "Defining environment variables" on page
3-4 for details.
To import binary object files from an integrated OMC, the import path is: /usr/omc/ne_data
Click Filter to display the entries in the Files scroll box. Select the required file and click OK. An information
window (as shown in Figure 3-31) is displayed when the file has been imported to the BSS area.
68P02900W22-Q 3-65
09-Sep-2004
The Service window Chapter 3: Operating DataGen
The binary object creation Date and Time stamp is displayed in the information window.
Export Object
Select this option to display the default path to where binary objects are exported.
To transfer binary object files from DataGen to a BSS, first transfer the binary objects files to the OMC.
Refer to "Exporting object files to the OMC" on page 3-120 for more details. Next, download the binary
object files from the OMC to the BSS.
Selecting Export Object from the File menu on the Service window only identifies the file path for the OMC
operator. The following information window is displayed:
To define an alternative path to export the binary object files (002) to, refer to "Administration
tasks" on page 3-11 for details.
3-66 68P02900W22-Q
09-Sep-2004
System Information: DataGen The Service window
Make Directories
If an area exists in the DataGen database but does not have the corresponding directory structure, for example,
~dg/country_name/area_name/conf_no/, the Make Directories option can be used to create the directory
structure.
Save
This option enables the DataGen user to save the current state of DataGen in case of interruptions.
History
This option provides the following details to identify a BSS area as follows:
• Title
If a new BSS area is created, the title contains the following information: Country, BSS area,
Configuration Number and Software version. The title reflects if the area is copied or upgraded.
• Owner
• Creation Date
• Modified By
• Modification Date
Exit
Selecting this option closes the Service window, returning to the DataGen Main window. This option is the
same as clicking the X button in the Service window.
68P02900W22-Q 3-67
09-Sep-2004
The Service window Chapter 3: Operating DataGen
Edit menu
The following options are available from the Edit menu in the Service window:
• Script
• Compile log
• Upgrade log
• Hardware report
Script
This option enables the user to view an MMI Script file via the X-Windows editor xedit. Refer to the section
"Generating a database script file" on page 3-76.
Compile log
This option enables the user to view the compile log file, via the X-Windows editor xedit, running the object
compiler. Refer to the section "Generating a database script file" on page 3-76 for details.
Upgrade log
This option enables the user to view the upgrade log file, via a text editor. The upgrade log file is available for
upgrades carried out via the GUI. The log file is not created if the upgrade is carried out from the command
line. Refer to "Upgrader" on page 3-129 for details on how to upgrade a software release.
Users may define the default editor for editing scripts or viewing the compile or upgrade logs.
Refer to "Administration tasks" on page 3-11 for details.
Hardware Report
This option enables the user to view a hardware report via a text editor. Refer to "Generating a hardware
report" on page 3-115 for details.
3-68 68P02900W22-Q
09-Sep-2004
System Information: DataGen The Service window
Services menu
The following options are available from the Services menu in the Service window:
• Table Control
• Revgen
• Object Compiler
• Recombine Script
Table Control
Select this option to open a Table Controller window, view and edit the BSS tables. Refer to "Using the
Table Controller" on page 3-83 for details.
Revgen
Selecting this option activates the Revgen process and converts the selected object file into a DataGen script
file. The binary object file can be compressed or uncompressed. Refer to "Converting a CM database
object file to a script file" on page 3-71 for details.
Object Compiler
The Object Compiler enables the user to generate a .002 Object file from the MMI Script. The .002 object
files are automatically compressed if the software version is 1.6.0.0 or greater.
Recombine Script
Selecting this option enables the concatenation of a number of MMI script files into a single file. This
also generates individual site based MMI script files, for example: SITEXXX where XXX is replaced by
the site number.
Topology
The option becomes available after the Revgen process is complete. Selecting this option enables users
to view a graphical representation of a BSS area.
Generate Script
The option becomes available after the Revgen process is complete. Selecting this option enables the user to
generate an MMI script file and individual site files.
68P02900W22-Q 3-69
09-Sep-2004
The Service window Chapter 3: Operating DataGen
3-70 68P02900W22-Q
09-Sep-2004
System Information: DataGen Converting a CM database object file to a script file
Converting a CM Database Object to a Database Script File enables upgrading to a later software version, or
changing some parameters in the existing software version. It also enables the user to view the topology
of a BSS area.
Invoking Revgen
Revgen is invoked either by selecting REVGEN from the Services menu or clicking the Revgen button
on the toolbar.
Depending on how the environment variable setenv DG_AUTO_REVGEN is set, selecting Revgen may
result in the following:
• The Revgen window opens.
Refer to "Defining environment variables" on page 3-4 for details on how to set the environment variable
DG_AUTO_REVGEN. By default, this environment variable is not enabled.
The software version of the new BSS area MUST be the same as the imported CM database object.
Revgen can only be run successfully on a NEW BSS area. The CM database binary object file can
be compressed or uncompressed.
The Revgen window (refer to Figure 3-34) is divided into four areas as follows:
• File menu
• Information area
• Data area
• Toolbar
68P02900W22-Q 3-71
09-Sep-2004
Converting a CM database object file to a script file Chapter 3: Operating DataGen
File menu
Table 3-3 describes the File menu options in the Revgen window:
Select To
Import BSS Object Specify and import a CM Database object.
Run Revgen Start the Object conversion.
Remove Lock File Unlock a BSS area.
Exit Exit and close the Revgen windows.
Information area
The information area in the Revgen window contains three data fields as described in Table 3-4.
Data area
The data area displays information about the progress of the object conversion.
Toolbar
3-72 68P02900W22-Q
09-Sep-2004
System Information: DataGen Converting a CM database object file to a script file
Activating Revgen
If the setenv DG_AUTO_REVGEN environment variable is not set to yes, run Revgen as follows:
1. Select the REVGEN button or select Revgen from the Services menu.
The Revgen window is displayed as in Figure 3-34.
4. Click the Filter button to display the entries in the Files list.
6. Select Import. A confirmation window is displayed when the import is complete. Click OK.
7. The initial display of Revgen shows the BSS area and the software version of the imported
object. Check these details before running Revgen.
68P02900W22-Q 3-73
09-Sep-2004
Converting a CM database object file to a script file Chapter 3: Operating DataGen
8. Click Run Revgen. The information and data areas display the details and progress of the
object conversion. An example is shown in Figure 3-35.
9. Click Exit to return to the Service window when the process is complete.
If the Exit button is selected before Revgen is complete, the actual conversion of
the 002 object will NOT be terminated, because it is running as a background
task. The Revgen tool is monitoring the status of the logfile, and when Revgen is
invoked again, the current status of the logfile is displayed.
If the setenv DG_AUTO_REVGEN environment variable is set to yes, run Revgen as follows:
Select the REVGEN button or select Services - Revgen from the menu bar. This displays the Revgen
window and starts the Revgen process. The information window displays the details and progress of the
object conversion. Figure 3-35 displays an example of the window on completion of Revgen.
Select the Exit button to return to the Service window when the process is complete.
3-74 68P02900W22-Q
09-Sep-2004
System Information: DataGen Converting a CM database object file to a script file
If the Exit button is selected before Revgen is complete, the actual conversion of the .002
object will NOT be terminated, because it is running as a background task. The Revgen tool
is monitoring the status of the logfile, and when Revgen is invoked again, the current status of
the logfile is displayed.
As the process is completing, the following message is displayed: Loading BSS Area. Please
wait. . .
Completion of the Revgen process may take several minutes for a large BSS area. On completion, a new
Service Window is displayed with a full complement of tools.
If the prompt BSS Area is locked appears when trying to open a BSS area, refer to the section
Lock/Unlock BSS area in Chapter 5 - Command Line Tools for more information. Alternatively,
use the Remove Lock File option in the File menu of the Watch window.
68P02900W22-Q 3-75
09-Sep-2004
Generating a database script file Chapter 3: Operating DataGen
After the Revgen process has successfully completed, it produces a database script file in the DataGen
output file directory.
The system also issues a report stating that the database tables have been populated.
Generating a database script can be performed from the Services window (refer to Figure 3-30) either by
clicking the MMI button or selecting the Generate Script option in the Services menu.
The database script generator uses the file data in the Service window (Country, BSS Area, Software
Version, and Configuration No.) to identify the correct file. The user is informed when the script has been
successfully created.
The database script file is stored in the output file directory of DataGen.
Each time a combined script is generated the original script is backed up with
a Date and Time stamp. For example COMBINED.BACKUP072498123425.
This allows the original to be compared against the new script.
Individual site files are created for example; SITE<XXX> where XXX is
replaced by the site number.
3-76 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generating a database script file
If the Options Object file is found to be missing or corrupt, an error message as shown in
Figure 3-36 is displayed. Refer to "Administration tasks" on page 3-11 for details of reinstalling
the Options object file.
After a database script file has been created, it may be viewed by selecting the Script option in the Edit
menu of the Service Window.
The script file is displayed within an xedit window as shown in Figure 3-37. The script file can be edited at
this point, although this is not recommended unless an error has occurred as a result of the compiler process.
If the database script file is edited, DataGen does not hold any record of changes which have been made.
68P02900W22-Q 3-77
09-Sep-2004
Generating a database script file Chapter 3: Operating DataGen
To define which editor to launch when viewing scripts, refer to "Defining environment variables" on
page 3-4 for details.
The file information areas show the full path of the script file presented in the display area of the xedit window.
3-78 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generating a database script file
This area in the xedit window displays the combined script file contents which can be edited and saved with a
new BSS name. The window can be scrolled using the Up and Down arrow keys on the keyboard.
A script file can also be generated and edited using an editor in an Xterm window, for example,
the UNIX editor vi.
The following procedure describes how to define a text editor to view MMI scripts or compilation logs
other than the standard editors.
When adding a new editor, verify that the editor runs on the system processor. This can be done
by entering the editor name from the command line and ensuring that it launches correctly.
1. Log on to the DataGen processor as user root.
2. Copy the selected editor to the /usr/bin directory using the following commands:
cp <text_editor> /usr/bin
Where: is:
text_editor name of the text editor
3. Change the permissions on the text editor to allow all users access to the file:
chmod 555 /usr/bin/<text_editor>
4. If all users wish to use the editor, add the following line to the file
/usr/omc/DataGen/current/config/local/cshrc.datagen:
setenv DG_EDITOR <text_editor>
Where: is:
text editor the name of the text editor
68P02900W22-Q 3-79
09-Sep-2004
Generating a database script file Chapter 3: Operating DataGen
If only specific users wish to use the editor, edit the .cshrc in the user’s home
directory.
For example, setenv DG_EDITOR vi. Therefore, when the script file is invoked from the
Edit menu, it is displayed with the vi editor, refer to Figure 3-38.
3-80 68P02900W22-Q
09-Sep-2004
System Information: DataGen Viewing and editing DataGen files
After a CM database object has been uploaded and converted using the Revgen option in the Service window,
it can be manipulated and edited into a new format using the DataGen tools. These tools comprise:
• Table Controller
• Topology Viewer
• Upgrader
• Difference Reporter
Table Controller
The Table Controller enables users to create MCDF (Motorola Customer Data Format) input files by
exporting file information from the Informix database.
It also enables users to validate input files and insert the file parameters back into the Informix database.
The Generic Table Editor enables MCDF files to be displayed and edited from the Table Controller.
Topology Viewer
The Topology Viewer provides users with a graphical representation of the topology of the complete BSS
area and a view of all the cage hardware in a BSS area.
Upgrader
The Upgrader is a window-based tool which is invoked by selecting the UPG button from the DataGen
main menu.
68P02900W22-Q 3-81
09-Sep-2004
Viewing and editing DataGen files Chapter 3: Operating DataGen
The Upgrader creates a new BSS area in the Informix database. The new BSS area is an exact copy of the
BSS area in the database which is to be upgraded.
The upgrade of the BSS area is then carried out on the copy of the area so that the original area is unchanged.
Upgrader can also be invoked using the Command Line. Refer to Chapter 5 - Command Line Tools,
Version upgrader (upg) command for details.
If any parameters in the BSS area are to be changed prior to the upgrade they should be done
by altering the MCDF files. Refer to "Using the Generic Table Editor (GTE)" on page
3-94 for details.
3-82 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Table Controller
To open the Table Controller window (as in Figure 3-39) from the Service window, either select the Table
Control option from the Services menu or click the Table Controller button.
68P02900W22-Q 3-83
09-Sep-2004
Using the Table Controller Chapter 3: Operating DataGen
• Exporting data to create a new set of MCDF files for the BSS area.
User controls
• Command buttons
Menu bar
The menu bar provides the following options to manipulate DataGen input files as described in Table 3-5
below:
Table 3-5 Table Controller - menu bar File and Select options
Option Definition
Exit When selected, exits and closes the Table controller
window.
Select all Files Selects all the displayed file types in the Table
Controller window.
Deselect all Files Clears all file types in the Table Controller window.
Command buttons
The command buttons are used to perform File, Validate, Insert, Export and Report functions on the
files imported into the Table Controller.
3-84 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Table Controller
File
Click File to open or create an input file. A check mark shown in the File column opposite an input file button
indicates that the file exists in the DataGen input file directory.
Validate
Click Validate to check that the parameters held in an input file are valid. A report is produced informing the
user of the result of validation. If the report file contains any warnings, then a W appears in this column
against the particular parameter.
Insert
Click Insert to insert the input files into the DataGen Informix Database. Files are validated automatically as
they are inserted and a report is produced informing the user of the result of the insertion.
Export
Click Export to export data from the Informix database into the DataGen Table Controller.
Report
Click Report to display the reports produced after using the Validate and Insert options. There is one table
report per input file. The table reports must be read before another operation is carried out on that table. A
W character in the Validate or Insert column indicates the presence of a warning in the report file which
should be checked.
Each check box on the left-hand side of the Table Controller is used to select or clear a DataGen input file (table
file) containing BSS database parameters. The name next to the check box identifies the contents of the file.
This area of the Table Controller window displays icons identifying the status of each table during each type
of operation. For example, a tick shown in the file column opposite a file select button indicates that the file
has been correctly imported. Figure 3-41 shows examples of each of these icons.
The following description provides a general introduction to the contents of each table file in the Table
Controller.
For more detailed information, refer to Chapter 6 - MCDF tables.
68P02900W22-Q 3-85
09-Sep-2004
Using the Table Controller Chapter 3: Operating DataGen
• BSS (bss) - This table is at the top of the MCDF hierarchy and contains BSS specific
information.
• SITE (bts) - This table contains specific information regarding each site in the BSS area.
• Hardware (hw) - This table contains information regarding all cages, default cabinets and
full-height cards throughout the BSS area. Each entry in the table contains details of one
device, noting the site, cabinet, cage and slot in which the device resides.
The cabinets and cages are not explicitly noted in the table; further information is
included within the details of the cards.
• Cabinet (cab) - This (optional) table contains information about all the non-default type
cabinets throughout the BSS area.
• Generics (gene) - This table contains a list of elements, including Motorola specific elements.
For convenience, the Timer and Statistics elements have been placed in separate files. Either
the value from the value field (if present) or the Motorola recommended value is set BSS-wide
but may be overridden for a site or cell by values in the specifics and cell tables. Also, values
for the commands dnlk_vad_qtx, and msc_qt are inserted via the Generics Table.
• Timer (time) - This table contains a list of timer elements, including Motorola specific
elements. Either the value from the value field (if present) or the Motorola recommended value
is set BSS-wide but may be overridden for a site or cell by values in the Specifics table.
• Circuit (acct) - This table contains all MTL, LMTL and OML signalling links. It also contains
the terrestrial circuits to time slots at the BSC for radio traffic channels.
• Channel (chan) - This table is only required for Remote Transcoders and contains the OML
and MTL signalling links through the remote transcoder. It also contains details of the traffic
channels between the MSC and BSC on the remote transcoder. The MSIs and MMSs required
are detailed in the Hardware table.
In both cases, the MSIs and the MMSs required are detailed in the Hardware table.
• Modify Value (modv) - This table details all the modify_value commands related to
MMS/LCF device functions within the area.
• PATHs (path) - This table details all the paths within the BSS area (providing signalling and
traffic communication between the BSC and the BTSs), using the links detailed in the Links
table. Details of RSLs are also contained in this table.
3-86 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Table Controller
• LAPD (lapd) - This table contains details of the LAPD values for the RSLs and XBLs in the
area. The RSLs and XBLs required are detailed in the Circuits and Paths tables.
• Cell (cell) - This table details all the cells across the OMC or network and also the external
neighbours used by the specified cells. The optional fields in this table contain information
which override the defaults specified in the Generics table.
• RTF (rtf) - This table contains details of the RTFs contained in the BSS area.
• DRI (dri) - This table contains details of the DRIs specified in the Hardware table for the BSS
area. The DRI must have its cage and slot number detailed in the Hardware table.
• Statistics (stat) - This table contains a list of statistical elements. Either the value from the
value field (if present) or the Motorola recommended value is set BSS-wide but may be
overridden for a site or cell by values in the Specifics table.
• Specifics (spec) - The Specifics table enables the user to define specific values for
chg_element and add_cell elements for a particular site or cell overriding the parameters
specified in the Generics, Timers and Statistics tables.
Elements that can exist in the Cell table are not shown in the Specifics table.
• Neighbour (ngbr) - This table identifies the cell pairings network-wide, using the bss_id
to identify the BSS area containing the cell marked as the source. The bsic and the bssh
frequency are detailed in the Cell table. The fields classed as optional may contain values
overriding those specified in the Cell table.
• Algorithm (alg) - This table specifies the algorithm data to be used across the BSS area. These
entries do not use the lac and ci fields. It also enables the user to define specific algorithm data
for defined cells identified by their lac and ci.
• Throttles (thro) - The Throttles table specifies throttles to be applied to device types for the
whole BSS area and links them to alarm numbers.
• EAS (eas) - The EAS table is used to specify alarm strings for alarm numbers used with
the BSS area.
• Daughter (dgtr) - This table is used to identify the half-height cards at a site in the same
way as the Hardware table specifies the full-height cards.
• PIX (pix) - The PIX Table specifies the hardware circuits that activate specific alarms in an
EAS device.
• KSW (ksw) - The KSW table specifies the data for the KSW configuration commands
(chg_ksw_config). This table only has entries for sites that implement expanded KSW
cards. Also, this table only contains entries that differ from the default values generated
within the BSS and BTS tables.
• NSVC (nsvc) - The NSVC table is used to specify all the parameters of the add_nsvc
command. This is used to allow the user to map a NS-VCI and DLCI to a specific GBL.
68P02900W22-Q 3-87
09-Sep-2004
Using the Table Controller Chapter 3: Operating DataGen
• {4322} ACS (acs) - The Active Codec Set (ACS) table is used to specify the parameters for
any chg_acs_params commands.
• {3723} Hop (hop) - The Hop table is used to specify the parameters of the chg_hop_params
command.
MCDF files can either be created, using blank templates, or regenerated, using an existing database.
The term Export means that the functions carried out in the Table Controller serve to Export the
files out of the Informix database, perform any editing required (or simply view the tables), and
then Insert the table back into the database.
If a configuration area has been imported and was created using an earlier version of DataGen, it
is necessary to re-export the MCDF files owing to changes in the DataGen 1.6.0.0 MCDF tables.
Warning messages may appear during the Export process; these can be safely ignored as the
Export will continue successfully.
To create MCDF files, perform the following steps:
1. After the Object file has been converted to a Script file by the Revgen process, select Table
Control from the Services menu in the Services window.
2. In the displayed Table Controller window, choose Select All Files from the Select menu.
4. When the message window indicates that all files have been exported, click the OK button.
Each file, when correctly exported, is indicated by a check mark in the File column.
3-88 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Table Controller
2. In the Table Controller window, choose Select All Files from the Select menu.
4. When the message window indicates that all files have been validated, click OK.
Each correctly validated file is indicated by a check mark in the File column.
2. In the Table Controller window, choose Select All Files from the Select menu.
68P02900W22-Q 3-89
09-Sep-2004
Using the Table Controller Chapter 3: Operating DataGen
4. When the Message window indicates that all files have been inserted, click OK.
Each correctly inserted file is indicated by a check mark in the File column.
As each file is validated and inserted into the database, a report is generated, the
results of which can be viewed by selecting the file and clicking Report.
Instead of carrying out separate Validate and Insert tasks on the selected files, users can select the files and
carry out the Insert task ONLY which automatically validates the files before insertion.
However, creating a new file or making a large number of edits to an old file increases the likelihood of errors,
particularly as many of the input files are interdependent. It is recommended that, in such cases, separate
validate and insert operations are performed.
The interdependency of input files also means that a file can only be validated if all its dependent files have
been validated and inserted or are currently selected.
After the MCDF files have been created from the Informix database, they can be edited using the Generic
Table Editor (GTE). The following procedure uses as an example of table editing a Generics table, which
requires a change to the Generics parameter ber_loss_daily.
5. From the Generics Table File menu, select Store in DDS, then select Exit.
The Generics Table window closes and the relevant Validate and Insert columns in the
Table Controller contain an asterisk (*).
3-90 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Table Controller
7. Click OK in the message window, and a check mark is displayed in the relevant Validate
and Insert columns.
8. Select the Generics file select button. A Report window displays the message that the
ber_loss_daily value was successfully updated in the database.
68P02900W22-Q 3-91
09-Sep-2004
Using the Table Controller Chapter 3: Operating DataGen
If an invalid entry is made to the MCDF tables, a report file is generated informing the user of an
error. In certain cases, a warning icon is displayed in the Validate column and no further editing is
allowed until the error has been corrected. Some input files, however, do not display a warning
icon (for example, out of range values). It is important therefore to read the Report file
every time a parameter is edited and inserted. Otherwise, the error may not be
apparent to the user until the file has been through the Binary Compiler process.
If the validation log (DGLog) window is open, it is possible to monitor and identify
problems as they occur.
The File Status icons on the Table Controller window are defined as follows (refer to Figure 3-41):
3-92 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Table Controller
#
#
& &
& !
&
"
"
"
"
"
& %
%
& &
68P02900W22-Q 3-93
09-Sep-2004
Using the Generic Table Editor (GTE) Chapter 3: Operating DataGen
The Generic Table Editor (GTE) allows the user to display and edit the MCDF input files.
An MCDF input file has three selections on its menu bar:
• File
• Edit
• Format
Select To
New Create a new (empty) MCDF input file.
Open Open an existing file.
Store in DDS Save the current state of an edited file in the DataGen Directory Structure (DDS).
Save As Save a file with a different, or new filename, using the Save As option in the
File menu.
Print Setup Set up printing parameters.
Print Print the current file to one of the available printers.
Restart Restore the file to its last saved version, before any modifications were made.
Exit Close the input file.
3-94 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Generic Table Editor (GTE)
New option
To create a new (empty) MCDF input file, use the following procedure:
In the MCDF input (.mcd) file, select New from File menu. A New message window is displayed as
in Figure 3-42.
Open option
Selecting the Open option from the File menu in the MCDF input file window displays an Open File window
as shown in Figure 3-43.
68P02900W22-Q 3-95
09-Sep-2004
Using the Generic Table Editor (GTE) Chapter 3: Operating DataGen
• Directories
This scrolled list box displays directories and sub-directories which can be selected by
double-clicking an entry, or highlighting an entry and pressing the Filter button.
• Files
This scrolled list box displays the files contained in the selected directory. To open a file,
highlight the file using the mouse button and press the OK button.
• Selection
This data field shows the selected path and filename.
• Buttons
The following buttons are available:
◦ OK - initiates the File - Open function.
◦ Filter - initiates the search process on the path displayed in the filter box, and display the
results in the Directories and Files list boxes.
◦ Help - Help is not available in this version of DataGen. The following message is
displayed: ’For DataGen Help please refer to the DataGen manual
supplied, OLM On-Line help is available via the OLM GUI’
4. If the Insert was successful, click the OK button in the message window.
A check mark is placed in the Insert column of the file type indicating successful insertion.
3-96 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Generic Table Editor (GTE)
Save As option
Figure 3-44 shows the Save To File window which is displayed when the Save As option is selected in
the MCDF Input File File menu. Using this option, existing files can be saved with a different filename,
or a new file can be saved with a new filename.
68P02900W22-Q 3-97
09-Sep-2004
Using the Generic Table Editor (GTE) Chapter 3: Operating DataGen
The Printer Setup window enables the user to specify printing parameters using:
• Two menu buttons for page size and orientation.
The various printing parameters are defined in Table 3-7, Table 3-8 and Table 3-9:
Select To
Page Size Display a drop down menu of available page sizes for printing. Select A4 page
size from the menu to enter the default values into the data fields.
Orientation Display a drop down menu of page layout types.
3-98 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Generic Table Editor (GTE)
Select To
Resolution Display the default DPI for printing.
Height Display the default page width for printing.
Width Display the default page height for printing.
Scaling factor Display the default scaling factor, normally zero.
Select To
OK Confirm the displayed parameters and close the Printer Setup window.
Apply Accept the displayed parameters.
Cancel Cancel the current operation.
Help Display the following Help message:’For DataGen Help please
refer to the DataGen manual supplied, OLM On-Line help is
available via the OLM GUI’ .
Print option
The Print Table window is displayed when the Print option is selected from the File menu.
The print command selects the appropriate command for postscript or text only printer as in
Figure 3-46. If no printer is set up, then none is displayed in the printer list.
68P02900W22-Q 3-99
09-Sep-2004
Using the Generic Table Editor (GTE) Chapter 3: Operating DataGen
The Print Table window allows the user to specify printer output parameters. This window has:
• Two option buttons allowing format selection:
◦ Postscript - generates the printer output as a postscript file.
• The Printers list box which displays the available printer names.
For more information about installing printers, refer to Configuring the printer in
Software Release Notes: DataGen (68P02900W76).
The Edit menu enables the user to perform general editing operations on the data contained in the cells of
an MCDF file.
Table 3-10 describes the Edit menu options.
Before Copying and Pasting cells, create the requisite number of columns and/or rows needed
to contain the data.
3-100 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Generic Table Editor (GTE)
Select To
Cut Cut the contents of the currently selected cell(s) with the data being retained in
a buffer. However, subsequent cut operations will overwrite the contents of the
buffer. The cut cells are left empty.
Copy Copy the contents of the currently selected cell(s) into a buffer.
Paste Copy the contents of the buffer into the currently selected cell(s).
Clear Delete the contents of the currently selected cell(s). Note that the data is NOT
saved into the buffer.
Fill Rapidly fill a range of cells with numerical data. For details, refer to the next
section Fill Cells window.
Insert Insert a new (empty) element (row/column) into the table, either before or
after the currently selected cell or row.
Delete Delete the contents of an entire row or column, when the appropriate
row/column has been selected.
Undo Undo the last operation: Cut, Copy, Paste, Clear, Fill, Insert, Delete, Undo,
or Replace.
There is a single buffer for Cut/Copy operations. Only the last Cut/Copy operation is retained
in the buffer.
68P02900W22-Q 3-101
09-Sep-2004
Using the Generic Table Editor (GTE) Chapter 3: Operating DataGen
Figure 3-47 show the Fill Cells window which is displayed when the Fill option is selected from the Edit
menu in the MCDF input file.
The Fill Cells window allows the user to change the contents of multiple cells using:
• Four data fields for the cell parameters (refer to Table 3-11).
Select To
Start Specify the number of the starting cell.
Increment Specify the cell number increment (normally 1).
End Specify the end cell number.
Number of Cells Specify the number of cells to be filled.
3-102 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Generic Table Editor (GTE)
Clear To
Start Allow its associated data field to be modified.
Increment Allow its associated data field to be modified.
End Allow its associated data field to be modified.
Cell count Allow its associated data field to be modified.
Select To
OK Confirm the displayed parameters and close the Fill Cells window.
Cancel Cancel the current operation.
Help Display the following message: ’For DataGen Help please refer to
the DataGen manual supplied, OLM On-Line help is available
via the OLM GUI’.
6. The value from the first highlighted cell is copied into all the highlighted cells.
68P02900W22-Q 3-103
09-Sep-2004
Using the Generic Table Editor (GTE) Chapter 3: Operating DataGen
Format menu
The Format menu enables the user to perform general search and replace operations. Table 3-14 shows the
definitions of the Format menu options.
Select To
Find Search for the occurrence of a specific character string.
Goto Go to a specific cell.
Replace Search for a specific character string and replace with another string.
Sort Sort certain MCDF tables.
Unlock Edit locked MCDF files.
Find option
Enter the string to search for and select the appropriate search criteria (Exact match or Case sensitive) for the
search. Figure 3-48 shows the Format Find window.
The Search For data field allows the user to specify the character string to find.
Table 3-15 and Table 3-16 describe the Enable buttons and the Action buttons.
3-104 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Generic Table Editor (GTE)
Select To
Exact match Specify that the string to be searched must be an exact match of the string
entered in the Search For data field.
Case Sensitive Specify that the search must be in the same case as the string entered in the
Search For data field.
Select To
Find First Find the first occurrence of the search string.
Find Next Find the next occurrence of the search string.
Cancel Cancel the operation.
Help Display the following message: ’For DataGen Help please refer to
the DataGen manual supplied, OLM On-Line help is available
via the OLM GUI’.
Goto option
Figure 3-49 shows the Goto Cell window which enables the user to move to a specific cell by entering the
appropriate column and row numbers. If the column or row selected lies outside of the table, the last cell
in that row or column is highlighted.
68P02900W22-Q 3-105
09-Sep-2004
Using the Generic Table Editor (GTE) Chapter 3: Operating DataGen
Field Enter
Column Column number
Row Row number
Select To
OK Confirm the displayed parameters and close the Goto Cell window
Cancel Cancel the operation and close the Fill Cell window.
Help Display the following message: ’For DataGen Help please refer to
the DataGen manual supplied, OLM On-Line help is available
via the OLM GUI’.
Replace option
This option enables the user to perform a search and replace operation on the contents of an MCDF file
using the Replace window shown in Figure 3-50.
3-106 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Generic Table Editor (GTE)
Field Enter
Search for The specific character string to search for.
Replace with The replacement character string.
Select To
Exact match Specify that the string to be searched must be an exact match of the string
entered in the Search For data field.
Case sensitive Specify that the search must be in the same case as the string entered in the
Search For data field.
Select To
Replace Single Specify that only the first occurrence of the search string is to be replaced.
Replace All Specify that all occurrences of the search string should be replaced.
Replace Query Display a query message for each search and replace action.
Select To
OK Confirm the displayed parameters and close the Replace window.
Cancel Cancel the operation and close the Replace window.
Help Display the following message: ’For DataGen Help please refer to
the DataGen manual supplied, OLM On-Line help is available
via the OLM GUI’.
Sort option
The contents of some tables can be sorted. If a table cannot be sorted, this option is greyed out.
Unlock option
Some of the BSS area definition files contain locked data which must not be altered, although the DataGen
GUI provides the functionality to do this.
The Unlock button enables the user to unlock a table and change the locked values. The user is presented with
a warning of the effects of this action.
68P02900W22-Q 3-107
09-Sep-2004
Using the Generic Table Editor (GTE) Chapter 3: Operating DataGen
Table 3-23 describes the key equivalents that are available when working on MCDF tables.
3-108 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Topology Viewer
Selecting the Topology option causes the DataGen GUI to core if the GMS licence
(KEYS) is not purchased.
The Topology Viewer allows the user to display a graphical representation of a BSS Area showing a BSC and
its associated BTSs. Two topologies can be displayed at the same time for comparison purposes.
The viewer has four data fields which show the Base Site System Description information and a Menu bar with
Cage, MMI, Path File and Increase/Decrease magnification options. The File menu has an Exit option only.
68P02900W22-Q 3-109
09-Sep-2004
Using the Topology Viewer Chapter 3: Operating DataGen
To display the Topology Viewer (as in Figure 3-51), either select Topology from the Services menu or
click the Topology icon on the Services window.
3-110 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Topology Viewer
Use the buttons on the menu bar shown in Figure 3-52 to access the topology viewer options.
The Cage selection on the menu bar and the Cage Number window allow the user to display cage
configurations for a BSC and BTSs displayed in the Topology Viewer window.
68P02900W22-Q 3-111
09-Sep-2004
Using the Topology Viewer Chapter 3: Operating DataGen
2. Click a BSC or BTS symbol (only green and yellow symbols are valid).
3. In the displayed Cage Number window, select the cage number. Refer to Figure 3-53.
3-112 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the Topology Viewer
The MMI button enables the user to regenerate an MMI script for the current site. This button performs
exactly the same function as the MMI button located on the Service window, described in the section "The
Service window" on page 3-62.
68P02900W22-Q 3-113
09-Sep-2004
Using the Topology Viewer Chapter 3: Operating DataGen
This button uses a text editor to display the path or connectivity information. For example:
PATH 0 = Site: 0 [MSI 2,0] connected to Site: 7 [MSI 3,0].
A copy of the file is stored in the users home directory: /home/<username>/PathFile. If the file already
exists, a backup of the original file will be made.
This button increases the magnification factor applied to the Topology Viewer to allow greater definition.
This button decreases the magnification factor applied to the Topology Viewer.
3-114 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generating a hardware report
Users can generate a hardware report containing a list of all the devices names, function names, slot numbers
and Id devices within each cage per site. A default text editor is used to open the report.
2. From the Service window (refer to Figure 3-30), select Generate Hardware Report from
the Services menu.
There must be data in the BSS area. Otherwise, the Generate Hardware Report
option will not be available.
3. The message Generating Hardware Report for Base Station System is displayed in a status
window. When complete, a confirmation window is displayed. Click OK to continue.
68P02900W22-Q 3-115
09-Sep-2004
Generating a hardware report Chapter 3: Operating DataGen
4. To view the report, select Hardware Report from the Edit menu.
The default text editor displays the report as in the example shown in Figure 3-55. Refer to
"Administration tasks" on page 3-11 for details on how to define a default editor.
5. Close the report by using the appropriate command for the text editor in use.
3-116 68P02900W22-Q
09-Sep-2004
System Information: DataGen Converting a database script file to a CM database object file
Overview of conversion
Conversion of a database script file to a database object file can be performed either on the DataGen
platform or in the BSS.
This process is normally carried out on a Test BSS which is not connected to the live network.
The Test BSS must first be entered into SYSGEN Mode. Once this has been done, the Database Script
File can be downloaded to the BSS via a TTY interface connected to the Master GPROC. The BSC then
processes the information sent to it and produces a CM Database Object from this information. The object
file has the extension .002.
The CM database object must then be uploaded to the OMC so that it is available for downloading to
the live network when it is required.
The Binary Object Compiler is used by DataGen to convert a script file into a CM database object. If the
software version is 1.6.0.0, then the CM database object is automatically compressed. As a secondary
function of compiling the object, the compiler also validates the database.
As a requirement for running the binary object compiler, the user must have installed the Options
Object into DataGen during the installation phase. The object compiler reads the Options Object
to ascertain what additional functionality the network supports. Refer to Installing the options
object in Software Release Notes: DataGen (68P02900W76) for details.
The binary object compiler is executed either from the Services Window menu, or by clicking the Compile
icon shown in Figure 3-56.
68P02900W22-Q 3-117
09-Sep-2004
Converting a database script file to a CM database object file Chapter 3: Operating DataGen
The Compiler does a validation check on all parameters. If any errors are detected during the Compile process,
a message is generated in the main window. The errors should be corrected using the Table Controller.
Editing of the script via the MMI Script Generate command does not update the Informix database, as it
is in an output file directory.
3-118 68P02900W22-Q
09-Sep-2004
System Information: DataGen Converting a database script file to a CM database object file
The Binary Object Compiler window has two data fields which display the BSS Area information and the
Status of the compiler. There are two action buttons: Run Compiler and Exit. The File menu has three
selections:
• Run Compiler
• Exit
From GSR4 all binary object files (.002) are compressed. Refer to Command
Line tools, Compress /uncompress 16xx Binary object files for details on how
to uncompress files.
To activate the compiler, click the Compile button or select the Compile option from the File menu.
68P02900W22-Q 3-119
09-Sep-2004
Exporting object files to the OMC Chapter 3: Operating DataGen
After a binary object has been generated, it can be downloaded to the OMC. The three methods for exporting
object files are:
• Export multiple binary object files to the OMC.
For more information about the requirements for this type of operation,
refer to DataGen-OMC Integration in Software Release Notes: DataGen
(68P02900W76).
3-120 68P02900W22-Q
09-Sep-2004
System Information: DataGen Exporting object files to the OMC
To export multiple binary object files to the OMC, perform the following steps:
1. Ensure that the export path is set to the desired directory. For example,
/usr/omc/DataGen/dg/<Country>/<BSS Area Name>/<export>.
Refer to "Administration tasks" on page 3-11, customizing parameters for details on
how to define a path to an export directory.
2. From the Service window (refer to Figure 3-29) within each area, select Export from the
File menu.
4. At the OMC, ensure that a sub-directory exists in the database directory with the same name as
the BSS Area being exported from DataGen. If a sub-directory does not exist, create one. For
example, /usr/omc/ne_data/dbroot/BSS/BSSspecific/<BSS Area Name>
5. At the OMC, invoke Utilities - OMC Database Utility, then select the Load Database option.
A load_db utility is invoked which opens a new Xterm window and presents four load
source options.
6. Select option 4 (User definable source and location) and input the requested information.
7. After the download, check that the database object is located in the database directory under
the specified BSS Area name. For example, /usr/omc/ne_data/dbroot/databases/<BSS
Area Name>/<db_load name>
68P02900W22-Q 3-121
09-Sep-2004
Exporting object files to the OMC Chapter 3: Operating DataGen
To export one object file that has been created via the DataGen GUI to the OMC, perform the following steps:
1. Verify that the binary object file is in the correct directory. For example,
/usr/omc/DG/dg/<Country>/<BSS Area Name>/conf<n>/002
Where: is:
n replaced by the configuration
number.
2. At the OMC, ensure that a sub-directory exists in the database directory with the same name as
the BSS Area which is being exported from DataGen. If one does not exist, create one. For
example, /usr/omc/ne_data/dbroot/BSS/BSSspecific/<BSS Area Name>
3. At the OMC, invoke Utilities - OMC Database Utility, then select the Load Database option.
A load_db utility is invoked which opens a new Xterm window and presents four load
source options.
5. After the download, check that the database object is located in the database directory under
the specified BSS Area name.
3-122 68P02900W22-Q
09-Sep-2004
System Information: DataGen Exporting object files to the OMC
To export multiple binary object files to the OMC from the Offline MIB, perform the following steps:
1. At the OMC, invoke Utilities - OMC Database Utility.
4. After the download, check that the database object is located in the database directory under
the specified BSS Area name.
For example:
/usr/omc/ne_data/dbroot/databases/<BSS Area Name>/<db_load name>
68P02900W22-Q 3-123
09-Sep-2004
Difference Reporter Chapter 3: Operating DataGen
Difference Reporter
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Difference reports between sites and site elements for BSS areas can be generated using the DIFF option
from the DataGen main menu (refer to Figure 3-1).
Two different BSS Areas are chosen and a comparison of both started. A viewable report is generated in
which sites common to both areas are listed. Differences between the two BSS Areas for each site are also
listed. In addition, the report indicates where no differences between sites are found.
Select DIFF from the DataGen main menu to display a Difference Reporter window as shown in Figure 3-57.
The Difference Reporter window displays the details of two BSS areas which may be selected for comparison
using the BSS Area Details window.
3-124 68P02900W22-Q
09-Sep-2004
System Information: DataGen Difference Reporter
• BSS Name
• Version
• Config
The action buttons on the Difference Reporter window may be used as follows:
Use To
Set Display a BSS Area Details window for Area 1 or Area 2 comparison (left
or right-hand option).
Compare Begin the comparison between Area 1 and Area 2.
View View the Report File.
Exit Close and exit the DIFF function.
The Select BSS Area Details window allows the user to select two BSS areas for comparison. To open the
window, select the left-hand or right-hand Set button for the relevant BSS area on the Difference Reporter
window. The Select BSS Area Details window is then displayed. Refer to Figure 3-58.
Note that when the window is first displayed, the BSS Name, Software Version, and Config Version list boxes
are blank. Only the Country Name list box contains a list of countries.
68P02900W22-Q 3-125
09-Sep-2004
Difference Reporter Chapter 3: Operating DataGen
• BSS Name
When a BSS Name is selected, the Software Versions in the next list box are displayed.
• Software Version
When a Software Version is selected, the configuration numbers in the last list box are
displayed.
• Config Version
Select the configuration number. The scroll bar may be used to step through the list of
configuration versions for a specified BSS area
The action buttons on the Select BSS Area Details window may be used as follows:
Use To
Done Enter the selected details into the Difference Reporter window for BSS Area 1
and Area 2.
Cancel Cancel the operation and close the window.
3-126 68P02900W22-Q
09-Sep-2004
System Information: DataGen Difference Reporter
The Information window is displayed after the user presses the Compare button in the Difference Reporter
main window to begin the comparison. The Information window displays the progress of the Difference
Reporter as in Figure 3-59.
Use To
View Report Display an Information window.
Close Close the Information window.
68P02900W22-Q 3-127
09-Sep-2004
Difference Reporter Chapter 3: Operating DataGen
The results of the Difference Reporter process are displayed in a Report window as shown in Figure 3-60.
3-128 68P02900W22-Q
09-Sep-2004
System Information: DataGen Upgrader
Upgrader
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The Upgrade function allows the user to upgrade an earlier version of DataGen to a more recent software
release. This option can be invoked from the DataGen main menu by selecting the UPG option (refer
to Figure 3-1).
The existing BSS area is copied to a new BSS area. The MMI script changes and modifications to parameter
values are applied to this new area.
The following upgrade paths are supported:
• 1.6.7.0 to 1.7.4.0
• 1.6.7.0 to 1.7.6.0
• 1.7.4.0 to 1.7.6.0
Refer to Software Release Notes: DataGen (68P02900W76) for more information about upgrades supported.
When UPG is selected from the DataGen main menu, the Upgrade BSS Area window is displayed as in
Figure 3-61. This allows the user to select the BSS Area characteristics to be upgraded. The Target Version
is entered automatically by DataGen.
68P02900W22-Q 3-129
09-Sep-2004
Upgrader Chapter 3: Operating DataGen
To change parameters in the BSS area prior to the upgrade, modify the MCDF files. Refer to
"Using the Generic Table Editor (GTE)" on page 3-94 for details. Do not modify the BSS area
by editing and compiling the MMI script, as any changes made will be lost after the upgrade.
Select To
Country Name Display a list of country names.
BSS Area Display a list of available BSS Areas.
Software Version Display a list software versions.
Configuration No. Display a list of Configuration numbers for the software versions.
Target Version Display the available target versions automatically.
Target Config. Display a list of target Configuration numbers.
Select To
Upgrade Start the upgrade process and display a Status window.
Close Cancels the operation and close the Upgrade BSS Area window.
3-130 68P02900W22-Q
09-Sep-2004
System Information: DataGen Upgrader
Where: is:
BSS area the name of the original BSS area.
Configuration No the configuration number of the
original BSS area.
2. Select a Country Name in the list box to display a list of BSS areas.
4. Select the required software version which is to be upgraded: a list of associated configuration
numbers is displayed.
68P02900W22-Q 3-131
09-Sep-2004
Upgrader Chapter 3: Operating DataGen
7. If the information displayed in the list box data fields is correct, click Upgrade.
If the BSS area is locked by another user, an information window is displayed as shown in
Figure 3-62. If this message is not displayed, proceed to Step 9.
8. Click OK to override the lock or Cancel to return to the Upgrade BSS Area window.
Information on the user holding the lock may be found in the DataGen.log file.
Refer to "Administration tasks" on page 3-11 for details.
A Status window is displayed as shown in Figure 3-63.
The following message is displayed in the Status window if the upgrade was successful:
3-132 68P02900W22-Q
09-Sep-2004
System Information: DataGen Upgrader
9. Click Close to return to the Upgrade BSS Area window when Gcmd has completed.
If the upgrade is unsuccessful, the Status window displays the following information:
REPORT :- Upgrade completed.
It is not necessary to wait for the upgrade to be completed before starting to upgrade another BSS area.
To upgrade a second BSS Area, select the Upgrade BSS Area window. Refer to Upgrade BSS Area and carry
out Step 3 to Step 9.
During the upgrade process, problems may be identified with the BSS area that prevent the success of the
upgrade. The Status window identifies any problems found.
Depending on the nature of the problem(s), modifications may be made in one of two ways:
• Modify MCDF files
68P02900W22-Q 3-133
09-Sep-2004
Upgrader Chapter 3: Operating DataGen
2. Click Close in the Status window to return to the Upgrade BSS Area window and Cancel
to return to the DataGen main menu (refer to Figure 3-1).
2. From the Service window, use the Table Controller to modify the MCDF files and insert
them back into the Informix database. Refer to "Using the Table Controller" on page
3-83 for details.
3. Generate an MMI script by clicking the MMI button or by selecting Generate Script from the
Services menu. Refer to "Generating a database script file" on page 3-76 for details.
4. Compile the created script file by selecting the COMPILE button or selecting Object
Compiler from the Services menu. Refer to "Converting a database script file to a CM
database object file" on page 3-117 for details.
3-134 68P02900W22-Q
09-Sep-2004
System Information: DataGen Upgrader
2. View the MMI script file with a text editor and make the necessary changes. Refer to
"Generating a database script file" on page 3-76 for more details.
3. From the Services menu, compile the script file to generate a new BSS binary object files.
Refer to "Converting a database script file to a CM database object file" on page 3-117
for more details.
4. Export the binary object file from the DataGen Directory structure. To create an export
directory refer to "Administration tasks" on page 3-11 for more details. From the Service
window, select File - Export Object.
6. Create a new BSS area and overwrite the existing configuration number. Refer to "Creating a
new BSS area" on page 3-34 for more details.
7. Import the exported binary object file from the Service window. Refer to the section Import
object in "The Service window" on page 3-62 for more details.
8. Revgen the binary object from the service window to update the BSS area in DataGen.
Refer to Activating Revgen in "Converting a CM database object file to a script file"
on page 3-71 for more details.
The Dynamic Allocation of RXCDR to BSC circuits (DARBC) alters the role of the terrestrial circuit portion
of the A-interface between a BSC and RXCDR (known as Ater channels), so that the Ater channels between
the remote transcoder (RXCDR) and BSC are allocated as the channels are needed, rather than statically
assigning the channels to a specific circuit identifier code (CIC).
The term XBL, refers to a base site controller (BSC) transcoder (RXCDR) link. The new Enhanced XBL
(EXBL) feature provides robust communication between the BSC and the RXCDR. The basis of the EXBL
feature is to provide a generic messaging system between the BSC and the RXCDR. This generic messaging
system is used to suit both current operator needs and the needs of future BSS features.
Dynamic Allocation of RXCDR-BSC Circuits (DARBC) and Enhanced XBL (EXBL) have interdependent
functionality.
For further technical details, see Technical Description: BSS Implementation (68P02901W36).
68P02900W22-Q 3-135
09-Sep-2004
Batch processing of binary object files Chapter 3: Operating DataGen
Batch processing of binary object (.002) files may be carried out by selecting Batch from the DataGen main
menu. The following functions can be carried out on one or more binary object files:
• Revgen
Multiple binary object files can be selected and converted into a DataGen script file.
• Upgrade
Multiple binary object files can be selected and upgraded to GSR7 version of DataGen.
• Compile
Multiple scripts files can be selected and compiled to form binary object files.
A default BSS Area name is derived from the binary object name minus the .002
extension. For example, BSS12.002 will become BSS area BSS12. It is advisable
to use meaningful binary names.
3-136 68P02900W22-Q
09-Sep-2004
System Information: DataGen Batch processing of binary object files
To Revgen multiple binary object files, carry out the following procedure:
1. Start DataGen from an Xterm window and select BATCH
from the DataGen main menu, (refer to Figure 3-1).
3. To export the Revgened areas automatically, click Export MCDF Files; otherwise proceed to
Step 4.
4. To copy the Revgened areas automatically, click Copy Area; otherwise proceed to Step 5.
5. To locate the directory where the binary object files are located, enter the path in the Filter
field and click the Filter button. All files are Revgened in the directory.
To Revgen only one file in the directory, select the required file from the Files list box.
If files other than binary object files exist in the directory, then a warning message
is generated in the Batch monitoring window. A default import path can be defined.
Refer to Network Expansion - Defining environment variables for details.
6. Click OK.
68P02900W22-Q 3-137
09-Sep-2004
Batch processing of binary object files Chapter 3: Operating DataGen
8. Enter the starting configuration number in the Start Config: field and click Execute.
If the number already exists, DataGen assigns the next available number.
If all the essential fields have not been completed, an error window is displayed
stating: All fields have not been filled in. Click OK to return to the Batch Tools
window.
9. The Batch monitor window is displayed as Figure 3-66. The Batch window may be left open
to monitor the batch processing.
3-138 68P02900W22-Q
09-Sep-2004
System Information: DataGen Batch processing of binary object files
To upgrade multiple binary object files carry out the following procedure:
1. Refer to the earlier procedure Revgen multiple binary object files and repeat Step 1. This
displays the Batch Tool window (refer to Figure 3-64).
3. To export the upgraded areas automatically, click Export MCDF Files; otherwise proceed to
Step 4.
4. To copy the upgraded areas automatically, click Copy Area; otherwise proceed to Step 5.
68P02900W22-Q 3-139
09-Sep-2004
Batch processing of binary object files Chapter 3: Operating DataGen
5. To locate the directory where the binary objects files are located, enter the path in the Filter
field and select the Filter button. All files are upgraded in the directory.
To upgrade only one file, select the required file from the Files list box.
If files other than binary object files exist in the directory, then
an error message is generated in the Batch monitoring window.
A default import path can be defined. Refer to Network Expansion - Defining
environment variables for details.
6. Click OK.
All the binary object files in the directory must be the same software version
for the upgrade to be successful.
8. Select the target version to upgrade to from the Target Version list.
9. Enter the starting configuration number in the Start Config: field and click Execute.
If the number already exists, DataGen assigns the next available number.
From the Edit menu on the Service window it is possible to view the upgrade log
file. Refer to "The Service window" on page 3-62, Edit menu for details.
3-140 68P02900W22-Q
09-Sep-2004
System Information: DataGen Batch processing of binary object files
3. To locate the directory where the script files are located, enter the path in the
Filter field and select the Filter button. All files are compiled in the directory.
To compile only one file from the directory, select it from the Files list box.
If files other than script files (ASCII text) exist in the directory, then
a warning message is generated in the Batch monitoring window.
A default import path may be defined. Refer to Network Expansion - Defining
environment variables for details.
4. Click OK.
All script files must be the same software version and the correct compiler version
must be selected, otherwise errors will be generated.
68P02900W22-Q 3-141
09-Sep-2004
Batch processing of binary object files Chapter 3: Operating DataGen
8. Click OK to continue.
The Batch monitor window is displayed, refer to Figure 3-67. This batch window may be
left open to monitor the batch processing.
Once the batch process is complete, the following files are generated for each script compiled:
• Binary object file (.002)
The files are located in the directory where the scripts reside.
3-142 68P02900W22-Q
09-Sep-2004
System Information: DataGen Batch processing of binary object files
If any of the scripts fail to compile, then only a report file is generated. This may be used
to identify the problem
68P02900W22-Q 3-143
09-Sep-2004
Batch processing of binary object files Chapter 3: Operating DataGen
3-144 68P02900W22-Q
09-Sep-2004
Chapter
4
Operating the Offline MIB
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q 4-1
09-Sep-2004
Introduction to the Offline MIB Chapter 4: Operating the Offline MIB
A Configuration Management (CM) database object is a binary file. Until the development of DataGen, it was
only possible to create a binary file by downloading an ASCII format script file to a BSS in SYSGEN mode.
Prior to GSR4 it was possible, using DataGen, to modify a single BSS binary file via MCDF tables or to
modify MMI scripts. Currently, DataGen allows the user to modify and carry out Radio Frequency (RF)
planning on multiple BSS binary files via the Offline MIB (OLM) which has a graphical user interface (GUI).
Users can only run one Offline MIB at a time. However, multiple GUIs for the same MIB may be displayed
and tasks may be carried out by several different users.
The task list orders the tasks in the sequence that they are routinely performed within the OLM. Additional
OLM features describe extra functions that are performed infrequently.
The following list describes the general procedures which should be carried out before using the OLM GUI:
• Import BSS binary files from the OMC into DataGen. Refer to the procedure DataGen - OMC
Integration in Software Release Notes: DataGen (68P02900W76).
• Upgrade function is carried out from the front panel DataGen window, not from the OLM GUI.
Refer to Upgrader in Chapter 3, Operating DataGen for details.
4-2 68P02900W22-Q
09-Sep-2004
System Information: DataGen Introduction to the Offline MIB
Task list
The following lists in sequence the procedures which are normally performed using the OLM GUI:
• Start OLM from DataGen front panel.
• From the Navigation Tree of the OLM, import BSS binary files from DataGen into the network.
RXCDRs binary files can be added but channels cannot be modified or equipped.
Only hardware changes can be made.
• Audit the network. The OLM must reflect the current configuration of the BSS binary files.
• Export BSS binary files to the OMC. Refer to Exporting object files to the OMC in Chapter
3, Operating DataGen.
Further information
To carry out additional functions such as importing Binary files from tape into the OLM directory (ReAlign
Network), refer to this section.
These functions are not routine functions and should only be carried out by the administrator or
creator of the Offline MIB network.
68P02900W22-Q 4-3
09-Sep-2004
Introduction to the Offline MIB Chapter 4: Operating the Offline MIB
Levels of users
Table 4-1 shows the administrative tasks that the various users can perform on the Offline MIB:
If problems are encountered when operating the Offline MIB, refer to this section to help resolve the
problems. Many administrative tasks are located from the Network Configuration selection window under the
menu option Admin (refer to Figure 4-1).
The environment variable OLM_VERIFY_DB_LOGGING can be used to identify the relevant sites and
cells that errors apply to when verifying an NE database. Refer to "Verify and save network" on page 4-40
for details on this procedure.
4-4 68P02900W22-Q
09-Sep-2004
System Information: DataGen Introduction to the Offline MIB
4. Exit and restart the OLM for the variable to be applied. Refer to "Starting/exiting the OLM
GUI" on page 4-9 for more information.
On the OLM, the command cmutil.olm is used as opposed to cmutil on the OMC. When using
cmutil.olm, the environment variable DBNAME must be set to the name of the network on which the
operation is to be performed, for example: set DBNAME = network1. Other than that, cmutil.olm
should perform similarly to cmutil.
For more information about using the cmutil command, refer to the manual Installation and Configuration:
GSM System Configuration (68P02901W17).
68P02900W22-Q 4-5
09-Sep-2004
Starting/creating a network configuration in the OLM Chapter 4: Operating the Offline MIB
To start the OLM from the DataGen main menu, click the OLM button (refer to DataGen - startup and
shutdown in the Chapter 3, Operating DataGen). A status message is displayed. Click OK to continue. The
OLM Network Configurations window then opens as shown in Figure 4-1.
4-6 68P02900W22-Q
09-Sep-2004
System Information: DataGen Starting/creating a network configuration in the OLM
2. Enter the name of the new network configuration and press the Tab key.
3. Enter the Mobile Country Code (MCC) and press the Tab key.
5. Click in Additional Information and enter a brief description of the network. It is not
mandatory to enter this information.
6. Select File - Create from the menu bar to create the network configuration.
68P02900W22-Q 4-7
09-Sep-2004
Starting/creating a network configuration in the OLM Chapter 4: Operating the Offline MIB
7. Select File - Save from the menu bar to save the configuration.
8. Select File - Close from the menu bar to close the window and return to the OLM Network
Configurations window.
The list is updated and now contains the new network configuration name.
To edit the Additional Information field, select Network Detailed View from the
Navigation Tree. Refer to "Modifying the network configuration from the
Navigation Tree" on page 4-32 for more details.
4-8 68P02900W22-Q
09-Sep-2004
System Information: DataGen Starting/exiting the OLM GUI
Introduction
2. Select the required network configuration name from the OLM Network Configurations
list. The selection is highlighted in black.
3. Select Edit - Open from the menu bar (alternatively, click the Open button or double click with
left mouse button) to open the OLM GUI.
68P02900W22-Q 4-9
09-Sep-2004
Starting/exiting the OLM GUI Chapter 4: Operating the Offline MIB
While the OLM is starting, a status window displays the following message:
Initialising...Please wait...
It is only possible to open one network configuration at a time. However, the GUI
for the opened network can be displayed on several machines. The InUse column
on the OLM Network Configurations window identifies the number of users that
currently have the network configuration GUI open (refer to Figure 4-4).
4-10 68P02900W22-Q
09-Sep-2004
System Information: DataGen Starting/exiting the OLM GUI
The OLM GUI opens and the front panel is displayed (refer to Figure 4-5). Refer to the section
"Front panel icons" on page 4-14 for more information about the OLM front panel.
To exit the OLM GUI, click Exit on the OLM front panel (refer to Figure 4-5). A confirmation window is
displayed. Click OK to exit the GUI and return to the OLM Network Configurations window.
The message shown in Figure 4-6 is displayed if the network configuration GUI is opened
by more than one user.
68P02900W22-Q 4-11
09-Sep-2004
Starting/exiting the OLM GUI Chapter 4: Operating the Offline MIB
Use the following steps to exit and shut down the OLM:
The last user to exit the GUI shuts down the Offline MIB.
1. Click Exit on the OLM front panel (refer to Figure 4-5).
A Confirmation window is displayed as shown in Figure 4-7.
4-12 68P02900W22-Q
09-Sep-2004
System Information: DataGen Starting/exiting the OLM GUI
3. For each Network element where errors exist, a warning window is displayed, detailing the
location and errors found. Refer to Figure 4-8.
Figure 4-8 Binary Database Error and warning window for a Network element
4. Click the Save NE button to save the Network element with the reported errors or go to Step 5.
If no more Network element errors are present, the OLM shuts down.
5. Click Don’t Save NE. If no more errors are present, the OLM shuts down.
This may result in inconsistencies between the Offline MIB and the specific NE
database within the network configuration directory.
68P02900W22-Q 4-13
09-Sep-2004
Front panel icons Chapter 4: Operating the Offline MIB
The DataGen OLM front panel provides the top level controls (icons) for the Offline MIB (OLM) as in
Figure 4-5. The name of the logged in operator is displayed at the top left of the front panel.
To show the current version of the OLM, place the cursor over the front panel, then press and hold the right
mouse button and select the About Offline MIB option.
Configuration management
Select the Config Mgmt icon to display the Navigation Tree. The Navigation Tree provides a means of
importing multiple BSS DataGen binary files. It displays a family tree representation of all configurable
objects. RF planning and modifications can be carried out on multiple BSSs. Refer to "Using the Navigation
Tree: overview" on page 4-22 for details.
Administration
Select the Admin icon to view the Admin Options window. Administration is related to the audit functions,
all BSSs, RXCDRs must be audited before it is possible to alter their BSS Binary database files.
4-14 68P02900W22-Q
09-Sep-2004
System Information: DataGen Front panel icons
Find
Select the Find icon to invoke a search facility to locate a Network Entity, Site or Cell within a network.
Once the item has been found it is possible to perform the following:
• Open the Navigation Tree with the found node as its root.
Help
Select this icon to invoke the contents page of the OLM online help.
A Help option can also be selected from many of the windows shown in the OLM section of the manual. The
Help option is described in the DataGen OLM Online Help facility.
Xterm
Exit
The EXIT button is located beneath the icons in the OLM front panel. Click this button and then confirm the
action to exit from the OLM front panel.
68P02900W22-Q 4-15
09-Sep-2004
Front panel icons Chapter 4: Operating the Offline MIB
The OLM front panel may be reduced in size to optimize screen coverage. To reduce the size, place the
cursor over the front panel, then press and hold the right mouse button. Select the Expert Desktop option
to resize the front panel (Figure 4-9).
To return to the standard desktop, place the cursor over the front panel then press and hold the right mouse
button. Select the Standard Desktop option to return to the standard desktop display.
4-16 68P02900W22-Q
09-Sep-2004
System Information: DataGen Finding a Network Element or Site or Cell
The Find function is used to locate an NE, site or cell within the network. From the Offline MIB front panel,
select the Find icon to display a Find window. Search for NEs, sites or cells by entering completely or
partially the following details:
• NE Name
• Site Name
• Site Id
• Cell Name
• GSM Cell Id
68P02900W22-Q 4-17
09-Sep-2004
Finding a Network Element or Site or Cell Chapter 4: Operating the Offline MIB
1. Select the Find button from the Offline MIB front panel. This displays the Find window
as in Figure 4-10.
2. Enter the name of the NE, Site, or Cell in the relevant Name field. An Id can be entered
for a Site or Cell in the relevant Id field.
Click the Clear button to remove the text from all the fields.
The search performs an exact match on Site Id or Cell Id and a partial match in all
other fields. For example, Site Id:1 is matched with site 1 but not
site 10. The text string SS1 is matched with BSS1 and BSS10.
4-18 68P02900W22-Q
09-Sep-2004
System Information: DataGen Finding a Network Element or Site or Cell
If no text is entered, the search display all NEs or Sites or Cells in the network.
4. The result of the search is displayed in the Find Results area of the window. The heading
indicates the class of objects found, that is, Network Elements or Sites or Cells.
5. Click the required <object> in the Find Results box. The selection is highlighted in inverse text.
Where: is:
object Network Element
Site
Cell
6. For a Cell or Site, to obtain the parent view, click the Find Parent button; otherwise, skip to
Step 7.
68P02900W22-Q 4-19
09-Sep-2004
Finding a Network Element or Site or Cell Chapter 4: Operating the Offline MIB
7. From the Open section of the Find window, select either the Navigation Tree or Detailed
View button. Refer to Figure 4-11.
The Navigation Tree opens with the found node as its root or a Detailed View opens for
the node.
Figure 4-11 Find window with a Cell and Navigation Tree selected
Objects found
Search Criteria
Open
8. From the menu bar on the Navigation Tree or Detailed View window, select File - Close to
return to the Find window.
Below are typical examples of where an operator might use the Find feature.
2. Enter the BSS name in the NE Name field, then enter the Site Id in the Site id field.
4-20 68P02900W22-Q
09-Sep-2004
System Information: DataGen Finding a Network Element or Site or Cell
2. Enter the name of the Cell in the Cell Name field, or its Id in the GSM Cell Id field.
5. Click Find Parent. The parent Site of the Cell is displayed in the Find Results box.
2. Enter the LAC in the third field of the GSM Cell Id.
Additional information about GSM cell ids can be found in Technical Description:
BSS Command Reference (68P02903W18) and Installation & Configuration: GSM
System Configuration (68P02901W17).
68P02900W22-Q 4-21
09-Sep-2004
Using the Navigation Tree: overview Chapter 4: Operating the Offline MIB
Procedure list
Further information
Further information on using the Navigation Tree can be found in Online Help.
The Navigation Tree is similar to the OMC Navigation Tree except for the following details:
• The menu bar has an Offline MIB pull down menu bar.
• Load Mgt, Fault Mgt are not present in the menu bar.
4-22 68P02900W22-Q
09-Sep-2004
System Information: DataGen Opening and closing a Navigation Tree
68P02900W22-Q 4-23
09-Sep-2004
Opening and closing a Navigation Tree Chapter 4: Operating the Offline MIB
When the Navigation Tree is opened, a comparison between the NEs in the MIB and the BSS binary files in
the configuration directory is carried out. If NEs exist in the MIB with no corresponding BSS binary files, a
warning window listing all invalid NEs is displayed as in Figure 4-13.
Resolving inconsistencies
OR
• Selecting the NEs and deleting them from the Navigation Tree. Refer to "Deleting a BSS or
RXCDR from the Navigation Tree" on page 4-50 for details.
4-24 68P02900W22-Q
09-Sep-2004
System Information: DataGen Moving levels on a Navigation Tree
A Navigation Tree must be open and displayed on the user terminal before attempting to move levels on that
tree. See the procedure for "Opening and closing a Navigation Tree" on page 4-23.
In the event that the OLM has no BSS or RXCDR network object created, an empty Navigation
Tree window is displayed. Refer to Creating a BSS/RXCDR from the Navigation Tree for
details on how to create BSSs or RXCDRs.
Assuming the Navigation Tree is in the form shown in Figure 4-14, use the following procedure for moving
levels:
To expand the Navigation Tree to the second level, click the folder icon next to the Network object.
The various class buttons are displayed.
To open the branch of a tree under a button, click the folder icon beside the button.
To close the branch of a tree under a button, click again on the folder icon beside the button.
68P02900W22-Q 4-25
09-Sep-2004
Moving levels on a Navigation Tree Chapter 4: Operating the Offline MIB
Panner region
When the Navigation Tree diagram becomes larger in size than the display area of the Navigation Tree
window (Figure 4-14), a panner/porthole arrangement is used to control what is being displayed. The tree is
displayed in the porthole region, and what is displayed is controlled by means of a panner.
To display different portions of the tree, move the panner. To do this:
Click and hold the left mouse button within the panner region, and move the mouse until the required area is
in view within the porthole. Then, release the mouse button.
4-26 68P02900W22-Q
09-Sep-2004
System Information: DataGen Creating a BSS/RXCDR from the Navigation Tree
Introduction to creating an NE
Creating a BSS or RXCDR involves importing BSS binary files from DataGen into the OLM. The original
files remain in DataGen and a copy is imported into the OLM.
To create a BSS or RXCDR from the Navigation Tree window, proceed as follows:
1. Click the BSS/RXCDR Node and select Edit - Create from the menu bar.
The BSS Binary configurations creation window is displayed as in Figure 4-15.
6. Click the Import database button. The message ReAlign Operation successful is displayed in
the status bar at the bottom of the Navigation Tree window when the import is complete.
68P02900W22-Q 4-27
09-Sep-2004
Creating a BSS/RXCDR from the Navigation Tree Chapter 4: Operating the Offline MIB
8. Repeat Step 2 to Step 6 to import the required number of BSS binary files into the network
configuration.
The maximum number of BSS binary files that can be imported is 64. The BSS
binary files must be from different areas containing different cells.
9. Click Cancel to close the BSS Binary configurations creation window and return to the
Navigation Tree.
To audit the network, refer to the section "Running an audit from the Navigation Tree" on page 4-30.
4-28 68P02900W22-Q
09-Sep-2004
System Information: DataGen Audit: overview
Audit: overview
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Introduction to auditing
After creating a network element from the Navigation Tree, it is necessary to populate the network elements
(NEs) with device information. This is done by selecting the network and carrying out an Audit and Apply
to OMC.
Ways to audit
The preferred way of using audit is on a per NE basis. Networkwide audits are
not recommended as they may cause degradation of the DataGen machine due to
resource consumption. For more information about Auditing recommendations,
refer to the manual Installation & Configuration: GSM System Configuration
(68P02901W17).
68P02900W22-Q 4-29
09-Sep-2004
Running an audit from the Navigation Tree Chapter 4: Operating the Offline MIB
It is possible to carry out an audit from the Navigation Tree and then, once the audit is complete, perform
the function Apply to OMC.
To carry out an audit from the Navigation Tree, use the following procedure:
1. From the Navigation Tree (refer to Figure 4-12), click the network node.
3. To monitor the status of the audit, select Config Mgt - Audit Logs from the menu bar.
4. From the Audit Logs window, monitor the audit until it shows a status of finished.
4-30 68P02900W22-Q
09-Sep-2004
System Information: DataGen Running an audit from the Navigation Tree
6. Select File - Open from the menu bar or double-click on the highlighted row.
An Audit Inconsistency List window is displayed as in Figure 4-17.
9. When complete, select File - Close to close the window and to return to the Navigation Tree.
Inconsistencies that have been applied to the OLM during the audit procedure are now visible
on the Navigation Tree window: that is, any devices deleted are removed from the Navigation
Tree and any new devices are displayed.
68P02900W22-Q 4-31
09-Sep-2004
Modifying the network configuration from the Navigation Tree Chapter 4: Operating the Offline MIB
Device management
From the Navigation Tree, it is possible to create, modify, save NE devices and parameters. The procedures
to carry out these operations are documented in Installation & Configuration: GSM System Configuration
(68P02901W17).
Creating or editing circuits, channels, statistics (enabling/disabling/threshold), and time slot reservations are
not supported from the Navigation Tree.
When required, use the Offline MIB pulldown menu to verify and save the new configuration.
From the Navigation Tree, saving a detailed view of a device will not automatically alter the BSS
binary file. To update the BSS binary file, it is necessary to verify and save the databases. For
further information refer to "Verify and save NE database" on page 4-37 for details.
Configuring cells
From the Navigation Tree, it is possible to add, modify, delete and propagate certain cell parameters. When
certain cell parameters are changed the values are propagated to the neighbour commands of the surrounding
cells automatically.
The procedures for carrying out these tasks are documented in Installation & Configuration: GSM System
Configuration (68P02901W17).
When required, use the Offline MIB pulldown menu to verify and save the new configuration.
From the Navigation Tree, saving a detailed view of a device will not automatically alter the BSS
binary file. To update the BSS binary file, it is necessary to verify and save the databases. For
further information, refer to "Verify and save NE database" on page 4-37 for details.
4-32 68P02900W22-Q
09-Sep-2004
System Information: DataGen CellXchange: overview
CellXchange: overview
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Introduction to CellXchange
• Import parameters from a tab delimited format into the OLM network.
CellXchange can be carried out either in a live environment using the OMC-R CM MIB or in an offline
environment using the OLM. Refer to the manual Installation & Configuration: GSM System Configuration
(68P02901W17) for more information on performing CellXchange from the OLM.
68P02900W22-Q 4-33
09-Sep-2004
Overwrite a BSS/RXCDR binary object file Chapter 4: Operating the Offline MIB
It is possible to copy BSS binary object file and overwrite the existing BSS binary object file in the OLM.
This feature overwrites the existing NEs and any changes made via the OLM are lost.
To overwrite an existing BSS Binary object file, use the following procedure:
1. Select the network from the network selection window. Refer to "Starting/exiting the OLM
GUI" on page 4-9 for details.
2. Select Config Mgmt from the Front Panel to display the Navigation Tree. Refer to "Opening
and closing a Navigation Tree" on page 4-23 for details.
4-34 68P02900W22-Q
09-Sep-2004
System Information: DataGen Overwrite a BSS/RXCDR binary object file
◦ Select the same BSS or RXCDR area from the Area list.
6. Click Import database. The message Reload Operation successful is displayed in the status bar
at the bottom of the Navigation Tree window when the import is complete.
An Information window is displayed as shown in Figure 4-19. Click OK to continue.
7. Click Cancel to close the selection window and return to the Navigation Tree.
An audit is initiated.
8. To view the status of the audit, select Config Mgt - Audit Logs from the menu bar. When the
audit and apply is complete, the Navigation Tree reflects the new BSS binary object file.
68P02900W22-Q 4-35
09-Sep-2004
Verify and save: overview Chapter 4: Operating the Offline MIB
The Navigation Tree is used to modify the network, the information is saved in the OLM. To apply the
changes to the BSS databases (binary files) on disk, the following procedures must be carried out:
• Verify - this ensures that all the parameters are correct in accordance to predefined BSS rules.
Once a validation is carried out it highlights any discrepancies that need corrective action. It
is possible to select individual NEs or an entire network. This option is available under the
Offline MIB pull-down menu.
• Save - this saves the BSS database file to disk and should be carried out regularly. Exiting
the OLM without saving, will result in changes being lost. This option is available under the
Offline MIB pull-down menu.
Do not deploy a saved BSS database without first carrying out a verify procedure.
It is possible to carry out in one step, a verify and save for the entire network by selecting Database Operations
from the Offline MIB pull-down menu. This option provides a complete list of all NEs in the network to
which a verify and save operation can be applied.
By default all NEs are selected. It is possible to deselect NEs from the list before carrying out
a verify and save.
4-36 68P02900W22-Q
09-Sep-2004
System Information: DataGen Verify and save NE database
2. Select Config Mgt from the Front Panel to display the Navigation Tree. Refer to "Opening
and closing a Navigation Tree" on page 4-23 for details.
68P02900W22-Q 4-37
09-Sep-2004
Verify and save NE database Chapter 4: Operating the Offline MIB
4. Select Offline MIB - Verify NE Database from the menu bar on the Navigation Tree window.
If errors exist, a warning window is displayed detailing the location and errors found for
each NE as in Figure 4-20.
Do not deploy a saved NE database without first carrying out a verify procedure.
To save a NE, first refer to the previous procedure Verify a network element and follow Step 1 to Step
4. The NE is then selected.
Select Offline MIB - Save NE Database from the menu bar on the Navigation Tree window.
4-38 68P02900W22-Q
09-Sep-2004
System Information: DataGen Verify and save NE database
The following message is displayed in the status bar at the bottom of the Navigation Tree window:
Off-Line MIB operation in progress...
Operation successful.
68P02900W22-Q 4-39
09-Sep-2004
Verify and save network Chapter 4: Operating the Offline MIB
Verify network
Upon successive Verify actions, the file will be over written. Refer to "Introduction to the
Offline MIB" on page 4-2 for details.
To verify the entire network, use the following procedures:
1. Select the network from the network selection window. Refer to "Starting/exiting the OLM
GUI" on page 4-9 for details.
2. Select Config Mgmt from the Front Panel to display the Navigation Tree.
4. Select Offline MIB - Database Operations from the menu bar on the Navigation Tree window.
4-40 68P02900W22-Q
09-Sep-2004
System Information: DataGen Verify and save network
5. Click the button Verify NE Database on the Offline MIB Database Operations window.
Refer to Figure 4-21.
The Offline MIB Verify Operation Monitor window is displayed as in Figure 4-22. This
contains a list of all NE names and the Operation status. If the verification produces errors or
warnings, this is indicated in the Reason column.
By default all NEs in the network are selected and highlighted in the OLM
Database Operations window. To deselect an NE, click the NE in the list. The
NE is then displayed in normal text.
6. If the status Operation successful is displayed for all NEs, click Close in this window and in all
subsequent windows to return to the Navigation Tree window.
If the operation failed, select the Network Element. The selected NE is then highlighted.
68P02900W22-Q 4-41
09-Sep-2004
Verify and save network Chapter 4: Operating the Offline MIB
7. Click Show Errors/Warnings. This displays the Binary Database error and warnings window,
detailing the location and errors found as in Figure 4-23.
8. Click Close to return to the Offline MIB Verify Operation Monitor window.
3. Click Close in all subsequent windows to return to the Navigation Tree window.
4-42 68P02900W22-Q
09-Sep-2004
System Information: DataGen Verify and save network
Resolving errors
To resolve any errors found, for example, to add NE devices and parameters, refer to the section "Modifying
the network configuration from the Navigation Tree" on page 4-32.
1. After resolving the errors found, repeat Step 3 to Step 5 (from the Verify Network procedure)
to validate the modifications.
If successful, the Operation Status field in the OLM Verify Operation Monitor window
should display the status Operation successful for all NEs.
2. Click Close in this window and in all subsequent windows to return to the Navigation Tree
window.
As soon as a verify NE database operation commences, the details are displayed in the Offline MIB Verify
Operation Monitor window.
To abort a verify operation in progress, use the following procedure:
1. Refer to the Verify network procedure and follow Step 1 to Step 5. The Offline MIB Verify
Operation Monitor window is then displayed (refer to Figure 4-22).
4. Click Close in this window and in all subsequent windows to return to the Navigation Tree
window.
68P02900W22-Q 4-43
09-Sep-2004
Verify and save network Chapter 4: Operating the Offline MIB
Saving a network
3. Click Close in this window and in all subsequent windows to return to the Navigation Tree
window.
Do not deploy a saved network without first carrying out a verify procedure.
As soon as a save NE database commences, the details are displayed in the Offline MIB Save Operation
Monitor window.
4-44 68P02900W22-Q
09-Sep-2004
System Information: DataGen Verify and save network
For NEs that have been saved, aborting does not rollback the saves already
carried out.
4. Click Close in this window and in all subsequent windows to return to the Navigation Tree
window.
68P02900W22-Q 4-45
09-Sep-2004
Deleting a network configuration in the OLM Chapter 4: Operating the Offline MIB
It is recommended to archive and delete the network configuration, once the binary files are transferred to the
OMC. Refer to Chapter 3, Operating DataGenExporting object files to the OMC for details.
4-46 68P02900W22-Q
09-Sep-2004
System Information: DataGen Network Expansion: overview
The purpose of this feature is to support large scale network expansion in an offline environment. This is
achieved from the Navigation Tree by being able to:
• Create a new BTS SITE by copying and pasting an existing BTS into a BSS configuration.
• Delete a BTS with its associated hardware devices and software functions in a single operation.
• Review transaction logs and maintain a historical record of operations. It allows the operator to
progress intervened batch mode operations.
Network Expansion can be carried out either in a live environment using the OMC-R CM MIB or in an offline
environment using the OLM. Refer to the manual Installation & Configuration: GSM System Configuration
(68P02901W17) for more information on performing Network Expansion from the OLM.
68P02900W22-Q 4-47
09-Sep-2004
Additional OLM features Chapter 4: Operating the Offline MIB
Additional tasks that may be carried out from the Offline MIB are:
• "Using the autoclose function" on page 4-49
The Navigation Tree supports an autoclose feature. This feature controls
the expanding and closing of branches on the Navigation Tree.
4-48 68P02900W22-Q
09-Sep-2004
System Information: DataGen Using the autoclose function
The Navigation Tree supports an autoclose feature. When this feature is turned on, then expanding a certain
branch of a tree results in the automatic closing of any other branches that might be open at that level. With
the feature turned off, multiple branches of a tree at any given level might be open.
Prerequisite
A Navigation Tree must be open and displayed on the user terminal before setting autoclose. Refer to
"Opening and closing a Navigation Tree" on page 4-23 for details.
The autoclose function is a menu option. When selected, the alternate state will be shown in the
menu window, that is, with Autoclose On selected. Autoclose Off will display in the View menu.
68P02900W22-Q 4-49
09-Sep-2004
Deleting a BSS or RXCDR from the Navigation Tree Chapter 4: Operating the Offline MIB
Introduction
This option is used to hierarchically delete all BSS or RXCDR network elements from the OLM. The
associated binary files are also deleted from the network configuration directory.
Procedure
2. Select Edit - Delete from the menu bar on the Navigation Tree window (refer to Figure 4-12).
A Confirmation window as shown in Figure 4-26 is displayed.
3. Click OK to continue.
An information window is displayed stating that the operation was completed successfully.
4-50 68P02900W22-Q
09-Sep-2004
System Information: DataGen Scheduling an audit
Scheduling an audit
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
List of procedures
The procedures that can be performed using the Audit Scheduler Admin Option are:
• Scheduling an audit
68P02900W22-Q 4-51
09-Sep-2004
Scheduling an audit Chapter 4: Operating the Offline MIB
3. Click OK.
The Audit scheduler window, as shown in Figure 4-28, opens. This contains a list of all
scheduled audits, detailing their Name, Status, Start Time, End Time, Interval, Execute
Mode, Update Mode and Operator.
4. To create a new audit, select Edit - Create from the Audit Scheduler window. The auSchedule
Detailed View <create> window is displayed as in Figure 4-29.
5. To insert the elements to be audited, click the Scheduled Element button. The network
Navigation Tree window is displayed.
4-52 68P02900W22-Q
09-Sep-2004
System Information: DataGen Scheduling an audit
It is valid to select either BSS, RXCDR, SITE, PCU or the entire network
to be audited.
68P02900W22-Q 4-53
09-Sep-2004
Scheduling an audit Chapter 4: Operating the Offline MIB
3. Once all the above information has been entered into the
Detailed View, select File - Create from the menu bar.
The new Scheduled Audit is then created and can be viewed in the Audit Scheduler window.
4. Close the Detailed View window by selecting File - Close from the menu bar.
5. Close the Audit Scheduler window by selecting File - Close from the menu bar.
4-54 68P02900W22-Q
09-Sep-2004
System Information: DataGen Scheduling an audit
All the limitations that apply to auditing also apply when modifying a scheduled audit. For more information,
refer to the earlier procedure for Creating a scheduled audit.
To modify a scheduled audit, use the following procedure:
1. Open an Audit Scheduler window. The Audit Scheduler window is displayed as in Figure 4-30.
3. To open this audit for modification, select Edit - Modify from the Audit Scheduler window.
The auSchedule Detailed View window is displayed as in Figure 4-29.
4. Select Edit - Edit from the menu bar. The Detailed View can now be edited.
The File - Revert option can be used before saving an edited auSchedule Detailed View to
return all changed fields to their previous state.
It is not possible to revert to a previous version after an edited version has been
saved.
5. When all the required fields have been changed, select File - Save from the menu bar.
6. Close the Detailed View by selecting File - Close from the menu bar. The modified Scheduled
Audit can be viewed in the Audit Scheduler window.
7. Close the Audit Scheduler window by selecting File - Close from the menu bar.
68P02900W22-Q 4-55
09-Sep-2004
Scheduling an audit Chapter 4: Operating the Offline MIB
Expired Scheduled Audits must be deleted from time to time to avoid using excess memory.
To delete a scheduled audit, use the following procedure:
1. Refer to the earlier procedure for Creating a scheduled audit and follow Step 1 to Step 3.
The Audit Scheduler window is displayed as in Figure 4-30.
4. Click OK.
The Scheduled Audit closes and the message Element Deleted is displayed in the status bar.
5. Close the Audit Scheduler window by selecting File - Close from the menu bar.
4-56 68P02900W22-Q
09-Sep-2004
System Information: DataGen Auditing logs
Auditing logs
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
List of procedures
The procedures that can be performed using the Audit Logs Admin Option are:
• Viewing an audit log list
After an audit has taken place, information relating to this audit is placed in an audit log. This information
can be accessed and printed.
To view an audit log list, use the following steps:
1. Select the Admin icon on the Front Panel to display the Admin Options window (Figure 4-27).
It is also possible to view the audit logs from the Navigation Tree by selecting
Config Mgt - Audit Logs from the menu bar.
68P02900W22-Q 4-57
09-Sep-2004
Auditing logs Chapter 4: Operating the Offline MIB
3. Close the Audit Logs window by selecting File - Close from the menu bar.
As soon as a Scheduled Audit begins (see "Scheduling an audit" on page 4-51), progress details are
displayed in the Audit log list.
To abort an audit in progress, use the following procedure:
1. Refer to the Viewing an audit log procedure and follow Step 1 to Step 2 to open the Audit
Logs window.
The Status of an audit in progress is displayed as Active in the Audit Log list.
4-58 68P02900W22-Q
09-Sep-2004
System Information: DataGen Auditing logs
4. Click OK.
The confirmation window closes and the Audit Log list is updated. The Status of the audit is
now changed to Aborted.
5. Select File - Close from the menu bar to close the Audit Log window.
Inconsistency reports
After an audit has taken place, information relating to this audit is placed in an Audit Log. Any inconsistencies
found between the NE and OLM configuration database are placed in an Inconsistency List. This information
can be accessed and printed.
There is a distinction between an Audit Log, which is a general information message generated as the outcome
of an audit, and an Audit Inconsistency Report, which is a further extension to show any inconsistencies
discovered during an audit in a more detailed form.
68P02900W22-Q 4-59
09-Sep-2004
Auditing logs Chapter 4: Operating the Offline MIB
To view an Audit Inconsistency report for a particular Scheduled Audit, use the following procedure:
1. Refer to the Viewing an audit log procedure and follow Step 1 to Step 2. The Audit Logs
window is displayed as in Figure 4-31.
2. From the Audit Log list, select the audit from which any inconsistencies should be viewed.
The selected audit is highlighted.
An Audit Inconsistency report is only completely valid for an audit with a Status
of either Finished or Applied.
Column Identifies
Object Name The name of the configurable device
Object Class The class (or type) of the configurable device.
Record Type Whether this record is reporting an inconsistency or an error,
and what type of inconsistency it is, if applicable. The
Record Type can be one of: Object Not at OMC; Object Not
at NE; Attribute Differs; Error Report.
4-60 68P02900W22-Q
09-Sep-2004
System Information: DataGen Auditing logs
Column Identifies
Apply Status The status of an attempted update to the system to remove an
inconsistency, or indicates the error detected by the audit.
If an inconsistency is being reported and an Apply to OMC
or Apply to NE operation has been performed, this column
indicates the result of the operation. This can be Success or
Failure. If an apply operation has not been attempted, this
field is blank.
If an error is being reported, this column describes the error.
Warning for NE Apply The type of warning given when inconsistencies applied to a
network element fail.
Attribute Name The name of the attribute that is inconsistent, if applicable.
OMC Attr Value The value of the attribute at the OMC, if applicable.
NE Attr Value The value of the attribute at the NE, if applicable.
Reason The reason why an inconsistency fails to be applied, if
applicable.
4. Select File - Close from the menu bar to close the Audit Inconsistency report.
3. Select Edit - Delete from the menu bar. Select Edit - Delete All to delete all the logs.
A confirmation of deletion window is displayed.
4. Click OK. The confirmation window closes and the selected audit log is removed from the list.
5. Close the Audit Logs window by selecting File - Close from the menu bar.
68P02900W22-Q 4-61
09-Sep-2004
Audit log management Chapter 4: Operating the Offline MIB
The Audit Log Management Admin option is used to delete audit logs after a predefined period. This
period is configurable between zero and seven days.
Audit logs may also be deleted manually. Refer to the procedure Deleting an audit log for more information.
The operator should set the number of days for retaining the audit log files, after which interval the OMC
automatically deletes the files. If set to zero all the audit logs, except the current one, are deleted.
4-62 68P02900W22-Q
09-Sep-2004
System Information: DataGen Audit log management
5. Select File - Save from the menu bar to save the change.
The following message is displayed in the status bar at the foot of the window:
Save completed
To quit without saving, select File - Close. A message window displays the
following:
There have been changes since you last saved. Pressing OK
will exit your current interface without saving.
68P02900W22-Q 4-63
09-Sep-2004
Reload NE database Chapter 4: Operating the Offline MIB
Reload NE database
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
If changes have been made to the network and the user wishes to return to a previous saved version of the
NE database, then Reload from the Offline MIB may be carried out.
If multiple NEs are changed, for example if an RF import, Cell or neighbour propagation has been
carried out, then all the affected NEs must be included in the roll back.
4-64 68P02900W22-Q
09-Sep-2004
System Information: DataGen Reload NE database
2. Select Offline MIB - Reload NE Database from the menu bar on the Navigation Tree.
A Confirmation window is displayed as in Figure 4-34.
4. Click OK.
5. To monitor the status of the audit, select Config Mgt - Audit Logs from the menu bar.
6. From the audit log list, monitor the audit until it shows a status of finished.
68P02900W22-Q 4-65
09-Sep-2004
Realign a network Chapter 4: Operating the Offline MIB
Realign a network
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The realign function is a short-cut method of putting BSSs and RXCDRs into a network configuration.
Normally, this is done from the Navigation Tree. Refer to "Creating a BSS/RXCDR from the Navigation
Tree" on page 4-27 for details. However, it is possible to copy NE binary files from a tar tape or via ftp into
the appropriate configuration directory in the OLM.
The realign function ensures that there is the same number of NEs in the MIB, as there are BSS binary files in
the configuration directory.
The following cases may apply (refer to Table 4-2):
2. Open the network configuration. Refer to "Starting/exiting the OLM GUI" on page
4-9 for details.
3. Open a Navigation Tree using the Config Mgmt icon. Refer to "Opening and closing a
Navigation Tree" on page 4-23 for details.
4-66 68P02900W22-Q
09-Sep-2004
System Information: DataGen Realign a network
4. Open an Xterm window and copy the BSS binary files to:
/usr/omc/DataGen/olm/<network configuration name>
5. Select the network node and select Offline MIB - ReAlign Network from the menu bar.
The message ReAlign Operation successful is displayed in the status bar at the bottom of the
Navigation Tree window when no errors are present.
An Information window is displayed as shown in Figure 4-35.
7. If new NEs have been added, then carry out an audit on the network. Refer to "Running an
audit from the Navigation Tree" on page 4-30 for details.
If NE binary files have been replaced, carry out Step 8.
8. Select the NE and do a reload from the Offline MIB pulldown menu. Refer to "Reload NE
database" on page 4-64Reload NE database for details.
68P02900W22-Q 4-67
09-Sep-2004
Compress or uncompress an OLM network Chapter 4: Operating the Offline MIB
It is possible to compress or uncompress an Offline MIB network from the OLM Network Configurations
window using the Admin options. All the binary files located in the selected network configuration directory
will be compressed or uncompressed.
When starting the OLM from the DataGen main menu, all compressed files are automatically uncompressed.
The compress function may be used when disk space is an issue.
It is better to archive and delete old network configurations when the binary files are transferred
to the OMC.
Compress procedure
2. Select the network configuration name from the list on the OLM Network Configurations
window. The selection is highlighted in black as in Figure 4-36.
4-68 68P02900W22-Q
09-Sep-2004
System Information: DataGen Compress or uncompress an OLM network
Uncompress procedure
To uncompress a network without restarting the OLM from the DataGen front panel, use the following
procedure:
1. Refer to the Compress procedure and follow Step 1 to Step 2.
68P02900W22-Q 4-69
09-Sep-2004
Troubleshooting the OLM Chapter 4: Operating the Offline MIB
If the OLM does not appear to be functioning normally, refer to the information in Table 4-3 to Table 4-7
which details errors that can occur and how to resolve them.
To investigate potential problems, carry out the following steps:
1. Check the omcaudit file which is located in /usr/omc/logs/omcaudityyyymmdd.
If a problem occurs, the messages are stored in the omcaudit file.
2. Refer to Table 4-3 to Table 4-7 for information on error messages and the appropriate action
to take.
If the OLM fails to start, Table 4-3 shows the possible error messages that may appear and the appropriate
action to take.
4-70 68P02900W22-Q
09-Sep-2004
System Information: DataGen Troubleshooting the OLM
68P02900W22-Q 4-71
09-Sep-2004
Troubleshooting the OLM Chapter 4: Operating the Offline MIB
Database errors
Table 4-4 shows the error messages that may appear and the appropriate action to take.
Error/Warning Action
Invalid NE To correct the errors carry out the following:
failed to open database
1. Reinitialise the database. Refer to the procedure
<Network name> sql error
"Reinitialise database" on page 4-75.
<Number>
Network name is <Name> it 2. Audit the network. Refer to the procedure "Running an
should be <Network Name> audit from the Navigation Tree" on page 4-30
There is more than one
Network in this database
Rose message received from
an NE when only start up
messages expected
Rejecting message because
unable to route message to
NE
Unable to route message to
<BSS NAME>
Message from BSS with
key <number> rejected BSS
unknown
NE %s in Binary directory Revert to the previously saved version of the NE database. Refer
and in MIB do not have to "Reload NE database" on page 4-64 for details.
the same software version
and/or type (BSS/RXCDR)
Unable to route message Check the version of BSS binary files as specified in
because NE is unknown. /usr/omc/config/OLM.CNFG and contact your local support
office.
Cont.
4-72 68P02900W22-Q
09-Sep-2004
System Information: DataGen Troubleshooting the OLM
General errors
Table 4-5 shows the error messages that may appear and the appropriate action to take.
Error/Warning Action
The number of Users in the To correct the errors carry out the following:
Network Configurations list
is set to non-zero even 1. Reset the number of users to zero. Refer to the procedure
though there is no OLM GUI Force shutdown OLM in this section.
open.
The GUI hangs 2. Audit the network. Refer to the procedure "Running an
audit from the Navigation Tree" on page 4-30
SMASE channel has been To correct the errors carry out the following:
deleted.
1. Force shutdown the OLM. Refer to the procedureForce
OlmOmcInit channel has been
shutdown OLM in this section.
deleted
Unable to read from IPC 2. Open the network. Refer to the procedure "Starting/exiting
channels the OLM GUI" on page 4-9
If a specific task fails, Table 4-6 shows the error messages that may appear and the appropriate action to take.
Error/Warning Action
Fatal Off-Line MIB To correct the error carry out the following:
Operation Error
1. View the audit log. Refer to the procedure "Auditing
logs" on page 4-57.
68P02900W22-Q 4-73
09-Sep-2004
Troubleshooting the OLM Chapter 4: Operating the Offline MIB
Import errors
While importing NE binary files Table 4-7 shows the possible error that may occur and the appropriate
action to take.
Error/Warning Action
Transaction timeout To correct the errors carry out the following:
Link OOS
• Revert to the previously saved version of the NE database.
Ported BSS S/W for <BSS Refer to the procedure "Reload NE database" on page
Name> has not started 4-64
or
msgsnd call failed for NE
<BSS Name>.
msgrcv call failed for msg • Exit and restart the OLM. Refer to the procedure
Q "Starting/exiting the OLM GUI" on page 4-9
msgget call failed with
key <number> for BSS <BSS
Name>.
Unable to route message to
<BSS Name> because ported
BSS SW is not started.
Force shutdown OLM function should be carried out only when the OLM is behaving abnormally. This
function will shut down the Offline MIB and reset the number of users to zero for the network configuration.
Any changes that have been made since the last save was carried out are lost. The system
administrator, the person who created the network configuration or the first user to launch
the OLM network can carry out this task.
4-74 68P02900W22-Q
09-Sep-2004
System Information: DataGen Troubleshooting the OLM
To shut down the OLM and reset the number of users to zero for the network configuration, use the following
procedure:
1. From the DataGen main menu, select the OLM option. The Offline MIB (OLM) Network
Configurations selection window is displayed. Refer to Figure 4-1.
2. Select the required network configuration name from the OLM Network Configuration
list. The selection is highlighted in black.
4. Click OK.
The message Database operation successfully completed is displayed in an
Information window.
5. Click OK.
The column Users in the Network configuration window is reset to zero for the network.
On opening the network, carry out an audit. Refer to "Running an audit from the
Navigation Tree" on page 4-30 for details.
Reinitialise database
The reinitialise function should be carried out only when the database has become corrupt. This function
shuts down and deletes all audited information in the Offline MIB.
68P02900W22-Q 4-75
09-Sep-2004
Troubleshooting the OLM Chapter 4: Operating the Offline MIB
Only the person that created the network configuration or the system administrator can carry
out this task.
To reinitialise the network database, use the following procedure:
1. Refer to the earlier procedure Force shutdown OLM and follow Step 1 to Step 2.
The OLM Network Configurations window opens and the network is selected.
3. Click OK.
The message Database operation successfully completed is displayed in an Information
window.
On opening the network, it will be seen that all the information that was audited
has been lost. It is necessary to carry out a complete audit on the shell NEs. Refer
to "Running an audit from the Navigation Tree" on page 4-30 for details.
4-76 68P02900W22-Q
09-Sep-2004
Chapter
5
Command line tools
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q 5-1
09-Sep-2004
Overview of command line tools Chapter 5: Command line tools
There are several software tools available for use in association with DataGen which are not part of the
Graphical User Interface (GUI) or can be accessed either from the GUI or the command line.
Table 5-1 shows the user tools available for command line operation:
5-2 68P02900W22-Q
09-Sep-2004
System Information: DataGen Overview of command line tools
68P02900W22-Q 5-3
09-Sep-2004
Overview of command line tools Chapter 5: Command line tools
General information
Most command line tools require that DGAdmin be run before they can be invoked, using the following
command:
DGAdmin
The DGAdmin command sets the user environment for DataGen. DGAdmin sets system variables in the
current environment to allow DataGen tools to function correctly.
DGAdmin changes the current prompt to indicate that the environment has been set up for use with DataGen.
User options
There is a user option to display values in either Hexadecimal or Decimal (default) format.
Prior to starting DataGen, two variables must be set to allow MMI scripts to display GSM Cell IDs, OPCs
and DPCs in Hex.
Procedure
Open an Xterm window and, if using the Bourne Shell (sh) interpreter, execute the following commands:
DG_HEX_CELL_IDS=yes ; export DG_HEX_CELL_IDS
DG_HEX_POINT_CODES=yes ; export DG_HEX_POINT_CODES
Open an Xterm window and, if using the C shell interpreter, execute the following commands:
setenv DG_HEX_CELL_IDS yes
setenv DG_HEX_POINT_CODES yes
5-4 68P02900W22-Q
09-Sep-2004
System Information: DataGen Copy Area (ca) command
Name
ca - copy area.
Synopsis
Description
This utility allows a BSS area to be copied to a new configuration, or act as the basis with which to generate a
new BSS area at a given configuration. If no configuration number is specified for the new configuration,
the next available configuration number is used.
68P02900W22-Q 5-5
09-Sep-2004
Copy Area (ca) command Chapter 5: Command line tools
Option Description
<country name> The country name containing the objects.
<BSS area name> The BSS name for the original objects.
<configuration number> The configuration number of the BSS containing
the objects.
-area <new BSS area name> Define a new BSS area.
-id <new BSS area id> Define a BSS area id for the new area.
-config <new configuration number> Define a new configuration.
-title <new configuration title string> The comment entered when creating the BSS area.
Requirements
Output
Output from Copy Area utility is the insertion of a new BSS area configuration, or a new BSS area in the
DataGen database. The screen output informs the user of the Copy Area operation and completion.
If the user opens the table controller screen for the new area created by the ca command, all of the columns
are blank. The File and Report columns are blank as the ca utility only copies the database entry and not the
input tables. The Validate and Insert columns are blank because the records associated with the original
database entry holding this information are specifically excluded from the copy.
The Copy Area utility ca works from the command line. The following command line can be customized
to perform the required copy:
ca -source UK:Area10:0
This example does not have a title string. By default a comment is created for the target area:
Copied from BSS area: <BSS Area> <Configuration No>
5-6 68P02900W22-Q
09-Sep-2004
System Information: DataGen Copy Area (ca) command
This copies configuration 0 of Area 10 to the next free configuration number within Area10.
To copy configuration 0 of area 10 to a new area and add the comment “copy of Area 10", a command of the
following type must be used:
ca -source UK:Area10:0 -area Area11 -title “copy of Area 10"
The next free configuration number in Area 11 is used and, if Area 11 does not exist, it will be
created.
68P02900W22-Q 5-7
09-Sep-2004
MMI Combiner (combine) command Chapter 5: Command line tools
Name
Synopsis
combine
Description
This utility generates a combined GSM MMI command file by combining the GSM MMI command files
under the command directory (generated by gcmd) when run under the BSS area directory path.
Output
Output from the script is in the form of a combined GSM MMI command file, located under the command
directory and named COMBINED.
Example
Each time a combined script is generated the original script is backed up with a Date and Time
stamp. For example, COMBINED.BACKUP072498123425.
5-8 68P02900W22-Q
09-Sep-2004
System Information: DataGen MMI Combiner (combine) command
Requirements
68P02900W22-Q 5-9
09-Sep-2004
Compile MMI script (compile) command Chapter 5: Command line tools
Name
Synopsis
Where: is:
country name of the country where the
options object is located
Version software version to compile with
(1.6.7.0 or 1.7.4.0 or 1.7.6.0)
filename name of script file to compile
Description
This utility allows a MMI script to be converted into a CM database object (binary object) file. It outputs a
binary object file and a report file and places them in the directory where the script was run.
Example
• BSS_scr.rep
If the compilation fails, only the report file (.rep) is generated and this may be used to determine the error.
5-10 68P02900W22-Q
09-Sep-2004
System Information: DataGen Compile MMI script (compile) command
Requirements
68P02900W22-Q 5-11
09-Sep-2004
Auto-compile MMI script command Chapter 5: Command line tools
Name
Synopsis
Description
This utility allows a number of MMI scripts to be compiled sequentially. The software version of the scripts
must be the same and the correct compiler version must be selected. After a successful compilation, the
resultant binary and report files are created in the directory where the scripts reside.
Option Description
-C <Country> The -C option identifies the country in which to insert the BSS
record.
-v <Version> The software version to compile with.
<filename or *> Define a directory where the scripts reside or a single MMI script.
Requirements
5-12 68P02900W22-Q
09-Sep-2004
System Information: DataGen Auto-compile MMI script command
Output
Output from the auto_compile utility is a batch logfile. This shows each operation of the batch process and
any relevant report file created along with its path. The result of each compile, successful or not, appears in
the logfile.
Once the batch process is complete the final message in the log file states:
BATCH COMPLETED
The batch file resides in the directory of the original binaries.
The auto_compile utility works from the command line. The following command line can be customized
to perform the required batch compile:
auto_compile -C Austria -v 1.7.6.0 ~/scr_objs/1760x/*
This compiles all existing MMI scripts in the specified directory using the corresponding 1760 compiler. On
successful completion, the report files and binaries will reside in the chosen batch directory.
A cronjob can be set up to schedule the running of auto_revgen or auto_compile or auto _upgrade batch
jobs. If cronjobs are set up, then the specific path for the DGAdmin executable and the auto_revgen or
auto_upgrade or auto_compile scripts must be entered along with the files to be run through the batch
process.
For example, when setting up a crontab file, “cron”, containing an auto_revgen cronjob to be run at 10.20
a.m. every day, the cron file should contain the following:
20 10 * * * /usr/omc/DataGen/bin/DGAdmin
/usr/omc/DataGen/current/bin/auto_revgen -m -d -C Austria -v
1.7.6.0 -c 0 /usr/omc/test/1760x/objects/*
The complete path for DGAdmin, batch process and the location of the binary files must be
entered.
To run the cronjob job, log on to the DataGen processor as omcadmin and enter the following command:
crontab cron
To check the status of the cronjob, enter the following command:
crontab -l
68P02900W22-Q 5-13
09-Sep-2004
Compress/uncompress 16xx binary object files Chapter 5: Command line tools
Name
Synopsis
Compress
cpdb -c <database object filename> <compressed object filename>
Where: is:
database object filename name of the .002 file to compress
compressed object filename the name of the compressed file
Uncompress
cpdb -u <database object filename> <uncompressed object filename>
Where: is:
database object filename name of the compressed .002 file
to uncompress
uncompressed object filename the name for the uncompressed
file
Description
The above command allows 16xx binary object files to be compressed or uncompressed from the command
line. Revgen converts the binary object file into a DataGen script file. Revgen can use both compressed
or uncompressed binary object files.
Example
The following are two examples of how to use the compress and uncompress command:
5-14 68P02900W22-Q
09-Sep-2004
System Information: DataGen Compress/uncompress 16xx binary object files
Requirements
68P02900W22-Q 5-15
09-Sep-2004
Delete database object (del) command Chapter 5: Command line tools
Name
Synopsis
Description
After the last Configuration area has been deleted, the BSS Area is also deleted.
Option Description
<verification> Off (0) performs action.
On (1) verifies action without performing it (displays a list with the
number of rows that may be deleted from the database).
<country> The country name.
<BSS area> The BSS name.
<configuration number> The configuration number of the BSS area.
5-16 68P02900W22-Q
09-Sep-2004
System Information: DataGen Delete database object (del) command
Example
Requirements
If the BSS area is deleted, the related files in the DDS are also deleted.
68P02900W22-Q 5-17
09-Sep-2004
MCDF filter command Chapter 5: Command line tools
Name
filter - allows the insertion or validation or exportation of MCDF files from and to the DataGen database.
Synopsis
Description
This utility allows MCDF files to be exported from the DataGen database or inserted into the DataGen
database. It may also be used to validate files.
5-18 68P02900W22-Q
09-Sep-2004
System Information: DataGen MCDF filter command
Option Description
–insert Insert the file or all files from the DataGen Directory Structure
(DDS) into the DataGen database
–validate Validate the file or all files from the DDS. This checks the tables for
errors and does not affect the DataGen database
–export Export the file or all files from the DataGen database into the DDS -
~/dg/country/BSS_area_name/configuration_number/MCDF/
country The country name containing the bss area
bss area The BSS area name
config no The configuration number to filter
–files[FileName ...] | all] If all is selected, then all files will be inserted or validated or
exported. Otherwise only the specific FileName or FileNames will
be used. Refer to Table 5-6 for valid FileNames.
Table 5-6 lists the valid file names to filter MCDF files.
FileName Table
bss BSS
site Site
cab Cabinet
hware Hardware
gene Generics
timer Timer
modv Modify Value
acct Circuits
Cont.
68P02900W22-Q 5-19
09-Sep-2004
MCDF filter command Chapter 5: Command line tools
Example
The following example demonstrates how to use the MCDF filter command:
filter -export -area Austria:Area10:0 -files all
This example exports all the MCDF files for country Austria, BSS Area, Area10 and configuration number 0
to the directory: ~/dg/Austria/Area10/conf0/MCDF/.
Requirements
5-20 68P02900W22-Q
09-Sep-2004
System Information: DataGen MMI command generator (gcmd) command
Name
Synopsis
Description
This utility generates BSS command files from the DataGen database, for the objects specified by the
command line parameters.
Option Description
<Country> The country name.
<BSS area> The BSS area.
<Config No> The configuration number of the BSS.
<Site name> The site name (optional parameter).
Example
68P02900W22-Q 5-21
09-Sep-2004
MMI command generator (gcmd) command Chapter 5: Command line tools
gcmd Austria:Area10:0:1
This example produces a MMI script for site 1 only in Austria BSS Area10, configuration number 0.
Requirements
Output
Output from the script is in the form of BSS command files which can be found in the directory from where
the command was run. A logfile is also produced and the user is mailed the command status on completion.
5-22 68P02900W22-Q
09-Sep-2004
System Information: DataGen Optimise DataGen database (dbaccess) command
Name
Synopsis
Description
In order to maximise free disk space, it is advisable to optimise the DataGen database. This can be performed
by running the script named clusters.sql.
Example
Requirements
Run DGAdmin before executing the dbaccess command. Before starting the optimization, execute the
following command:
/usr/gsm/DataGen/bin/DGAdmin
68P02900W22-Q 5-23
09-Sep-2004
Lock/unlock BSS area (lock_adm) command Chapter 5: Command line tools
Name
Synopsis
Description
A BSS area configuration is automatically locked while the user is working on it and is automatically
unlocked when the user is finished. However, due to occasional error conditions, a BSS area configuration
can remain locked. If this happens, it must then be unlocked using the lock_adm command before further
progress can be made.
5-24 68P02900W22-Q
09-Sep-2004
System Information: DataGen Lock/unlock BSS area (lock_adm) command
Option Description
<country name> The country name of the configuration.
<BSS area name> The BSS name of the configuration.
<config_no> The configuration number.
–who query about lock status.
–lock lock a configuration.
–unlock unlock a configuration.
Example
This command should not be used when another user is genuinely accessing an area.
The following example shows how to lock an area:
lock -adm Austria:Area10:0 -lock
Requirements
Output
The lock option locks a BSS area. The unlock option unlocks a BSS area. The who option gives the process
id, the user name, the host name and the time when the area was locked as in the following example:
68P02900W22-Q 5-25
09-Sep-2004
Lock/unlock BSS area (lock_adm) command Chapter 5: Command line tools
5-26 68P02900W22-Q
09-Sep-2004
System Information: DataGen Revgen command
Revgen command
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Name
Synopsis
revgen -d <CM Object Filename> -C <Country Name> -a <BSS Area Name> [-s
<Sites String>] [-i <area id>] [-c <config number>] [-r <reference config
number>] [-B <config file>] [-v <BSS Version Number>] [-n]
See Table 5-9 for options description.
Description
The CM Database Object does not contain all of the information needed to create a complete DataGen record.
The information missing is the name of the country, the BSS, and the names of the sites. This information
can be supplied in one of three ways:
• The database where a previous configuration version of the BSS exists.
• A configuration file.
The command line options indicate the preferred method. If the CM Database Object contains a site that is not
named by any of these sources, it will be given a default name Site <N>, where N is the site number.
68P02900W22-Q 5-27
09-Sep-2004
Revgen command Chapter 5: Command line tools
Option Description
-d <CM Object Filename> The -d option takes a further parameter and identifies the CM
Database Object’s file name.
-C <Country Name> The -C option identifies the Country in which to insert the BSS
record.
-a <BSS area name> The BSS name for the original objects.
-s <Sites String> The -s option takes a further parameter and identifies the site names
for sites in the BSS. The names parameter is a single option and
must be placed in quotes. It consists of the site number immediately
followed by an equal sign (=) and then the name of the site. The
quotes prevent the names parameter being split and information
being lost. For example:
"0=B06,1=Hereford,2=Upper Dunton"
-i <area id> Define a BSS area id.
-c <config number> The -c option takes a further parameter and identifies the
configuration version in which to insert the new DataGen BSS
record. If this option is not used, the revgen process will pick out
the next available configuration in the indicated BSS records.
-r <reference config number> The -r option takes a further parameter and identifies the reference
configuration number. This number identifies a similar BSS which
the revgen utility uses to look up unscheduled site names.
-B <config file> The -B option takes a further parameter and identifies a
configuration file to use to identify the BSS and the site names.
The structure of the configuration file is as follows.
Line 1 - The Country name.
Line 2 - The BSS name (and optionally BSS ID).
Line 3 - The configuration number (may be blank).
Line 4 onwards - Site numbers and names.
For example, a file with the contents:
UK
B06,6
0=B06,
1=Hereford,
2=Upper Dunton
would create a BSS record choosing the first available configuration
number in country UK and BSS name B06 with ID of 6. Set site 0
up with name B06, site 1 as Hereford and site 2 as Upper Dunton.
-v <BSS Version Number> The -v option takes a further parameter and identifies the
configuration version number of the DataGen BSS record for the
reference configuration. This record will be used to resolve any
site numbers left unnamed by the -B or -s option. If the reference
contains the same site numbers with the names that are required in
the new record, then this is all that needs to be supplied.
-n No SYSGEN generated.
5-28 68P02900W22-Q
09-Sep-2004
System Information: DataGen Revgen command
Example
If the DDS directory does not exist for the configuration, the command
will fail. Therefore before running the revgen command, type:
mkdir -p /home/<user_name>/dg/
<country>/<BSS_area_name>/<configuration_number>/002
Requirements
Output
The output from this command is in the form of a set of GSM MMI command files, which can be found
in the relevant DDS command directory. The set of GSM MMI command files are combined to produce
one script (COMBINED) for the current DataGen BSS record. The command status is mailed to the user
upon completion.
68P02900W22-Q 5-29
09-Sep-2004
Auto-Revgen command Chapter 5: Command line tools
Auto-Revgen command
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Name
Synopsis
Description
This utility allows a number of binaries of one software version to be Revgened sequentially, creating the new
database areas under relevant BSS areas in the database. The binaries must all be of the version specified. The
BSS areas are named after the binary file names.
Extra options are available to export all the MCDF tables for each new area and to copy each new area upon
Revgen completion. An optional initial configuration number can be specified for the first new area, with
subsequent new areas having the next available configurations above the starting number.
5-30 68P02900W22-Q
09-Sep-2004
System Information: DataGen Auto-Revgen command
Option Description
-m Specifies that MCDF tables, should be exported after Revgen
(optional).
-d Specifies that a copy of the new area should be made after Revgen
is complete (optional).
-C <Country> The -C option identifies the country in which to insert the BSS
record.
-c <configuration> The configuration number to Revgen the first binary to (optional).
-v <Version> The software version to Revgen the binaries to.
<filename or *> Defines a directory where the binary or binaries reside.
Requirements
Output
Output from the auto_revgen utility is a batch logfile. This shows each operation of the batch process and any
relevant report file created along with its path. Any part of the batch process which fails, will be reported
along with an explanation. For example, when an attempted Revgen is carried out on a non binary file.
Once the batch process is complete the final message in the batch file states:
BATCH COMPLETED
The batch file resides in the directory of the original binaries.
Example
The auto_revgen utility works from the command line. The following
command line can be customized to perform the required batch Revgen:
auto_revgen -C Austria -v 1.7.6.0 ~/option_object/1760x/*
This Revgens all existing binaries in the specified directory to the corresponding 1740 areas in the database. If
the BSS areas already exist in the database, then the next available configuration, for each new area is used.
auto_revgen -m -d -C Austria -c 25 -v 1.7.6.0 ~/option_object/1760x/*
This command Revgens all existing binaries. After each Revgen process, the MCDF tables are exported for
the new area. The area is copied to the next available configuration and the MCDF tables for the copied
area are exported. The process attempts to Revgen first and then assigns the configuration number 25. If the
number is already in use, the next available number greater than 25 will be selected.
68P02900W22-Q 5-31
09-Sep-2004
Toggle permissions (tp) command Chapter 5: Command line tools
Name
Synopsis
Description
The DataGen user has a standard set of access permissions. This utility toggles between the access permitted,
and access denied states.
Option Description
<-r> Re-allocate grant permissions to all registered users.
-u <user name> Toggle permissions for the specified user.
[<class>] [<mail address>] Update class or mail address for specified user.
Example
5-32 68P02900W22-Q
09-Sep-2004
System Information: DataGen Toggle permissions (tp) command
Requirements
68P02900W22-Q 5-33
09-Sep-2004
Version upgrader (upg) command Chapter 5: Command line tools
Name
Synopsis
Description
This utility copies the specified BSS area to a new configuration, and upgrades the new configuration to the
specified GSM BSS software version. If no parameters are specified, the upgrader reports which upgrade
paths are available. An upgrade path consists of a single upgrade, or a series of upgrades to take the specified
area from its current BSS/GSM software version to an upgraded version.
Refer to Software Release Notes: DataGen (68P02900W76)for details of current upgrades supported.
Option Description
-C <country> BSS or RXCDR area country name.
-a <area> BSS or RXCDR area name.
-c <config> BSS or RXCDR area configuration to be upgraded.
-u <version> GSM software version to which area is to be upgraded to.
-t <target Config > Target configuration number to upgrade to.
5-34 68P02900W22-Q
09-Sep-2004
System Information: DataGen Version upgrader (upg) command
Requirements
Output
Output from the upgrader consists of a screen report informing the user of the new configuration number for
the upgraded area and of the progress and status.
Example of upgrading
Where: is:
Country UK
BSS area BSS area
Configuration No. 0 to version 1.7.6.0
Configuration No. 5
68P02900W22-Q 5-35
09-Sep-2004
Auto-upgrader command Chapter 5: Command line tools
Auto-upgrader command
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Name
Synopsis
Description
This utility allows a number of binaries of the same software version to be upgraded sequentially. It creates
new database areas under relevant BSS areas in the database. The binary files must all be of the version
specified. These new areas are then upgraded to the specified software version.
Extra options are available to export all the MCDF tables for each new area and to copy each new area upon
upgrade completion. An optional initial configuration number can be specified for the first new area with
subsequent new areas having the next available configurations greater than the initial number.
5-36 68P02900W22-Q
09-Sep-2004
System Information: DataGen Auto-upgrader command
Option Description
–m Specifies that MCDF tables, should be exported after revgen
(optional).
–d Specifies that a copy of the new area should be made after revgen
(optional).
–C <Country> The -C option identifies the Country in which to insert the BSS
record.
–c <start configuration> The configuration number to revgen the first binary to (optional).
–v <Version> The software version of the binary files.
–u <Upgrade Version> The software version to which the resultant areas should all be
upgraded to.
<filename or *> Define a directory where the binaries reside or a single binary.
Requirements
Output
Output from the auto_upgrade utility is a batch logfile. This shows each operation of the batch process and
any relevant report files created and their location. Any part of the batch process which fails will be reported
along with the reason for failure. For example, when an attempted Revgen is performed on a non-binary file.
Once the batch process is complete the final message in the batch file states:
BATCH COMPLETED
The batch file resides in the directory of the original binaries.
Example
The auto_upgrade utility works from the command line. The following
command line can be customized to perform the required batch upgrade:
auto_upgrade -C Austria -v 1.6.7.0 -u 1.7.6.0 ~/scr_objs/1670x/*
This Revgens all existing binaries in the specified directory to corresponding 1670 areas in the database. If
the BSS areas corresponding to the binary file names already exist in the database, then the next available
configuration for each new area is used in each case. Each newly created 1670 area will then be upgraded to
1760.
68P02900W22-Q 5-37
09-Sep-2004
Auto-upgrader command Chapter 5: Command line tools
5-38 68P02900W22-Q
09-Sep-2004
System Information: DataGen Country administration
Country administration
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The following describes how the DataGen user can create new Country and Network files in the DataGen
database using the Country Administration (CADM) feature. The various functions of the CADM feature
which enable the user to manipulate the files are:
• Administration files are created and edited using the Generic Table Editor (GTE). The GTE is
also used to save the files to a specified name or to a supplied standard file name.
• Default Country and Network administration files can be edited using the GTE. The GTE is
also used to save the files to a specified name or to a supplied standard file name.
• Generate or update operations can be performed on the default Country and Network
administration files.
• The CADM feature prompts the DataGen user to decide whether or not to notify the owners
and modifiers of BSS area configurations about Countries and Networks that cannot be
deleted. Notification is by email.
A Command Line Interface (CLI), enables the DataGen user to generate and update Country and Network
administration files in the DataGen database using CADM utilities.
68P02900W22-Q 5-39
09-Sep-2004
Country administration Chapter 5: Command line tools
Invoking xcadm
3. Click OK to continue.
The xcadm GUI (Figure 5-2) is organised into three functional areas:
• Menu bar
• Data fields
• Action buttons
5-40 68P02900W22-Q
09-Sep-2004
System Information: DataGen Country administration
The menus
The menu bar enables the DataGen user to create, update, and edit Country and Network Administration
files as follows:
File menu
The following option is available:
• Exit
Use the Exit option to exit from the Country Administration window.
Network menu
The following options are available:
• Edit
Select to use GTE to edit the default Network Administration file.
• Generate
Select to generate a Network Administration file from the DataGen database.
• Update
Select to update the DataGen database with the default Network Administration file.
Country and Network menu options may be greyed out, according to which
operations are permitted at the time.
68P02900W22-Q 5-41
09-Sep-2004
Country administration Chapter 5: Command line tools
Country menu
The following options are available:
• Edit
Select to use GTE to edit the default Country.
• Generate
Select to generate a Country Administration file from the DataGen database.
• Update
Select to update the DataGen database with the default Country Administration file.
For NEW users where no country.std file exists, select Generate from
the Country menu to automatically generate a country.std file in the
/omcadmin/dg/ADMIN/country directory. This also applies to the network.std
file.
Data fields
• Network File
Displays the default Network Administration file name when the CADM GUI
window is opened.
Action buttons
Table 5-14 shows the definitions for the action buttons on the xcadm GUI.
Button Definition
Exit The Exit button closes the CADM window.
Help Not available in this version of DataGen.
5-42 68P02900W22-Q
09-Sep-2004
System Information: DataGen Country administration
CADM utilities
The CADM utilities provide read and write access to the CADM administration files through the File Format
utilities (FFMT). FFMT utilities are part of the GTE functionality.
CADM administration files are held in the DataGen database in the following format:
• The file contains country definitions, one definition per line.
Where: is:
country_name the name of the country.
MCC the Mobile Country Code.
new_line_character the character which designates the
end of the record.
68P02900W22-Q 5-43
09-Sep-2004
Country administration Chapter 5: Command line tools
5-44 68P02900W22-Q
09-Sep-2004
Chapter
6
MCDF tables
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q 6-1
09-Sep-2004
Overview of MCDF tables Chapter 6: MCDF tables
This specification details the format of each of the files within the MCDF file set for use in BSS versions
1.6.5.0 and beyond.
Its aim is to provide a clear, understandable description and format for the customer, the developer, and any
other audience which needs information about its scope.
This chapter defines the layout and format of each of the files within the MCDF file set.
Due to MCDF supporting BSS versions 1.6.5.0, 1.6.7.0, 1.7.4.0 and 1.7.6.0, it is important that users
adhere to all ranges defined in the subsequent tables. The ranges may change from one load to the next.
The following diagrams show which tables are mandatory and which are optional (refer to Figure 6-1
and Figure 6-2).
6-2 68P02900W22-Q
09-Sep-2004
System Information: DataGen Overview of MCDF tables
BSS Table
EAS Table
KSW Table Site Table
Cabinet
Table
Hardware
Table
PIX Table
Generics Neighbour
Table Links Table Stats Table Table
Specifics Algorithm
Paths Table Table Table
File dependency,
RTC Table predecessor must exist
File dependency
if predecessor exists.
68P02900W22-Q 6-3
09-Sep-2004
Overview of MCDF tables Chapter 6: MCDF tables
BSS Table
EAS Table
KSW Table
Cabinet Table
Hardware
Table
PIX Table
KEY
MCDF Table
Optional Table
File dependency,
predecessor must exist
File dependency
if predecessor exists.
6-4 68P02900W22-Q
09-Sep-2004
System Information: DataGen BSS table
BSS table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table is the top of the MCDF hierarchy and contains BSS specific information along with a field depicting
the format of the MCDF file itself (refer to Table 6-1).
This table is a list file laid out as follows: <field name><field width><range><status>
Default filename bss.mcd
Field
Field Name Range Status
Width
Country 50 Text Mandatory.
Used to verify the country name.
BSS Name 50 Text Mandatory.
Used to verify the BSS name.
Software Version 50 30 characters Mandatory.
Desired Text
Used to verify the GSM BSS software version.
BSS ID 50 0 to 255 Mandatory
Used for element bss_id.
BSS Serial 50 Text Optional.
A complex code to refer to each BSS.
SPC BSC 50 0 to 16777215 Mandatory if BSS area is not
a RXCDR (see Site Type)
otherwise not used.
Used for element opc.
Cont.
68P02900W22-Q 6-5
09-Sep-2004
BSS table Chapter 6: MCDF tables
Cont.
6-6 68P02900W22-Q
09-Sep-2004
System Information: DataGen BSS table
68P02900W22-Q 6-7
09-Sep-2004
BSS table Chapter 6: MCDF tables
6-8 68P02900W22-Q
09-Sep-2004
System Information: DataGen BSS table
All entries into this field must be space separated, for example: the blocks allowed are A, B, D only, so the
user must type:
A B D
It is very important that the information is entered this way when a subset of frequency blocks is required.
68P02900W22-Q 6-9
09-Sep-2004
Site (BTS specific) table Chapter 6: MCDF tables
This table contains information regarding each site in the BSS area (refer to Table 6-4).
Default filename bts.mcd
Cont.
6-10 68P02900W22-Q
09-Sep-2004
System Information: DataGen Site (BTS specific) table
Cont.
68P02900W22-Q 6-11
09-Sep-2004
Site (BTS specific) table Chapter 6: MCDF tables
6-12 68P02900W22-Q
09-Sep-2004
System Information: DataGen Cabinet table
Cabinet table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This mandatory table contains information about all of the non-default type cabinets throughout the BSS
area. Refer to Table 6-5. The default cabinet type is type 0 (BTS4).
Default filename cab.mcd
Cont.
68P02900W22-Q 6-13
09-Sep-2004
Cabinet table Chapter 6: MCDF tables
Multiple frequency types within a single cabinet are not supported by the HORIZONMACRO2
and HORIZONMACRO2_EXT cabinet_types.
6-14 68P02900W22-Q
09-Sep-2004
System Information: DataGen Cabinet table
If Then
Both Infrastructure Sharing Homogeneous Cabinet Each cabinet (within any given site) can support
and Infrastructure Sharing Heterogeneous Cabinet multiple frequency types.
options have been purchased: Valid Range: 1 to 15
Cont.
68P02900W22-Q 6-15
09-Sep-2004
Cabinet table Chapter 6: MCDF tables
6-16 68P02900W22-Q
09-Sep-2004
System Information: DataGen Hardware table
Hardware table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table contains information about all cages, default cabinets and full height cards throughout the BSS
area. Each entry in the table contains details of one device noting the site, cabinet, cage and slot in which
the device resides (refer to Table 6-8).
The cabinets and cages are not explicitly noted in the table, more included within the details
of the cards.
Default filename hw.mcd
68P02900W22-Q 6-17
09-Sep-2004
Hardware table Chapter 6: MCDF tables
Cont.
6-18 68P02900W22-Q
09-Sep-2004
System Information: DataGen Hardware table
Manual equipage of MSI is not allowed on Horizon II and Horizon II_ext cabinets.
Cont.
68P02900W22-Q 6-19
09-Sep-2004
Hardware table Chapter 6: MCDF tables
Cont.
6-20 68P02900W22-Q
09-Sep-2004
System Information: DataGen Hardware table
Cont.
68P02900W22-Q 6-21
09-Sep-2004
Hardware table Chapter 6: MCDF tables
Cont.
6-22 68P02900W22-Q
09-Sep-2004
System Information: DataGen Hardware table
Cont.
68P02900W22-Q 6-23
09-Sep-2004
Hardware table Chapter 6: MCDF tables
Cont.
6-24 68P02900W22-Q
09-Sep-2004
System Information: DataGen Hardware table
68P02900W22-Q 6-25
09-Sep-2004
Generics table Chapter 6: MCDF tables
Generics table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The Generics table contains a list of elements, including Motorola specific elements. For convenience, the
timer and statistics elements have been placed in separate files. Either the value from the value field (if
present), or the Motorola recommended value, is set BSS-wide but may be overridden for a site or cell by
values in the Specifics and Cell tables.
Table 6-9 outlines the parameters of the Generics table.
Default filename gene.mcd
The following are the elements in the Generics table (refer to Table 6-10):
6-26 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generics table
Cont.
68P02900W22-Q 6-27
09-Sep-2004
Generics table Chapter 6: MCDF tables
Cont.
6-28 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generics table
Cont.
68P02900W22-Q 6-29
09-Sep-2004
Generics table Chapter 6: MCDF tables
Cont.
6-30 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generics table
Cont.
68P02900W22-Q 6-31
09-Sep-2004
Generics table Chapter 6: MCDF tables
Cont.
6-32 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generics table
Cont.
68P02900W22-Q 6-33
09-Sep-2004
Generics table Chapter 6: MCDF tables
Cont.
6-34 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generics table
Cont.
68P02900W22-Q 6-35
09-Sep-2004
Generics table Chapter 6: MCDF tables
Cont.
6-36 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generics table
Cont.
68P02900W22-Q 6-37
09-Sep-2004
Generics table Chapter 6: MCDF tables
From release 1740 onwards, the NSEI parameter is located in the Hardware table.
Cont.
6-38 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generics table
Cont.
68P02900W22-Q 6-39
09-Sep-2004
Generics table Chapter 6: MCDF tables
Cont.
6-40 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generics table
Cont.
68P02900W22-Q 6-41
09-Sep-2004
Generics table Chapter 6: MCDF tables
Cont.
6-42 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generics table
All DCS1800 DRI devices in a Horizon II macro and Horizon II macro_ext cabinet are forced
to operate in high power mode (32 Watts).
68P02900W22-Q 6-43
09-Sep-2004
Generics table Chapter 6: MCDF tables
{22064}
Table 6-11 shows the new and modified Generics table elements for GSM Half Rate and their recommended
values.
Cont.
6-44 68P02900W22-Q
09-Sep-2004
System Information: DataGen Generics table
Table 6-11 Generics table elements for GSM Half Rate (Continued)
Element name Recommended value
{22064} l_rxqual_ul_p_hopping_hr None
{22064} l_rxqual_dl_p_hr None
{22064} l_rxqual_dl_h_hr None
{22064} l_rxqual_dl_h_hopping_hr None
{22064} l_rxqual_dl_p_hopping_hr None
{22064} u_rxqual_dl_p_hr None
{22064} u_rxqual_ul_p_hr None
{22064} gsm_bss_half_rate_enabled 0
{22064} gsm_half_rate_enabled 0
68P02900W22-Q 6-45
09-Sep-2004
Timer table Chapter 6: MCDF tables
Timer table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table contains a list of timer elements, including Motorola specific elements. Either the value from the
value field (if present) or the Motorola recommended value is set bss-wide, but may be overridden for a site
or cell by values in the Specifics table.
Table 6-12 outlines the parameters of the Timer table.
Default filename time.mcd
Table 6-13 shows the layout of the timer element parameters in the Timer table.
6-46 68P02900W22-Q
09-Sep-2004
System Information: DataGen Timer table
Cont.
68P02900W22-Q 6-47
09-Sep-2004
Timer table Chapter 6: MCDF tables
Cont.
6-48 68P02900W22-Q
09-Sep-2004
System Information: DataGen Timer table
Cont.
68P02900W22-Q 6-49
09-Sep-2004
Timer table Chapter 6: MCDF tables
Cont.
6-50 68P02900W22-Q
09-Sep-2004
System Information: DataGen Timer table
68P02900W22-Q 6-51
09-Sep-2004
Modify Value table Chapter 6: MCDF tables
This table contains the modify_value commands. The table is only applicable for MMS and LCF device
functions currently as DataGen only supports these devices within the modify_value command.
Default filename modv.mcd
Table 6-14 shows the MMS element parameters:
LCF: *max_opls
*max_opls is not currently supported, except for Motorola internal use.
DYNET: shared_timeslots
Used for the value_name parameter of the modify_value command.
New Value 6 See Range Table below. Mandatory.
The applicable ranges are shown in the following table:
Value Name Min Value Max Value
nbit 0 1
ber_oos_mon_period 1 60
ber_restore_mon_period 1 18000
Cont.
6-52 68P02900W22-Q
09-Sep-2004
System Information: DataGen Modify Value table
DYNET: 0 to 19
This value defines the DYNET first id to which this modify_value command
relates
Device Fn ID2 2 0 or 1 Mandatory.
Used for the dev_fun_id2 parameter of the modify_value command.
MMS: This value defines the MMS identifier for the MMS device function.
68P02900W22-Q 6-53
09-Sep-2004
Circuit table Chapter 6: MCDF tables
Circuit table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-15 contains all MTL, LMTL and OML signalling links. It also contains the terrestrial circuits
to timeslots at the BSC for radio traffic channels. (Typical commands supported are chg_ts_usage and
add_circuit / equip CIC).
The MSIs and MMSs required are detailed in the hardware file.
Default filename acct.mcd
Cont.
6-54 68P02900W22-Q
09-Sep-2004
System Information: DataGen Circuit table
CBL 0
OPL 0
OML 0 to 3
MTL 0 to 15
LMTL5 0 to 15
XBL 0 to 31 (Pre 1600), 0 to 9 (From 1600)
Associated Device ID 3 1 to 128 Mandatory if not used for signalling
links
Provides the ID of the associated RXCDR and AXCDR when at the BSS and the associated BSS and ABSS
when at the RXCDR.
At the BSC this is the device ID which corresponds to the RXCDR which provides the TRAU resource for
the CIC.
At the RXCDR this is the device ID which corresponds to the BSS which is managing the CIC. (This field
is not valid for local transcoding BSCs.)
Start Timeslot 2 1 to 31 Mandatory.
The Timeslot at which the defined block is to start.
End Timeslot 2 1 to 31 Mandatory if Type = TCH or RES,
otherwise unused.
The Timeslot at which the defined block is to end.
Start CIC 5 0 to 65,535 Mandatory if Type = TCH,
otherwise unused.
The CIC at which the defined block is to start.
End CIC 5 0 to 65,535 Mandatory if Type = TCH,
otherwise unused.
The CIC at which the defined block is to end.
Start Group 1 0 to 3 Mandatory if Type = TCH,
otherwise unused.
The starting group number for the start timeslot.
End Group 1 0 to 3 Mandatory if Type = TCH,
otherwise unused.
The ending group number for the end timeslot.
MSC MSI 2 0 to 71 Mandatory if Type = TCH,
otherwise unused.
MSI used to the MSC (valid only for local transcoding BSC and RXCDR sites).
Cont.
68P02900W22-Q 6-55
09-Sep-2004
Circuit table Chapter 6: MCDF tables
6-56 68P02900W22-Q
09-Sep-2004
System Information: DataGen Channel table
Channel table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-16 is only required for Remote Transcoders. This table contains the OML and MTL signalling links
through the remote transcoder. It also contains details of the traffic channels between the MSC and the BSC
on the remote transcoder. The MSIs and MMSs required are detailed in the hardware table.
Cont.
68P02900W22-Q 6-57
09-Sep-2004
Channel table Chapter 6: MCDF tables
6-58 68P02900W22-Q
09-Sep-2004
System Information: DataGen Links table
Links table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table is used for two different tasks (refer to Table 6-17):
• Non-RXCDR area
Contains details of the links between MMSs required by the paths. May also contain details of
the links between the RXCDR and its BSCs used by the XBL feature (add_conn from 1620).
• RXCDR area
Contains details of the links between the RXCDR and its BSCs used by the XBL feature
(add_conn from 1620, add_bss_conn from 1510 and add_xbl_conn for pre-1510).
In both cases, the MSIs and MMSs required are detailed in the Hardware table.
Default filename link.mcd
68P02900W22-Q 6-59
09-Sep-2004
Links table Chapter 6: MCDF tables
When the Link Type is LINK, Site Number A should always be 0 for the BSC. Site Number B is
the unique NE ID of the counterpart of the LINK (Transcoder).
6-60 68P02900W22-Q
09-Sep-2004
System Information: DataGen Paths table
Paths table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-18 contains details of all the paths/Dynets within the BSS area (providing signalling and traffic
communication between the BSC and the BTSs), using the links detailed in the links table. Details of
RSLs are also contained in this table.
Default filename path.mcd
Cont.
68P02900W22-Q 6-61
09-Sep-2004
Paths table Chapter 6: MCDF tables
6-62 68P02900W22-Q
09-Sep-2004
System Information: DataGen LAPD table
LAPD table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-19 contains details of the LAPD values for the RSLs and XBLs in the area. The RSLs and XBLs
required are detailed in the circuits and paths tables.
Default filename lapd.mcd.
Cont.
68P02900W22-Q 6-63
09-Sep-2004
LAPD table Chapter 6: MCDF tables
6-64 68P02900W22-Q
09-Sep-2004
System Information: DataGen Cell table
Cell table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-20 can detail all the cells across the OMC or network and also the external neighbours used by the
cells specified. The optional fields in this table contain information that overrides the defaults, as specified in
the "Generics table " on page 6-26.
Default filename cell.mcd
Cont.
68P02900W22-Q 6-65
09-Sep-2004
Cell table Chapter 6: MCDF tables
Cont.
6-66 68P02900W22-Q
09-Sep-2004
System Information: DataGen Cell table
If a value is not entered here, a generic value is used (refer to the "Generics table " on page 6-26).
Used for element rxlev_access_min.
ccch_conf 1 0, 1, 2, 4, 6
Optional, only used if
not an external cell.
If a value is not entered here, a generic value is used (refer to the "Generics table " on page 6-26).
0: 1 Timeslot using Timeslot 0
1: Combined ccch and sdcch on Timeslot 0
2: 2 Timeslots using Timeslots 0 and 2
4: 3 Timeslots using Timeslots 0, 2 and 4
6: 4 Timeslots using Timeslots 0, 2, 4 and 6
Cont.
68P02900W22-Q 6-67
09-Sep-2004
Cell table Chapter 6: MCDF tables
Cont.
6-68 68P02900W22-Q
09-Sep-2004
System Information: DataGen Cell table
Cont.
68P02900W22-Q 6-69
09-Sep-2004
Cell table Chapter 6: MCDF tables
network_control_order 1 0 to 4 Optional.
ts_in_usf_active 1 0 to 3 Optional.
inter_rat_enabled 1 0 to 3 Optional. Only applicable to
1650 loads and later.
The default value is 0.
qsearch_i 2 0 to 15 Optional. Only applicable to
1650 loads and later.
The default value is 15.
qsearch_c_initial 1 0 to 1 Optional. Only applicable to
1650 loads and later.
The default value is 0.
fdd_qoffset 2 0 to 15 Optional. Only applicable to
1650 loads and later.
Cont.
6-70 68P02900W22-Q
09-Sep-2004
System Information: DataGen Cell table
68P02900W22-Q 6-71
09-Sep-2004
Cell table Chapter 6: MCDF tables
To avoid the need for two ms_max_range elements (add_cell and chg_cell_element), the
ms_max_range parameter for ext_range_cell may be set in the ms_max_range field within
the cell table.
A default value of 63 is inserted into the ms_max_range parameter of the add_cell command
as the chg_cell_element value will override this. If this were not so, the add_cell command
would fail to compile with the new range.
6-72 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Statistics table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-21, the Statistics table, contains a list of statistical elements. Either the value from the value field
(if present) or the Motorola recommended value is set bss-wide but may be overridden for a site or cell by
values in the Specifics table.
Default filename stat.mcd
(Element dependent)
Default value of the statistics element.
Value 11 -2, 147, 483, 648 Optional.
to
+2, 147, 483, 647
(Element dependent)
Specific value of the statistics element.
68P02900W22-Q 6-73
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Table 6-22 shows the statistics elements and their recommended values.
The statistics air_dl_data_blks and air_ul_data_blks are not available if the EGPRS option
is purchased.
Cont.
6-74 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-75
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-76 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-77
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-78 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-79
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-80 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-81
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-82 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-83
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-84 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-85
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-86 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-87
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-88 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-89
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-90 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-91
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-92 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-93
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-94 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-95
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-96 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-97
09-Sep-2004
Statistics table Chapter 6: MCDF tables
Cont.
6-98 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Cont.
68P02900W22-Q 6-99
09-Sep-2004
Statistics table Chapter 6: MCDF tables
{22064}
Table 6-23 shows the new and modified Statistics table elements for GSM Half Rate and their recommended
values.
Cont.
6-100 68P02900W22-Q
09-Sep-2004
System Information: DataGen Statistics table
Table 6-23 Statistics table - elements for GSM Half Rate (Continued)
Element name Recommended value
{22064} busy_tch_hr,5,3 6
{22064} busy_tch_hr,5,4 8
{22064} busy_tch_hr,5,5 10
{22064} busy_tch_hr,5,6 12
{22064} busy_tch_hr,5,7 14
{22064} busy_tch_hr,5,8 16
{22064} busy_tch_hr,5,9 400
{22064} busy_tch_carr_hr,0 1
{22064} rf_losses_tch_hr,0 0
{22064} tch_congestion_hr,0 0
{22064} tch_cong_inner_zone_hr,0 0
{22064} fer_gsm_hr 0
{22064} ho_req_ack_to_msc 0
68P02900W22-Q 6-101
09-Sep-2004
Specifics table Chapter 6: MCDF tables
Specifics table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The Specifics table (Table 6-24) allows the user to specify specific values for chg_element and add_cell
elements for a particular site or cell overriding the parameters specified in the Generics, Timers and Statistics
tables.
Elements that can exist in the Cell table are not shown in the Specifics table.
Some elements exist here but do not exist in the Generics, Timers, or Statistics table because
of restrictions such as the following: elements that have no specific default value, or elements
that are specific to particular site/cell configurations, for example, elements only supported at
Horizonoffice.
Some elements that exist within the Generics, Timers or Statistics tables do not exist here because
they are only required for site 0 (BSC). Therefore, there may only be one instance of the element.
6-102 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
• efr_enabled
• dl_audio_lev_offset
• ul_audio_lev_offset
• volume_control_type
• enh_ter_cic_mgt_ena
LAC 6 6 digit numeric Optional.
The Location Area Code. This field can be entered in decimal or hex form. Hex numbers must be followed
by h or preceded by 0x; for example:1234h or 0x1234.
This field is used as the LAC of the Cell for which the specific value is required.
CI 6 6 digit numeric Optional (mandatory if
the LAC field contains a
cell’s LAC).
The Cell identifier can be entered in decimal or hex form. Hex numbers must be followed by h or preceded
by 0x; for example: 1234h or 0x1234.
This field is used as the CI of the Cell for which the specific value is required.
Value 11 -2, 147, 483, 647 Mandatory.
to
+2, 147, 483, 647
(Element dependent)
This field is used as the specific value.
68P02900W22-Q 6-103
09-Sep-2004
Specifics table Chapter 6: MCDF tables
access_per_agch,0
access_per_pch,0
{3723} access_per_ppch,0
access_per_rach,0
air_dl_control_blks,0
air_ul_control_blks,0
air_dl_data_blks,0
air_ul_data_blks,0
The statistics air_dl_data_blks and air_ul_data_blks are not available if the EGPRS option
is purchased.
{4445} air_dl_tbf_failures,0
{4445} air_ul_tbf_failures,0
adap_ho_alt_trigger_rxqual
adap_ho_pbgt
adap_ho_rxlev
adap_ho_rxqual
adap_trigger_hop_rxqual_dl
adap_trigger_hop_rxqual_ul
adap_trigger_pbgt
adap_trigger_rxlev_dl
adap_trigger_rxlev_ul
adap_trigger_rxqual_dl
adap_trigger_rxqual_ul
alloc_sdcch,0
alloc_sdcch_fail,0
alloc_sdcch_fail,2
alloc_sdcch_carr,0
alloc_tch,0
alloc_tch_carr,0
Cont.
6-104 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
alloc_tch_fail,0
alloc_tch_fail,2
{4322} alloc_tch_fail_hr_amr,0
alloc_tch_fail_inner_zone,0
alloc_tch_inner_zone,0
{4322} alloc_tch_hr_amr,0
alt_qual_proc
{4322} amr_fr_dl_codec_mode_usage,0
{4322} amr_fr_ul_codec_mode_usage,0
{4322} amr_hr_dl_codec_mode_usage,0
{4322} amr_hr_ul_codec_mode_usage,0
amr_fr_dl_adaption,0
amr_fr_ul_adaption,0
amr_hr_dl_adaption,0
amr_hr_ul_adaption,0
amr_increase_thresh_adjust,0
amr_decrease_thresh_adjust,0
{4322} amr_fr_dl_la_enabled
{4322} amr_fr_ul_la_enabled
{4322} amr_hr_dl_la_enabled
{4322} amr_hr_ul_la_enabled
{4322} amr_hr_res_ts
{4322} amr_hr_intracell_ho_allowed
{4322} amr_hop_count
{4322} amr_inner_hr_usage_thres
{4322} amr_half_rate_enabled
{4322} amr_full_rate_enabled
{4322} amr_new_calls_hr
{4322} amr_reconfig_fr_to_hr
{4415} ater_channel_status,0
{4415} ater_emerg_preempt_status,0
attach_detach
available_pdtch,0
auto_rf_loss_trace
available_sdcch,0
Cont.
68P02900W22-Q 6-105
09-Sep-2004
Specifics table Chapter 6: MCDF tables
available_tch,0
available_tch,4,0
available_tch,4,1
available_tch,4,2
available_tch,4,3
available_tch,4,4
available_tch,4,5
available_tch,4,6
available_tch,4,7
available_tch,4,8
available_tch,4,9
available_tch,5,0
available_tch,5,1
available_tch,5,2
available_tch,5,3
available_tch,5,4
available_tch,5,5
available_tch,5,6
available_tch,5,7
available_tch,5,8
available_tch,5,9
{4322} available_tch_hr_amr,0
bad_ho_refnum_ms,0
bad_ho_refnum_ms,2
band_preference
band_preference_mode
{23658} bep_period
{23658} bep_period2
ber,0
ber_loss_daily
ber_loss_hourly
bounce_protect_margin
bounce_protect_cong_tmr
bounce_protect_qual_tmr
bs_pa_mfrms
Cont.
6-106 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
{3723} bs_pag_blks_res
{3723} bs_pbcch_blks
{3723}bs_pcc_chans
{3723} bs_prach_blks
bssgp_block_retries
bssgp_fc_period_c
bssgp_flow_control
bssgp_racap_retries
bssgp_reset_retries
bssgp_scheduling
bssgp_t1_timer
bssgp_t2_timer
bssgp_t2_timer
bss_msc_overload_allowed
bts_escalation
bts_p_con_ack
bts_p_con_interval
bts_power_control_allowed
bts_txpwr_max_inner
busy_sdcch,0
busy_sdcch,4,0
busy_sdcch,4,1
busy_sdcch,4,2
busy_sdcch,4,3
busy_sdcch,4,4
busy_sdcch,4,5
busy_sdcch,4,6
busy_sdcch,4,7
busy_sdcch,4,8
busy_sdcch,4,9
busy_sdcch,5,0
busy_sdcch,5,1
busy_sdcch,5,2
busy_sdcch,5,3
busy_sdcch,5,4
Cont.
68P02900W22-Q 6-107
09-Sep-2004
Specifics table Chapter 6: MCDF tables
busy_sdcch,5,5
busy_sdcch,5,6
busy_sdcch,5,7
busy_sdcch,5,8
busy_sdcch,5,9
{4322} busy_tch_hr_amr,0
{4322} busy_tch_hr_amr,4,0
{4322} busy_tch_hr_amr,4,1
{4322} busy_tch_hr_amr,4,2
{4322} busy_tch_hr_amr,4,3
{4322} busy_tch_hr_amr,4,4
{4322} busy_tch_hr_amr,4,5
{4322} busy_tch_hr_amr,4,6
{4322} busy_tch_hr_amr,4,7
{4322} busy_tch_hr_amr,4,8
{4322} busy_tch_hr_amr,4,9
{4322} busy_tch_hr_amr,5,0
{4322} busy_tch_hr_amr,5,1
{4322} busy_tch_hr_amr,5,2
{4322} busy_tch_hr_amr,5,3
{4322} busy_tch_hr_amr,5,4
{4322} busy_tch_hr_amr,5,5
{4322} busy_tch_hr_amr,5,6
{4322} busy_tch_hr_amr,5,7
{4322} busy_tch_hr_amr,5,8
{4322} busy_tch_hr_amr,5,9
{4322} busy_tch_carr_hr_amr,0
busy_tch,0
busy_tch,4,0
busy_tch,4,1
busy_tch,4,2
busy_tch,4,3
busy_tch,4,4
busy_tch,4,5
busy_tch,4,6
Cont.
6-108 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
busy_tch,4,7
busy_tch,4,8
busy_tch,4,9
busy_tch,5,0
busy_tch,5,1
busy_tch,5,2
busy_tch,5,3
busy_tch,5,4
busy_tch,5,5
busy_tch,5,6
busy_tch,5,7
busy_tch,5,8
busy_tch,5,9
bvci
{3723} c31_hyst
{3723} c32_qual
call_trace_options
called_pci
calling_pci
calls_queued,0
calls_queued,2
carrier_disable_time
carriers_ins_pwr_fail
cbc_fast_select
cbc_intface_vers
cbc_vbind_cntr
cbs_outage_cntr
cbch_enabled
ccch_load_period
cell_bar_access_class
cell_bar_access_switch
cell_bar_qualify
cell_flush_reqs,0
cell_reselect_offset
cell_reselect_param_ind
Cont.
68P02900W22-Q 6-109
09-Sep-2004
Specifics table Chapter 6: MCDF tables
{4441} ch_req_unsvcd_pcu,0
chan_dl_tx_pwr_lvl,0
chan_dl_tx_pwr_lvl,4,0
chan_dl_tx_pwr_lvl,4,1
chan_dl_tx_pwr_lvl,4,2
chan_dl_tx_pwr_lvl,4,3
chan_dl_tx_pwr_lvl,4,4
chan_dl_tx_pwr_lvl,4,5
chan_dl_tx_pwr_lvl,4,6
chan_dl_tx_pwr_lvl,4,7
chan_dl_tx_pwr_lvl,4,8
chan_dl_tx_pwr_lvl,4,9
chan_dl_tx_pwr_lvl,5,0
chan_dl_tx_pwr_lvl,5,1
chan_dl_tx_pwr_lvl,5,2
chan_dl_tx_pwr_lvl,5,3
chan_dl_tx_pwr_lvl,5,4
chan_dl_tx_pwr_lvl,5,5
chan_dl_tx_pwr_lvl,5,6
chan_dl_tx_pwr_lvl,5,7
chan_dl_tx_pwr_lvl,5,8
chan_dl_tx_pwr_lvl,5,9
chan_req_cause_atmpt,0
chan_ul_tx_pwr_lvl,0
chan_ul_tx_pwr_lvl,4,0
chan_ul_tx_pwr_lvl,4,1
chan_ul_tx_pwr_lvl,4,2
chan_ul_tx_pwr_lvl,4,3
chan_ul_tx_pwr_lvl,4,4
chan_ul_tx_pwr_lvl,4,5
chan_ul_tx_pwr_lvl,4,6
chan_ul_tx_pwr_lvl,4,7
chan_ul_tx_pwr_lvl,4,8
chan_ul_tx_pwr_lvl,4,9
chan_ul_tx_pwr_lvl,5,0
Cont.
6-110 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
chan_ul_tx_pwr_lvl,5,1
chan_ul_tx_pwr_lvl,5,2
chan_ul_tx_pwr_lvl,5,3
chan_ul_tx_pwr_lvl,5,4
chan_ul_tx_pwr_lvl,5,5
chan_ul_tx_pwr_lvl,5,6
chan_ul_tx_pwr_lvl,5,7
chan_ul_tx_pwr_lvl,5,8
chan_ul_tx_pwr_lvl,5,9
chan_req_ms_blk,0
chan_req_ms_blk,2
chan_req_ms_fail,0
chan_req_ms_fail,2
channel_reconfiguration_switch
channel_reqs_rec,0
channel_reqs_reject,0
channel_reqs_success,0
cipher_mode_fail,0
cipher_mode_fail,2
ciph_mode_rej_allowed
classmk_update_fail,0
classmk_update_fail,2
clk_src_fail_reset_period
clr_cmd_from_msc,0
clr_req_to_msc,0
coding_scheme_change,0
coincident_offset
confusion_msg_allowed
congest_at_source
congest_at_target
congest_exist_ho_atmpt,0
congest_stand_ho_atmpt,0
congestion_lost_msu,0
congestion_lost_msu,2
{4445} cong_rel_dl_scts
Cont.
68P02900W22-Q 6-111
09-Sep-2004
Specifics table Chapter 6: MCDF tables
conn_refused,0
conn_req_to_msc,0
cp_option_reset_ckt
cp_option_rr_status
cpu_usage,0
cpu_usage,4,0
cpu_usage,4,1
cpu_usage,4,2
cpu_usage,4,3
cpu_usage,4,4
cpu_usage,4,5
cpu_usage,4,6
cpu_usage,4,7
cpu_usage,4,8
cpu_usage,4,9
cpu_usage,5,0
cpu_usage,5,1
cpu_usage,5,2
cpu_usage,5,3
cpu_usage,5,4
cpu_usage,5,5
cpu_usage,5,6
cpu_usage,5,7
cpu_usage,5,8
cpu_usage,5,9
cr_calling
cs34_enabled
crm_timer_value,0
crm_timer_value,1
crm_timer_value,2
crm_timer_value,3
crm_timer_value,4
crm_timer_value,5
crm_timer_value,6
crm_timer_value,7
Cont.
6-112 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
crm_timer_value,8
crm_timer_value,9
crm_timer_value,10
crm_timer_value,11
crm_timer_value,12
crmpc_timer_value,0
crmpc_timer_value,1
crmpc_timer_value,2
crmpc_timer_value,3
crmpc_timer_value,4
crmpc_timer_value,5
crmpc_timer_value,6
crmpc_timer_value,7
crmpc_timer_value,8
cs12_on_32k_chan,0
d1_ba_alloc_proc
d1_missing_report
d1_ncell_proc
d1_sdcch_ho
d1_sdcch_timer_ho
decision_1_dl_rxlev_av_h
decision_1_dl_rxlev_av_ih
decision_1_dl_rxlev_av_p
decision_1_dl_rxqual_av_h
decision_1_dl_rxqual_av_p
decision_1_n1
decision_1_n2
decision_1_n3
decision_1_n4
decision_1_n5
decision_1_n6
decision_1_n7
decision_1_n8
decision_1_ncell_rxlev_av_h_calc
decision_1_p1
Cont.
68P02900W22-Q 6-113
09-Sep-2004
Specifics table Chapter 6: MCDF tables
decision_1_p2
decision_1_p3
decision_1_p4
decision_1_p5
decision_1_p6
decision_1_p7
decision_1_p8
decision_1_p_bgt_rxlev_av_h
decision_1_tim_adv_av_alg
decision_1_ul_rxlev_av_h
decision_1_ul_rxlev_av_ih
decision_1_ul_rxlev_av_p
decision_1_ul_rxqual_av_h
decision_1_ul_rxqual_av_p
decision_alg_num
decision_alg_type
direct_inner_zone_threshold
disuse_cnt_hreqave
dl_audio_lev_offset
dl_busy_pdtch,0
dl_busy_pdtch,4,0
dl_busy_pdtch,4,1
dl_busy_pdtch,4,2
dl_busy_pdtch,4,3
dl_busy_pdtch,4,4
dl_busy_pdtch,4,5
dl_busy_pdtch,4,6
dl_busy_pdtch,4,7
dl_busy_pdtch,4,8
dl_busy_pdtch,4,9
dl_busy_pdtch,5,0
dl_busy_pdtch,5,1
dl_busy_pdtch,5,2
dl_busy_pdtch,5,3
dl_busy_pdtch,5,4
Cont.
6-114 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
dl_busy_pdtch,5,5
dl_busy_pdtch,5,6
dl_busy_pdtch,5,7
dl_busy_pdtch,5,8
dl_busy_pdtch,5,9
dl_dtx_voice_data
dl_pdtch_congestion,0
dl_pdtch_q_length,0
dl_pdtch_seizure,0
{23658} dl_radio_blks_1_ts
{23658} dl_radio_blks_2_ts
{23658} dl_radio_blks_3_ts
{23658} dl_radio_blks_4_ts
{23658} dl_rlc_ack_new_blks
{23658} dl_rlc_ddtr_blks
{23658} dl_rlc_nack_blks
{23658} dl_rlc_retx_blks
{23658} dl_rlc_stalled _blks
{23658} dl_rlc_unack_new_blks
dl_rxlev_ho_allowed
dl_rxqual_ho_allowed
{23658} dl_tbf_time_1_ts
{23658} dl_tbf_time_2_ts
{23658} dl_tbf_time_3_ts
{23658} dl_tbf_time_4_ts
downlink_sync_timer
dr_chan_mode_modify
dr_ho_during_assign
dr_msc_preference
dr_preference
dr_standard_congest
dtx_required
dual_band_offset
dyn_step_adj
dyn_step_adj_fmpr
Cont.
68P02900W22-Q 6-115
09-Sep-2004
Specifics table Chapter 6: MCDF tables
dynet_assign_fail,0
dynet_call_rejects,0
dynet_retry_time
dynet_tchs_reserved
efr_enabled
efr_req_from_msc,0
{23658} egprs_avail_pdtch
{23658} egprs_64k_channels_switched
{23658} egprs_64k_not_avail
{23658} egprs_dl_asgn_pccch
{23658} egprs_init_dl_cs
{23658} egprs_init_ul_cs
egsm_handover_threshold
emergency_class_switch
en_incom_ho
enhanced_relief
enh_ter_cic_mgt_ena_val
er_intra_cell_ho_atmpt,0
er_intra_cell_ho_suc,0
erc_ta_priority
extended_paging_active
fer,0
{4322} fer_amr_fr,0
{4322} ffer_amr_hr,0
flow_control_barred,0
frmr,0
frmr,2
full_pwr_rfloss
{4441} g_rach_unsvcd_bts,0
gbl_link_ins,0
gbl_dl_data_thrput,0
gbl_flow_ctrl_sent,0
gbl_paging_reqs,0
gbl_dl_data_thrput_hist,0
gbl_dl_data_thrput_hist,4,0
Cont.
6-116 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
gbl_dl_data_thrput_hist,4,1
gbl_dl_data_thrput_hist,4,2
gbl_dl_data_thrput_hist,4,3
gbl_dl_data_thrput_hist,4,4
gbl_dl_data_thrput_hist,4,5
gbl_dl_data_thrput_hist,4,6
gbl_dl_data_thrput_hist,4,7
gbl_dl_data_thrput_hist,4,8
gbl_dl_data_thrput_hist,4,9
gbl_dl_data_thrput_hist,5,0
gbl_dl_data_thrput_hist,5,1
gbl_dl_data_thrput_hist,5,2
gbl_dl_data_thrput_hist,5,3
gbl_dl_data_thrput_hist,5,4
gbl_dl_data_thrput_hist,5,5
gbl_dl_data_thrput_hist,5,6
gbl_dl_data_thrput_hist,5,7
gbl_dl_data_thrput_hist,5,8
gbl_dl_data_thrput_hist,5,9
gbl_ul_data_thrput_hist_0
gbl_ul_data_thrput_hist,4,0
gbl_ul_data_thrput_hist,4,1
gbl_ul_data_thrput_hist,4,2
gbl_ul_data_thrput_hist,4,3
gbl_ul_data_thrput_hist,4,4
gbl_ul_data_thrput_hist,4,5
gbl_ul_data_thrput_hist,4,6
gbl_ul_data_thrput_hist,4,7
gbl_ul_data_thrput_hist,4,8
gbl_ul_data_thrput_hist,4,9
gbl_ul_data_thrput_hist,5,0
gbl_ul_data_thrput_hist,5,1
gbl_ul_data_thrput_hist,5,2
gbl_ul_data_thrput_hist,5,3
gbl_ul_data_thrput_hist,5,4
Cont.
68P02900W22-Q 6-117
09-Sep-2004
Specifics table Chapter 6: MCDF tables
gbl_ul_data_thrput_hist,5,5
gbl_ul_data_thrput_hist,5,6
gbl_ul_data_thrput_hist,5,7
gbl_ul_data_thrput_hist,5,8
gbl_ul_data_thrput_hist,5,9
gbl_ul_data_thrput,0
gbl_unavailable,0
gprs_access_per_agch,0
gprs_access_per_rach,0
gprs_cell_reselect_attmpt,0
gprs_cell_reselect_fail,0
gprs_cell_reselect_hysteresis
gprs_channels_switched,0
gprs_32K_channels_switched,0
gprs_32K_dl_not_avail,0
gprs_32K_ul_not_avail,0
gprs_dl_asgn_pccch,0
gprs_dynet_failures,0
gprs_dynet_res_reqs,0
gprs_dynet_swi_reqs,0
gprs_dynet_res_reqs,4,0
gprs_dynet_res_reqs,4,1
gprs_dynet_res_reqs,4,2
gprs_dynet_res_reqs,4,3
gprs_dynet_res_reqs,4,4
gprs_dynet_res_reqs,4,5
gprs_dynet_res_reqs,4,6
gprs_dynet_res_reqs,4,7
gprs_dynet_res_reqs,4,8
gprs_dynet_res_reqs,4,9
gprs_dynet_res_reqs,5,0
gprs_dynet_res_reqs,5,1
gprs_dynet_res_reqs,5,2
gprs_dynet_res_reqs,5,3
gprs_dynet_res_reqs,5,4
Cont.
6-118 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
gprs_dynet_res_reqs,5,5
gprs_dynet_res_reqs,5,6
gprs_dynet_res_reqs,5,7
gprs_dynet_res_reqs,5,8
gprs_dynet_res_reqs,5,9
gprs_dynet_swi_reqs,4,0
gprs_dynet_swi_reqs,4,1
gprs_dynet_swi_reqs,4,2
gprs_dynet_swi_reqs,4,3
gprs_dynet_swi_reqs,4,4
gprs_dynet_swi_reqs,4,5
gprs_dynet_swi_reqs,4,6
gprs_dynet_swi_reqs,4,7
gprs_dynet_swi_reqs,4,8
gprs_dynet_swi_reqs,4,9
gprs_dynet_swi_reqs,5,0
gprs_dynet_swi_reqs,5,1
gprs_dynet_swi_reqs,5,2
gprs_dynet_swi_reqs,5,3
gprs_dynet_swi_reqs,5,4
gprs_dynet_swi_reqs,5,5
gprs_dynet_swi_reqs,5,6
gprs_dynet_swi_reqs,5,7
gprs_dynet_swi_reqs,5,8
gprs_dynet_swi_reqs,5,9
gprs_ms_neighbor_strong,0
gprs_pch_agch_q_length,0
gbl_thrput_period
gclk_qwarm_flag
global_reset_repetitions
gproc_slots
gprs_bs_cv_max
gprs_drx_timer_max
gprs_intraho_allwd
gprs_min_prr_blks
Cont.
68P02900W22-Q 6-119
09-Sep-2004
Specifics table Chapter 6: MCDF tables
gprs_ms_pan_dec
gprs_ms_pan_inc
gprs_ms_pan_max
gprs_ms_txpwr_max_cch
gprs_pb
gprs_pc_alpha
gprs_pc_meas_chan
{3723} gprs_penalty_time
{3723} gprs_ppch_pagch__q_length,0
{4441} gprs_prr_blk_usg,0
{4441} gprs_prr_blk_usg,4,0
{4441} gprs_prr_blk_usg,4,1
{4441} gprs_prr_blk_usg,4,2
{4441} gprs_prr_blk_usg,4,3
{4441} gprs_prr_blk_usg,4,4
{4441} gprs_prr_blk_usg,4,5
{4441} gprs_prr_blk_usg,4,6
{4441} gprs_prr_blk_usg,4,7
{4441} gprs_prr_blk_usg,4,8
{4441} gprs_prr_blk_usg,4,9
{4441} gprs_prr_blk_usg,5,0
{4441} gprs_prr_blk_usg,5,1
{4441} gprs_prr_blk_usg,5,2
{4441} gprs_prr_blk_usg,5,3
{4441} gprs_prr_blk_usg,5,4
{4441} gprs_prr_blk_usg,5,5
{4441} gprs_prr_blk_usg,5,6
{4441} gprs_prr_blk_usg,5,7
{4441} gprs_prr_blk_usg,5,8
{4441} gprs_prr_blk_usg,5,9
{4441} gprs_rach_arrival,0
{4441} gprs_rach_arrival,4,0
{4441} gprs_rach_arrival,4,1
{4441} gprs_rach_arrival,4,2
{4441} gprs_rach_arrival,4,3
Cont.
6-120 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
{4441} gprs_rach_arrival,4,4
{4441} gprs_rach_arrival,4,5
{4441} gprs_rach_arrival,4,6
{4441} gprs_rach_arrival,4,7
{4441} gprs_rach_arrival,4,8
{4441} gprs_rach_arrival,4,9
{4441} gprs_rach_arrival,5,0
{4441} gprs_rach_arrival,5,1
{4441} gprs_rach_arrival,5,2
{4441} gprs_rach_arrival,5,3
{4441} gprs_rach_arrival,5,4
{4441} gprs_rach_arrival,5,5
{4441} gprs_rach_arrival,5,6
{4441} gprs_rach_arrival,5,7
{4441} gprs_rach_arrival,5,8
{4441} gprs_rach_arrival,5,9
gprs_reconfig_thresh_idle_tch
{3723} gprs_reselect_offset
{3723} gprs_rxlev_access_min
gprs_sig_bvci
gprs_t3168
gprs_t3192
{3723} gprs_temporary_offset
gprs_ts_config_alg
gprs_smg30_t3192
group_block_unblock_allowed
gsm_cell_id_format
handover_recognized_period
handover_required_curr_ch
handover_required_reject_switch
{3723} hcs_thr
hdsl_losw_oos
hdsl_losw_restore
hdsl_snr_daily
hdsl_snr_daily_mon_period
Cont.
68P02900W22-Q 6-121
09-Sep-2004
Specifics table Chapter 6: MCDF tables
hdsl_snr_hourly
hdsl_snr_hourly_mon_period
hdsl_snr_oos
hdsl_snr_restore
ho_ack
ho_complete
ho_exist_congest
ho_fail_no_resources,0
ho_margin_usage_flag
ho_only_max_pwr
ho_pwr_level_inner
{4322} ho_req_from_msc,0
ho_req_msc_fail,0
ho_req_msc_fail,2
ho_req_msc_ok,0
ho_req_msc_proto,0
ho_req_msc_proto,2
hop_count
hop_count_timer
hopping_support
hopping_systems_enabled,0
hopping_systems_enabled,1
hopping_systems_enabled,2
hopping_systems_enabled,3
hopping_systems_enabled,4
hopping_systems_enabled,5
hopping_systems_enabled,6
hopping_systems_enabled,7
hopping_systems_enabled,8
hopping_systems_enabled,9
hopping_systems_enabled,10
hopping_systems_enabled,11
hopping_systems_enabled,12
hopping_systems_enabled,13
hopping_systems_enabled,14
Cont.
6-122 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
hopping_systems_enabled,15
hopping_systems_hsn,0
hopping_systems_hsn,1
hopping_systems_hsn,2
hopping_systems_hsn,3
hopping_systems_hsn,4
hopping_systems_hsn,5
hopping_systems_hsn,6
hopping_systems_hsn,7
hopping_systems_hsn,8
hopping_systems_hsn,9
hopping_systems_hsn,10
hopping_systems_hsn,11
hopping_systems_hsn,12
hopping_systems_hsn,13
hopping_systems_hsn,14
hopping_systems_hsn,15
i_frames_rx,0
i_frames_tx,0
idle_pdtch_intf_band,0,0
idle_pdtch_intf_band,1,0
idle_pdtch_intf_band,2,0
idle_pdtch_intf_band,3,0
idle_pdtch_intf_band,4,0
idle_tch_intf_band0,0
idle_tch_intf_band1,0
idle_tch_intf_band2,0
idle_tch_intf_band3,0
idle_tch_intf_band4,0
illegal_circuit_id
immediate_assign_mode
imm_assgn_cause
in_inter_bss_ho,0
in_intra_bss_ho,0
in_intra_bss_nc_atmpt,0
Cont.
68P02900W22-Q 6-123
09-Sep-2004
Specifics table Chapter 6: MCDF tables
in_intra_bss_nc_suc,0
initial_sync_timer
intave
{4445} init_dl_cs
{4445} init_ul_cs
inter_cell_handover_allowed
interband_activity,0
interband_ho_allowed
interfer_bands,0
interfer_bands,1
interfer_bands,2
interfer_bands,3
interfer_bands,4
interfer_ho_allowed
intf_on_idle,0
intf_on_idle,4,0
intf_on_idle,4,1
intf_on_idle,4,2
intf_on_idle,4,3
intf_on_idle,4,4
intf_on_idle,4,5
intf_on_idle,4,6
intf_on_idle,4,7
intf_on_idle,4,8
intf_on_idle,4,9
intf_on_idle,5,0
intf_on_idle,5,1
intf_on_idle,5,2
intf_on_idle,5,3
intf_on_idle,5,4
intf_on_idle,5,5
intf_on_idle,5,6
intf_on_idle,5,7
intf_on_idle,5,8
intf_on_idle,5,9
Cont.
6-124 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
intra_bss_ho,0
intra_bss_ho_cause_suc,0
intra_cell_handover_allowed
intra_cell_ho,0
inv_est_cause_on_rach,0
invalid_frames_rx,0
invalid_frames_rx,2
l_rxlev_dl_h
l_rxlev_dl_p
l_rxlev_ul_h
l_rxlev_ul_p
l_rxqual_dl_h
l_rxqual_dl_h_data
l_rxqual_dl_h_hopping
l_rxqual_dl_p
l_rxqual_dl_p_data
l_rxqual_dl_p_hopping
l_rxqual_ul_h
l_rxqual_ul_h_data
l_rxqual_ul_h_hopping
l_rxqual_ul_p
l_rxqual_ul_p_data
l_rxqual_ul_p_hopping
{4322} l_rxqual_ul_p_amr_fr
{4322} l_rxqual_ul_p_amr_hr
{4322} l_rxqual_ul_h_amr_fr
{4322} l_rxqual_ul_h_amr_hr
{4322} u_rxqual_ul_p_amr_hr
{4322} l_rxqual_ul_h_hopping_amr_fr
{4322} l_rxqual_ul_h_hopping_amr_hr
{4322} l_rxqual_ul_p_hopping_amr_fr
{4322} l_rxqual_ul_p_hopping_amr_hr
{4322} l_rxqual_dl_p_amr_fr
{4322} l_rxqual_dl_p_amr_hr
{4322} l_rxqual_dl_h_amr_fr
Cont.
68P02900W22-Q 6-125
09-Sep-2004
Specifics table Chapter 6: MCDF tables
{4322} l_rxqual_dl_h_amr_hr
{4322} u_rxqual_dl_p_amr_hr
{4322} l_rxqual_dl_h_hopping_amr_fr
{4322} l_rxqual_dl_h_hopping_amr_hr
{4322} l_rxqual_dl_p_hopping_amr_fr
{4322} l_rxqual_dl_p_hopping_amr_hr
layer_number
link_about_to_fail
link_fail
local_maintenance
low_sig_thresh
lta_alarm_range
ltu_fw_auto_download
ma_cmd_to_ms,0
ma_cmd_to_ms_blkd,0
ma_cmd_to_ms_blkd,2
ma_complete_to_msc,0
ma_fail_from_ms,0
ma_fail_from_ms,2
ma_req_from_msc,0
ma_req_from_msc_fail,0
ma_req_from_msc_fail,2
max_gprs_ts_per_carrier
max_ms_dl_buffer
max_ms_dl_rate
max_q_length_full_rate_channel
max_q_length_immediate_assignments
max_q_length_sdcch
max_retran
max_rst_ckt_timer_exps
mb_tch_congest_thres
min_gprs_ts_per_carrier
6-126 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
mms_cat_enable
mms_config_type
ms_access_by_type,0
ms_class_1_10_req,0
ms_class_11,20_req,0
ms_class,21_29_req,0
ms_distance_allowed
ms_p_con_ack
ms_power_control_allowed
ms_power_level_period
ms_power_offset
ms_tch_usage_by_type,0
ms_txpwr_max_def
ms_txpwr_max_inner
mspwr_alg
mtl_loadshare_granularity
msu_discarded,0
msu_discarded,2
mt_lcs_on_sdcch,0
mtp_changeback,0
mtp_changeover,0
mtp_congestion,0
mtp_link_ins,0
mtp_linkfail,0
mtp_local_busy,0
mtp_local_mgt,0
Cont.
68P02900W22-Q 6-127
09-Sep-2004
Specifics table Chapter 6: MCDF tables
mtp_mgt_inhibit,0
mtp_mgt_uninhibit,0
mtp_msu_rx,0
mtp_msu_tx,0
mtp_neg_acks,0
mtp_neg_acks,2
mtp_re_tx,0
mtp_re_tx,2
mtp_remote_mgt,0
mtp_remote_proc,0
mtp_restoration,0
mtp_sif_sio_rx,0
mtp_sif_sio_tx,0
mtp_sl_ack,0
mtp_sl_ack,2
mtp_sl_alignment,0
mtp_sl_alignment,2
mtp_sl_congestion,0
mtp_sl_congestion,2
mtp_sl_error_rate,0
mtp_sl_error_rate,2
mtp_sl_fail,0
mtp_sl_fail,2
mtp_sl_fibr,0
mtp_sl_fibr,2
mtp_start_rpo,0
mtp_start_rpo,2
mtp_stop_rpo,0
mtp_su_error,0
mtp_su_error,2
mtp_unavailable,0
multiband_reporting
n_avg
n_avg_i
n2_expiry,0
Cont.
6-128 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
n2_expiry,2
no_pdtch_avail,0
no_pdtch_avail_time,0
ncc_of_plmn_allowed
neighbor_journal
neighbor_report_timer
ns_alive_retries
ns_alive_timer
ns_block_retries
ns_block_timer
ns_reset_period
ns_reset_timer
ns_test_timer
ns_unblock_retries
num_audit_retries
num_emerg_access,0
num_emerg_rejected,0
num_emerg_tch_kill,0
num_emerg_term_sdcch,0
num_gbl_dl_thrput_samples
num_gbl_ul_thrput_samples
number_of_preferred_cells
ok_acc_proc,0
ok_acc_proc_suc_rach,0
option_alg_a5_1
option_alg_a5_2
option_alg_a5_3
option_alg_a5_4
option_alg_a5_5
option_alg_a5_6
option_alg_a5_7
option_cbsms
option_emergency_preempt
out_ho_cause_atmpt,0
out_inter_bss_ho,0
Cont.
68P02900W22-Q 6-129
09-Sep-2004
Specifics table Chapter 6: MCDF tables
out_intra_bss_ho,0
out_intra_bss_nc_atmpt,0
out_intra_bss_nc_suc,0
outer_zone_usage_level
override_intra_bss_pre_transfer
page_req_from_msc,0
page_req_from_msc_fail,0
page_req_from_msc_fail,2
paging_requests,0
path_balance,0
path_balance,4,0
path_balance,4,1
path_balance,4,2
path_balance,4,3
path_balance,4,4
path_balance,4,5
path_balance,4,6
path_balance,4,7
path_balance,4,8
path_balance,4,9
path_balance,5,0
path_balance,5,1
path_balance,5,2
path_balance,5,3
path_balance,5,4
path_balance,5,5
path_balance,5,6
path_balance,5,7
path_balance,5,8
path_balance,5,9
pbgt_mode
{3723} pccch_drx_timer_max
{3723} pccch_enabled
pch_agch_q_length,0
pch_q_page_discard,0
Cont.
6-130 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
pcr_enable
pcr_n1
pcr_n2
penalty_time
{4441} percent_traf_cs
phase2_classmark_allowed
phase2_resource_ind_allowed
phase_lock_gclk
poor_initial_assignment
pool_gproc_preemption
pow_inc_step_size
pow_inc_step_size_dl
pow_inc_step_size_ul
pow_red_step_size
pow_red_step_size_dl
pow_red_step_size_ul
{3723} ppch_q_page_discard,0
{3723} prach_s
{3723} prach_tx_int
{4040} primary_pcu
prioritize_microcell
{3723} priority_class
protect_last_ts
prp_load,0
prp_load,4,0
prp_load,4,1
prp_load,4,2
prp_load,4,3
prp_load,4,4
prp_load,4,5
prp_load,4,6
prp_load,4,7
prp_load,4,8
prp_load,4,9
prp_load,5,0
Cont.
68P02900W22-Q 6-131
09-Sep-2004
Specifics table Chapter 6: MCDF tables
prp_load,5,1
prp_load,5,2
prp_load,5,3
prp_load,5,4
prp_load,5,5
prp_load,5,6
prp_load,5,7
prp_load,5,8
prp_load,5,9
{3723} psi1_repeat_period
pwr_handover_allowed
pwrc
{3723} qsearch_p
queue_management_information
rac
ra_colour
{3723} ra_reselect_hysteresis
rach_load_period
rach_load_threshold
rach_load_type
radio_link_timeout
rapid_pwr_down
red_loss_daily
red_loss_hourly
red_loss_oos
red_loss_restore
red_time_oos
red_time_restore
reestablish_allowed
remote_loss_daily
remote_loss_daily_pcu
remote_loss_hourly
remote_loss_hourly_pcu
remote_loss_oos
remote_loss_oos_pcu
Cont.
6-132 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
remote_loss_restore
remote_time_oos
remote_time_oos_pcu
remote_time_restore
remote_time_restore_pcu
report_resource_tch_f_high_water_mark
report_resource_tch_f_low_water_mark
res_gprs_pdchs
res_ts_less_one_carrier
rber,0
rf_losses_sd,0
rf_losses_sd,2
rf_losses_tch,0
rf_losses_tch,2
{4322} rf_losses_tch_hr_amr,0
rf_res_ind_period
roc,0
roc,4,0
roc,4,1
roc,4,2
roc,4,3
roc,4,4
roc,4,5
roc,4,6
roc,4,7
roc,4,8
roc,4,9
roc,5,0
roc,5,1
roc,5,2
roc,5,3
roc,5,4
roc,5,5
roc,5,6
roc,5,7
Cont.
68P02900W22-Q 6-133
09-Sep-2004
Specifics table Chapter 6: MCDF tables
roc,5,8
roc,5,9
routing_syntax,0
routing_syntax,2
routing_unknown,0
routing_unknown,2
rpd_offset
rpd_period
rpd_trigger
rpt_bad_qual_no_mr
rrsm_timer_value,0
rrsm_timer_value,3
rrsm_timer_value,5
rrsm_timer_value,8
rrsm_timer_value,9
rrsm_timer_value,10
rrsm_timer_value,11
rrsm_timer_value,12
rrsm_timer_value,13
rrsm_timer_value,14
rrsm_timer_value,15
rrsm_timer_value,16
rrsm_timer_value,18
rrsmpc_timer_value,0
rrsmpc_timer_value,1
rrs_timer_values,0
rrs_timer_values,1
rrs_timer_values,2
rrs_timer_values,3
rrspc_timer_values,0
rrspc_timer_values,1
rxlev_dl_zone
rxlev_ul_zone
sabm_tx,0
sccp_bssap_mgt
Cont.
6-134 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
sccp_msgs,0
sccp_msgs_rx,0
sccp_msgs_tx,0
sdcch_congestion,0
secondary_freq_type
sdcch_tch_band_reassign_delay
{3723} search_prio_3g
second_assign_atmpt,0
second_assign_suc,0
sif_sio_rx_opc,0
sif_sio_tx_dpc,0
sif_sio_type,0
sl_congestion,0
sl_congestion,2
sl_stop_congestion,0
slip_loss_daily
slip_loss_hourly
slip_loss_oos
slip_loss_restore
smg_gb_vers
smg_um_vers
sms_dl_allowed
sms_init_on_sdcch,0
sms_init_on_tch,0
sms_no_bcast_msg,0
sms_tch_chan
sms_ul_allowed
ss7_mode
ssm_critical_overload_threshold
ssm_normal_overload_threshold
ssmpc_timer_value
ssp_burst_delay
ssp_burst_limit
static_sync_timer
stat_interval
Cont.
68P02900W22-Q 6-135
09-Sep-2004
Specifics table Chapter 6: MCDF tables
sw_ts_less_one_carrier
switch_gprs_pdchs
sync_loss_daily
sync_loss_daily_pcu
sync_loss_hourly
sync_loss_hourly_pcu
sync_loss_oos
sync_loss_oos_pcu
sync_loss_restore
sync_time_oos
sync_time_oos_pcu
sync_time_restore
sync_time_restore_pcu
t_avg_t
t_avg_w
tch_busy_critical_threshold
tch_busy_norm_threshold
tch_cong_inner_zone,0
tch_congestion,0
{4322} tch_congestion_hr_amr,0
{4322} tch_cong_inner_zone_hr_amr,
tch_congest_prevent_thres
tch_delay,0
tch_delay,4,0
tch_delay,4,1
tch_delay,4,2
tch_delay,4,3
tch_delay,4,4
tch_delay,4,5
tch_delay,4,6
tch_delay,4,7
tch_delay,4,8
tch_delay,4,9
tch_delay,5,0
tch_delay,5,1
Cont.
6-136 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
tch_delay,5,2
tch_delay,5,3
tch_delay,5,4
tch_delay,5,5
tch_delay,5,6
tch_delay,5,7
tch_delay,5,8
tch_delay,5,9
tch_flow_control
tch_full_need_low_water_mark
tch_q_length,0
tch_q_length,4,0
tch_q_length,4,1
tch_q_length,4,2
tch_q_length,4,3
tch_q_length,4,4
tch_q_length,4,5
tch_q_length,4,6
tch_q_length,4,7
tch_q_length,4,8
tch_q_length,4,9
tch_q_length,5,0
tch_q_length,5,1
tch_q_length,5,2
tch_q_length,5,3
tch_q_length,5,4
tch_q_length,5,5
tch_q_length,5,6
tch_q_length,5,7
tch_q_length,5,8
tch_q_length,5,9
tch_usage,0
tch_usage_ext_range,0
tch_usage_inner_zone,0
temporary_offset
Cont.
68P02900W22-Q 6-137
09-Sep-2004
Specifics table Chapter 6: MCDF tables
threshold
timing_advance_period
{23658} tlli_blk_coding
total_calls,0
trunk_critical_threshold
trunk_major_threshold
ts_alloc_flag
tsc_update_method
tx_integer
tx_power_cap
u_ber,0
u_ber,4,0
u_ber,4,1
u_ber,4,2
u_ber,4,3
u_ber,4,4
u_ber,4,5
u_ber,4,6
u_ber,4,7
u_ber,4,8
u_ber,4,9
u_ber,5,0
u_ber,5,1
u_ber,5,2
u_ber,5,3
u_ber,5,4
u_ber,5,5
u_ber,5,6
u_ber,5,7
u_ber,5,8
u_ber,5,9
u_rxlev_dl_ih
u_rxlev_dl_p
u_rxlev_ul_ih
u_rxlev_ul_p
Cont.
6-138 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
u_rxqual_dl_p
u_rxqual_ul_p
ul_audio_lev_offset
ul_busy_pdtch,0
ul_busy_pdtch,4,0
ul_busy_pdtch,4,1
ul_busy_pdtch,4,2
ul_busy_pdtch,4,3
ul_busy_pdtch,4,4
ul_busy_pdtch,4,5
ul_busy_pdtch,4,6
ul_busy_pdtch,4,7
ul_busy_pdtch,4,8
ul_busy_pdtch,4,9
ul_busy_pdtch,5,0
ul_busy_pdtch,5,1
ul_busy_pdtch,5,2
ul_busy_pdtch,5,3
ul_busy_pdtch,5,4
ul_busy_pdtch,5,5
ul_busy_pdtch,5,6
ul_busy_pdtch,5,7
ul_busy_pdtch,5,8
ul_busy_pdtch,5,9
ul_pdtch_congestion,0
ul_pdtch_q_length,0
ul_pdtch_seizure,0
{23658} ul_radio_blks_gmsk_1_ts,0
{23658} ul_radio_blks_gmsk_2_ts,0
{23658} ul_radio_blks_8psk_1_ts,0
{23658} ul_radio_blks_8psk_2_ts,0
{23658} ul_rlc_ack_new_blks,0
{23658} ul_rlc_retx_blks,0
{23658} ul_rlc_unack_new_blks,0
{23658} ul_tbf_time_gmsk_1_ts,0
Cont.
68P02900W22-Q 6-139
09-Sep-2004
Specifics table Chapter 6: MCDF tables
{23658} ul_tbf_time_gmsk_2_ts,0
{23658} ul_tbf_time_8psk_1_ts,0
{23658} ul_tbf_time_8psk_2_ts,0
ul_rxlev_ho_allowed
ul_rxqual_ho_allowed
unequipped_circuit_allowed
update_c
uplink_path_loss,0
uplink_path_loss,4,0
uplink_path_loss,4,1
uplink_path_loss,4,2
uplink_path_loss,4,3
uplink_path_loss,4,4
uplink_path_loss,4,5
uplink_path_loss,4,6
uplink_path_loss,4,7
uplink_path_loss,4,8
uplink_path_loss,4,9
uplink_path_loss,5,0
uplink_path_loss,5,1
uplink_path_loss,5,2
uplink_path_loss,5,3
uplink_path_loss,5,4
uplink_path_loss,5,5
uplink_path_loss,5,6
uplink_path_loss,5,7
uplink_path_loss,5,8
uplink_path_loss,5,9
uplink_sync_timer
use_bcch_for_gprs
6-140 68P02900W22-Q
09-Sep-2004
System Information: DataGen Specifics table
use_derived_ho_power
use_neighbor_pbgt_hreqave
volume_control_type
wait_for_reselection
wait_indication_parameters
worse_neighbor_ho
zone_change_atmpt,0
zone_change_suc,0
zone_ho_hyst
{22064}
Table 6-26 lists the new and modified parameters supported in the Specifics table for GSM Half Rate.
{22064} alloc_tch_hr,0
{22064} alloc_tch_fail_hr,0
{22064} available_tch_hr,0
{22064} busy_tch_carr_hr,0
{22064} busy_tch_hr,0
{22064} busy_tch_hr,4,0
{22064} busy_tch_hr,4,1
{22064} busy_tch_hr,4,2
{22064} busy_tch_hr,4,3
{22064} busy_tch_hr,4,4
{22064} busy_tch_hr,4,5
{22064} busy_tch_hr,4,6
{22064} busy_tch_hr,4,7
{22064} busy_tch_hr,4,8
Cont.
68P02900W22-Q 6-141
09-Sep-2004
Specifics table Chapter 6: MCDF tables
Table 6-26 Specifics table - elements for GSM Half Rate (Continued)
{22064} busy_tch_hr,4,9
{22064} busy_tch_hr,5,0
{22064} busy_tch_hr,5,1
{22064} busy_tch_hr,5,2
{22064} busy_tch_hr,5,3
{22064} busy_tch_hr,5,4
{22064} busy_tch_hr,5,5
{22064} busy_tch_hr,5,6
{22064} busy_tch_hr,5,7
{22064} busy_tch_hr,5,8
{22064} busy_tch_hr,5,9
{22064} fer_gsm_hr
{22064} force_hr_usage
{22064} ho_req_ack_to_msc
{22064} hr_fr_hop_count
{22064} hr_intracell_ho_allowed
{22064} hr_res_ts
{22064} inner_hr_usage_thres
{22064} l_rxqual_dl_h_hopping_hr
{22064} l_rxqual_dl_h_hr
{22064} l_rxqual_dl_p_hopping_hr
{22064} l_rxqual_dl_p_hr
{22064} l_rxqual_ul_h_hopping_hr
{22064} l_rxqual_ul_h_hr
{22064} l_rxqual_ul_p_hopping_hr
{22064} l_rxqual_ul_p_hr
{22064} new_calls_hr
{22064} reconfig_fr_to_hr
{22064} rf_losses_tch_hr,0
{22064} tch_cong_inner_zone_hr,0
{22064} tch_congestion_hr,0
{22064} u_rxqual_dl_p_hr
{22064} u_rxqual_ul_p_hr
6-142 68P02900W22-Q
09-Sep-2004
System Information: DataGen RTF table
RTF table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table contains details of the RTFs contained within the BSS area (refer to Table 6-27).
Default filename rtf.mcd
68P02900W22-Q 6-143
09-Sep-2004
RTF table Chapter 6: MCDF tables
* From 1600, BCCH Frequency may be in extension band if egsm_bcch_sd is enabled in the Cell table.
KSW pair 1 0 to 3 Optional. (Mandatory
at non-M-Cell/non-
Horizonoffice sites,
otherwise unused.)
Used for the Managing KSW Pair prompt within the RTF equipage command.
6-144 68P02900W22-Q
09-Sep-2004
System Information: DataGen RTF table
Cont.
68P02900W22-Q 6-145
09-Sep-2004
RTF table Chapter 6: MCDF tables
Allow 32k Trau is visible but not available if the EGPRS option is purchased. Refer to
pkt_radio_type for more information.
Cont.
6-146 68P02900W22-Q
09-Sep-2004
System Information: DataGen RTF table
{22064}
Table 6-28 contains the parameters prompted for during the equipage of an RTF if both/either the AMR Half
Rate feature and/or GSM Half Rate feature is unrestricted.
Table 6-28 RTF table for GSM Half Rate
68P02900W22-Q 6-147
09-Sep-2004
DRI table Chapter 6: MCDF tables
DRI table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table contains details of the DRIs specified in the Hardware table for the BSS area (refer to Table 6-29).
The DRI must have its Cage and Slot number detailed in the Hardware table.
Default filename dri.mcd
6-148 68P02900W22-Q
09-Sep-2004
System Information: DataGen DRI table
68P02900W22-Q 6-149
09-Sep-2004
DRI table Chapter 6: MCDF tables
6-150 68P02900W22-Q
09-Sep-2004
System Information: DataGen DRI table
68P02900W22-Q 6-151
09-Sep-2004
DRI table Chapter 6: MCDF tables
0 None or Hybrid
1 Non-Controlling
2 Controlling
Combiner Identifier 2 0 to 13 Optional.
Valid for 1620 onwards and used to reference the associated combiner for this DRI.
Cavity Number 2 0 to 5 Optional.
Valid for 1620 onwards and used to reference the associated combiner for this DRI.
dri_density 1 1 to 2 Optional.
DRI density 2 is allowed only for HORIZON, HORIZON_MACRO, HORIZONMACRO2,
HORIZONMACRO2_EXT cabinets.
Assoc_dri_id 3 0 to 11 Mandatory when
dri_density is 2.
DRI density 2 is allowed only for HORIZON, HORIZON_MACRO, HORIZONMACRO2,
HORIZONMACRO2_EXT cabinets.
6-152 68P02900W22-Q
09-Sep-2004
System Information: DataGen Algorithm data table
specifies the algorithm data to be used across the BSS area. These entries do not use the lac and ci fields.
It also allows the user to specify specific algorithm data for specific cells identified by their lac and ci. These
entries specify the lac and ci for the cell to which the specific algorithm data applies and do not stop the cell
picking up all the other standard algorithm entries for the remaining algorithms or indexes into algorithms.
Default filename alg.mcd
• surround_cell
• rel_tim_adv
• rxlev_dl_ho
• rxlev_dl_pc
• rxlev_ul_ho
• rxlev_ul_pc
• rxqual_dl_ho
• rxqual_dl_pc
• rxqual_ul_ho
• rxqual_ul_pc
• interfer_alg
Cont.
68P02900W22-Q 6-153
09-Sep-2004
Algorithm data table Chapter 6: MCDF tables
6-154 68P02900W22-Q
09-Sep-2004
System Information: DataGen Neighbour table
Neighbour table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table identifies the cell pairs network-wide, using the bss_id to identify the BSS area containing the cell
marked as the source. Refer to Table 6-31. The bsic and bcch frequency are detailed in the cell table. The
fields classed as optional may contain values overriding those specified in the cell table.
Default filename ngbr.mcd
Cont.
68P02900W22-Q 6-155
09-Sep-2004
Neighbour table Chapter 6: MCDF tables
Cont.
6-156 68P02900W22-Q
09-Sep-2004
System Information: DataGen Neighbour table
Cont.
68P02900W22-Q 6-157
09-Sep-2004
Neighbour table Chapter 6: MCDF tables
Cont.
6-158 68P02900W22-Q
09-Sep-2004
System Information: DataGen Neighbour table
Cont.
68P02900W22-Q 6-159
09-Sep-2004
Neighbour table Chapter 6: MCDF tables
6-160 68P02900W22-Q
09-Sep-2004
System Information: DataGen Throttles table
Throttles table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The Throttles table specifies throttles to be applied to device types for the whole BSS area and links them to
alarm numbers. Refer to Table 6-32.
Default filename thro.mcd
68P02900W22-Q 6-161
09-Sep-2004
EAS table Chapter 6: MCDF tables
EAS table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The EAS table is used to specify alarm strings for alarm numbers used with the BSS area. Refer to Table 6-33.
Default filename eas.mcd
6-162 68P02900W22-Q
09-Sep-2004
System Information: DataGen Daughter table
Daughter table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table is used to specify the half height cards at a site in the same way as the hardware table specifies
the full height cards at a site. Refer to Table 6-34.
Default filename dgtr.mcd
68P02900W22-Q 6-163
09-Sep-2004
Daughter table Chapter 6: MCDF tables
6-164 68P02900W22-Q
09-Sep-2004
System Information: DataGen PIX table
PIX table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The PIX table specifies the hardware circuits which activate specific alarms in an EAS device as in Table 6-35.
Default filename pix.mcd
68P02900W22-Q 6-165
09-Sep-2004
KSW table Chapter 6: MCDF tables
KSW table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The KSW table specifies the data for the KSW configuration commands (chg_ksw_config) as in Table 6-36.
This table only has entries for sites that implement expanded KSW cards. Also, this table only contains entries
that differ from the default values (generated within the BSS and BTS tables).
Note that this command is invalid at M-Cell sites and will not be generated for these sites.
Default filename ksw.mcd
Table 6-36 KSW table
Cont.
6-166 68P02900W22-Q
09-Sep-2004
System Information: DataGen KSW table
68P02900W22-Q 6-167
09-Sep-2004
NSVC table Chapter 6: MCDF tables
NSVC table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The NSVC table is used to specify the parameters for any add_nsvc commands as in Table 6-37.
Default filename nsvc.mcd
6-168 68P02900W22-Q
09-Sep-2004
System Information: DataGen Hop table
Hop table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
{3723}
The Hop table is used to specify the parameters of the chhg_hop_params command as in Table 6-38.
Default filename: hop.mcd
Cont.
68P02900W22-Q 6-169
09-Sep-2004
Hop table Chapter 6: MCDF tables
Cont.
6-170 68P02900W22-Q
09-Sep-2004
System Information: DataGen Hop table
Cont.
68P02900W22-Q 6-171
09-Sep-2004
Hop table Chapter 6: MCDF tables
Cont.
6-172 68P02900W22-Q
09-Sep-2004
System Information: DataGen Hop table
68P02900W22-Q 6-173
09-Sep-2004
ACS table Chapter 6: MCDF tables
ACS table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
{4322}
The Active Codec Set (ACS) table is used to specify the parameters for any chg_acs_params commands
as in Table 6-39.
Default filename: acs.mcd
Cont.
6-174 68P02900W22-Q
09-Sep-2004
System Information: DataGen ACS table
Cont.
68P02900W22-Q 6-175
09-Sep-2004
ACS table Chapter 6: MCDF tables
Cont.
6-176 68P02900W22-Q
09-Sep-2004
System Information: DataGen ACS table
Cont.
68P02900W22-Q 6-177
09-Sep-2004
ACS table Chapter 6: MCDF tables
Cont.
6-178 68P02900W22-Q
09-Sep-2004
System Information: DataGen ACS table
Cont.
68P02900W22-Q 6-179
09-Sep-2004
ACS table Chapter 6: MCDF tables
6-180 68P02900W22-Q
09-Sep-2004
Index
Index
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
A
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
B
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q IX-1
09-Sep-2004
Index
C
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
D
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Daisy chain configuration with TS switch . . . . 3-58 DataGen database structure (contd.)
Database DataGen - OMC integration. . . . . . . . . . 1-7
dropping/recreating the db_dg Informix DataGen directory structure . . . . . . . . . . . 1-11
database . . . . . . . . . . . . . . . . . . . 3-22 main structure . . . . . . . . . . . . . . . . 1-12
reloading the Informix database . . . . . . . . 3-21 sub-structure. . . . . . . . . . . . . . . . . 1-13
save . . . . . . . . . . . . . . . . . . . . . 4-36 DataGen files . . . . . . . . . . . . . . . . . 3-81
system performance . . . . . . . . . . . . . 3-20 tools for editing . . . . . . . . . . . . . . . 3-81
usage scripts . . . . . . . . . . . . . . . . . 3-20 DataGen functions . . . . . . . . . . . . . . . 1-2
verify . . . . . . . . . . . . . . . . . . . . 4-36 Defragmenting the database . . . . . . . . . . . 3-14
warning messages . . . . . . . . . . . . . . 3-21 Delete database object (del) command . . . . . . 5-16
Database script files . . . . . . . . . . . . . . 3-76 Deleting a BSS area . . . . . . . . . . . . . . 3-42
alternative text editor . . . . . . . . . . . . . 3-79 Deleting a network . . . . . . . . . . . . . . . 4-46
producing . . . . . . . . . . . . . . . . . . 3-76 Deleting a network/country . . . . . . . . . . . 3-32
viewing . . . . . . . . . . . . . . . . . . . 3-77 Device management
xedit window . . . . . . . . . . . . . . . . 3-78 from navigation tree . . . . . . . . . . . . . 4-32
DataGen and OLM platform . . . . . . . . . . 1-5 Difference reporter . . . . . . . . . . . . . . 3-124
DataGen database structure . . . . . . . . . . . 1-7 menu option . . . . . . . . . . . . . . . . . 3-10
BSS database . . . . . . . . . . . . . . . . 1-7 selecting BSS area details. . . . . . . . . . 3-125
CM database object . . . . . . . . . . . . 1-7
database script file . . . . . . . . . . . . . 1-7
IX-2 68P02900W22-Q
09-Sep-2004
Index
E
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
F
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
G
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Generic Table Editor (GTE) . . . . . . . . . . . 3-94 Generic Table Editor (GTE) (contd.)
edit menu . . . . . . . . . . . . . . . . . 3-100 hot keys for MCDF . . . . . . . . . . . . 3-108
file menu . . . . . . . . . . . . . . . . . . 3-94 Group management. . . . . . . . . . . . . . . 2-13
fill cells . . . . . . . . . . . . . . . . . . 3-102 group parameters. . . . . . . . . . . . . . . 2-13
format menu . . . . . . . . . . . . . . . . 3-104
H
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q IX-3
09-Sep-2004
Index
I
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
L
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Loading network information . . . . . . . . . . 1-9 Lock/Unlock BSS area (lock_adm) command . . 5-24
gathering network information . . . . . . . . 1-10 Log files
Locate NE, site or cell . . . . . . . . . . . . . 4-17 viewing audit logs . . . . . . . . . . . . . . 4-57
M
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
N
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
IX-4 68P02900W22-Q
09-Sep-2004
Index
O
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
P
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
R
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
S
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-Q IX-5
09-Sep-2004
Index
T
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
U
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
V
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
X
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
IX-6 68P02900W22-Q
09-Sep-2004