Professional Documents
Culture Documents
68P02900W22
68P02900W22
System Information
GSR9
68P02900W22-S
Motorola and the Stylized M Logo are registered in the US Patent & Trademark Office. All other product or service
names are the property of their respective owners.
The CE mark confirms Motorola, Inc. statement of compliance with EU directives applicable to this product. Copies
of the Declaration of Compliance and installation information in accordance with the requirements of EN50385 can
be obtained from the local Motorola representative or by contacting the Customer Network Resolution Center
(CNRC). The 24 hour telephone numbers are listed at https://mynetworksupport.motorola.com. Select Customer
Network Resolution Center contact information. Alternatively if you do not have access to CNRC or the
internet, contact the Local Motorola Office.
Jul 2008
Table
of
Contents
Contents
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-S i
Jul 2008
Contents
ii 68P02900W22-S
Jul 2008
System Information: DataGen Contents
68P02900W22-S iii
Jul 2008
Contents
iv 68P02900W22-S
Jul 2008
System Information: DataGen Contents
68P02900W22-S v
Jul 2008
Contents
vi 68P02900W22-S
Jul 2008
System Information: DataGen Contents
68P02900W22-S vii
Jul 2008
Contents
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
Compile MMI script (compile) command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Auto-compile MMI script command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
Example auto_compile usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
Running cron jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
Compress/uncompress binary object files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
Delete database object (del) command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13
MCDF filter command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
Command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16
MMI command generator (gcmd) command . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
Command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18
Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18
Optimize DataGen database (dbaccess) command . . . . . . . . . . . . . . . . . . . . . . . . 5-19
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
Lock/unlock BSS area (lock_adm) command . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20
Command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21
viii 68P02900W22-S
Jul 2008
System Information: DataGen Contents
Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21
Revgen command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22
Command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24
Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24
Auto-Revgen command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25
Command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26
Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26
Toggle permissions (tp) command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27
Command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27
Version upgrader (upg) command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
Command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-29
Example of upgrading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-29
Auto-upgrader command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
Command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-31
Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-31
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-31
Country administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-32
Introduction to country administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-32
Command Line Interface (CLI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-32
Invoking xcadm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-33
Using the xcadm GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-33
Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-34
Data fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35
Action buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35
CADM utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-36
68P02900W22-S ix
Jul 2008
Contents
x 68P02900W22-S
Jul 2008
Contents
68P02900W22-S xi
Jul 2008
Contents
xii 68P02900W22-S
Jul 2008
List
of
Figures
List of Figures
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-S xiii
Jul 2008
List of Figures
xiv 68P02900W22-S
Jul 2008
List of Figures
68P02900W22-S xv
Jul 2008
List of Figures
xvi 68P02900W22-S
Jul 2008
List
of
Tables
List of Tables
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-S xvii
Jul 2008
List of Tables
xviii 68P02900W22-S
Jul 2008
About
This
Manual
The DataGen product provides the user with the capabilities for performing offline configuration
management of Motorola GSM network entities (NEs). It is a collection of software tools used
to produce, edit, and update BSS databases.
The Offline MIB (OLM) can create new networks, and visualize and validate networks before
deployment into a live network. It has a common User Interface (UI) with the online Operations
and Maintenance Centre (OMC). BSS binary files are used to create the network which is
displayed in the hierarchical structure called the Navigation Tree. The manual is organized
into the following chapters:
• Chapter 1 Overview of DataGen, provides the user with the capabilities for performing
offline configuration management of Motorola GSM network entities (NEs).
• Chapter 2 User and Group management using the usertool, contains information on user
and group management using the OMC usertool. In addition, information is also available
in the following manuals:
DataGen/OLM Clean Install Guide provides information about installation procedures.
DataGen/OLM Upgrade and Migration Guide provides information about upgrade and
migration procedures.
Both guides are included in the manual Software Release Notes: DataGen
(68P02900W76).
• Chapter 3 Operating DataGen, describes the procedures used for operating DataGen and
its associated administrative tools.
• Chapter 4 Operating the Offline MIB, describes the procedures used for operating the
Offline MIB.
Information on performing Cell Xchange and Network Expansion from the Offline
MIB is provided in the manual Installation Configuration: GSM System Configuration
(68P02901W17).
• Chapter 6 MCDF tables, provides description on Motorola Customer Data Format (MCDF)
tables.
For detailed information about the ranges, default values and dependencies of the parameters
in the MCDF tables, refer to the manual Technical Description: BSS Command Reference
(68P02901W23).
68P02900W22-S 1
Jul 2008
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.
2 68P02900W22-S
Jul 2008
Revision history
Revision history
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Version information
The following table lists the supported versions of this manual in order of issue:
Service
CMBP Number Remarks
Request
N/A N/A N/A
68P02900W22-S 3
Jul 2008
General information
General information
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Purpose
Motorola cellular communications documents 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.
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 customer's behalf, to abide by the instructions, system parameters,
or recommendations made in this document.
These documents are not intended to replace the system and equipment training offered by
Motorola. They can be used to supplement and enhance the knowledge gained through such
training.
NOTE
If this document 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 are supplied automatically by Motorola and posted
on the Motorola customer website.
Cross references
References made to external publications are shown in italics. Other cross references,
emphasized in blue text in electronic versions, are active links to the references.
This document is divided into numbered chapters that 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.
4 68P02900W22-S
Jul 2008
Text conventions
Text conventions
The following conventions are used in the Motorola cellular infrastructure documents to
represent keyboard input text, screen output text, and special key sequences.
Input
Output
CTRL-c or CTRL+C Press the Ctrl and C keys at the same time.
CTRL-SHIFT-c or Press the Ctrl, Shift, and C keys at the same time.
CTRL+SHIFT+C
ALT-f or ALT+F Press the Alt and F keys at the same time.
ALT+SHIFT+F11 Press the Alt, Shift and F11 keys at the same time.
¦ Press the pipe symbol key.
RETURN or ENTER Press the Return or Enter key.
68P02900W22-S 5
Jul 2008
Contacting Motorola
Contacting Motorola
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
24–hour support
If you have problems regarding the operation of your equipment, contact the Customer Network
Resolution Center (CNRC) for immediate assistance. The 24–hour telephone numbers are listed
at https://mynetworksupport.motorola.com. Select Customer Network Resolution Center
contact information. Alternatively if you do not have access to CNRC or the internet, contact
the Local Motorola Office.
Send questions and comments regarding user documentation to the email address:
mydocs@motorola.com.
Errors
To report a documentation error, call the CNRC (Customer Network Resolution Center) and
provide the following information to enable CNRC to open an SR (Service Request):
• The document type
6 68P02900W22-S
Jul 2008
Security advice
Security advice
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Motorola systems and equipment provide security parameters that can be configured by the
operator based on their particular operating environment. Motorola recommends setting and
using these parameters following industry recognized security practices. Security aspects
to be considered are protecting the confidentiality, integrity, and availability of information
and assets. Assets include the ability to communicate, information about the nature of the
communications, and information about the parties involved.
Contact the Customer Network Resolution Center (CNRC) for assistance. The 24–hour
telephone numbers are listed at https://mynetworksupport.motorola.com. Select Customer
Network Resolution Center contact information, from the menu located to the left of the
Login box. Alternatively if you do not have access to CNRC or the internet, contact the Local
Motorola Office.
68P02900W22-S 7
Jul 2008
Warnings, cautions, and notes
The following describes how warnings and cautions are used in this document and in all
documents of this Motorola document set.
Warnings
Warnings precede instructions that contain potentially hazardous situations. Warnings are
used to alert the reader to possible hazards that could cause loss of life or physical injury. A
warning has the following format:
WARNING
Warning text and consequence for not following the instructions in the warning.
Cautions
Cautions precede instructions and are used when there is a possibility of damage to systems,
software, or individual items of equipment within a system. However, this damage presents
no danger to personnel. A caution has the following format:
CAUTION
Caution text and consequence for not following the instructions in the caution.
Notes
NOTE
Note text.
8 68P02900W22-S
Jul 2008
Safety
Safety
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
General safety
NOTE
Refer to Grounding Guideline for Cellular Radio Installations – 68P81150E62.
• Using non-Motorola parts for repair could damage the equipment or void warranty.
Contact Motorola Warranty and Repair for service and repair instructions.
Electromagnetic energy
Relevant standards (USA and EC) applicable 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.
• Directive 2004/40/EC of the European Parliament and of the Council of 29 April 2004 on
the minimum health and safety requirements regarding the exposure of workers to the
risks arising from physical agents (electromagnetic fields) (18th individual Directive within
the meaning of Article 16(1) of Directive 89/391/EEC).
68P02900W22-S 9
Jul 2008
Caring for the environment
The following information describes national or regional requirements for the disposal of
Motorola supplied equipment and for the approved disposal of surplus packaging.
Contact the Customer Network Resolution Center (CNRC) for assistance. The 24–hour
telephone numbers are listed at https://mynetworksupport.motorola.com. Select Customer
Network Resolution Center contact information. Alternatively if you do not have access
to CNRC or the internet, contact the Local Motorola Office.
In EU countries
The following information is provided to enable regulatory compliance with the European Union
(EU) directives identified and any amendments made to these directives when using Motorola
equipment in EU countries.
European Union (EU) Directive 2002/96/EC Waste Electrical and Electronic Equipment (WEEE)
Do not dispose of Motorola equipment in landfill sites. In the EU, Motorola in conjunction
with a recycling partner ensures that equipment is collected and recycled according to the
requirements of EU environmental law.
European Parliament and Council Directive 94/62/EC Packaging and Packaging Waste
Do not dispose of surplus packaging in landfill sites. In the EU, it is the individual recipient’s
responsibility to ensure that packaging materials are collected and recycled according to the
requirements of EU environmental law.
In non-EU countries
In non-EU countries, dispose of Motorola equipment and all surplus packaging in accordance
with national and regional regulations.
10 68P02900W22-S
Jul 2008
CMM labeling and disclosure table
The People’s Republic of China requires that our products comply with China Management
Methods (CMM) environmental regulations. (China Management Methods refers to the
regulation Management Methods for Controlling Pollution by Electronic Information Products.)
Two items are used to demonstrate compliance; the label and the disclosure table.
• Logo 2 means that the product may contain substances in excess of the maximum
concentration value for materials identified in the China Management Methods regulation,
and has an Environmental Friendly Use Period (EFUP) in years. The example shown
uses 50 years.
Logo 1 Logo 2
The Environmental Friendly Use Period (EFUP) is the period (in years) during which the Toxic
and Hazardous Substances (T&HS) contained in the Electronic Information Product (EIP)
will not leak or mutate causing environmental pollution or bodily injury from the use of the
EIP. The EFUP indicated by the Logo 2 label applies to a product and all its parts. Certain
field-replaceable parts, such as battery modules, can have a different EFUP and are marked
separately.
The Disclosure table is intended only to communicate compliance with China requirements.
It is not intended to communicate compliance with EU RoHS or any other environmental
requirements.
68P02900W22-S 11
Jul 2008
Motorola document set
The Motorola document sets provide the information to operate, install, and maintain the
Motorola equipment.
With internet access available, to view, download, or order documents (original or revised), visit
the Motorola Lifecycles Customer web page at https://mynetworksupport.motorola.com, or
contact your Motorola account representative.
Without internet access available, order hard-copy documents or CD-ROMs from your Motorola
Local Office or Representative.
If Motorola changes the content of a document after the original printing date, Motorola
publishes a new version with the same part number but a different revision character.
A banner indicates that some information contained in the document is not yet approved for
general customer use. A banner is oversized text on the bottom of the page, for example,
PRELIMINARY — UNDER DEVELOPMENT.
Data encryption
In order to avoid electronic eavesdropping, data passing between certain elements in the
network is encrypted. In order to comply with the export and import requirements of particular
countries, this encryption occurs at different levels. The encryption may be individually
standardized or may not be present at all in some parts of the network in which it is normally
implemented. The document set covers encryption as if fully implemented. Limitations on the
encryption included in the particular software being delivered, are covered in the Release Notes
that accompany the individual software release.
12 68P02900W22-S
Jul 2008
Chapter
Overview of DataGen
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-S 1-1
Jul 2008
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 of 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 and 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.
This information includes the 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-S
Jul 2008
System Information: DataGen Overview of the Offline MIB
• Generate commands for the Operations and Maintenance Centre (OMC) to apply changes.
The Offline MIB (OLM) can create new networks, visualize, 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, by propagating neighbor changes from one BSS binary file to another.
68P02900W22-S 1-3
Jul 2008
Offline MIB functionality Chapter 1: Overview of DataGen
DataGen and the Offline MIB work together. The following functions can be performed (refer
to Figure 1-3):
• Import binary database object files from the OMC.
• Import multiple binary object files into the OLM and thus carry out the radio frequency
planning.
1-4 68P02900W22-S
Jul 2008
System Information: DataGen The DataGen and OLM platform
Upgrader
Input
Ta ble control
MCDF
tables DataGen Data Store MMI generator
BSS Revgen
database object file (Informix)
from OMC
Output
BSS
database object file
from OMC
Audit
OLM OMC-R GUI
Database Operations
Admin
Help Find
ti-GSM-DataGen_Of fline MIB functions-00003-ai-sw
DataGen and the OLM are implemented on either a Sun Netra 440 platform or the 'Flexible
Platform'. For more information about the supported platforms, refer to Supported platforms
on page 1-15. DataGen and the OLM use many of the same software tools as the OMC-R, thus
maximizing compatibility between the two systems. Deploy DataGen on a shared Ethernet LAN
with the OMC-R to facilitate data interchange.
68P02900W22-S 1-5
Jul 2008
The DataGen and OLM platform 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 DVD drive. The system uses Sun UltraSPARC processor; CPU speed and RAM
are subject to change.
Standard peripherals include a DAT tape drive, a DVD-ROM drive, and monitor. The standard
system is configured for LAN Ethernet support.
Software
DataGen and OLM are 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 DVD-ROM together with all third-party
products.
Da ta Ge n NMC
OMC-R
OS I
S ys te m
S e rve r
1-6 68P02900W22-S
Jul 2008
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, a database script file and a
Configuration Management (CM) database object.
A database script file is an ASCII file. The operator can read from or write into the database
script file. It can be produced manually by entering the text into an ASCII file. This process is
slow and is likely to introduce errors. Format the file precisely to contain the correct number
of line feeds and spaces. DataGen provides a faster and more accurate way to produce a
Database Script File.
A CM Database Object (Binary Object) is the compiled database script file and cannot be read or
edited. The CM Database Object is produced by downloading a database script file into a BSC.
This object can then be uploaded and stored on a disk or at the OMC.
The code used by the BSS to convert the SYSGEN script into a binary object is ported to the
DataGen platform. It 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 are uploaded, to be imported into DataGen using Revgen.
68P02900W22-S 1-7
Jul 2008
DataGen and the OMC Chapter 1: Overview of DataGen
GUI GUI
DATAGEN LOAD
CM
MANAGEMENT
RDB MIB
Topology
DATABASE
BSS CM
DB Root
BSS Databases
OLM Binary
object cobh
bss_cork bss_cobh
BINARY
Binary
objects GENERATION
CellXchange
1-8 68P02900W22-S
Jul 2008
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:
• Start up DataGen.
68P02900W22-S 1-9
Jul 2008
Gathering network information Chapter 1: Overview of DataGen
Hardware
Software
Configuration
Configuration
NETWORK
Input
Files
DATAGEN
First gather the network configuration information for the network. This information is then
used to produce the input files which can be read by DataGen. The input files can be entered
directly into either of the two computer-based tools:
Both methods involve entering the information into a computer using a custom designed
software package.
1-10 68P02900W22-S
Jul 2008
System Information: DataGen The DataGen Directory Structure (DDS)
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 after 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.
CAUTION
Do not create directories within the DataGen Directory Structure manually. DataGen
creates the directories automatically, thus ensuring that there are no syntax errors
in the directory names.
68P02900W22-S 1-11
Jul 2008
Main structure of the DDS Chapter 1: Overview of DataGen
dg
conf0 conf1
command
/usr/gsm/DataGen/dg/<country>/<bss>/conf<N>
Where Is
country replaced by the name of the country
bss replaced by the name of the base
site
N replaced by the configuration
For example:
$HOME/dg/UK/testbss/conf0
All directories must be created by DataGen for each BSS area. Leave the directory creation to
DataGen to avoid problems with capitalization.
1-12 68P02900W22-S
Jul 2008
System Information: DataGen Sub-structure
Sub-structure
Inside the conf<N> directory, there are some other directories as follows:
The directories below the OLM are created when an operator creates a 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).
olm
Each network configuration can contain up to 256 binary object (.002) files. An example of
Offline MIB network structure is displayed in Figure 1-10.
Network 2
68P02900W22-S 1-13
Jul 2008
Main structure of the Offline MIB directory Chapter 1: Overview of DataGen
/usr/gsm/DataGen/olm/<network_configuration>
Where Is
network_configuration replaced by the network configuration name,
which contains .002 files.
1-14 68P02900W22-S
Jul 2008
System Information: DataGen Supported platforms
Supported platforms
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
DataGen is configured to run as a standalone processor with its own disk storage, tape drive,
and DVD-ROM drive. Table 1-1 lists the hardware configurations supported.
NOTE
• The same configuration is used for Clean Install and Upgrade platforms.
• DataGen is supported on a Flexible Platform. Any Sun UltraSPARC machine that
meets the minimum specification set by Motorola can be used. For more details,
refer to the Bulletin number GSM_G_OMCR_056.
68P02900W22-S 1-15
Jul 2008
Overview of supported platforms Chapter 1: Overview of DataGen
1-16 68P02900W22-S
Jul 2008
Chapter
68P02900W22-S 2-1
Jul 2008
User and Group management using the usertool Chapter 2: User and Group management using the usertool
Introduction to usertool
This chapter describes the procedures to manage users and groups on the DataGen processor
using the usertool utility.
The Common Desktop Environment (CDE) Manager provides a desktop environment which can
be customized 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.
Usertool - Overview
Usertool is a utility that is used for managing users and groups on the DataGen processor.
Usertool can be accessed either from the command line (/var/install/bin/usertool) or from
the OMC Admin menu available in the Common Desktop Environment (CDE).
• Manage groups
Procedure list
2-2 68P02900W22-S
Jul 2008
System Information: DataGen DataGen User management using the usertool
Usertool is a utility that enables the management of 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 the users to specific groups, ensure that the groups first exist. Before adding
user accounts, use usertool to add any groups to which the users are assigned. Refer to DataGen
Group management using the usertool on page 2-13 for more information.
The User Name specifies the login name the operating system uses to identify an
individual user. A user name must be a unique name, composed of lowercase alphabetical
characters (a-z) or digits (0-9). The first character of a user name must be a letter.
• Full Name
The Full Name can be any text string. It is generally a short description of the login, and
is used as the field for the user's full name.
NOTE
The user’s full name is displayed on the OLM GUI.
• Home Directory
68P02900W22-S 2-3
Jul 2008
User administration utility Chapter 2: User and Group management using the usertool
• User ID (UID)
The User ID (UID) specifies the unique number by which the operating system can
identify a user. The maximum value is 2147483647. Keep the UIDs below 60000
to minimize the amount of software incompatibilities. Reserved UIDs include 60001
(nobody) and 65534 (nobody4).
• Group
This parameter specifies the primary group to which the user belongs. A group ID
number or group name can be specified. Group 110 (omc) is the default primary group
for DataGen users.
• Secondary Groups
This optional parameter specifies one or more groups to which the user also belongs. A
group ID number or group name can be specified. If more than one group is specified,
separate them from the other groups with commas.
• Account Locked
If the account is locked, the user cannot log in until the account is unlocked by the System
Administrator.
• Change Password
The parameter forces the user to change the password on the next login. This occurs only
once. Having chosen a new password, the user is not prompted for password change on
subsequent logins.
• Shell
This is the full path name of the program used as the user's shell on login. It is
recommended that the C-shell (/bin/csh) is used for DataGen users.
1 Usertool is the user administration utility. Usertool can be started from the
OMC Admin menu in the Common Desktop Environment (CDE) or from
the command line.
2 To start the usertool from the Common Desktop Environment (CDE), log
on to the CDE environment with user name root.
Continued
2-4 68P02900W22-S
Jul 2008
System Information: DataGen User administration utility
Figure 2-3 CDE desktop front panel with open OMC Admin drawer
Continued
68P02900W22-S 2-5
Jul 2008
User administration utility Chapter 2: User and Group management using the usertool
• Add user
• Modify user
• Rename user
• Delete user
• Add group
• Modify group
• Rename group
• Delete group
2-6 68P02900W22-S
Jul 2008
System Information: DataGen Add a new user account
Administration utility
----------------------
1. Add user
2. Modify user
3. Rename user
4. Delete user
5. Add group
6. Modify group
7. Rename group
8. Delete group
0. Exit
Action:
2 Enter 1 to select the Add User option.
The User Administration window is displayed as follows:
In this window, one field is highlighted with a bar which can be moved with
the cursor keys. The highlighted field can be modified by typing or deleting
as required. A help message is provided for each field. If any of the fields is
in conflict, a message to that effect is displayed.
NOTE
Refer to the section User management parameters on page 2-3
for more information about data fields.
Continued
68P02900W22-S 2-7
Jul 2008
Add a new user account Chapter 2: User and Group management using the usertool
2-8 68P02900W22-S
Jul 2008
System Information: DataGen Modify a user account
Administration utility
----------------------
1. Add user
2. Modify user
3. Rename user
4. Delete user
5. Add group
6. Modify group
7. Rename group
8. Delete group
0. Exit
Action:
2 Enter 2 to select the Modify User option.
The User Administration window is displayed as follows:
In this window, one field is highlighted with a bar which can be moved with
the cursor keys. The highlighted field can be modified by typing or deleting
as required. A help message is provided for each field. If any of the fields
are in conflict, a message to that effect will be displayed.
NOTE
Refer to the section User management parameters on page 2-3
for more information about data fields.
Continued
68P02900W22-S 2-9
Jul 2008
Rename a user account Chapter 2: User and Group management using the usertool
To rename a user account, that is, to change the username or login associated with the user ID,
perform the following procedure.
1 Start the usertool utility using the steps in User administration utility on
page 2-4. The usertool menu is displayed as in Figure 2-4.
Administration utility
----------------------
1. Add user
2. Modify user
3. Rename user
4. Delete user
5. Add group
6. Modify group
7. Rename group
8. Delete group
0. Exit
Action:
2 Enter 3 to select the Rename user option.
3 When prompted, enter the existing username of the account.
4 When prompted, enter the new username of the account. The usertool utility
exits automatically upon completion of the requested operation.
2-10 68P02900W22-S
Jul 2008
System Information: DataGen Delete a user account
CAUTION
Deleting a user account permanently removes the home directory of the user and all
files contained within it.
Administration utility
----------------------
1. Add user
2. Modify user
3. Rename user
4. Delete user
5. Add group
6. Modify group
7. Rename group
8. Delete group
0. Exit
Action:
Continued
68P02900W22-S 2-11
Jul 2008
Delete a user account Chapter 2: User and Group management using the usertool
In this window, one field is highlighted with a bar which can be moved with
the cursor keys. The highlighted field can be modified by typing or deleting
as required. A help message is provided for each field. If any of the fields
are in conflict, a message to that effect will be displayed.
NOTE
Refer to the section User management parameters on page 2-3
for more information about data fields.
3 Enter the user name to be deleted into the Username field, the other
fields are automatically filled with the current settings of the user.
2-12 68P02900W22-S
Jul 2008
System Information: DataGen DataGen Group management using the usertool
Usertool is a utility that enables the management of groups on the local system. Usertool is
used to perform the following group management tasks:
• Add a new group
• Modify a group
• Rename a group
• Delete a group
Group Name specifies a name used to identify a user group. A group name contains
lowercase alphabetical characters (a-z) and digits (0-9). A group name can be 1 - 8
characters long.
• Group ID (GID)
Group ID specifies a group identification number used to identify a user's primary group.
The maximum value is 2147483647. To minimize the amount of software incompatibilities,
keep the GIDs below 60000. Reserved GIDs include 60002 (no access) and 65534 (no
group).
The Group Administration Utility is usertool, which is the same utility used for user
administration. Usertool can be started from the OMC Admin menu in the Common Desktop
Environment (CDE) or from the command line. Refer to the section User administration utility
on page 2-4, which contains detailed instructions for starting the usertool utility.
68P02900W22-S 2-13
Jul 2008
Add a group Chapter 2: User and Group management using the usertool
Add a group
Administration utility
----------------------
1. Add user
2. Modify user
3. Rename user
4. Delete user
5. Add group
6. Modify group
7. Rename group
8. Delete group
0. Exit
Action:
2 Enter 5 to select the Add Group option.
The Group Administration window is displayed as follows:
In this window, one field is highlighted with a bar which can be moved with
the cursor keys. The highlighted field can be modified by typing or deleting
as required. A help message is provided for each field. If any of the fields
are in conflict, a message to that effect is displayed.
NOTE
Refer to the section Group management parameters on page 2-13
for more information about data fields.
3 Enter the required group name into the Group field:
2-14 68P02900W22-S
Jul 2008
System Information: DataGen Modify group information
Administration utility
----------------------
1. Add user
2. Modify user
3. Rename user
4. Delete user
5. Add group
6. Modify group
7. Rename group
8. Delete group
0. Exit
Action:
2 Enter 6 to select the Modify Group option.
The Group Administration window is displayed as follows:
In this window, one field is highlighted with a bar which can be moved with
the cursor keys. The highlighted field can be modified by typing or deleting
as required. A help message is provided for each field. If any of the fields
are in conflict, a message to that effect is displayed.
NOTE
Refer to the section Group management parameters on page 2-13
for more information about data fields.
Continued
68P02900W22-S 2-15
Jul 2008
Rename a group Chapter 2: User and Group management using the usertool
Rename a group
Administration utility
----------------------
1. Add user
2. Modify user
3. Rename user
4. Delete user
5. Add group
6. Modify group
7. Rename group
8. Delete group
0. Exit
Action:
2 Enter 7 to select the Rename Group option.
3 When prompted, enter the existing Group name.
4 When prompted, enter the new Group name.
5 Select Done to save the changes and rename the group. The usertool utility
exits automatically upon completion of the requested operation.
2-16 68P02900W22-S
Jul 2008
System Information: DataGen Delete a group
Delete a group
Administration utility
----------------------
1. Add user
2. Modify user
3. Rename user
4. Delete user
5. Add group
6. Modify group
7. Rename group
8. Delete group
0. Exit
Action:
2 Enter 8 to select the Delete group option.
The Group Administration window is displayed as follows:
In this window, one field is highlighted with a bar which can be moved with
the cursor keys. The highlighted field can be modified by typing or deleting
as required. A help message is provided for each field. If any of the fields
are in conflict, a message to that effect is displayed.
NOTE
Refer to the section Group management parameters on page 2-13
for more information about data fields.
Continued
68P02900W22-S 2-17
Jul 2008
Delete a group Chapter 2: User and Group management using the usertool
2-18 68P02900W22-S
Jul 2008
Chapter
Operating DataGen
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-S 3-1
Jul 2008
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. Use this in conjunction with Chapter 6
MCDF tables.
The information in this chapter is aimed primarily at new users of DataGen. The routines are set
in the order in which they would 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 works with an existing database and perform a variety of DataGen functions to
generate a working database.
If the user is successful in editing or creating new information in the database, then the
database compiles successfully and create a viable BSS script.
To operate the DataGen, perform the listed procedures in the following order:
• Converting a CM database object file to a script file on page 3-66 - Using Revgen.
• Generating a database script file on page 3-71 - Using the MMI tool.
• Viewing and editing DataGen files on page 3-77 - Using the Service Window, Table
Controller, Generic Table Editor, and Topology viewer.
• Converting a database script file to a CM database object file on page 3-112 - Using the
Binary Object Compiler.
Other procedures for operating DataGen can be performed as required, including:
• Administration tasks on page 3-12
3-2 68P02900W22-S
Jul 2008
System Information: DataGen Procedures for operating DataGen
For information on operating the offline MIB, refer to Chapter 4 Operating the Offline MIB.
68P02900W22-S 3-3
Jul 2008
Defining environment variables Chapter 3: Operating DataGen
Environment variables are variables that the shell or any other program can access to get
information unique to a specific user. DataGen can create and use several environment variables.
Certain variables can be set from the DataGen main menu by using the ADMIN - Preferences
option. Refer to Administration tasks on page 3-12 for more details.
NOTE
Set up these standard C shell environment variables before running DataGen.
The following two environment variables can be set up to allow the users to decide at the run
time whether they want HEX or DECIMAL representation:
• DG_HEX_CELL_IDS determines the format in which GSM cell ids are displayed.
• DG_HEX_POINT_CODES determines the format in which the elements opc and dpc are
displayed. The format applies to the MMI script and to MCDF.
Set the variables to yes to display the values in HEX using the
following commands in the C shell:
NOTE
These variables can also be set from the DataGen main menu using the ADMIN -
Preferences option. Refer to Administration tasks on page 3-12 for more details.
3-4 68P02900W22-S
Jul 2008
System Information: DataGen Version list order
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:
This feature is optional and allows the user a 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 gives a significant performance improvement.
• To enable the time slot order equipage, enter the following command in the C shell:
• To disable the time slot order equipage, enter the following command in the C shell:
setenv DG_AGGREGATE_ABIS no
NOTE
This variable can also be set from the DataGen main menu using the ADMIN -
Preferences option. Refer to Administration tasks on page 3-12 for more details.
Revgen converts a Binary Object File into an Informix format. Revgen can be invoked by
selecting the Services option from the Services menu, or by selecting the Revgen button.
• To automate the functioning of Revgen from the Service menu or Revgen button, enter
the following command in the C shell:
• To disable the automated functioning of Revgen from the Service menu or Revgen button,
enter the following command in the C shell:
setenv DG_AUTO_REVGEN no
NOTE
This variable can also be set from the DataGen main menu using the ADMIN -
Preferences option. Refer to Administration tasks on page 3-12 for details.
68P02900W22-S 3-5
Jul 2008
Default file import path Chapter 3: Operating DataGen
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
the previous paths selected.
For example:
NOTE
This variable can also be set from the DataGen main menu using the ADMIN -
Preferences option. Refer to Administration tasks on page 3-12 for more details.
The variable DG_EXPORT_PATH allows binary object files to be exported from the Service
window to an export directory.
For example:
NOTE
This variable can also be set from the DataGen main menu using the ADMIN -
Preferences option. Refer to Administration tasks on page 3-12 for more details.
3-6 68P02900W22-S
Jul 2008
System Information: DataGen Define default text editor
From the Service window, it is possible to view the 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.
Where Is
text editor textedit, vi, or xedit
NOTE
• This variable can also be set from the DataGen main menu using the ADMIN -
Preferences option. Refer to Administration tasks on page 3-12 for more details.
• To define another editor other than the three standard editors, refer to
Generating a database script file on page 3-71.
When a BSS area that is already in use is accessed, a warning message is displayed. The user
can unlock the area or cancel it.
• To automatically unlock the locked area without displaying the warning message, enter
the following command:
• 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
NOTE
This variable can also be set from the DataGen main menu using the ADMIN -
Preferences option. Refer to Administration tasks on page 3-12 for more details.
68P02900W22-S 3-7
Jul 2008
Output all elements in a script Chapter 3: Operating DataGen
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.
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, execute the following command:
setenv DG_ALL_CHG_ELEMENT no
NOTE
• Setting the value to Yes can result in compilation failures. Set the value to
Yes only to view the 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-12 for more details.
The MCDF Algorithm data table (alg.mcd) has hundreds of rows of data for all cells. Each cell
is specified by the Location Area Code (LAC) and Cell Identifier (CI) in the table.
The ALG_TABLE_NEW environment variable is used to display only generic algorithm details
(the most repeating value for a particular algorithm) for cells with no Mobile Country Code
(MCC), Mobile Network Code (MNC), LAC and CI details specified. That is, any cells with
algorithm details which differ from the generic, are listed in the alg.mcd table, with complete
MCC, MNC, LAC, and CI information.
unsetenv ALG_TABLE_NEW
If the environment variable ALG_TABLE_NEW is set, the MCDF exports the generic values of
the alg.mcd table as a single record.
During insert, if there are no generic values in the alg.mcd table, the values present in the
genercialg.dat file are inserted.
The format of the genericalg.dat file is same as alg.mcd, except that there should be no value
for cell id.
3-8 68P02900W22-S
Jul 2008
System Information: DataGen Display only generic algorithm details in alg.mcd table
surround_cell 00 610
rel_tim_adv 00 810
rxlev_dl_ho 00 610
rxlev_dl_pc 00 210
rxlev_ul_ho 00 610
rxlev_ul_pc 00 210
rxqual_dl_ho 00 411
rxqual_dl_pc 00 211
rxqual_ul_ho 00 411
rxqual_ul_pc 00 211
68P02900W22-S 3-9
Jul 2008
DataGen - startup and shutdown Chapter 3: Operating DataGen
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 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).
Select To
NEW Display a window where a new BSS area can be created.
OPEN Display a window where an existing BSS area can be viewed or
edited.
UPG Display a window where an existing BSS area can be upgraded
to a later version.
COPY Display a window where BSS areas can be copied.
DEL Display a window where an existing BSS area can be deleted.
DIFF Display a window where difference reports between sites and site
elements for BSS areas can be generated.
BATCH Display a window where multiple binary object files can be
revgened, upgraded, or compiled.
ADMIN Display a window where a range of Administration tasks can be
carried out. For example, Country administration.
OLM Display a window 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:
3-10 68P02900W22-S
Jul 2008
System Information: DataGen Shutdown
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, execute 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.
68P02900W22-S 3-11
Jul 2008
Administration tasks Chapter 3: Operating DataGen
Administration tasks
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Overview of tasks
Following is a list of tasks that can be carried out by selecting the ADMIN option from the
DataGen main menu:
• Country Admin
• Permissions
The DataGen user has a standard set of access permissions. This option allows the user to
set the status to access permitted or access denied.
• Defragment
• 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 (or downloaded electronically from
the GSM Software Distribution and Licensing Centre) and uncompressed, they can be
installed using this feature.
NOTE
The following privileges are available for a user logged into the DataGen
processor as omcadmin:
• Permissions
• Defragment
• Options
3-12 68P02900W22-S
Jul 2008
System Information: DataGen Changing permissions
Changing permissions
To change or toggle access permissions for a user, perform the following procedure.
4 Enter the Username and click Toggle to grant or withhold the permissions.
NOTE
Enter valid users only, such as omcadmin, informix, and so on.
Continued
68P02900W22-S 3-13
Jul 2008
Optimizing the database Chapter 3: Operating DataGen
NOTE
Refer to the section Viewing the log file on page 3-15 for more
details.
NOTE
After performing a defragmentation, exit the GUI and then reopen
it to access the previously created areas.
3-14 68P02900W22-S
Jul 2008
System Information: DataGen Viewing the log file
NOTE
Figure 3-4 displays the default menu for non-omcadmin users.
4 The DataGen logfile displays the history of all the commands issued in
DataGen. If the logfile is open, the progress of a task can be viewed as it is
executed. An example of a logfile is displayed in Figure 3-5.
5 Press Ctrl+C to exit the logfile and return to the Administration menu.
68P02900W22-S 3-15
Jul 2008
Customizing parameters Chapter 3: Operating DataGen
Customizing parameters
From the Preferences menu, several different parameters can be customized. To view the
preferences available, perform the following procedure.
NOTE
It is not essential to select any of these criteria. If they are not required, skip these
steps and DataGen applies the default values.
Continued
3-16 68P02900W22-S
Jul 2008
System Information: DataGen Customizing parameters
NOTE
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.
5 To select which editor to use when viewing MMI scripts or compilation logs,
enter one of the following in the Editor field:
• textedit
• vi
• xedit
NOTE
If an alternative editor is available, enter the name of the text
editor. Refer to Generating a database script file on page 3-71
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 are 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.
NOTE
Set the Preferences every time DataGen is closed and reopened.
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-10 for details.
NOTE
An alternative to shutting down DataGen is to execute the following
command in the Xterm window from which DataGen was started:
source.cshrc
68P02900W22-S 3-17
Jul 2008
Installing the Options Object Chapter 3: Operating DataGen
NOTE
Copy the Option Object files from tape (or downloaded electronically from the GSM
Software Distribution and Licensing Centre) uncompress and store in a directory
on the DataGen processor. Refer to the section Upgrade procedures in the
DataGen/OLM Upgrade/Migration Guide in the Software Release Notes: DataGen
(68P02900W76) for details.
Continued
3-18 68P02900W22-S
Jul 2008
System Information: DataGen Installing the Options Object
4 To locate the directory where the Options Object files are located, enter the
path in the Filter field and select the Filter button.
5 Select the Options Object file and click OK.
6 Select a country from the Country Name list.
7 Select a software version from the Software Version list.
8 Click Install. A Confirmation window is displayed. Click OK to continue.
When the installation is complete, a Confirmation window is displayed stating:
68P02900W22-S 3-19
Jul 2008
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 can be executed manually or as
a cronjob.
NOTE
If the usage script is executed as a cronjob, it must be restarted after any upgrade
activity is 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
crontab usage.cron
To check if the usage script is activated as a cronjob, log on to the DataGen processor as
omcadmin.
crontab -l
3-20 68P02900W22-S
Jul 2008
System Information: DataGen Running usage script manually
• To run the usage script manually, log on to the DataGen processor as omcadmin. Execute
the following command:
cd /usr/omc/DataGen/current/cron
usage
If either the file system or the Informix database reaches 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.
NOTE
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.
If all the MCDF tables are not displayed in the Table Controller (for example, the table only
displays up to the Specifics table), or if gcmd fails with an error relating to parameters not
found in the Informix database, then there could be a problem with the integrity of the database.
68P02900W22-S 3-21
Jul 2008
Dropping and recreating the db_dg Informix database Chapter 3: Operating DataGen
cd /usr/omc/DataGen/current/bin
valid_load -o c_tables.dat
valid_load -o mcdf.dat
7 Exit from the omcadmin account.
It is possible to destroy and recreate the DataGen Informix database (db_dg). Carry out this
procedure 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.
CAUTION
This procedure permanently erases the dg_db Informix database and should be used
with caution.
To drop and recreate the db_dg Informix database, perform the following procedure.
Continued
3-22 68P02900W22-S
Jul 2008
System Information: DataGen Dropping and recreating the db_dg Informix database
Procedure 3-7 Drop and recreate the db_dg Informix database (Continued)
3 Prepare to drop and recreate the Informix database.
4 Drop the database.
5 Create a database.
6 Load the OLM netwk_conf table.
7 Load the DataGen configuration tables.
The netwk_conf table exists in the DataGen Informix database (db_dg). It stores information
about OLM network configurations. This table must be unloaded to a file so that OLM network
configuration information can be recovered after dropping the db_dg database.
To unload the netwk_conf table, log on to DataGen processor as omcadmin. Enter the
following command (in the same line):
The country, network, bss_conf, bss_list, and conf_list tables exist in the DataGen Informix
database (db_dg). They contain configuration information for the DataGen BSS areas. These
tables must be unloaded to a file so that DataGen BSS area information can be recovered
after dropping the db_dg database.
To unload the tables, log on to DataGen processor as omcadmin. Enter the following commands
(all in one line):
68P02900W22-S 3-23
Jul 2008
Dropping and recreating the db_dg Informix database Chapter 3: Operating DataGen
Before dropping and recreating the Informix database, perform the following procedure.
1 Back up the Informix database. For details, refer to the section Backup
Procedures in the DataGen/OLM Clean Install Guide that is printed with
Software Release Notes: DataGen (68P02900W76).
2 Log on to DataGen processor as omcadmin.
3 Enter the following command to verify that DataGen is not being accessed:
whodo
4 Close all open DataGen GUIs.
5 Enter the following command to start DGAdmin:
DGAdmin
6 To display the INFORMIX-SQL main menu, type:
dbaccess
To drop and recreate the Informix database, perform the following procedure.
3-24 68P02900W22-S
Jul 2008
System Information: DataGen Dropping and recreating the db_dg Informix database
Creating a database
To recover the OLM network configuration information, the netwk_conf table previously
unloaded to a file must now be loaded into the DataGen Informix (db_dg) database.
To load the netwk_conf table, log on to DataGen processor as omcadmin. Execute the
command (in the same line):
The OLM network configurations are now visible in the OLM GUI.
In order to recover the configuration information for the DataGen BSS areas, the country,
network, bss_conf, bss_list, and conf_list tables, previously unloaded to a file must now be
loaded into the DataGen Informix (db_dg) database.
To load the tables, log on to DataGen processor as omcadmin. Execute the commands (in
the same line):
The DataGen BSS areas are now visible in the DataGen GUI.
68P02900W22-S 3-25
Jul 2008
Importing existing CM database objects Chapter 3: Operating DataGen
Overview
A Configuration Management (CM) database object is a binary format file. Before the
development of DataGen, such file could be created only 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
3-26 68P02900W22-S
Jul 2008
System Information: DataGen Creating a country/network
Creating a country/network
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Existing DataGen users with an earlier DataGen version can use this database to maintain
previously created country or 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 or 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.
1 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-4.
2 Select Country Admin from the Administration menu. The Country
Administration window is displayed as shown in Figure 3-8.
3 If the Country Admin option is already in use, a warning message is displayed.
Click OK to return to the Administration menu.
68P02900W22-S 3-27
Jul 2008
Country Administration window - An Overview Chapter 3: Operating DataGen
The Country Administration window (as in Figure 3-8) enables users to create, update, and
edit Country and Network Administration files as follows.
File menu
The user option is Exit. The Exit option is used to exit from the Country Administration
window.
Country menu
• Generate
• Update
Select to update the DataGen database with the default Country Administration file.
NOTE
For NEW users where no country.std file exists, select Generate from the Country
menu to automatically generate a country.std file in the /home/omcadmin/dg/AD-
MIN directory. This also applies to the network.std file.
3-28 68P02900W22-S
Jul 2008
System Information: DataGen Country Administration window - An Overview
Network menu
• Generate
• Update
Select to update the DataGen database with the default Network Administration file.
NOTE
Country and Network menu options may be grayed out, according to which operations
are permitted at the time.
Data fields
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.
68P02900W22-S 3-29
Jul 2008
Creating a country Chapter 3: Operating DataGen
Creating a country
To create a country using Country Admin option, perform the following procedure.
1 Select the Edit option from the Country menu in the Country
Administration window (as in Figure 3-8). The CADM Country File window
shown in Figure 3-9 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.
4 Select Store in DDS from the File menu in the CADM Country File window.
NOTE
The new data is saved only locally at this point.
5 Select Exit from the File menu to close the CADM Country File window.
Continued
3-30 68P02900W22-S
Jul 2008
System Information: DataGen Editing a country
NOTE
The new data is now permanently stored.
Editing a country
Once a country is created, it can be edited using the Edit option from the Country menu on the
Country Administration window.
Creating a network
A new network entry is created and edited in the same way as a new country entry, using the
following procedure.
Continued
68P02900W22-S 3-31
Jul 2008
Creating a network Chapter 3: Operating DataGen
3 Select Store in DDS from the File menu in the CADM Network File
window.
NOTE
The new data is saved locally.
4 Select Exit from the File menu to close the 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-10.
6 Confirm the update by clicking the OK button. A message is displayed
showing that the update has taken place.
NOTE
The new data is now permanently stored.
3-32 68P02900W22-S
Jul 2008
System Information: DataGen Deleting a country/network
Deleting a country/network
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
To delete a country using the Country Administration Tool, the associated BSS areas and
network must first be deleted.
The BSS areas, network, and country must be deleted in the following order:
• BSS areas
• Network
• Country
To delete a BSS areas, refer to the section Deleting a BSS area on page 3-43 for details.
After deleting the BSS areas, the network can also be deleted using the following procedure.
68P02900W22-S 3-33
Jul 2008
Deleting the country Chapter 3: Operating DataGen
After the BSS areas and its network is deleted, the country can be deleted using the same
sequence of steps as described for deleting the network.
In the Country Administration window, select the Edit option from the Country menu and
follow step 4 to step 9 of Procedure 3-14 to delete the country.
3-34 68P02900W22-S
Jul 2008
System Information: DataGen Creating a BSS area
This section describes the New BSS Area window and the procedure for creating a BSS area.
From the DataGen main menu, select NEW (refer to Figure 1-1). The New BSS Area window is
displayed as shown in Figure 3-12.
Country Name
The list of available countries is already present in the window. All other columns are blank at
this time.
68P02900W22-S 3-35
Jul 2008
Creating a BSS area Chapter 3: Operating DataGen
BSS Area
When a Country Name is selected, any BSS areas currently configured for that country are
displayed.
Users can select an existing BSS area or else create a 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 is selected, the software versions available are listed in the Software
Version column. Select the appropriate software version.
Configuration number
When the software version is selected, the configuration numbers that exist are listed in the
Configuration number column. Three user options are available:
• Enter a new configuration number by typing the number in the text box below the
Configuration number column.
Area Comment
The Area Comment data field allows the users to add useful information or comments, which
are displayed every time the BSS area is selected.
• When all entries are made, click Create. DataGen checks the entries and opens the
Service Window.
1 Select a country from the Country Name list in the New BSS Area window
(refer to Figure 3-12).
Continued
3-36 68P02900W22-S
Jul 2008
System Information: DataGen Creating a BSS area
NOTE
If no configuration number is entered or selected, the lowest
configuration number available is assigned to the new BSS area.
5 Select a Configuration number from the list or enter a number in the data
field below the Configuration number list box. If an existing number is
reused, a Confirmation window is displayed as in Figure 3-14.
Click OK to overwrite the existing BSS area or Cancel to return to the New
BSS Area window, and enter an alternative number.
Continued
68P02900W22-S 3-37
Jul 2008
Creating a BSS area Chapter 3: Operating DataGen
7 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. The functions of the grayed
toolbar icons are available only at a later stage. The following section
describes the layout and functionality of the Service window.
3-38 68P02900W22-S
Jul 2008
System Information: DataGen Opening a BSS area
NOTE
The maximum number of BSS areas that can be opened at a time is 10.
To open an existing BSS area from the DataGen Main window, perform the following procedure.
1 From the DataGen main menu, select Open. The Open BSS Area window is
displayed as shown in Figure 3-16.
2 Select a country from the Country Name list in the Open BSS area window.
3 Select a BSS area from the BSS Area list.
4 Select the software version from the Software Version list.
5 Select the configuration number from the Configuration number list.
NOTE
Select multiple configuration numbers to open multiple
configurations simultaneously as shown in Figure 3-16.
Continued
68P02900W22-S 3-39
Jul 2008
Opening a BSS area Chapter 3: Operating DataGen
NOTE
If the Override Lock parameter is enabled then the configuration
is unlocked automatically. Refer to Administration tasks on page
3-12 for details.
7 Click OK to override the lock or Cancel to return to the Open BSS Area
window.
NOTE
Information on the user holding the lock is found in the DataGen.log
file. Refer to Administration tasks on page 3-12 for details.
3-40 68P02900W22-S
Jul 2008
System Information: DataGen Copying a BSS area
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 the origin of the copied area.
1 From the DataGen main menu, select Copy. The Copy BSS Area window is
displayed as in Figure 3-18.
NOTE
To overwrite an existing BSS area, select the BSS area from the
Target BSS list.
Continued
68P02900W22-S 3-41
Jul 2008
Copying a BSS area procedure Chapter 3: Operating DataGen
NOTE
If a configuration number is not entered, then DataGen automatically
assigns the lowest configuration number available.
NOTE
All columns in the Table Controller window for the new area are
blank because the structure is copied but not the input tables.
3-42 68P02900W22-S
Jul 2008
System Information: DataGen Deleting a BSS area
NOTE
The maximum number of BSS areas that can be deleted at a time is 10.
1 From the DataGen main menu select DEL. The Delete BSS Area is displayed
as shown in Figure 3-19.
2 Select a country from the Country Name list in the Delete BSS Area window.
3 Select a BSS area from the BSS Area list.
4 Select the software version from the Software Version list.
Continued
68P02900W22-S 3-43
Jul 2008
Deleting an existing BSS area Chapter 3: Operating DataGen
NOTE
Select multiple configuration numbers to delete BSS areas
simultaneously. Locked areas are automatically unlocked.
6 Click Delete.
NOTE
It is possible to return to the DataGen main menu while the delete
process is running. If the same BSS area is selected, the following
message is displayed:
When the BSS area is deleted, an Information window displays the name of
the deleted BSS area.
7 Click OK to continue. The Delete BSS area window is now updated.
8 Click Close to return to the DataGen main menu.
3-44 68P02900W22-S
Jul 2008
System Information: DataGen Configuring BSS areas
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 subsystems run the same software.
The Motorola implementation of the GSM Base Transceiver System (BTS) differs from
the GSM specifications in that a Motorola BTS can support more than one cell. The GSM
recommendations specify that a BTS supports only one cell. In this section, the terms BTS and
BTS site refer to the Motorola BTS.
Each configuration or equip function for a BSS uses an MCDF table that is populated with
parameters which are generic or specified by the user. Table 3-2 lists these functions and their
equivalent MCDF tables.
68P02900W22-S 3-45
Jul 2008
Functions and MCDF table relationships Chapter 3: Operating DataGen
3-46 68P02900W22-S
Jul 2008
System Information: DataGen Basic BSS with TS switch - Expansion
Overview
This section describes the procedures used to add another BTS site to the basic BSS. To expand
the basic network, it is necessary to modify the following MCDF tables:
• The bss.mcd table
To add another BTS site to a BSS area, perform the following procedure.
1 Copy an existing BSS area to a new BSS area with a different configuration
number.
2 From the Table Controller window, open each of the tables and modify
their contents.
3 Save the file in the DDS, then validate and insert the files.
4 Open a Topology window to check whether the system has added an
additional site.
68P02900W22-S 3-47
Jul 2008
Copying a BSS area Chapter 3: Operating DataGen
NOTE
A BSS area can be copied by selecting Copy from the DataGen main menu. Refer to
Copying a BSS area on page 3-41 for details.
1 Open an Xterm window, and enter the command to obtain the DGAdmin
prompt: DGAdmin
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:
For example:
ca -source Austria:Area1900:17 -area Area1900 -config 18
The following message is displayed:
NOTE
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.
A 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-56.
The procedure for entering reconfiguration parameters in the tables to expand the basic BSS is
the same for each table. The tables to be modified are listed in the overview of this section.
3-48 68P02900W22-S
Jul 2008
System Information: DataGen Expanding the BSS
1 From the Service window, select the Service menu, then select Table
Controller to open a Table Controller window. Refer to the section Using
the Table Controller on page 3-79 for more information.
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 are to be added before the data can be modified, go to
step 3; else 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.
4 Repeat step 3 if more columns are to be added; otherwise go to step 5.
5 Enter the appropriate values in the data fields. Use the Return key to go 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.
68P02900W22-S 3-49
Jul 2008
Expanding the BSS Chapter 3: Operating DataGen
To insert and validate the reconfigured MCDF tables, perform the following procedure.
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-105 for more
information.
Figure 3-20 shows the topology of the new BSS area with the additional site added.
3-50 68P02900W22-S
Jul 2008
System Information: DataGen Expanding the BSS
68P02900W22-S 3-51
Jul 2008
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.
• From the Table Controller window, open each of the tables 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 can 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-41 for details.
1 Once the BSS area is copied, select Open from the DataGen main menu to
display the BSS Area window.
2 The list of available countries is displayed. Select the following: Country
Name, BSS Area Name, Software Version and enter the new configuration
number.
Continued
3-52 68P02900W22-S
Jul 2008
System Information: DataGen Daisy chain configuration
NOTE
For more information about the Service window, refer to The
Service window on page 3-56.
This procedure is used to the 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
68P02900W22-S 3-53
Jul 2008
Daisy chain configuration Chapter 3: Operating DataGen
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 are 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.
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 are 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.
3-54 68P02900W22-S
Jul 2008
System Information: DataGen Daisy chain configuration
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 are 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.
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 are 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 procedure for inserting and validating MCDF tables. Refer to
Procedure 3-22.
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-105 for more
information.
68P02900W22-S 3-55
Jul 2008
The Service window Chapter 3: Operating DataGen
The Service window provides several options which enables the 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-21. 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:
3-56 68P02900W22-S
Jul 2008
System Information: DataGen Service window toolbar
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.
Revgen/Compile
The Revgen/Compile 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.
68P02900W22-S 3-57
Jul 2008
Service window menu bar Chapter 3: Operating DataGen
Exit
The Exit button closes the Service window and takes the user back to the DataGen main menu.
Help
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
3-58 68P02900W22-S
Jul 2008
System Information: DataGen File menu
Import object
Select the Import Object from the File menu in the Service window. The Database Object
window is displayed as shown in Figure 3-22. This window enables the 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.
NOTE
• 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-23) is displayed when the file is imported to
the BSS area.
68P02900W22-S 3-59
Jul 2008
File menu Chapter 3: Operating DataGen
NOTE
The binary object creation Date and Time stamp is displayed in the Information
window.
Export Object
The Export object option displays the default path, where the binary objects are exported.
To transfer binary object files from DataGen to a BSS, perform the following procedure.
1 Transfer the binary objects files to the OMC. Refer to Exporting object files
to the OMC on page 3-115 for more details.
2 Download the binary object files from the OMC to the BSS.
Continued
3-60 68P02900W22-S
Jul 2008
System Information: DataGen File menu
Procedure 3-29 Transfer binary object files from Datagen to a BSS (Continued)
3 Selecting Export Object from the File menu on the Service window
identifies the file path for the OMC operator. The following Information
window is displayed.
NOTE
To define an alternative path to export the binary object files (002), refer to
Administration tasks on page 3-12 for details.
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.
68P02900W22-S 3-61
Jul 2008
File menu Chapter 3: Operating DataGen
History
This option provides the following details of a BSS area as shown in Figure 3-25:
• 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
Select the Exit option to close the Service window and return to the DataGen main window.
This option is the same as clicking the X button in the Service window.
3-62 68P02900W22-S
Jul 2008
System Information: DataGen Edit menu
Edit menu
The following options are available in the Edit menu of the Service window:
• Script
• Compile log
• Upgrade log
• Hardware report
Script
This option enables the user to view an MMI Script file using the X-Windows editor xedit. Refer
to the section Generating a database script file on page 3-71.
Compile log
This option enables the user to view the compile log file, using the X-Windows editor xedit,
running the object compiler. Refer to the section Generating a database script file on page
3-71 for details.
Upgrade log
This option enables the user to view the upgrade log file, using a text editor. The upgrade log
file is available for upgrades carried out through the GUI. The log file is not created if the
upgrade is carried out from the command line. Refer to Upgrader on page 3-123 for details on
how to upgrade a software release.
NOTE
Operators can define the default editor for editing scripts or viewing the compile or
upgrade logs. Refer to Administration tasks on page 3-12 for details.
Hardware Report
This option enables the user to view a hardware report a text editor. Refer to Generating a
hardware report on page 3-110 for details.
68P02900W22-S 3-63
Jul 2008
Services menu Chapter 3: Operating DataGen
Services menu
The following options are available in the Services menu of 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-79 for details.
Revgen
Select the Revgen option to activate the Revgen process and convert 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-66 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.
Recombine Script
Select the Recombine Script option to enable the concatenation of many MMI script files into
a single file. This also generates individual site based MMI script files, for example: SITEXXX,
where site number replaces XXX.
Topology
The Topology option becomes available after the Revgen process is complete. Selecting this
option enables the 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.
3-64 68P02900W22-S
Jul 2008
System Information: DataGen Services menu
The option becomes available after the Revgen process is complete. Selecting this option
enables the users to generate a hardware report which contains a list of all the device names,
function names, slot numbers, and Id devices within each cage. Refer to Generating a hardware
report on page 3-110 for details.
68P02900W22-S 3-65
Jul 2008
Converting a CM database object file to a script file Chapter 3: Operating DataGen
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
can 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.
NOTE
Revgen can be run successfully only on a NEW BSS area. The CM database binary
object file can be compressed or uncompressed.
The Revgen window (refer to Figure 3-26) is divided into four areas as follows:
• File menu on page 3-67
3-66 68P02900W22-S
Jul 2008
System Information: DataGen File menu
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
68P02900W22-S 3-67
Jul 2008
Activating Revgen Chapter 3: Operating DataGen
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-26.
Continued
3-68 68P02900W22-S
Jul 2008
System Information: DataGen Activating Revgen
Continued
68P02900W22-S 3-69
Jul 2008
Activating auto Revgen Chapter 3: Operating DataGen
NOTE
If the Exit button is selected before Revgen is complete, the actual
conversion of the .002 object is not 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. Table 3-4 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.
NOTE
If the Exit button is selected before Revgen is complete, the actual conversion of the
.002 object is not 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.
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.
NOTE
• If the BSS Area gets locked when trying to open it, refer to the section
Lock/unlock BSS area (lock_adm) command on page 5-20 in Chapter 5 Command
line tools.
• Alternatively, use the Remove Lock File option in the File menu.
3-70 68P02900W22-S
Jul 2008
System Information: DataGen Generating a database script file
After the Revgen process is completed successfully, it produces a database script file in the
DataGen output file directory.
The system also issues a report stating that the database tables are populated.
Generating a database script can be performed from the Services window (refer to Figure 3-28)
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 number) to identify the correct file. The operator is
informed when the script has been successfully created.
The database script file is stored in the output file directory of DataGen.
NOTE
• 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 script to be compared against the new script. Individual site
files are created, for example; SITE<XXX>, where site number replaces XXX.
• If the Options Object file is found to be missing or corrupt, an error message as
shown in Figure 3-28 is displayed. Refer to Administration tasks on page 3-12
for details of reinstalling the Options object file.
68P02900W22-S 3-71
Jul 2008
Viewing a database script file Chapter 3: Operating DataGen
After a database script file has been created, it can be viewed by selecting the Script option in
the Edit menu of the Service Window.
The script file is displayed within a xedit window as shown in Figure 3-29. 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 are made.
To define which editor to launch when viewing scripts, refer to Defining environment variables
on page 3-4 for details.
3-72 68P02900W22-S
Jul 2008
System Information: DataGen xedit window description
68P02900W22-S 3-73
Jul 2008
Using the toolbars Chapter 3: Operating DataGen
The file information areas show the full path of the script file presented in the display area
of the xedit window.
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.
NOTE
A script file can also be generated and edited using an editor in an Xterm window,
for example, the UNIX editor vi.
Procedure 3-31 describes the steps involved in defining a text editor to view MMI scripts or
compilation logs other than the standard editors.
NOTE
When adding a new editor, verify that the editor runs on the system processor.
Verification can be done by entering the editor name from the command line and
ensuring that it launches correctly.
3-74 68P02900W22-S
Jul 2008
System Information: DataGen Alternative text editor
cp <text_editor> /usr/bin
Continued
68P02900W22-S 3-75
Jul 2008
Alternative text editor Chapter 3: Operating DataGen
/usr/omc/DataGen/current/config/local/cshrc.datagen:
setenv DG_EDITOR <text_editor>
NOTE
If only specific operators wish to use the editor, edit the .cshrc in
the home directory of the user.
3-76 68P02900W22-S
Jul 2008
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.
68P02900W22-S 3-77
Jul 2008
Upgrader Chapter 3: Operating DataGen
Upgrader
The Upgrader is a window-based tool which is invoked by selecting the UPG button from
the DataGen main menu.
The Upgrader creates a 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.
NOTE
If any parameters in the BSS area are to be changed before the upgrade, it should
be done by altering the MCDF files. Refer to Using the Generic Table Editor (GTE)
on page 3-90 for details.
3-78 68P02900W22-S
Jul 2008
System Information: DataGen Using the Table Controller
To open the Table Controller window (as in Figure 3-31) from the Service window, either
select the Table Control option from the Services menu or click the Table Controller button.
68P02900W22-S 3-79
Jul 2008
Table Controller functions Chapter 3: Operating DataGen
• Exporting data to create a set of MCDF files for the BSS area.
User controls
Menu bar
The menu bar provides the following options to manipulate DataGen input files as described in
Table 3-5.
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 Clears all file types in the Table Controller window.
Files
Command buttons
The command buttons are used to perform File, Validate, Insert, Export, and Report functions
on the files imported into 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.
3-80 68P02900W22-S
Jul 2008
System Information: DataGen File select buttons
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
is displayed 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. Table 3-6 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.
68P02900W22-S 3-81
Jul 2008
MCDF table files Chapter 3: Operating DataGen
• SITE (bts) - The SITE table contains specific information regarding each site in the BSS
area.
• Hardware (hw) - The Hardware 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, with respect to the site, cabinet, cage, and slot in which the device
resides.
NOTE
The cabinets and cages are not explicitly noted in the table; further information
is included within the details of the cards.
• Cabinet (cab) - The Cabinet (optional) table contains information about all the non-default
type cabinets throughout the BSS area.
• Timer (time) - The Timer 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 can be overridden for a site or cell
by values in the Specifics table.
• Circuit (acct) - The Circuit table contains all MTL, LMTL, and OML signaling links. It also
contains the terrestrial circuits to time slots at the BSC for radio traffic channels.
• Channel (chan) - The Channel table is only required for Remote Transcoders and contains
the OML and MTL signaling 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 given in detail in the Hardware table.
• Link (link) - The Link table is used for two different tasks:
Non-RXCDR area - contains details of the links between MMSs required by the paths.
RXCDR area - contains details of the links between the RXCDR and its BSCs used
by the XBL feature.
In both cases, the MSIs and the MMSs required are given in detail in the Hardware table.
• Modify Value (modv) - The Modify Value table details all the modify_value commands
related to MMS/LCF device functions within the area.
• PATHs (path) - The Paths table gives the details of all the paths within the BSS area
(providing signaling 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-82 68P02900W22-S
Jul 2008
System Information: DataGen MCDF table files
• LAPD (lapd) - The LAPD table contains details of the LAPD values for the RSLs and XBLs
in the area. The RSLs and XBLs required are given in detail in the Circuits and Paths tables.
• Cell (cell) - The Cell table contains the details of all the cells across the OMC or network
and also the external neighbors used by the specified cells. The optional fields in this table
contain information which override the defaults specified in the Generics table.
• RTF (rtf) - The RTF table contains details of the RTFs contained in the BSS area.
• DRI (dri) - The DRI 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) - 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 can 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.
NOTE
Elements that can exist in the Cell table are not shown in the Specifics table.
• Neighbor (ngbr) - The Neighbor 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) - The Algorithm 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) - The Daughter 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 an NS-VCI and DLCI to a specific GBL.
• Hop (hop) - The Hop table is used to specify the parameters of the chg_hop_params
command.
68P02900W22-S 3-83
Jul 2008
Creating MCDF files Chapter 3: Operating DataGen
• ACS (acs) - The Active Codec Set (ACS) table is used to specify the parameters for any
chg_acs_params commands.
• Test Neighbor (testngbr) - The Test Neighbor table specifies test neighbor details that
allow the cell to add frequencies to the bcch allocation list without having that frequency
considered for a handover .
• Nail Connection (Nailconn) - The Nail Connection table is used to nail the connections
through the BSC to equip the GBLs by specifying the parameters of the chg_ts_usage
command.
MCDF files can either be created, using blank templates, or regenerated, using an existing
database.
To create files in MCDF format, it is necessary to Export the files from the Informix database.
NOTE
• 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 MCDF tables.
• Warning messages appear during the Export process, which can be safely
ignored as the export continues successfully.
3-84 68P02900W22-S
Jul 2008
System Information: DataGen MCDF file procedures
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.
3 In the Table Controller window, select the Export button. A Message
window is displayed showing the progress of the Export function for each
file.
4 When the Message window indicates that all files are exported, click the
OK button. Each file, when correctly exported, is indicated by a check mark
in the File column.
After the files are created, and/or edited using the GTE, the files must be validated and then
inserted back into the Informix database.
Validation can be carried out separately on each file or the whole file set can be validated in
one process. Validation comprises the following procedures:
• A check for missing fields
DGAdmin DGLog
The Validation Log window opens and displays errors and warnings about
the progress of the validation and insert process. This information is also
available by viewing the log file from the Administration menu. Refer to
Administration tasks on page 3-12 for details.
2 In the Table Controller window, choose Select All Files from the Select
menu.
3 Click the Validate button. A Message window showing the progress of the
Validate function for each file is displayed.
4 When the Message window indicates that all files are validated, click OK.
Each correctly validated file is indicated by a check mark in the File column.
68P02900W22-S 3-85
Jul 2008
MCDF table editing Chapter 3: Operating DataGen
After successful validation, the files must be inserted back into the Informix database. To insert
the files, perform the following procedure.
DGAdmin DGLog
The Validation Log window displays the errors and warnings about the
progress of the validation and insert process. This information is also
available by viewing the log file from the Administration menu. Refer to
Administration tasks on page 3-12 for details.
2 In the Table Controller window, choose Select All Files from the Select
menu.
3 Click the Insert button. A Message window showing the progress of the
Insert function for each file is displayed.
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.
NOTE
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 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 the input files also means that a file can only be validated if all its
dependent files are validated and inserted or are currently selected.
After the MCDF files are created from the Informix database, they can be edited using the
Generic Table Editor (GTE). The following procedure uses a Generics table, which requires a
change to the Generics parameter ber_loss_daily, as an example of table editing.
3-86 68P02900W22-S
Jul 2008
System Information: DataGen MCDF table editing
Procedure 3-35 Edit an MCDF table using the Generic Table Editor
1 In the Table Controller window, select the Generics Radio button, then select
the File button.
2 A Generics table (gene.mcd) is displayed as in Figure 3-32.
Continued
68P02900W22-S 3-87
Jul 2008
File status icons Chapter 3: Operating DataGen
Procedure 3-35 Edit an MCDF table using the Generic Table Editor (Continued)
4 Enter the value 4, then press CR to save the entry.
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 (*).
6 Select the Generics file select button. A Report window displays the message
that the ber_loss_daily value was successfully updated in the database.
NOTE
The File Status icons on the Table Controller window are defined as follows (refer to Table 3-6):
Continued
3-88 68P02900W22-S
Jul 2008
System Information: DataGen File status icons
68P02900W22-S 3-89
Jul 2008
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.
• 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-90 68P02900W22-S
Jul 2008
System Information: DataGen The File menu
New option
To create an (empty) MCDF input file, select New from File menu in the MCDF input (.mcd)
file. A New message window is displayed as in Figure 3-33.
Open option
To open an MCDF input file, select the Open option from the File menu in the MCDF input file
window. The Open File window is displayed as shown in Figure 3-34.
68P02900W22-S 3-91
Jul 2008
The File menu Chapter 3: Operating DataGen
This data field enables the user to specify a directory path, and the name of the file which
is to be opened. The wildcard character * can be used to display ALL files in a directory.
• Directories
This scrolled list box displays directories and subdirectories 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
• Buttons
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 through the OLM GUI.
After editing an MCDF Input file, perform the following procedure to store the file in the
DataGen Directory Structure (DDS).
Procedure 3-36 Store MCDF Input file in the DataGen Directory Structure
1 Select the Store in DDS option from the File menu in the edited MCDF
Input file menu bar.
2 Select Exit to close the edited file.
3 In the Table Controller window, select the Insert button. A Message
window is displayed showing the results of the Insert process. The file is
validated automatically.
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-92 68P02900W22-S
Jul 2008
System Information: DataGen The File menu
Save As option
Figure 3-35 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.
Figure 3-36 shows the Printer Setup window which is displayed when Print Setup is selected
from the File menu.
NOTE
The default page size is A4.
68P02900W22-S 3-93
Jul 2008
The File menu 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-8, Table 3-9, and Table 3-10.
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.
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.
3-94 68P02900W22-S
Jul 2008
System Information: DataGen The File menu
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:
Print option
The Print Table window is displayed when the Print option is selected from the File menu.
NOTE
The print command selects the appropriate command for postscript or text only
printer as in Figure 3-37. If no printer is set up, then none is displayed in the printer
list.
68P02900W22-S 3-95
Jul 2008
The Edit menu Chapter 3: Operating DataGen
The Print Table window allows the user to specify the printer output parameters. This window
has:
• Two option buttons allowing the following format selection:
Postscript - generates the printer output as a postscript file.
• The Printers list box which displays the available printer names.
NOTE
For more information about installing printers, refer to Configuring the
printer in Software Release Notes: DataGen (68P02900W76).
• The Printer command data field allows the user to enter a print command for a printer
which is not included in the Printers list box as follows:
Print - sends the MCDF input file to the printer selected in the Printers list.
The Edit menu enables the user to perform general editing operations on the data contained in
the cells of an MCDF file.
NOTE
Before copying and pasting the cells, create the required number of columns and/or
rows required to contain the data.
3-96 68P02900W22-S
Jul 2008
System Information: DataGen Fill Cells window
Select To
Cut Cut the contents of the currently selected cells with the data being retained
in a buffer. However, subsequent cut operations overwrite the contents of the
buffer. The cut cells are left empty.
Copy Copy the contents of the currently selected cells into a buffer.
Paste Copy the contents of the buffer into the currently selected cells.
Clear Delete the contents of the currently selected cells. 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.
NOTE
There is a single buffer for Cut or Copy operations. Only the last Cut or Copy
operation is retained in the buffer.
Figure 3-38 show the Fill Cells window which is displayed when the Fill option is selected
from the Edit menu in the MCDF input file.
68P02900W22-S 3-97
Jul 2008
Fill Cells window Chapter 3: Operating DataGen
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-12).
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.
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:
To modify an MCDF input file using the Fill Cells window, perform the following procedure.
Continued
3-98 68P02900W22-S
Jul 2008
System Information: DataGen Format menu
Format menu
The Format menu enables the user to perform general search and replace operations.
Table 3-15 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.
68P02900W22-S 3-99
Jul 2008
Format menu Chapter 3: Operating DataGen
Find option
Enter the string to search for and select the appropriate search criteria (Exact match or Case
sensitive) for the search. Figure 3-39 shows the Find window.
The Search For data field allows the user to specify the character string to find.
Table 3-16 and Table 3-17 describe the Enable buttons and the Action buttons.
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.
Continued
3-100 68P02900W22-S
Jul 2008
System Information: DataGen Format menu
Goto option
Figure 3-40 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.
Field Enter
Column Column number
Row Row number
Select To
OK Confirm the displayed parameters and close the Goto Cell window.
Continued
68P02900W22-S 3-101
Jul 2008
Format menu Chapter 3: Operating DataGen
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-41.
3-102 68P02900W22-S
Jul 2008
System Information: DataGen Format menu
Field Enter
Search for The specific character string for
searching.
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:
Sort option
The contents of some tables can be sorted. If a table cannot be sorted, this option is grayed 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 alter the data.
The Unlock button enables the user to unlock a table and change the locked values. A warning
is displayed to this effect.
68P02900W22-S 3-103
Jul 2008
MCDF key equivalents Chapter 3: Operating DataGen
Table 3-24 describes the key equivalents that are available when working on MCDF tables.
3-104 68P02900W22-S
Jul 2008
System Information: DataGen Using the Topology Viewer
NOTE
Selecting the Topology option causes the DataGen GUI to core, if the GMS license
(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 Exit option only.
To display the Topology Viewer (as in Figure 3-42), either select Topology from the Services
menu or click the Topology icon on the Services window.
68P02900W22-S 3-105
Jul 2008
Using the Topology Viewer Chapter 3: Operating DataGen
Use the buttons on the menu bar shown in Figure 3-43 to access the topology viewer options.
3-106 68P02900W22-S
Jul 2008
System Information: DataGen Cage hardware configuration button
The topology viewer options are described in greater detail in the following sections.
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-S 3-107
Jul 2008
Cage hardware configuration button Chapter 3: Operating DataGen
The main section of the window contains a graphical representation of the layout of the
hardware within the selected cage. If necessary, this main section can be cut and printed,
enabling users to produce a hard copy showing cabinet configurations.
The Cage Description window has six data fields which show the Cage Description information.
The buttons on the left-hand side of the window are not enabled. The Message window shown
at the bottom is currently unused.
Select the Exit option from the File menu to close the window.
3-108 68P02900W22-S
Jul 2008
System Information: DataGen The MMI button
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-56.
This button uses a text editor to display the path or connectivity information. For example:
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.
68P02900W22-S 3-109
Jul 2008
Generating a hardware report Chapter 3: Operating DataGen
Operators 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.
1 Open the Service window (refer to Opening a BSS area on page 3-39 for
details).
2 From the Service window, select Generate Hardware Report from the
Services menu.
NOTE
The Generate Hardware Report option is available only if the BSS
area contains data.
Continued
3-110 68P02900W22-S
Jul 2008
System Information: DataGen Procedure for generating a hardware report
5 Close the report by using the appropriate command for the text editor in use.
68P02900W22-S 3-111
Jul 2008
Converting a database script file to a CM database object file Chapter 3: Operating DataGen
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 is done, the Database Script
File can be downloaded to the BSS through 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.
DataGen uses the Binary Object Compiler to convert a script file into a CM database object.
The CM database object is automatically compressed. As a secondary function of compiling the
object, the compiler also validates the database.
NOTE
As a requirement for running the binary object compiler, install 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 menu, or by clicking Run
Compiler shown in Figure 3-47.
3-112 68P02900W22-S
Jul 2008
System Information: DataGen Producing a CM database object using the DataGen binary object compiler
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 using the MMI Script Generate command does
not update the Informix database, as it is in an output file directory.
The Binary Object Compiler window has two data fields which display the BSS Area informa-
tion and the Status of the compiler. There are two action buttons: Run Compiler and Exit.
The File menu has three selections:
• Run Compiler
• Exit
68P02900W22-S 3-113
Jul 2008
Producing a CM database object using the DataGen binary object compiler Chapter 3: Operating DataGen
NOTE
All binary object files (.002) are compressed. Refer to Command Line tools,
Compress /uncompress binary object files for details on how to uncompress files.
To activate the compiler, click Run Compiler or select the Compile option from the File menu.
3-114 68P02900W22-S
Jul 2008
System Information: DataGen Exporting object files to the OMC
After a binary object is generated, it can be downloaded to the OMC. The three methods for
exporting object files are:
• Export multiple binary object files to the OMC
NOTE
For more information about the requirements for this type of operation,
refer to DataGen-OMC Integration in Software Release Notes: DataGen
(68P02900W76).
To export multiple binary object files to the OMC, perform the following procedure.
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-12, customizing parameters for
details on how to define a path to an export directory.
2 From the Service window (refer to Figure 3-21), select the Export option
from the File menu.
3 Click OK in the displayed Message window.
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>
Continued
68P02900W22-S 3-115
Jul 2008
Exporting a single binary object file Chapter 3: Operating DataGen
NOTE
The setenv COUNTRY and COUNTRY_CODE variables are
to be set at the OMC, and must match the values set in the
country administrator (Country) table, in order for the available
configurations to be displayed.
To export one object file that has been created using the DataGen GUI to the OMC, perform the
following procedure.
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 the configuration number replaces n.
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 a sub directory does not exist, create one. For example:
Continued
3-116 68P02900W22-S
Jul 2008
System Information: DataGen Exporting OLM binary object files to the OMC
NOTE
The setenv COUNTRY and COUNTRY_CODE variables are
to be set at the OMC, and must match the values set in the
country administrator (Country) table, in order for the available
configurations to be displayed.
To export multiple binary object files to the OMC from the Offline MIB, perform the following
procedure.
68P02900W22-S 3-117
Jul 2008
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 1-1).
Two different BSS Areas are chosen and a comparison of both the areas is started. A viewable
report is generated in which the sites common to both the areas are listed. Differences between
the two BSS Areas for each site are also listed. In addition, the report indicates the areas where
no differences between the sites are found.
Select DIFF from the DataGen main menu to display a Difference Reporter window as shown
in Figure 3-48.
The Difference Reporter window displays the details of two BSS areas which can be selected
for comparison using the BSS Area Details window.
3-118 68P02900W22-S
Jul 2008
System Information: DataGen Select BSS Area Details window
The Difference Reporter window has two sets of four user input areas labeled as:
• Country
• BSS Name
• Version
• Config
The action buttons on the Difference Reporter window are 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 in
the Difference Reporter window. The Select BSS Area Details window is then displayed.
Refer to Figure 3-49.
When the window is displayed for the first time, the BSS Name, Software Version, and Config
Version list boxes are blank. Only the Country Name list box contains a list of countries.
68P02900W22-S 3-119
Jul 2008
Select BSS Area Details window Chapter 3: Operating DataGen
The Select BSS Area Details window has four user selectable areas:
• Country Name
When Country Name is selected, a list of BSS names in the BSS area list is displayed.
• 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 can 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 are used as follows:
Use To
Cancel Cancel the operation and close the window.
Done Enter the selected details into the Difference
Reporter window for BSS Area 1 and Area 2.
3-120 68P02900W22-S
Jul 2008
System Information: DataGen Difference Reporter Information window
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-50.
The Difference Reporter Information window has a text area which displays the progress of
the Difference Reporter and two action buttons which are used as follows:
Use To
View Report Display an Information window.
Close Close the Information window.
68P02900W22-S 3-121
Jul 2008
Difference Reporter Report window Chapter 3: Operating DataGen
The results of the Difference Reporter process are displayed in a Report window as shown
in Figure 3-51.
The Report window has a text box which displays Difference Report output. As reports can
be large, a horizontal scroll bar and a vertical scroll bar can be used to view different parts of
a report.
3-122 68P02900W22-S
Jul 2008
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 1-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.
• 1.7.6.0 to 1.9.0.0
• 1.8.0.0 to 1.9.0.0
Refer to Software Release Notes: DataGen (68P02900W76) for more information about the
upgrades supported.
When UPG is selected from the DataGen main menu, the Upgrade BSS Area window is
displayed as in Figure 3-52. This allows the user to select the BSS Area characteristics to be
upgraded. The Target Version is entered automatically by DataGen.
68P02900W22-S 3-123
Jul 2008
Upgrade BSS Area window Chapter 3: Operating DataGen
NOTE
To change parameters in the BSS area before the upgrade, modify the MCDF files.
Refer to Using the Generic Table Editor (GTE) on page 3-90 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 Display a list of Configuration numbers for the software versions.
number
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.
Where Is
BSS area Name of the original BSS area.
Configuration No Configuration number of the original BSS area.
3-124 68P02900W22-S
Jul 2008
System Information: DataGen Upgrading a BSS Area
1 Select the UPG from the DataGen Main menu (refer to Figure 1-1). This
displays the Upgrade BSS Area window (refer to Figure 3-52).
2 Select a Country Name in the list box to display a list of BSS areas.
3 Select a BSS Area to display a list of Software Versions.
4 Select the required software version which is to be upgraded: a list of
associated configuration numbers is displayed.
5 Select a Configuration No.
6 Select a Target Version which is displayed in the list box automatically. To
obtain a target configuration number automatically, do not select a number from
the Target Config. list. DataGen then assigns the next available configuration
number.
NOTE
To overwrite an existing configuration, select the number from the
Target Config. list.
7 If the information displayed in the list box data fields is correct, click Upgrade.
If another user has locked the BSS area, an Information window is displayed
as shown in Figure 3-53. If this message is not displayed, proceed to step 9.
Continued
68P02900W22-S 3-125
Jul 2008
Upgrading a BSS Area Chapter 3: Operating DataGen
NOTE
Information on the user holding the lock can be found in the
DataGen.log file. Refer to Administration tasks on page 3-12 for
details.
Continued
3-126 68P02900W22-S
Jul 2008
System Information: DataGen Upgrade multiple BSS areas
NOTE
Wait until Gcmd has completed before closing the window.
9 Click Close to return to the Upgrade BSS Area window when Gcmd is
completed. If the upgrade is unsuccessful, the Status window displays the
following information:
Refer to the section Resolving upgrade problems on page 3-127 for details.
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 Procedure 3-43
and carry out step 3 to step 9.
During the upgrade process, problems may occur in the BSS area that prevent the successful
upgrading. The Status window identifies any problems occurred.
Depending on the nature of the problems, modifications can be done in one of two ways:
• Modify MCDF files
68P02900W22-S 3-127
Jul 2008
Resolving upgrade problems Chapter 3: Operating DataGen
NOTE
Wait until Gcmd has completed before closing the window.
1 Open the target BSS area window from the DataGen main menu. Refer
to Opening a BSS area on page 3-39 for details.
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-79 for more 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-71 for more 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-112 for more details.
3-128 68P02900W22-S
Jul 2008
System Information: DataGen Overview of DARBC and Enhanced XBL
1 Open the Target BSS Area window from the DataGen main menu. Refer to
Opening a BSS area on page 3-39 for more details.
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-71 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-112 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-12 for
more details. From the Service window, select File à Export Object.
5 From the Service window, select File à Exit.
6 Create a BSS area and overwrite the existing configuration number. Refer to
Creating a BSS area on page 3-35 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-56 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-66 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.
68P02900W22-S 3-129
Jul 2008
Batch processing of binary object files Chapter 3: Operating DataGen
Batch processing of binary object (.002) files is 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 higher versions of DataGen.
• Compile
Multiple scripts files can be selected and compiled to form binary object files.
When the Revgen or upgrade batch option is selected, it is also possible to automatically
copy and/or export the new areas.
NOTE
A default BSS Area name is derived from the binary object name minus the .002
extension. For example, BSS12.002 becomes BSS area BSS12. Use meaningful
binary names.
3-130 68P02900W22-S
Jul 2008
System Information: DataGen Revgen multiple binary object files
1 Start DataGen from an Xterm window and select BATCH from the DataGen
main menu (refer to Figure 1-1). The Batch Tool window is displayed.
2 Select the Revgen option (as shown in Figure 3-55).
3 To export the revgened areas automatically, click Export MCDF Files; else
proceed to step 4.
4 To copy the revgened areas automatically, click Copy Area; else 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.
NOTE
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 Defining environment
variables on page 3-4 for details.
6 Click OK.
Continued
68P02900W22-S 3-131
Jul 2008
Revgen multiple binary object files Chapter 3: Operating DataGen
NOTE
To obtain a configuration number automatically, do not enter a
number. DataGen automatically assigns the lowest configuration
number available.
NOTE
If all the essential fields are not completed, an error window is
displayed stating:
Continued
3-132 68P02900W22-S
Jul 2008
System Information: DataGen Revgen multiple binary object files
NOTE
If the Close button is selected, batch processing continues in the
background. The outcome can be found in the report file which is
located in the selected binary object file directory. The report has a
Date and Time stamp, for example: batch_ddmmyyyyhhmmss.rpt.
68P02900W22-S 3-133
Jul 2008
Upgrade multiple binary object files Chapter 3: Operating DataGen
NOTE
If files other than binary object files exist in the directory, then
an error message is generated in the Batch Monitor window.
A default import path can be defined. Refer to Defining
environment variables on page 3-4 for details.
6 Click OK.
7 On the Batch Tool window, select the following:
NOTE
All the binary object files in the directory must be of the
same software version for the upgrade to be successful.
8 Select the target version to upgrade to from the Target Version list.
Continued
3-134 68P02900W22-S
Jul 2008
System Information: DataGen Compile multiple MMI scripts
NOTE
1 Refer to the procedure Revgen multiple binary object files and repeat
step 1. This displays the Batch Tool window (refer to Figure 3-55).
2 Select the Compile option.
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.
NOTE
If files other than script files (ASCII text) exist in the directory, then
a warning message is generated in the Batch Monitor window.
A default import path can be defined. Refer to Network
Expansion - Defining environment variables for details.
4 Click OK.
5 Select a country from the Country Name list.
Continued
68P02900W22-S 3-135
Jul 2008
Compile multiple MMI scripts Chapter 3: Operating DataGen
NOTE
All script files must be the of same software version and the correct
compiler version must be selected, else errors are generated.
7 Click Execute.
A Confirmation window displays the following message:
Continued
3-136 68P02900W22-S
Jul 2008
System Information: DataGen Compile multiple MMI scripts
NOTE
If the Close button is selected, batch processing continues in the
background. To view the outcome, check the report file which is
located in the directory where the scripts reside.
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.
NOTE
If any of the scripts fail to compile, then only a report file is generated. This can
be used to identify the problem.
68P02900W22-S 3-137
Jul 2008
Compile multiple MMI scripts Chapter 3: Operating DataGen
3-138 68P02900W22-S
Jul 2008
Chapter
68P02900W22-S 4-1
Jul 2008
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 possible to create a binary file only by downloading an ASCII format script file
to a BSS in SYSGEN mode.
DataGen allows the user to modify and carry out Radio Frequency (RF) planning on multiple
BSS binary files through the Offline MIB (OLM) which has a graphical user interface (GUI).
Users can run only one Offline MIB at a time. However, multiple GUIs for the same MIB can 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.
NOTE
Parameters such as circuits, channels, statistics (enabling/disabling/thresholds) and
time slot reservations cannot be modified using the OLM GUI.
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 the DataGen/OLM Clean Install Guide included in the manual
Software Release Notes: DataGen (68P02900W76).
• The upgrade function is carried out from the front panel DataGen window, not from the
OLM GUI. For details, refer to Upgrader in Chapter 3 Operating DataGen.
4-2 68P02900W22-S
Jul 2008
System Information: DataGen Task list for using the OLM GUI
The following lists, in sequence, the procedures that are performed using the OLM GUI:
• Start the OLM from the DataGen front panel.
• From the Navigation Tree of the OLM, import the BSS binary files from DataGen into the
network.
NOTE
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.
• Modify the BSSs through the Navigation Tree and Detail Views.
• 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 tasks such as importing binary files from tape into the OLM directory
(Realign Network), refer to Additional OLM features on page 4-56.
NOTE
These tasks are not routine functions and should be carried out only by the
administrator or creator of the Offline MIB network.
68P02900W22-S 4-3
Jul 2008
Levels of users 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 the section
Troubleshooting the OLM on page 4-80 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). For more information about these tasks,
refer to:
4-4 68P02900W22-S
Jul 2008
System Information: DataGen Using the cmutil.olm command
On the OLM, the command cmutil.olm is used, while on the OMC, the command cmutil is
used. 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-S 4-5
Jul 2008
Starting/creating a network configuration in the OLM Chapter 4: Operating the Offline MIB
To start the OLM from the DataGen main menu, perform the following procedure:
1 Click the OLM button, refer to DataGen - startup and shutdown in the
Chapter 3 Operating DataGen A status message is displayed.
2 Click OK to continue. The OLM Network Configurations window then
opens as shown in Figure 4-1.
1 Select the Create button or select Edit à Create from the menu bar (refer
to Figure 4-1). The OLM Network Configuration Creation window is then
displayed as in Figure 4-2.
Continued
4-6 68P02900W22-S
Jul 2008
System Information: DataGen Creating a network configuration
Continued
68P02900W22-S 4-7
Jul 2008
Creating a network configuration Chapter 4: Operating the Offline MIB
NOTE
The name cannot start with a number or include a hyphen.
3 Enter the Mobile Country Code (MCC) and press the Tab key.
4 Enter the Mobile Network Code (MNC). The RDN Class Network is
displayed.
5 Select Additional Information and enter a brief description of the network.
(But it is not mandatory to enter this information).
6 Select File à Create from the menu bar to create the network configuration.
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.
NOTE
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-37 for
more details.
4-8 68P02900W22-S
Jul 2008
System Information: DataGen Starting/exiting the OLM GUI
Introduction
1 From the DataGen main menu, select the OLM button, refer to DataGen -
startup and shutdown in Chapter 3 Operating DataGen. The Offline MIB
(OLM) Network Configurations window is displayed as in Figure 4-1.
2 Select the required network configuration name from the OLM Network
Configurations list. The selection is highlighted in black.
NOTE
By default, the first network configuration is selected.
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.
Continued
68P02900W22-S 4-9
Jul 2008
Starting the OLM GUI Chapter 4: Operating the Offline MIB
While the OLM is starting, a Status window displays the following message:
Initialising...Please wait...
Starting the MIB process...
Initialising the Network Elements...
Starting the GUI application...
NOTE
It is possible to open only 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).
Continued
4-10 68P02900W22-S
Jul 2008
System Information: DataGen Starting 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-15 for more information about the
OLM front panel.
68P02900W22-S 4-11
Jul 2008
Exiting the OLM GUI Chapter 4: Operating the Offline MIB
To exit the OLM GUI, click Exit on the OLM front panel (refer to Figure 4-5).
A Confirmation window is displayed (Figure 4-6).
Click OK to exit the GUI and return to the OLM Network Configurations window.
NOTE
If the network configuration GUI is opened by more than one user, the message
shown in Figure 4-6 is displayed.
NOTE
The last user to exit the GUI shuts down the Offline MIB.
4-12 68P02900W22-S
Jul 2008
System Information: DataGen Shutting down the OLM
Perform the following steps to exit and shut down the OLM.
1 Click Exit on the OLM front panel (refer to Figure 4-5). A Confirmation
window is displayed as shown in Figure 4-7.
2 Click the Save à Exit button. If no errors exist within the network, the
Confirmation window closes and the OLM shuts down. If errors are detected,
proceed to step 3.
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 errors and warnings window for a Network
Element
Continued
68P02900W22-S 4-13
Jul 2008
Shutting down the OLM Chapter 4: Operating the Offline MIB
NOTE
This can result in inconsistencies between the Offline MIB and the
specific NE database within the network configuration directory.
4-14 68P02900W22-S
Jul 2008
System Information: DataGen Front panel icons
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 operator who has logged in 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-27 for details.
For more detailed information about using the Navigation Tree, refer to Network Operations,
OMC-R Online Help.
Administration
Select the Admin icon to view the Admin Options window. Administration is related to
the audit functions. All BSSs and RXCDRs must be audited before altering their BSS Binary
database files.
68P02900W22-S 4-15
Jul 2008
Find Chapter 4: Operating the Offline MIB
Find
Select the Find icon to invoke a search facility to locate a Network Entity, PCU, Site, or Cell
within a network. The Find function displays a Navigation Tree starting at the network object
defined in the Find criteria. The Find function can also be used to locate an attribute.
Help
Select this icon to invoke the contents page of the OLM online help. The 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.
4-16 68P02900W22-S
Jul 2008
System Information: DataGen Expert Offline MIB front panel
The OLM front panel can 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.
68P02900W22-S 4-17
Jul 2008
Finding devices and attributes Chapter 4: Operating the Offline MIB
From the Offline MIB front panel, select the Find icon to display a Find window. The Find
Devices option is selected by default. Search for NEs, Sites, PCUs, or Cells by entering
completely or partially the following details:
• NE Name
• Site Name
• Site Id
• PCU Name
• Cell Name
• GSM Cell Id
For more information about finding devices, refer to Finding an NE, PCU, Site, or Cell on page
4-19.
Select the Find Attributes option to open a Find Attribute window where details of the
required attribute are entered. For more information about finding attributes, refer to Finding
an attribute on page 4-24.
4-18 68P02900W22-S
Jul 2008
System Information: DataGen Finding a Network Element, PCU, Site, or Cell
1 Select the Find button from the Offline MIB front panel. This displays the
Find window as in Figure 4-10 with the Find Devices option selected by
default.
Continued
68P02900W22-S 4-19
Jul 2008
Finding an NE, PCU, Site, or Cell Chapter 4: Operating the Offline MIB
NOTE
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. The search is not case sensitive.
3 Click the Find NE(s), Find PCU(s), Find SITE(s) or Find CELL(s) button.
• Find NE(s) displays the network elements that match the criteria in
all fields. If a cell name is entered, it finds the NE containing the cell.
• Find PCU(s) displays the PCUs that match the criteria in all fields.
• Find SITE(s) displays the sites that match the criteria in all fields.
• Find CELL(s) displays the cells that match the criteria in all fields.
NOTE
NOTE
If no match is found, an Information window is displayed stating:
No matching <object> was found.
5 Click the required object in the Find Results box. The selection is
highlighted in inverse text, where object is the Network Element, PCU,
Site, or Cell.
6 For a Site or Cell, to obtain the parent view, click the Find Parent button;
else, go to step 7.
Continued
4-20 68P02900W22-S
Jul 2008
System Information: DataGen Finding an NE, PCU, Site, or Cell
Figure 4-11 Find window with a Cell and Navigation Tree selected
8 From the menu bar on the Navigation Tree or Detailed View window, select
File à Close to return to the Find window.
9 Select Close to return to the Offline MIB front panel.
68P02900W22-S 4-21
Jul 2008
Examples of using Find Chapter 4: Operating the Offline MIB
The following are typical examples of when an operator can use the Find feature.
To find a Site at a BSS by specifying the BSS name and the Site id, perform the following
procedure.
1 Select the Find button from the Offline MIB Front Panel to open the Find
window.
2 Enter the BSS name in the NE Name field and then enter the Site ID in
the Site id field.
3 Click Find Site(s). The result of the search is displayed in the Find Results
box.
1 Select the Find button from the Offline MIB Front Panel to open the Find
window.
2 Enter the name of the Cell in the Cell Name field, or its ID in the GSM
Cell id field.
3 Click Find Cell(s). The results of the search are displayed in the Find
Results box.
4 Select the Cell in the Find Results box.
5 Click Find Parent. The parent site of the Cell is displayed in the Find
Results box.
6 Select the Site and then click Find Parent. The parent BSS of the Cell is
displayed in the Find Results box.
4-22 68P02900W22-S
Jul 2008
System Information: DataGen Examples of using Find
To search for Cells with a particular Location Area Code (LAC), perform the following procedure.
1 Select the Find button from the Offline MIB Front Panel to open the Find
window.
2 Enter the LAC in the third field of the GSM Cell Id.
3 Click Find Cell(s). All Cells with the specified LAC are displayed in the
Find Results box.
NOTE
Additional information about GSM Cell IDs can be found in
Technical Description: BSS Implementation (68P02901W36)
and Installation and Configuration: GSM System Configuration
(68P02901W17).
68P02900W22-S 4-23
Jul 2008
Finding an attribute Chapter 4: Operating the Offline MIB
Finding an attribute
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The Find Attributes window (as in Figure 4-12) can be used to identify the exact name of
an attribute when only part of the attribute name is known. For example, searching for con
would list all attribute names containing con.
4-24 68P02900W22-S
Jul 2008
System Information: DataGen Overview of finding attributes
Finding an attribute
1 Click the Find icon on the DataGen Front Panel. The Find window
Figure 4-10 is displayed with the Find Devices button selected, by default.
2 Click the Find Attributes button at the top of the window. The window is
ready to accept find criteria for an attribute (refer to Figure 4-12).
3 Select either Begins With, Ends With or Anywhere in the Attribute
Name field to search for an attribute whose name either begins with, ends
with or contains with the contiguous characters entered in step 4.
4 Enter at least three of the contiguous characters in the attribute name in the
Attribute name field.
For example, if searching for attribute names containing ho_margin in the
attribute name, entering mar would return many attribute names, but
entering ho_margin would return a more precise list of attribute names.
NOTE
The attribute name or search string cannot be less than three
characters.
5 Click either the OMC Naming or BSS Naming button to indicate the
naming convention of the attribute to be found.
6 Select the software version number associated with the attribute in the
Version field. The default is the latest software version.
NOTE
Some attributes can have a slightly different name in the OMC-R
database and the BSS database.
Continued
68P02900W22-S 4-25
Jul 2008
Overview of finding attributes Chapter 4: Operating the Offline MIB
CELL::ho_margin_def
neighbour::ho_margin_cell
neighbour::ho_margin_rxqual
neighbour::ho_margin_rxlev
neighbour::ho_margin_type5
neighbour::congest_ho_margin
To print the results shown in the Find Results pane, click the Print button.
To save the results shown in the Find Results pane to a file, perform the following procedure:
• Click the Save button. The File Selection window is displayed.
• Enter the name of the file and the directory to which the Find results are to be saved.
4-26 68P02900W22-S
Jul 2008
System Information: DataGen Using the Navigation Tree: Overview
Procedure list
Further information
Further information on using the Navigation Tree can be found in the 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 and Fault Mgt are not present in the menu bar.
68P02900W22-S 4-27
Jul 2008
Opening and closing a Navigation Tree Chapter 4: Operating the Offline MIB
To open a Navigation Tree, on the Offline MIB front panel (Figure 4-5), select the Config Mgmt
icon to display a Navigation Tree window as shown in Figure 4-13.
4-28 68P02900W22-S
Jul 2008
System Information: DataGen Warning window Invalid NE
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-14.
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-58 for details.
To close a Navigation Tree, select File à Close from the menu bar.
68P02900W22-S 4-29
Jul 2008
Moving levels on a Navigation Tree Chapter 4: Operating the Offline MIB
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-28.
NOTE
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 on page 4-32 for details on how to create BSSs or RXCDRs.
Assuming that the Navigation Tree is in the form shown in Figure 4-15, perform the following
procedure to move the levels.
1 To expand the Navigation Tree to the second level, click the folder icon next
to the Network object. The various class buttons are displayed.
2 To open the branch of a tree under a button, click the folder icon beside
the button.
3 To close the branch of a tree under a button, click again on the folder icon
beside the button.
4-30 68P02900W22-S
Jul 2008
System Information: DataGen Panner and porthole
When the Navigation Tree diagram becomes larger in size than the display area of the
Navigation Tree window (Figure 4-15), a panner and porthole arrangement is used to control
the display. The tree is displayed in the porthole region on the right-hand side of the window,
and the display is controlled by means of a panner on the left.
• Click and hold the left mouse button within the panner region.
• Move the mouse until the required area is in view within the porthole.
68P02900W22-S 4-31
Jul 2008
Creating a BSS/RXCDR from the Navigation Tree Chapter 4: Operating the Offline MIB
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, perform the following procedure.
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-16.
Continued
4-32 68P02900W22-S
Jul 2008
System Information: DataGen Procedure for creating a BSS or RXCDR
8 Repeat step 2 to step 6 to import the required number of BSS binary files
into the network configuration.
NOTE
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-35.
68P02900W22-S 4-33
Jul 2008
Audit: overview Chapter 4: Operating the Offline MIB
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
Current audits for the entire network can be set in progress from the Navigation Tree.
Refer to Running an audit from the Navigation Tree on page 4-35 for more information.
Audit puts a significant load on the OLM in terms of processing power and memory usage.
It takes a considerable amount of time and therefore it is better to schedule the audit.
Refer to Scheduling an audit on page 4-60 for more information.
NOTE
The preferred way of using audit is on a per NE basis. Network-wide 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 and Configuration: GSM
System Configuration (68P02901W17).
4-34 68P02900W22-S
Jul 2008
System Information: DataGen Running an audit from the Navigation Tree
An audit can be performed from the Navigation Tree. After the audit is complete, perform the
function, Apply to OMC.
To carry out an audit from the Navigation Tree, perform the following procedure.
1 From the Navigation Tree (refer to Figure 4-13), click the network node
for the whole network, then select either the individual BSS or multiple
BSSs to be audited.
NOTE
It is valid to select either the BSS, RXCDR, SITE, PCU, or the
entire network to be audited.
2 Select Config Mgt à Audit from the menu bar. The message Audit
operation successfully dispatched is displayed in the status bar at the
bottom of the Navigation Tree window.
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
having been finished.
5 Select the Audited Item (highlighted in inverse text).
Continued
68P02900W22-S 4-35
Jul 2008
Audit from the Navigation Tree Chapter 4: Operating the Offline MIB
4-36 68P02900W22-S
Jul 2008
System Information: DataGen Modifying the network configuration from the Navigation Tree
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 and Configuration:
GSM System Configuration (68P02901W17).
Creating or editing circuits, channels, statistics (enabling or disabling or threshold), and time
slot reservations are not supported from the Navigation Tree.
When required, use the Offline MIB pull-down menu to verify and save the new configuration.
NOTE
From the Navigation Tree, saving a detailed view of a device does 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-43 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
neighbor commands of the surrounding cells automatically.
The procedures for carrying out these tasks are documented in Installation and Configuration:
GSM System Configuration (68P02901W17).
When required, use the Offline MIB pull-down menu to verify and save the new configuration.
NOTE
From the Navigation Tree, saving a detailed view of a device does 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-43 for details.
68P02900W22-S 4-37
Jul 2008
CellXchange: overview Chapter 4: Operating the Offline MIB
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 and Configuration:
GSM System Configuration (68P02901W17) for more information on performing CellXchange
from the OLM.
On the Cell X Import Watcher window, Motorola recommends the following for the BSS
deployment setting:
• On the OLM, select Sequential mode.
Each BSS binary on the OLM has its own process running, so running several processes in
parallel on the OLM results in a lot of commands being sent out at the same time. Since
all of these commands run on the same machine, applying all the BSS changes results in
heavy loading on the OLM machine.
On the live OMC-R, the commands are sent out to individual BSS. Therefore, the loading on
the OMC-R is lesser since each BSS is running its own process.
4-38 68P02900W22-S
Jul 2008
System Information: DataGen Overwrite a BSS/RXCDR binary object file
It is possible to copy BSS binary object file and overwrite the existing BSS binary object file in
the OLM.
NOTE
This feature overwrites the existing NEs and any changes made through the OLM
are lost.
Continued
68P02900W22-S 4-39
Jul 2008
Procedure for overwriting a BSS Binary object file Chapter 4: Operating the Offline MIB
• Select the same BSS or RXCDR area from the Area list.
Continued
4-40 68P02900W22-S
Jul 2008
System Information: DataGen Procedure for overwriting a BSS Binary object file
68P02900W22-S 4-41
Jul 2008
Verify and save overview Chapter 4: Operating the Offline MIB
The Navigation Tree is used to modify the network, and the information is saved in the OLM.
To apply the changes to the BSS databases (binary files) on disk, the following actions must
be performed:
• Verify - Ensures that all the parameters are correct in accordance with 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 - Saves the BSS database file to disk and should be carried out regularly. Exiting the
OLM without saving, results in the loss of the changes effected. This option is available
under the Offline MIB pull-down menu.
NOTE
Do not deploy a saved BSS database without first carrying out a verify procedure.
The Verify and the Save actions for the entire network can be performed in a single step 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 verify and save operations can be applied.
NOTE
By default, all NEs are selected. It is possible to deselect NEs from the list before
performing the Verify or Save action.
4-42 68P02900W22-S
Jul 2008
System Information: DataGen Verify and save NE database
NOTE
Continued
68P02900W22-S 4-43
Jul 2008
Verify a network element Chapter 4: Operating the Offline MIB
5 Click Close to continue. To resolve any errors found (for example, to add
NE devices and parameters), refer to Modifying the network configuration
from the Navigation Tree on page 4-37 for details.
6 Repeat step 3 to step 4. A message is displayed in the status bar at the
bottom of the Navigation Tree window when no errors are present:
Operation successful.
NOTE
Do not deploy a saved NE database without first carrying out a
verify procedure.
4-44 68P02900W22-S
Jul 2008
System Information: DataGen Save a network element
To save a NE, first refer to Procedure 4-15 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. The following message is displayed in the status bar at the bottom of the Navigation
Tree window:
Operation successful.
NOTE
Carry out this procedure at regular intervals.
68P02900W22-S 4-45
Jul 2008
Verify and save network Chapter 4: Operating the Offline MIB
Verify network
NOTE
Continued
4-46 68P02900W22-S
Jul 2008
System Information: DataGen Verify network
NOTE
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.
Continued
68P02900W22-S 4-47
Jul 2008
Verify network Chapter 4: Operating the Offline MIB
6 If the status Operation successful is displayed for all NEs, click Close in
this window and in all the subsequent windows to return to the Navigation
Tree window. If the operation fails, select the Network Element. The
selected NE is then highlighted.
7 Click Show Errors/Warnings. This displays the Binary Database error
and warnings window, detailing the location, and errors found as in
Figure 4-24.
Continued
4-48 68P02900W22-S
Jul 2008
System Information: DataGen Verify network
68P02900W22-S 4-49
Jul 2008
Aborting a verify network in progress Chapter 4: Operating the Offline MIB
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-37.
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.
1 Refer to the Verify network procedure (Procedure 4-16) and follow step 1
to step 5. The Offline MIB Verify Operation Monitor window is then
displayed (refer to Figure 4-23).
2 Click the Abort button. A Confirmation window is displayed.
3 Click OK to confirm the action and close the window. The Offline MIB
Verify Operation Monitor window is updated. The details in the
Operation Status field change to Operation aborted for NEs that are not
already verified.
4 Click Close in this window and in all subsequent windows to return to the
Navigation Tree window.
4-50 68P02900W22-S
Jul 2008
System Information: DataGen Saving a network
Saving a network
3 Click Close in this window and in all subsequent windows to return to the
Navigation Tree window.
NOTE
Do not deploy a saved network without first carrying out a verify
procedure.
68P02900W22-S 4-51
Jul 2008
Aborting a save network in progress Chapter 4: Operating the Offline MIB
As soon as a save NE database commences, the details are displayed in the Offline MIB Save
Operation Monitor window.
NOTE
For NEs that are 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.
4-52 68P02900W22-S
Jul 2008
System Information: DataGen Deleting a network configuration in the OLM
It is recommended that the network configuration is archived and deleted, once the binary files
are transferred to the OMC. For details, refer to Exporting object files to the OMC Chapter 3
Operating DataGen.
1 From the DataGen main menu, select the OLM option. The Offline MIB
(OLM) Network Configurations window is displayed as shown in Figure 4-1.
2 Select the Network Configuration Name to be deleted. The selection is
highlighted.
NOTE
A network configuration can be deleted only by the owner or the
system administrator.
3 Click Delete. A Confirmation window is displayed as shown in Figure 4-26.
Continued
68P02900W22-S 4-53
Jul 2008
Delete network configuration Chapter 4: Operating the Offline MIB
4-54 68P02900W22-S
Jul 2008
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:
• Creating a BTS SITE by copying and pasting an existing BTS into a BSS configuration.
• Deleting a BTS with its associated hardware devices and software functions in a single
operation.
• Reviewing the transaction logs and maintaining 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 and Configuration:
GSM System Configuration (68P02901W17) for more information on performing Network
Expansion from the OLM.
68P02900W22-S 4-55
Jul 2008
Additional OLM features Chapter 4: Operating the Offline MIB
Additional tasks that are carried out from the Offline MIB are:
• Using the autoclose function on page 4-57.
The Navigation Tree supports an autoclose feature. This feature controls the expanding
and closing of branches on the Navigation Tree.
To carry out an audit takes a considerable amount of time and where possible it is better to
schedule an audit.
Audit logs provide a method of monitoring audits and also provide an audit history.
Audit log management can be used to automatically delete logs after a predefined period.
BSS binary files can be copied to the appropriate directory in the OLM. The realign
function ensures that there is the same number of NEs in the Navigation Tree as there are
BSS binary files in the network directory.
It is possible from the Network configuration window under the Admin options to
compress or uncompress an offline MIB network.
4-56 68P02900W22-S
Jul 2008
System Information: DataGen Using the autoclose function
The Navigation Tree supports an autoclose feature. When this feature is turned on, 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 is 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-28 for details.
To use the autoclose function, select View à Auto Close On/Off from the menu bar to toggle
the function. The default setting is Off.
NOTE
The autoclose function is a menu option. When selected, the alternate state is shown
in the menu window, that is, with Autoclose On selected. Autoclose Off is displayed
in the View menu.
68P02900W22-S 4-57
Jul 2008
Deleting a BSS or RXCDR from the Navigation Tree Chapter 4: Operating the Offline MIB
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.
1 Select the specified BSS or RXCDR element from the Navigation Tree.
2 Select Edit à Delete from the menu bar on the Navigation Tree window (refer
to Figure 4-13). A Confirmation window as shown in Figure 4-27 is displayed.
Continued
4-58 68P02900W22-S
Jul 2008
System Information: DataGen Deleting BSS or RXCDR network elements
NOTE
68P02900W22-S 4-59
Jul 2008
Scheduling an audit Chapter 4: Operating the Offline MIB
Scheduling an audit
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
List of procedures
The procedures that can be performed using the Audit Scheduler Admin Option are:
• Scheduling an audit
1 Select the Admin icon from the Front Panel to display the Admin Options
window (Figure 4-28).
Continued
4-60 68P02900W22-S
Jul 2008
System Information: DataGen Creating a scheduled audit
Continued
68P02900W22-S 4-61
Jul 2008
Creating a scheduled audit Chapter 4: Operating the Offline MIB
Continued
4-62 68P02900W22-S
Jul 2008
System Information: DataGen Creating a scheduled audit
Continued
68P02900W22-S 4-63
Jul 2008
Creating a scheduled audit Chapter 4: Operating the Offline MIB
NOTE
It is valid to select either BSS, RXCDR, SITE, PCU, or the entire
network to be audited.
7 Select Config Mgt à Audit. The Navigation Tree window closes and the
selected element is displayed in the Scheduled Element Name field.
Enter schedule information in the Detailed View window as described in the procedure.
1 Only the Start Time field needs to be specified for one shot auditing. Click
the parameter that requires changing. The selected parameter is highlighted
in black. The parameters are ordered as follows: Month/Day/Year
Hour:Minute:Second
NOTE
Ensure that the Execute Mode is Oneshot.
Use the up/down arrow symbols to the right of the Start Time field to
change the parameter to the required value.
2 Verify that the Update Mode field is Apply to OMC.
If not, click the Execute Mode button. Hold the left mouse button down, and
scroll to Apply to OMC. Once this is highlighted, release the mouse button.
The selected option is then displayed in the Detailed View.
Continued
4-64 68P02900W22-S
Jul 2008
System Information: DataGen Modifying a scheduled audit
NOTE
When the selected audit type is Full Audit, the Per Site Audit
Logging field is unavailable.
4 Verify that the Neighbor Propagation after Audit field is No unless
neighbor propagation after audit is required.
5 Once all the above information is entered into the Detailed View, select File à
Create from the menu bar. The new Scheduled Audit is created and can be
viewed in the Audit Scheduler window.
6 Close the Detailed View window by selecting File à Close from the menu
bar.
7 Close the Audit Scheduler window by selecting File à Close from the
menu bar.
All the limitations that apply to auditing also apply when modifying a scheduled audit. For more
information, refer to Procedure 4-24 Creating a scheduled audit.
Continued
68P02900W22-S 4-65
Jul 2008
Deleting a scheduled audit Chapter 4: Operating the Offline MIB
NOTE
It is not possible to revert to a previous version after an edited
version has been saved.
5 When all the required fields are 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.
Expired Scheduled Audits must be deleted from time to time to avoid using excess memory.
4-66 68P02900W22-S
Jul 2008
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.
1 Select the Admin icon on the Front Panel to display the Admin Options
window (Figure 4-28).
NOTE
It is also possible to view the audit logs from the Navigation Tree
by selecting Config Mgt à Audit Logs from the menu bar.
Continued
68P02900W22-S 4-67
Jul 2008
Aborting an audit in progress 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-60), the progress
details are displayed in the Audit log list.
1 Refer to the Viewing an audit log procedure (Procedure 4-28) and follow
step 1 and step 2 to open the Audit Logs window.
2 From the Audit Log list, select the audit to be aborted.
NOTE
The Status of an audit in progress is displayed as Active in the
Audit Log list.
Continued
4-68 68P02900W22-S
Jul 2008
System Information: DataGen Inconsistency reports
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.
To view an Audit Inconsistency report for a particular Scheduled Audit, perform the following
procedure.
1 Refer to the Viewing an audit log procedure (Procedure 4-28) and follow
step 1 and step 2. The Audit Logs window is displayed as in Figure 4-31.
Continued
68P02900W22-S 4-69
Jul 2008
Viewing an audit inconsistency report Chapter 4: Operating the Offline MIB
NOTE
An Audit Inconsistency report is valid only for an audit with a
Status of either Finished or Applied.
3 Select File à Open from the menu bar. An Audit Inconsistency List
window is then displayed (refer to Figure 4-18), detailing all elements where
inconsistencies were found during the audit. Information is displayed for
each reported inconsistency or error as in Table 4-2.
4 Select File à Close from the menu bar to close the Audit Inconsistency
report.
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 NE
• Attribute Differs
• Error Report
Apply Status The status of an attempted update to the system to remove an
inconsistency, or error indicates the error detected by the audit.
If an inconsistency is reported and an Apply to OMC or Apply
to NE operation is performed, this column indicates the result
of the operation. This can be Success or Failure. If an apply
operation is not attempted, this field is blank.
If an error is reported, this column describes the error.
Warning for NE The type of warning given when inconsistencies applied to a
Apply network element fail.
Attribute Name The name of the attribute that is inconsistent, if applicable.
Continued
4-70 68P02900W22-S
Jul 2008
System Information: DataGen Deleting an audit log
1 Refer to the Viewing an audit log procedure (Procedure 4-28) and follow
step 1 and step 2. The Audit Logs window opens on the screen as in
Figure 4-31.
2 Select the Audit Log to be deleted. The selection is highlighted.
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-S 4-71
Jul 2008
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 can also be deleted manually. Refer to the procedure Deleting an audit log for
more information.
The operator is required to set the number of days for retaining the audit log files, after
which the OMC automatically deletes the files. If set to zero all the audit logs, except the
current one, are deleted.
1 Select the Admin icon on the Front Panel to open the Admin Options
window as in Figure 4-28.
2 Select the Audit Log Management option, then click OK.
The Audit Log Management window is displayed. Refer to Figure 4-33.
Continued
4-72 68P02900W22-S
Jul 2008
System Information: DataGen Setting the delete period
Save completed
NOTE
To quit without saving, select File à Close. A Message window
displays the following:
68P02900W22-S 4-73
Jul 2008
Reload NE database Chapter 4: Operating the Offline MIB
Reload NE database
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
If changes are 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 can be carried out.
NOTE
If multiple NEs are changed, for example if an RF import, Cell or neighbor
propagation is carried out, then all the affected NEs must be included in the roll back.
1 Refer to the procedure Verify and save NE database on page 4-43 and repeat
step 1 to step 4. The NE is selected.
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.
Continued
4-74 68P02900W22-S
Jul 2008
System Information: DataGen Procedure for reloading an NE database
68P02900W22-S 4-75
Jul 2008
Realign a network Chapter 4: Operating the Offline MIB
Realign a network
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Introduction
The realign function is a shortest method of putting BSSs and RXCDRs into a network
configuration. This is done from the Navigation Tree. Refer to Creating a BSS/RXCDR from the
Navigation Tree on page 4-32 for details. However, it is possible to copy NE binary files from a
tar tape or through 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.
NOTE
It is not possible to continue working on the network when a realign is in progress.
Continued
4-76 68P02900W22-S
Jul 2008
System Information: DataGen Procedure for realigning a network
NOTE
The network configuration name is that created in step 1 above.
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.
68P02900W22-S 4-77
Jul 2008
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 can be used when disk space is an issue.
NOTE
It is better to archive and delete old network configurations when the binary files are
transferred to the OMC.
1 Open the OLM Network Configurations window (Figure 4-1) from the
DataGen main menu. Refer to Starting/creating a network configuration
in the OLM on page 4-6 for details.
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.
Continued
4-78 68P02900W22-S
Jul 2008
System Information: DataGen Uncompress a network procedure
To uncompress a network without restarting the OLM from the DataGen front panel, perform
the following procedure.
68P02900W22-S 4-79
Jul 2008
Troubleshooting the OLM Chapter 4: Operating the Offline MIB
If the OLM does not function, refer to the information in Table 4-4 to Table 4-8 which details
errors that can occur and how to resolve them.
If the OLM fails to start, Table 4-4 shows the possible error messages that are displayed and
the appropriate action to be taken.
Continued
4-80 68P02900W22-S
Jul 2008
System Information: DataGen Database errors
Database errors
Table 4-5 shows the error messages that are displayed and the appropriate actions to be taken.
Error/Warning Action
Invalid NE To correct the error, carry out the following actions:
failed to open database
<Network name> sql error • Reinitialize the database. Refer to the procedure
<Number> Reinitialize database procedure on page 4-85.
Network name is <Name> it • Audit the network. Refer to the procedure Running
should be <Network Name> an audit from the Navigation Tree on page 4-35.
There is more than one
Network in this database
Rose message received from
an NE when only start up
messages expected
Continued
68P02900W22-S 4-81
Jul 2008
General errors Chapter 4: Operating the Offline MIB
General errors
Table 4-6 shows the error messages that are displayed and the appropriate actions to be taken.
Error/Warning Action
The number of Users in To correct the errors, carry out the following actions:
the Network Configurations
list is set to non-zero • Reset the number of users to zero. Refer to the
even though there procedure Force shutdown OLM in this section.
is no OLM GUI open.
The GUI hangs • Audit the network. Refer to the procedure Running
an audit from the Navigation Tree on page 4-35.
SMASE channel has been To correct the errors, carry out the following actions:
deleted.
OlmOmcInit channel has been • Force shutdown the OLM. Refer to Procedure 4-38
deleted Force a shutdown of the OLM on page 4-84 in this
section.
Unable to read from IPC
channels • Open the network. Refer to the procedure
Starting/exiting the OLM GUI on page 4-9.
4-82 68P02900W22-S
Jul 2008
System Information: DataGen Specific operation fails
If a specific task fails, Table 4-7 shows the error messages that are displayed and the appropriate
actions to be taken.
Error/Warning Action
Fatal Off-Line MIB Operation To correct the error carry out the following actions:
Error
• View the audit log. Refer to the procedure Auditing
logs on page 4-67.
Import errors
Table 4-8 shows the possible error that can occur and the appropriate actions to be taken
while importing the NE binary files.
Error/Warning Action
Transaction timeout To correct the errors, carry out the following actions:
Link OOS
• Revert to the previously saved version of
Ported BSS S/W for <BSS Name> the NE database. Refer to the procedure
has not started Reload NE database on page 4-74.
msgsnd call failed for NE <BSS
Name>. or
Force shutdown OLM function should be carried out only when the OLM is not functioning
correctly. This function shuts down the Offline MIB and resets the number of users to zero for
the network configuration.
68P02900W22-S 4-83
Jul 2008
Force shutdown OLM procedure Chapter 4: Operating the Offline MIB
NOTE
Any changes that are done 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.
To shut down the OLM and reset the number of users to zero for the network configuration,
perform 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.
3 Select Admin à Force shutdown from the menu bar. A Confirmation
window is then displayed as in Figure 4-37.
NOTE
On opening the network, carry out an audit. Refer to Running an audit
from the Navigation Tree on page 4-35 for details.
4-84 68P02900W22-S
Jul 2008
System Information: DataGen Reinitialize database procedure
The reinitialize 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.
NOTE
Only the person who created the network configuration, or the system administrator
can carry out this task.
1 Refer to Force shutdown OLM and perform step 1 and step 2. The OLM
Network Configurations window opens and the network is selected.
2 Select Admin à Reinitialize Database from the menu bar. A Confirmation
window is displayed as in Figure 4-38.
NOTE
On opening the network, it is seen that all the information that was
audited is 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-35 for details.
68P02900W22-S 4-85
Jul 2008
Reinitialize database procedure Chapter 4: Operating the Offline MIB
4-86 68P02900W22-S
Jul 2008
Chapter
68P02900W22-S 5-1
Jul 2008
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), which can be accessed either from the GUI or the
command line.
Table 5-1 shows the user tools available for command line operation.
Continued
5-2 68P02900W22-S
Jul 2008
System Information: DataGen General information
General information
Most command line tools require that DGAdmin be run before they can be invoked, using the
following command:
DGAdmin
This command sets the user environment for DataGen. DGAdmin sets system variables in the
current environment to allow DataGen tools to function correctly. It 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.
Before 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:
• Open an Xterm window and, if using the C shell interpreter, execute the following
commands:
68P02900W22-S 5-3
Jul 2008
Copy Area (ca) command Chapter 5: Command line tools
Name
ca - Copies 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.
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 Define a new configuration.
number>
-title <new configuration title The comment entered when creating the BSS area.
string>
5-4 68P02900W22-S
Jul 2008
System Information: DataGen Requirements
Requirements
Run DGAdmin before executing the copy command. Any parameters that contain spaces must
be entered between single quotes.
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
NOTE
This example does not have a title string. By default, a comment is created for the
target area:
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:
NOTE
The next free configuration number in Area 11 is used and, if Area 11 does not exist,
it is created.
68P02900W22-S 5-5
Jul 2008
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
NOTE
Each time a combined script is generated the original script is backed up with a Date
and Time stamp. For example, COMBINED.BACKUP072498123425.
Requirements
5-6 68P02900W22-S
Jul 2008
System Information: DataGen Compile MMI script (compile) command
Name
Synopsis
Where Is
country name of the country where the options object is located.
Version software version to compile with (1.7.6.0 or 1.8.0.0 or 1.9.0.0).
filename name of script file to compile.
Description
This utility allows an 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 can be used to determine
the error.
Requirements
68P02900W22-S 5-7
Jul 2008
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 for compilation.
<filename or *> Define a directory where the scripts reside or a single MMI script.
Requirements
Any parameters that contain spaces must be entered between single quotes.
5-8 68P02900W22-S
Jul 2008
System Information: DataGen Output
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 auto_compile utility works from the command line. The following command line can be
customized to perform the required batch compile:
This compiles all existing MMI scripts in the specified directory using the corresponding 1900
compiler. On successful completion, the report files and binaries reside in the chosen batch
directory.
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.9.0.0 -c 0 /usr/omc/test/1900x/objects/*
NOTE
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
crontab -l
68P02900W22-S 5-9
Jul 2008
Compress/uncompress binary object files Chapter 5: Command line tools
Name
Synopsis
Compress
Where Is
database object filename name of the .002 file to compress
compressed object filename the name of the compressed file
Uncompress
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 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 and uncompressed binary object files.
5-10 68P02900W22-S
Jul 2008
System Information: DataGen Example
Example
The following are two examples of using the compress and uncompress commands:
Requirements
68P02900W22-S 5-11
Jul 2008
Delete database object (del) command Chapter 5: Command line tools
Name
Synopsis
Description
NOTE
After the last Configuration area has been deleted, the BSS Area is also deleted.
Option Description
<verification>
• Off (0) performs action.
The deletion must be specified to the <verification> <country> <BSS area> <configuration
number> level.
5-12 68P02900W22-S
Jul 2008
System Information: DataGen Example
Example
where configuration number 0 is deleted from the Country (Austria) and BSS area (Area 10).
Requirements
NOTE
If the BSS area is deleted, the related files in the DDS are also deleted.
68P02900W22-S 5-13
Jul 2008
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 is also used to validate files.
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 either inserted, 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.
5-14 68P02900W22-S
Jul 2008
System Information: DataGen Command line options
FileName Table
bss BSS
bts Site
cab Cabinet
hw Hardware
gene Generics
time Timer
modv Modify Value
acct Circuits
chan Channels (The Channels table is
available in MCDF for RXCDR scripts
only).
link Links
path Paths
lapd Lapd
cell Cell
stat Statistics
spec Specific
rtf RTF
dri DRI
alg Algorithm
ngbr Neighbors
thro Throttles
eas EAS
dgtr Daughters
pix PIX
ksw KSW
nsvc Nsvc
hop Hop
acs ACS
testngbr Test Neighbor
nailconn Nail Connection
68P02900W22-S 5-15
Jul 2008
Example Chapter 5: Command line tools
Example
The following example demonstrates how to use the MCDF filter command:
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
The MCDF file structure is interdependent. Therefore, in certain cases, a file can only be
validated if all its dependent files have been validated. For further details, refer to the MCDF
BSS and RXCDR tables in Chapter 6 MCDF tables.
5-16 68P02900W22-S
Jul 2008
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
This example produces an MMI script for Austria BSS Area10, configuration number 0.
• gcmd Austria:Area10:0:1
This example produces an MMI script for site 1 only in Austria BSS Area10, configuration
number 0.
68P02900W22-S 5-17
Jul 2008
Requirements Chapter 5: Command line tools
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-18 68P02900W22-S
Jul 2008
System Information: DataGen Optimize DataGen database (dbaccess) command
Name
Synopsis
Description
In order to maximize free disk space, it is advisable to optimize the DataGen database. This
can be performed by running the script named clusters.sql.
NOTE
The DataGen GUI must be closed before running the command:
Example
Requirements
Run DGAdmin before executing the dbaccess command. Before starting the optimization,
execute the following command:
/usr/gsm/DataGen/bin/DGAdmin
68P02900W22-S 5-19
Jul 2008
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.
Option Description
<country name> The country name of the configuration
<BSS area The BSS name of the configuration
name>
<config_no> The configuration number
–who Query about lock status
–lock Lock a configuration
–unlock Unlock a configuration
5-20 68P02900W22-S
Jul 2008
System Information: DataGen Example
Example
NOTE
This command should not be used when another user is genuinely accessing an area.
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 shown
in the following example:
68P02900W22-S 5-21
Jul 2008
Revgen command Chapter 5: Command line tools
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]
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.
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.
Continued
5-22 68P02900W22-S
Jul 2008
System Information: DataGen Command line options
68P02900W22-S 5-23
Jul 2008
Example Chapter 5: Command line tools
Example
This example creates a configuration number 0 for the CM Database Area10.002. The
configuration number (-c) is optional. If no configuration number is defined, the next available
number is used.
NOTE
If the DDS directory does not exist for the configuration, the command fails.
Therefore, before running the revgen command, type:
mkdir -p /home/<user_name>/dg/<country>/<BSS_area_name>/
<configuration_number>/002
Requirements
The DataGen database must be loaded with the GSM software versions, and any intermediate
software version requested by the upgrader to perform the Revgen.
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.
5-24 68P02900W22-S
Jul 2008
System Information: DataGen Auto-Revgen command
Auto-Revgen command
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Name
Synopsis
Description
This utility allows a number of binaries of one software version to be revgened sequentially,
creating the 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.
Option Description
-m Specifies that MCDF tables, should be exported after Revgen is
complete (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 (optional).
-v <Version> The software version to revgen the binaries.
<filename or *> Defines a directory where the binary or binaries reside.
68P02900W22-S 5-25
Jul 2008
Requirements Chapter 5: Command line tools
Requirements
Any parameters that contain spaces must be entered between single quotes.
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
Example
The auto_revgen utility works from the command line. The following command line can be
customized to perform the required batch Revgen:
This revgens all existing binaries in the specified directory to the corresponding 1900 areas
in the database. If the BSS areas already exist in the database, then the next available
configuration, for each new area is used.
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.
5-26 68P02900W22-S
Jul 2008
System Information: DataGen Toggle permissions (tp) command
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 the specified user.
Example
tp -u smithd
This example switches between access permitted and access denied or vice versa for user
smithd.
Requirements
68P02900W22-S 5-27
Jul 2008
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.
-t <target Config > Target configuration number for upgrading.
Requirements
The DataGen database must be loaded with the GSM software versions and any intermediate
software version requested by the upgrader.
5-28 68P02900W22-S
Jul 2008
System Information: DataGen Output
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 0 to version 1.9.0.0
Number
Configuration 5
Number
NOTE
If the specified target configuration exists, the upgrade is aborted.
68P02900W22-S 5-29
Jul 2008
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. All the binary files
must be 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.
Option Description
–m Specifies that MCDF tables, should be exported after
Revgen is complete (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 <start configuration> The configuration number to revgen the first binary
(optional).
Continued
5-30 68P02900W22-S
Jul 2008
System Information: DataGen Requirements
Requirements
Any parameters that contain spaces must be entered between single quotes.
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 is 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
Example
The auto_upgrade utility works from the command line. The following command line can be
customized to perform the required batch upgrade:
This revgens all existing binaries in the specified directory to corresponding 1800 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 1800 area is then upgraded to 1900.
This command revgens all existing binaries as before. After each Revgen process, each area
is upgraded to 1900 and all MCDF tables are exported for the upgraded area. The upgraded
areas are then copied to the next available configurations and the MCDF tables for the copied
areas are exported. The process attempts to revgen and assign configuration number 25. If the
number is already in use, the next available number greater than 25 is selected.
68P02900W22-S 5-31
Jul 2008
Country administration Chapter 5: Command line tools
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 enables 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.
5-32 68P02900W22-S
Jul 2008
System Information: DataGen Invoking xcadm
Invoking xcadm
1 Start DataGen.
2 Open an Xterm window and execute the following commands:
DGAdmin
xcadm
Click OK to continue.
The xcadm GUI (Figure 5-2) is organized into three functional areas:
• Menu bar
• Data fields
• Action buttons
68P02900W22-S 5-33
Jul 2008
Menus Chapter 5: Command line tools
Menus
The menu bar enables the DataGen user to Create, Update and Edit Country, and Network
Administration files as follows.
File menu
The Exit option is the only option available, which is used to exit from the Country
Administration window.
Network menu
• Generate
• Update
Select to update the DataGen database with the default Network Administration file.
NOTE
Country and Network menu options are grayed out, depending on the operations
permitted at the corresponding time.
5-34 68P02900W22-S
Jul 2008
System Information: DataGen Data fields
Country menu
• Generate
• Update
Select to update the DataGen database with the default Country Administration file.
NOTE
For NEW users where no country.std file exists, select Generate from
the Country menu to automatically generate a country.std file in the
/home/omcadmin/dg/ADMIN directory. This also applies to the network.std
file.
Data fields
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.
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.
68P02900W22-S 5-35
Jul 2008
CADM utilities Chapter 5: Command line tools
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.
<country_name>@<MCC><new_line_character>
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.
5-36 68P02900W22-S
Jul 2008
Chapter
MCDF tables
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-S 6-1
Jul 2008
Overview of MCDF tables Chapter 6: MCDF tables
This specification gives in detail, the format of each of the files within the MCDF file set. 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.
NOTE
Refer to the appropriate DataGen manual Software Release Notes: DataGen
(68P02900W76) for Customer Committed Problem Resolutions to the software
release installed.
Due to MCDF supporting BSS versions 1.7.6.0, 1.8.0.0 and 1.9.0.0, it is important that
users adhere to all the ranges defined in the subsequent tables. Remember that ranges and
recommended values may change from one load to the next. Refer to the manual Technical
Description: BSS Command Reference (68P02901W23) for detailed information about the
parameters in the MCDF tables.
If accessing DataGen using Exceed and viewing the MCDF tables on a flat screen monitor, users
should maximize Exceed to avoid possible DataGen GUI truncation.
The following diagrams show which tables are mandatory and which are optional (refer to
Figure 6-1 and Figure 6-2).
6-2 68P02900W22-S
Jul 2008
System Information: DataGen MCDF BSS and RXCDR tables
68P02900W22-S 6-3
Jul 2008
MCDF BSS and RXCDR tables Chapter 6: MCDF tables
BSS Table
EAS Table
KSW Table
Cabinet Table
Hardware Table
PIX Table
Generics Table Circuits Table Channel Table Stats Table Throttles Table
Key
MCDF Table
Optional Table
File dependency ,
predecessor must exist
File dependency
if predecessor exists.
6-4 68P02900W22-S
Jul 2008
System Information: DataGen BSS table
BSS table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table is at 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 lists the fields as follows: Field name, Field width, range, and status.
Continued
68P02900W22-S 6-5
Jul 2008
Description of BSS table Chapter 6: MCDF tables
0 RXCDR
1 BSC/
Collocated
Site Type 50 0, 1 or 3 Mandatory
Used for element fm_site_type:
0 Collocated
BSC/BTS
1 BSC
2 BTS
3 Remote
transcoder
BSC Type 50 0 to 3 Mandatory
Used for element bsc_type:
0 Non-Abis,
only DHP
1 Non-Abis,
only BSP
and LCF
2 Non-Abis,
BSP, LCF
and OMF
3 Abis, only
BSP
Network Indicator 50 0 to 3 Mandatory for
a Non-remote
transcoder area.
Used for element ni. Used for non-remote transcoder areas only.
Continued
6-6 68P02900W22-S
Jul 2008
System Information: DataGen Description of BSS table
Continued
68P02900W22-S 6-7
Jul 2008
Description of BSS table Chapter 6: MCDF tables
The field is used to define the valid frequency blocks for PCS1900. Valid blocks are detailed in
Table 6-2.
NOTE
For a subset of blocks, a space character is required.
Frequency
Block Channels
Parameter
ALL 512-810
A 512-585
D 587-610
B 612-685
E 687-710
F 712-735
C 737-810
All entries into this field must be separated with a space, for example, the blocks allowed are A,
B, D only, so the user must type:
A B D
Information must be entered this way when a subset of frequency blocks is required.
6-8 68P02900W22-S
Jul 2008
System Information: DataGen Site (BTS-specific) table
This table contains information regarding each site in the BSS area (refer to Table 6-3).
0 only BTP
1 only BTP and DHP2
Continued
68P02900W22-S 6-9
Jul 2008
Description of Site (BTS-specific) table Chapter 6: MCDF tables
Used to indicate whether the site uses dynamic allocation of terrestrial backing resources.
6-10 68P02900W22-S
Jul 2008
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-4. The default cabinet type is 0 (BTS4).
Continued
68P02900W22-S 6-11
Jul 2008
Description of Cabinet table Chapter 6: MCDF tables
NOTE
6-12 68P02900W22-S
Jul 2008
System Information: DataGen Description of Cabinet table
Numeric
Frequency Type
Entry
PGSM 1
EGSM 2
PGSM EGSM 3
DCS1800 4
PGSM DCS1800 5
EGSM DCS1800 6
PGSM EGSM DCS1800 7
PCS1900 8
PGSM PCS1900 9
EGSM PCS1900 10
PGSM EGSM PCS1900 11
DCS1800 PCS1900 12
PGSM, DCS1800 PCS1900 13
EGSM, DCS1800 PCS1900 14
PGSM, EGSM, DCS1800 PCS1900 15
If Then
Both Infrastructure Sharing Homogeneous Each cabinet (within any given site)
Cabinet and Infrastructure Sharing supports multiple frequency types.
Heterogeneous Cabinet options have been Valid Range: 1 to 15.
purchased.
Both Infrastructure Sharing Homogeneous Only the first cabinet for any given
Cabinet and Infrastructure Sharing site need have this field set. Multiple
Heterogeneous Cabinet options have not frequency types within a single cabinet,
been purchased. or multiple frequencies within a number
of cabinets in a given site is not allowed.
Valid Range: 1, 2, 4 or 8.
Infrastructure Sharing Homogeneous Each cabinet for any given site
Cabinet has been purchased and can be configured to support
Infrastructure Sharing Heterogeneous a different frequency type.
Cabinet options has not been purchased. Valid Range: 1, 2, 4 or 8.
{28938} DataGen supports Incell BTS (Site) as an optional feature. DataGen allows the
equipage of an Incell BTS cabinet including cabinet type of 0 to 9, only if Incell Support feature
is unrestricted.
68P02900W22-S 6-13
Jul 2008
Hardware table Chapter 6: MCDF tables
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-7).
NOTE
The cabinets and cages are not explicitly noted in the table, more included within
the details of the cards.
Continued
6-14 68P02900W22-S
Jul 2008
System Information: DataGen Description of Hardware table
Continued
68P02900W22-S 6-15
Jul 2008
Description of Hardware table Chapter 6: MCDF tables
NOTE
Continued
6-16 68P02900W22-S
Jul 2008
System Information: DataGen Description of Hardware table
Continued
68P02900W22-S 6-17
Jul 2008
Description of Hardware table Chapter 6: MCDF tables
Continued
6-18 68P02900W22-S
Jul 2008
System Information: DataGen Description of Hardware table
NOTE
• Equipage of more than one PCU is not allowed. While upgrading from 1800
to 1900, if there are more than one PCU equipped, Upgrader retains only
pcu_0 and removes the others.
• Manual equipage of Cabinet and Cage devices is not allowed under PCU. They
are automatically equipped when PCU is equipped.
• While upgrading to 1900, upgrader sets the value of gds_connectivity to 0.
Used as follows for BSS area specific devices:
DEVICE FUNCTION RANGE USAGE
AXCDR yes/no Used to specify use of CIC
validation.
Second Function ID 3 0 to 1 Optional
(Allow for
expansion)
NOTE
In the case of AXCDR, the Second Function ID represents eac_mode.
The second ID of this function is valid for GPROC and PCU entries, BSS, or RXCDR area
entries. Used as follows:
Continued
68P02900W22-S 6-19
Jul 2008
Description of Hardware table Chapter 6: MCDF tables
Continued
6-20 68P02900W22-S
Jul 2008
System Information: DataGen Description of Hardware table
prp_fanout_mode 1 2 1
Continued
68P02900W22-S 6-21
Jul 2008
Description of Hardware table Chapter 6: MCDF tables
Continued
6-22 68P02900W22-S
Jul 2008
System Information: DataGen Description of Hardware table
Continued
68P02900W22-S 6-23
Jul 2008
Description of Hardware table Chapter 6: MCDF tables
6-24 68P02900W22-S
Jul 2008
System Information: DataGen Generics table
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
can be overridden for a site or cell by values in the Specifics and Cell tables.
68P02900W22-S 6-25
Jul 2008
Layout of elements in the MCDF Generics table Chapter 6: MCDF tables
The elements in the Generics table are displayed in Table 6-9 as follows:
Continued
6-26 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Generics table
Continued
68P02900W22-S 6-27
Jul 2008
Layout of elements in the MCDF Generics table Chapter 6: MCDF tables
Continued
6-28 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Generics table
Continued
68P02900W22-S 6-29
Jul 2008
Layout of elements in the MCDF Generics table Chapter 6: MCDF tables
Continued
6-30 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Generics table
Continued
68P02900W22-S 6-31
Jul 2008
Layout of elements in the MCDF Generics table Chapter 6: MCDF tables
Continued
6-32 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Generics table
Continued
68P02900W22-S 6-33
Jul 2008
Layout of elements in the MCDF Generics table Chapter 6: MCDF tables
Continued
6-34 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Generics table
Continued
68P02900W22-S 6-35
Jul 2008
Layout of elements in the MCDF Generics table Chapter 6: MCDF tables
Continued
6-36 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Generics table
Continued
68P02900W22-S 6-37
Jul 2008
Layout of elements in the MCDF Generics table Chapter 6: MCDF tables
Continued
6-38 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Generics table
Continued
68P02900W22-S 6-39
Jul 2008
Layout of elements in the MCDF Generics table Chapter 6: MCDF tables
Continued
6-40 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Generics table
Continued
68P02900W22-S 6-41
Jul 2008
Layout of elements in the MCDF Generics table Chapter 6: MCDF tables
Continued
6-42 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Generics table
Continued
68P02900W22-S 6-43
Jul 2008
Layout of elements in the MCDF Generics table Chapter 6: MCDF tables
6-44 68P02900W22-S
Jul 2008
System Information: DataGen Timer table
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
can be overridden for a site or cell by values in the Specifics table.
68P02900W22-S 6-45
Jul 2008
Layout of elements in the MCDF Timer table Chapter 6: MCDF tables
Table 6-11 shows the layout of the timer element parameters in the Timer table.
2 assign_successful 30000
3 bcch_info 2000
4 bounce_protect_cong_tmr 0
5 bounce_protect_qual_tmr 0
6 bsc_audit 120000
7 bsc_audit_response 30000
8 bssgp_dwnld_retry 3
9 bssgp_t1_timer 3
10 bssgp_t2_timer 60
11 {27717} bssgp_t4_timer 800
12 bssgp_t5_timer 3000
13 bssgp_t6_timer 3000
14 bssgp_t8_timer 3000
15 bssmap_t1 30000
16 bssmap_t4 50000
17 bssmap_t7 30000
18 bssmap_t8 28000
19 bssmap_t10 28000
20 bssmap_t11 28000
21 bssmap_t13 40000
22 bssmap_t19 30000
23 bssmap_t20 30000
24 bssmap_tqho 30000
25 bts_audit 60000
26 bts_audit_response 30000
27 carrier_free_immediate 120000
28 cbch_1 30000
Continued
6-46 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Timer table
Continued
68P02900W22-S 6-47
Jul 2008
Layout of elements in the MCDF Timer table Chapter 6: MCDF tables
Continued
6-48 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Timer table
Continued
68P02900W22-S 6-49
Jul 2008
Layout of elements in the MCDF Timer table Chapter 6: MCDF tables
6-50 68P02900W22-S
Jul 2008
System Information: DataGen Modify Value table
This table contains the modify_value commands. The table is applicable only for MMS and LCF
device functions currently as DataGen only supports these devices within the modify_value
command.
MMS nbit
ber_oos_mon_period
ber_restore_mon_period
phase_lock_duration
mms_priority
hdsl_oos_mon_period
hdsl_restore_mon_period
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 Refer Range Table Mandatory
below.
The applicable ranges are shown in the following table:
Continued
68P02900W22-S 6-51
Jul 2008
Description of Modify Value table Chapter 6: MCDF tables
DYNET: 0 to 19
This value defines the DYNET first id to which this modify_value
command relates.
Continued
6-52 68P02900W22-S
Jul 2008
System Information: DataGen Description of Modify Value table
68P02900W22-S 6-53
Jul 2008
Circuit table Chapter 6: MCDF tables
Circuit table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-13 contains all MTL, LMTL, and OML signaling 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).
NOTE
The MSIs and MMSs required are detailed in the hardware file.
Continued
6-54 68P02900W22-S
Jul 2008
System Information: DataGen Description of Circuit table
Continued
68P02900W22-S 6-55
Jul 2008
Description of Circuit table Chapter 6: MCDF tables
Used for the CBC Operator name of the equip CBL command.
{28337}
DataGen supports the MTL parameter mtl_rate with the following values:
Table 6-14 Values of mtl_rate
The attribute can be set to 31 only when the Increased Network Capacity optional feature
is unrestricted.
6-56 68P02900W22-S
Jul 2008
System Information: DataGen Channel table
Channel table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-15 is required only for Remote Transcoders. This table contains the OML and MTL
signaling 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 Table 6-7.
Continued
68P02900W22-S 6-57
Jul 2008
Description of Channel table Chapter 6: MCDF tables
6-58 68P02900W22-S
Jul 2008
System Information: DataGen Links table
Links table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table is used for two different tasks (refer to Table 6-16):
• 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).
• RXCDR area
Contains details of the links between the RXCDR and its BSCs used by the XBL feature
(add_conn and add_bss_conn).
In both cases, the MSIs and MMSs required are detailed in the Hardware table.
NOTE
Valid for 1620 onwards.
Link Number 3 0 to 999 Mandatory if
area is a BSC or
collocated, unused if
area is an RXCDR.
This field is used as an internal ID to refer to this point-to-point link in the PATHS table. This
number is used as a unique identifier for the LINK within the scope of the BSS.
Site Number A 3 {28398} Mandatory
0 to 140, 253
With Increased
Network Capacity
feature.
This field is used as the A end site identifier. Value must be 0 in the case of an RXCDR area.
Continued
68P02900W22-S 6-59
Jul 2008
Description of Links table Chapter 6: MCDF tables
NOTE
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).
MSI A 3 0 to 123, 254 Mandatory
This field is used as the A end MSI identifier.
TS_SWITCH/Marker Sites
If Site Number A is a TS_SWITCH (marker site), 254 must be entered as the MSI A value.
MMS A 3 0 to 1, 254 Mandatory
This field is used as the A end MMS identifier.
TS_SWITCH/Marker Sites
If Site Number A is a TS_SWITCH (marker site), 254 must be entered as the MMS A value.
Site Number B 3 {28398} Mandatory
0 to 140, 253
With Increased
Network Capacity
feature.
This field is used as the B end site identifier.
TS_SWITCH/Marker Sites
This field also indicates the TS_SWITCH (marker site) if the Aggregate Abis option is
purchased.
254 is the value to insert if a TS_SWITCH is required.
MSI B 3 0 to 123, 254 Mandatory
This field is used as the B end MSI identifier.
TS_SWITCH/Marker Sites
If Site Number B is a TS_SWITCH (marker site), 254 must be entered as the MSI A value.
MMS B 3 0 to 1, 254 Mandatory
This field is used as the B end MMS identifier.
TS_SWITCH/Marker Sites
If Site Number B is a TS_SWITCH (marker site), 254 must be entered as the MMS A value.
6-60 68P02900W22-S
Jul 2008
System Information: DataGen Paths table
Paths table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-17 contains details of all the paths or Dynets within the BSS area (providing signaling
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.
Continued
68P02900W22-S 6-61
Jul 2008
Description of Paths table Chapter 6: MCDF tables
PATH Device
This field is used to identify the links in the chain (1 through 10) that composes the PATH.
Link 1 must terminate at site 0, and Link 10 must terminate at the value specified as the
Terminating Site Number. These links should be defined within the Links table.
It is an error to enter a link that does not terminate one end at the terminating site (refer
to first field above).
DYNET Device
This field is used to identify the links in the chain (1 through 11) that composes the
DYNET. Link 11 may only terminate at the BSC (site 0). These links should be
defined within the Links table.
6-62 68P02900W22-S
Jul 2008
System Information: DataGen LAPD table
LAPD table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-18 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.
NOTE
• Identifies at the BSC the device ID which corresponds to the RXCDR which
provides the TRAU resource for the CIC.
• Identifies at the RXCDR the device ID which corresponds to the BSS which is
managing the CIC. This field is not valid for local transcoding BSCs.
XBL data rate 2 16 or 64 Mandatory if Device Type is
XBL AND 16Kbps LAPD XBL
option is purchased, otherwise
unused.
Used for the prompt Enter the data rate for the XBL of the equip XBL command.
Continued
68P02900W22-S 6-63
Jul 2008
Description of LAPD table Chapter 6: MCDF tables
6-64 68P02900W22-S
Jul 2008
System Information: DataGen Cell table
Cell table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-19 provides the details of all the cells across the OMC or network and also the external
neighbors 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-25. {28398} DataGen
supports 250 Cells with Increased Network Capacity feature.
Continued
68P02900W22-S 6-65
Jul 2008
Description of Cell table Chapter 6: MCDF tables
Continued
6-66 68P02900W22-S
Jul 2008
System Information: DataGen Description of Cell table
If a value is not entered here, a generic value is used (refer to the Generics table on page 6-25).
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-25).
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
Used for element ccch_conf:
bs_ag_blks_res 1 See below for range. Optional, only
used if not an
external cell.
Range:
if ccch_conf = 1: range 0 to 2
if ccch_conf not 1: range 0 to 7.
If a value is not entered here, a generic value is used (refer to the
Generics table on page 6-25).
Continued
68P02900W22-S 6-67
Jul 2008
Description of Cell table Chapter 6: MCDF tables
Continued
6-68 68P02900W22-S
Jul 2008
System Information: DataGen Description of Cell table
Continued
68P02900W22-S 6-69
Jul 2008
Description of Cell table Chapter 6: MCDF tables
Continued
6-70 68P02900W22-S
Jul 2008
System Information: DataGen Description of Cell table
NOTE
Multi band must be enabled for inner_zone_alg to be modified.
Five parameters are associated with inner_zone_alg as follows:
• ms_txpwr_max_inner
• zone_ho_hyst
• rxlev_dl_zone
• rxlev_ul_zone
• neighbor_report_timer
These parameters may be set using the Generics table on page 6-25 or the Specifics table
on page 6-108.
Used for chg_cell_element inner_zone_alg:
ext_range_cell 1 0 to 2 Optional
One parameter is associated with ext_range_cell as follows:
ms_max_range (if ext_range is set then ms_max_range may be set between 0 and 219).
This parameter may be set using the Cell table field ms_max_range.
Used for chg_cell_element ext_range_cell:
hop_qual_enabled 1 0 to 1 Optional
Four parameters are associated with hop_qual_enabled as follows:
• l_rxqual_dl_h_hopping
• l_rxqual_dl_p_hopping
• l_rxqual_ul_h_hopping
• l_rxqual_ul_p_hopping
These parameters may be set using the Generics table on page 6-25 or the Specifics table
on page 6-108.
Continued
68P02900W22-S 6-71
Jul 2008
Description of Cell table Chapter 6: MCDF tables
• l_rxqual_dl_h_data
• l_rxqual_dl_p_data
• l_rxqual_ul_h_data
• l_rxqual_ul_p_data
These parameters may be set using the Generics table on page 6-25 or the Specifics table
on page 6-108.
Used for chg_cell_element data_qual_enabled:
gprs_enabled 1 0 to 1 Optional
Two parameters are associated with gprs_enabled as follows:
• rac
• ra_colour
These parameters may be set using the Generics table on page 6-25 or the Specifics table
on page 6-108.
Used for chg_cell_element gprs_enabled:
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
The default value is 0.
qsearch_i 2 0 to 15 Optional
The default value is 15.
qsearch_c_initial 1 0 to 1 Optional
Continued
6-72 68P02900W22-S
Jul 2008
System Information: DataGen Description of Cell table
68P02900W22-S 6-73
Jul 2008
Description of Cell table Chapter 6: MCDF tables
NOTE
6-74 68P02900W22-S
Jul 2008
System Information: DataGen Statistics table
Statistics table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
Table 6-20, 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.
(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-S 6-75
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
The elements in the Statistics table are displayed in Table 6-21 as follows:
Continued
6-76 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-77
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
80 bsslap_abort_rcv,0 0
81 bsslap_abort_sent,0 0
82 bsslap_ms_pos_cmd,0 0
83 bsslap_ms_pos_resp,0 0
84 bsslap_rej,0 0
85 bsslap_reset,0 0
86 bsslap_ta_req,0 0
87 bsslap_ta_resp,0 0
88 bsslap_toa_req,0 0
89 bssmap_conless_info_rcv,0 0
90 bssmap_conless_info_sent,0 0
91 bssmap_perf_loc_abort_msgs,0 0
92 bssmap_perf_loc_req_msgs,0 0
93 bssmap_perf_loc_resp_msgs,0 0
94 bssmaple_conless_info_rcv,0 0
95 bssmaple_conless_info_sent,0 0
96 bssmaple_perf_loc_abort_msgs,0 0
97 bssmaple_perf_loc_req_msgs,0 0
Continued
6-78 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-79
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-80 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-81
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-82 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-83
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-84 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-85
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-86 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-87
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-88 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-89
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-90 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-91
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-92 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-93
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-94 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-95
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-96 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-97
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-98 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-99
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-100 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
874 sccp_msgs_tx,0 0
875 sdcch_congestion,0 0
876 sdcch_handover,0 1
Continued
68P02900W22-S 6-101
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-102 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-103
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-104 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
Continued
68P02900W22-S 6-105
Jul 2008
Layout of elements in the MCDF Statistics table Chapter 6: MCDF tables
Continued
6-106 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Statistics table
68P02900W22-S 6-107
Jul 2008
Specifics table Chapter 6: MCDF tables
Specifics table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The Specifics table (Table 6-22) 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.
NOTE
• 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, Timer, or Statistics
table because of restrictions such as the elements have no specific default value,
or elements that are specific to particular site/cell configurations.
• 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.
Continued
6-108 68P02900W22-S
Jul 2008
System Information: DataGen Description of Specifics table
• efr_enabled
• dl_audio_lev_offset
• ul_audio_lev_offset
• volume_control_type
• enh_ter_cic_mgt_ena
MCC 3 3 digit numeric Mandatory
The Mobile Country Code.
MNC 3 3 digit numeric Mandatory
The Mobile Network Code.
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-S 6-109
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
The elements in the Specifics table are displayed in Table 6-23 as follows:
# Element Name
1 {31565} _cell_data,20
2 access_per_agch,0
3 access_per_pch_cs,0
4 access_per_pch_cs_ps,0
5 access_per_pch_ps,0
6 access_per_ppch,0
7 access_per_rach,0
8 adap_ho_alt_trigger_rxqual
9 adap_ho_pbgt
10 adap_ho_rxlev
11 adap_ho_rxqual
12 adap_trigger_hop_rxqual_dl
13 adap_trigger_hop_rxqual_ul
14 adap_trigger_pbgt
15 adap_trigger_rxlev_dl
16 adap_trigger_rxlev_ul
17 adap_trigger_rxqual_dl
18 adap_trigger_rxqual_ul
19 air_dl_control_blks,0
20 air_dl_tbf_failures,0
21 air_ul_control_blks,0
22 air_ul_tbf_failures,0
23 alloc_sdcch,0
24 alloc_sdcch_carr,0
25 alloc_sdcch_fail,0
26 alloc_sdcch_fail,2
27 alloc_tch,0
28 alloc_tch_carr,0
29 alloc_tch_fail,0
Continued
6-110 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-111
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-112 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-113
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-114 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-115
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-116 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-117
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-118 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-119
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-120 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-121
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-122 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-123
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-124 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-125
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-126 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-127
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-128 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-129
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-130 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-131
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-132 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-133
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-134 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-135
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-136 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-137
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-138 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-139
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-140 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-141
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-142 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-143
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-144 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-145
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-146 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-147
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-148 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-149
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-150 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
Continued
68P02900W22-S 6-151
Jul 2008
Layout of elements in the MCDF Specifics table Chapter 6: MCDF tables
Continued
6-152 68P02900W22-S
Jul 2008
System Information: DataGen Layout of elements in the MCDF Specifics table
68P02900W22-S 6-153
Jul 2008
RTF table Chapter 6: MCDF tables
RTF table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table contains details of the RTFs contained within the BSS area (refer to Table 6-24).
Continued
6-154 68P02900W22-S
Jul 2008
System Information: DataGen Description of RTF table
If the RTF is a BCCH carrier, this frequency is checked against the BCCH ARFN in the Cell
Table. If the two frequencies are different, the BCCH frequency from the Cell Table will be
used.
The channel selected for a PCS1900 cell must be within the allowed frequency blocks.
(Refer to the BSS table, PCS1900 Frequency Blocks field).
* BCCH Frequency can be in extension band if egsm_bcch_sd is enabled in
the Cell table.
KSW pair 1 0 to 3 Optional
Used for the Managing KSW Pair prompt within the RTF equipage command.
Continued
68P02900W22-S 6-155
Jul 2008
Description of RTF table Chapter 6: MCDF tables
Continued
6-156 68P02900W22-S
Jul 2008
System Information: DataGen Description of RTF table
NOTE
While upgrading from 1760/1800 to 1900, the parameter rtf_ds0_count is set to
7 (BCCH) and 8 (NON-BCCH) RTFs, as DataGen cannot handle the change in the
number of timeslot allocations. Users are provided with a WARNING message
through Upgrader as follows:
Continued
68P02900W22-S 6-157
Jul 2008
Description of RTF table Chapter 6: MCDF tables
1 = enabled
Not prompted for if the BTS is not AMR capable or the RTF is sub-equipped.
half_rate_enabled 1 0 to 1 Optional
Used to enable or disable GSM Half Rate at an RTF:
0 = disabled
1 = enabled
6-158 68P02900W22-S
Jul 2008
System Information: DataGen DRI table
DRI table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table contains details of the DRIs specified in the Hardware table for the BSS area (refer
to Table 6-26).
NOTE
The DRI must have its Cage and Slot number detailed in the Hardware table Table 6-7.
Continued
68P02900W22-S 6-159
Jul 2008
Description of DRI table Chapter 6: MCDF tables
NOTE
Continued
6-160 68P02900W22-S
Jul 2008
System Information: DataGen Description of DRI table
NOTE
Antenna number parameter is valid for the following cabinets:
Continued
68P02900W22-S 6-161
Jul 2008
Description of DRI table Chapter 6: MCDF tables
0 None or Hybrid
1 Non-Controlling
2 Controlling
Combiner Identifier 2 0 to 13 Optional
Used to reference the associated combiner for this DRI.
Cavity Number 2 0 to 5 Optional
Used to reference the associated combiner for this DRI.
{30828} Dri_density 1 1 to 3 Optional
1 = Single Density
2 = Double Density
3 = Double Density
with Capacity
The value of dri_density is 2 for Horizon macro, Horizon macro_ext, Horizon II macro,
Horizon II macro_ext, Horizon II mini, Horizon II mini_ext and Mcell6 cabinets. The value of
dri_density is 3 only if the following are true:
• The configured DRI is located in the Horizon II cabinets such as Horizon II macro,
Horizon II micro, Horizon II mini, Horizon II macro_ext, Horizon II micro_ext and
Horizon II mini_ext.
• The master cabinet for the SITE is either Horizon II macro, Horizon II micro or Horizon
II mini.
• The CTU2D Capacity feature is enabled, that is, the value of ctu2dcapOpt is 1.
{30828} 2 0 to 11 Mandatory when
Assoc_dri_id dri_density is 2 or 3.
6-162 68P02900W22-S
Jul 2008
System Information: DataGen Algorithm data table
Table 6-27 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.
• 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
Algorithm ID 1 0 to 3 Mandatory if
Algorithm Name is
not interfer_alg,
otherwise unused.
This field gives the value for the algorithm ID/bin number field.
Algorithm Number 1 0 to 1 Mandatory
This field gives the value for the algorithm number field.
Continued
68P02900W22-S 6-163
Jul 2008
Description of Algorithm data table Chapter 6: MCDF tables
To display only generic algorithm details for cells with no MCC, MNC, LAC, and CI details
specified, refer to Table 6-28.
6-164 68P02900W22-S
Jul 2008
System Information: DataGen Neighbor table
Neighbor 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-28. 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.
Continued
68P02900W22-S 6-165
Jul 2008
Description of Neighbor table Chapter 6: MCDF tables
Continued
6-166 68P02900W22-S
Jul 2008
System Information: DataGen Description of Neighbor table
Used for the add_neighbor prompt: Add neighbor to the BA BCCH List (yes/no)?
BA SACCH List Type 3 Yes or No Optional
The BA SACCH List Type must be set to Yes if the BA BCCH and BA GPRS List Types
are set to No, otherwise MCDF Insert fails.
Used for the add_neighbor prompt: Add neighbor to the BA SACCH List (yes/no)?
BA GPRS List Type 3 Yes or No Optional
The BA GPRS List Type must be set to Yes if the BA BCCH and
BA SACCH List Types are set to No, otherwise MCDF Insert fails.
Used for the add_neighbor prompt: Add neighbor to the BA GPRS List (yes/no)?
Power Budget 2 1 to 31 Optional if BSS Microcellular
hreqave option is purchased.
Used for the add_neighbor prompted parameter: Power budget surround cell hreqave.
Power Budget 2 1 to 7 Optional if BSS Microcellular
Algorithm Type option is purchased.
Used for the add_neighbor prompted parameter: Power budget algorithm type.
Interfering 3 Boolean Optional. Only applicable
Frequency where Concentric Cells
option is purchased,
inner_zone_alg is set to
interference for source cell
and the neighbor is being
added to the SACCH list.
Used for the add_neighbor prompt: Does this neighbor have a carrier with an
interfering frequency?
Inner Zone 2 0 to 63 Optional. Only applicable if
Handover Interfering Frequency is yes.
Threshold
Used for the add_neighbor prompt: Enter the threshold for inner zone handover.
Continued
68P02900W22-S 6-167
Jul 2008
Description of Neighbor table Chapter 6: MCDF tables
Continued
6-168 68P02900W22-S
Jul 2008
System Information: DataGen Description of Neighbor table
Continued
68P02900W22-S 6-169
Jul 2008
Description of Neighbor table Chapter 6: MCDF tables
Continued
6-170 68P02900W22-S
Jul 2008
System Information: DataGen Description of Neighbor table
68P02900W22-S 6-171
Jul 2008
Throttles table Chapter 6: MCDF tables
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-29.
6-172 68P02900W22-S
Jul 2008
System Information: DataGen EAS table
EAS table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The EAS table is used to specify alarm strings for alarm numbers used with the BSS area.
Refer to Table 6-30.
68P02900W22-S 6-173
Jul 2008
Daughter table Chapter 6: MCDF tables
Daughter table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
This table is used to specify the half height cards at a site in the same way as the hardware table
(Table 6-7) specifies the full height cards at a site, as described in Table 6-31.
6-174 68P02900W22-S
Jul 2008
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-32.
68P02900W22-S 6-175
Jul 2008
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-33. This table has entries only for sites that implement expanded KSW cards.
Also, this table contains the entries that differ from the default values (generated within the
BSS and BTS tables) only.
NOTE
This command is invalid at M-Cell sites and will not be generated for these sites.
2 EXP KSWX A1
3 EXP KSWX A2
Highway 1 1 0 to 3 Optional (Value must be
entered for Highway 0).
The KSWX card that handles TDM Highway 1.
Continued
6-176 68P02900W22-S
Jul 2008
System Information: DataGen Description of KSW table
68P02900W22-S 6-177
Jul 2008
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-34.
6-178 68P02900W22-S
Jul 2008
System Information: DataGen Hop table
Hop table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The Hop table is used to specify the parameters of the chhg_hop_params command as in
Table 6-35.
Continued
68P02900W22-S 6-179
Jul 2008
Description of Hop table Chapter 6: MCDF tables
Continued
6-180 68P02900W22-S
Jul 2008
System Information: DataGen Description of Hop table
Continued
68P02900W22-S 6-181
Jul 2008
Description of Hop table Chapter 6: MCDF tables
Continued
6-182 68P02900W22-S
Jul 2008
System Information: DataGen Description of Hop table
68P02900W22-S 6-183
Jul 2008
ACS table Chapter 6: MCDF tables
ACS table
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
The Active Codec Set (ACS) table is used to specify the parameters for any chg_acs_params
commands as in Table 6-36.
Continued
6-184 68P02900W22-S
Jul 2008
System Information: DataGen Description of ACS table
Continued
68P02900W22-S 6-185
Jul 2008
Description of ACS table Chapter 6: MCDF tables
Continued
6-186 68P02900W22-S
Jul 2008
System Information: DataGen Description of ACS table
Continued
68P02900W22-S 6-187
Jul 2008
Description of ACS table Chapter 6: MCDF tables
Continued
6-188 68P02900W22-S
Jul 2008
System Information: DataGen Description of ACS table
Continued
68P02900W22-S 6-189
Jul 2008
Description of ACS table Chapter 6: MCDF tables
Continued
6-190 68P02900W22-S
Jul 2008
System Information: DataGen Description of ACS table
68P02900W22-S 6-191
Jul 2008
Test Neighbor table Chapter 6: MCDF tables
Table 6-37 contains test neighbor details. Test neighbors are used by operators to optimize their
cellular network. The test neighbor allows the cell to add frequencies to the bcch allocation
list without having that frequency considered for a handover.
Continued
6-192 68P02900W22-S
Jul 2008
System Information: DataGen Description of the Test Neighbor table
The BA SACCH List Type must be set to Yes if the BA BCCH and
BA GPRS List Types are set to No, otherwise MCDF Insert fails.
Used for the add_neighbor prompt:
Add neighbour to the BA BCCH List (yes/no)?
BA GPRS List 3 Yes or No Mandatory. Prompted
Type Text if NCCR purchased.
The BA GPRS List Type must be set to Yes if the BA BCCH and
BA SACCH List Types are set to No, otherwise MCDF Insert fails.
Used for the add_neighbor prompt:
Add neighbour to the BA BCCH List (yes/no)?
Neighbor Cell 2 1 to 8 Mandatory
Frequency Type
Test Neighbor Cell Frequency type.
Neighbor BCCH 4 0 to 1023 Mandatory
Frequency
Number
Test Neighbor Mobile Allocation ARFCN for FHI.
68P02900W22-S 6-193
Jul 2008
Nail Connection Table Chapter 6: MCDF tables
The Nail Connection table is used to specify the parameters of the chg_ts_usage command as
in Table 6-38 to nail the GBL through the BSC.
There are no default values for any of the parameters. Datagen conducts only the range check.
Dependency checks are not done on these parameters.
Continued
6-194 68P02900W22-S
Jul 2008
System Information: DataGen Description of the Nail Connection table
68P02900W22-S 6-195
Jul 2008
Description of the Nail Connection table Chapter 6: MCDF tables
6-196 68P02900W22-S
Jul 2008
Index
Index
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
68P02900W22-S IX-197
Jul 2008
Index
Configuration management icon . . . . . 4-15 Copy BSS binary files into OLM . . . . . . 4-76
Configuring BSS area(s) Copying a BSS area from the GUI . . . . . 3-41
basic BSS with TS switch - expansion . . 3-47 Country administration (CADM) . . . . . 5-32
daisy chain configuration with TS administration files . . . . . . . . . . . 5-36
switch . . . . . . . . . . . . . . . . . . 3-52 menus. . . . . . . . . . . . . . . . . . 5-34
functions and MCDF table relation- using the xcadm GUI . . . . . . . . . . 5-33
ships . . . . . . . . . . . . . . . . . . 3-45 Creating a BSS area . . . . . . . . . . . 3-35
Configuring BSS areas . . . . . . . . . . 3-45 Creating a BSS from Navigation Tree . . . 4-32
Converting a script file . . . . . . . . . . 3-112 Creating a network
binary object compiler . . . . . . . . . 3-112 Saving a network . . . . . . . . . . . . . 4-6
Sysgen mode . . . . . . . . . . . . . . 3-112 Creating a RXCDR from Navigation
Copy area (ca) command . . . . . . . . . . 5-4 Tree . . . . . . . . . . . . . . . . . . . . 4-32
IX-198 68P02900W22-S
Jul 2008
Index
Generic Table Editor (GTE) . . . . . . . . 3-90 Generic Table Editor (GTE) (contd.)
edit menu . . . . . . . . . . . . . . . . 3-96 hot keys for MCDF . . . . . . . . . . . 3-104
file menu . . . . . . . . . . . . . . . . 3-90 Group management . . . . . . . . . . . . 2-13
fill cells . . . . . . . . . . . . . . . . . 3-97 group parameters . . . . . . . . . . . . 2-13
format menu . . . . . . . . . . . . . . 3-99
68P02900W22-S IX-199
Jul 2008
Index
IX-200 68P02900W22-S
Jul 2008
Index
68P02900W22-S IX-201
Jul 2008
Index
IX-202 68P02900W22-S
Jul 2008