MMI SYSTEM

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Definitions
MMI = Man Machine Interface
System consisting of software and peripherals. It is used by the
operator to perform operation and maintenance functions in
the exchange system.
MML = Man Machine Language
A command language with which the operator can manage the
operation of the exchange.
I/O syntax follows CCITT recommendations.
DIALOG / MML SESSION
Communication between the system and the user using MML
command language.

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Function of MMI System

the program blocks with which it is possible to execute MML
comprises
commands in the OMU unit

Services:
Opening and ending of an MML session
Entering the MML commands
Checking of command syntax and semantics
Authorization system

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

MMI
system

MMIcounterpart

PROCESS

MMI-system
time

Command
calendar

alarm

MML
session
log

Authorization
system

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Session:
- local
- remote

Design and Implementation of

MML
New way:

Old way:
no co-process
huge and complicated MMLs
difficult to replace MMI
interface with GUI
MML is loaded in memory
only when it is used
MML
program

MML
program

FILE

DISKS

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

MML is simple and compact

co-process contains the whole
business logic
co-process does not need to
know who communicates with
it ( MML, GUI, )
co-process is always in memory

Co
process

FILE

DISKS

MML Program
1

operator

command

message

guidance
5

MML
MML
co-process
4
co-process
program
program response

execution
outputs

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Dialog = MML session

OMU UNIT

MAIN LEVEL COMMAND <___>

<

>ZCWI;

MMI
system

316H
379H

LOADING PROGRAM VERSION 7.14-0

EXTENDED PREANALYSIS HANDLING COMMAND <CW_>

DIALOG
MMLLIB

<

MML

MML files
hard disk
(W0-MMDIRE)

After a command has been

entered, the DIALOG process
belonging to the MML Session
executes the MML program code.
The MMI system loads the
corresponding MML dynamically
from the hard disk of the OMU.

DIALOG process ids are: 316h .. 379h

7

MAIN LEVEL COMMAND <___>

< ZCW

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Contents of the MML Program

Code file (. MML)

Text file (. MTF)

Command group menu

Syntax description
Semantic table
Guidance routines

Guidance texts
command class is C
command group is W

static guides
dynamic guides

Execution routines

Execution output texts

Error texts

00-MAS>ZMXP:W0-MMDIRE/C0HANA*.*
VOLUME OMU_WDU
.DIR
INITIALIZED BY XY 89-01-01 LAST WRITE 05-10-19
DIRECTORY OF /MD_20_4_0/MMDIRE/
INITIALIZED BY XX 05-09-16 LAST WRITE 05-09-20
NAME
C0HANACW
C0HANAE1

EXT VER
CHECKSUM ID STRING
( D = DEFAULT VERSION )
.MML :01 D: 25E3B3BD: 7.14-0 05/08/01
GSMENVMD.PAC 20.4-0
.MTF :01 D: CB0E12F3: 7.14-0 05/08/01
GSMENVMD.PAC 20.4-0

LISTED LABELS

: 0002

00-MAS>

Two last letters tell command class and group in the code file of the MML
The load modules .MML and .MTF will be copied into W0(W1) - MMDIRE/ directory

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Parts of an MML Program

1) ANALYZING OF COMMANDS
Syntax description:
command char: 1=class, 2=group and
3=single command parameters: names, types, grouping types
Semantic of parameters
2) USER GUIDANCE ROUTINES
3) EXECUTION ROUTINES
Sending message(s) to co-process(es)
Receiving response(s) and analyzing them
Execution outputs to the user

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

General
Command: USI
Main Level

Organised in a three level

command hierarchy.

Command Class LevelU

D

C
S

ON-LINE help.

Command GroupUD
Level
Commands

Own MML program for

every MML command
group.
The MMI system loads the
MML programs from a disk
into the RAM when
entered to the command
group level.

10

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

ZR

US
S

ZRCI

RR

RC
C

XY

OMU

MML language hierarchy

PASSWORD
MAIN LEVEL

...
A

U
Z;

A..

COMMAND
CLASS LEVEL

U..

Z;

AB.

11

AH.

ABO

ABB

AHO

Print
alarms
currently
blocked

Block
alarms

Print
alarm
currently
on

AHP

US.
USI

USL

Print Interrogate List

alarm
working
unit
history
state
info

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

UD.
UDI

UDS

Int.
partial
unit
tests

Stop
current
test

COMMAND
GROUP LEVEL
COMMANDS

Command class menu

MAIN LEVEL COMMAND <___>
<?
DX 200 TRAINING_1
1993-02-13 14:08:25
MAIN LEVEL
? ..... DISPLAY MENU
A ..... ALARM SYSTEM ADMINISTRATION
C ..... ROUTING STATE ADMINISTRATION
D ..... SYSTEM SUPPORT AND COMMUNICATION
E ..... CELLULAR RADIO NETWORK ADMINISTRATION
I ..... I/O SYSTEM ADMINISTRATION
N ..... SS7 NETWORK ADMINISTRATION
O ..... SUPPLEMENTARY SS7 NETWORK ADMINISTRATION
Q ..... O&M NETWORK ADMINISTRATION
R ..... ROUTING ADMINISTRATION
T ..... TRAFFIC ADMINISTRATION
U ..... UNIT ADMINISTRATION
W ..... SYSTEM CONFIGURATION ADMINISTRATION
Y ..... SYSTEM SUPERVISION
Z; .... END DIALOGUE/DESTINATION SELECTION (:)

12

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Command group menu

MAIN LEVEL COMMAND <___>
< U?

UNIT ADMINISTRATION
? ..... DISPLAY MENU
B ..... RADIO NETWORK TEST HANDLING
D ..... DIAGNOSTICS HANDLING
S ..... WORKING STATE AND RESTART HANDLING
Z; .... RETURN TO MAIN LEVEL
UNIT ADMINISTRATION COMMAND <U__>

13

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Command menu
UNIT ADMINISTRATION COMMAND <U__>
< S?
LOADING PROGRAM VERSION 1.28-0
DX 200

TRAINING_1

1993-02-13 14:47:13

WORKING STATE AND RESTART HANDLING COMMANDS

? ..... DISPLAY MENU
C: ..... CHANGE UNIT STATE
T: ..... CHANGE UNIT INFO
I: ..... INTERROGATE UNIT STATE
L: ..... LIST UNITS IN SPECIFIED STATE OR INFO
U: ..... RESTART UNIT
S: ..... RESTART SYSTEM
Z; ..... RETURN TO MAIN LEVEL
WORKING STATE AND RESTART HANDLING COMMAND <US_>

14

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

MML command syntax

Command
ZABC: Parameter Block : Parameter Block :;
.... : Parameter, Parameter, ..... , :...
Parameter Type
1. Name Defined

.. : UNIT = OMU, DEV = LPT : ...

or: .. : DEV = LPT, UNIT = OMU : ...
2. Position Defined
.. : P1, P2, P3,

, P5 : ...

Omitted Parameter = DEFAULT

15

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Punctuation marks
:

Pass or End Parameter Block

End of Command --> EXECUTION

,

Separation of parameters

Menu or Parameter Information

% Wildcard
(e.g. SW % = all names with SW .... )

16

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Parameter Grouping Types

When a parameter consists of several arguments, they must be
grouped using the parameter separators: - & && &- &&(this defines in MDL before parameter semantics).
GROUPING_TYPE: indicates the grouping type of the parameter:
1
2
3
4
5
6
7
8
0

17

grouping_1
grouping_2
grouping_3
compound_1
compound_2
compound_3
compound_
no_grouping
end_mark

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

&
&&
&,&&
&&&&-,&&-,&
-

Example of Argument Groups

Grouping 1
1&7&9 -->

1,7,9

Grouping 2
1&&4 -->

1,2,3,4

Grouping 3
1&3&&5 -->

1,3,4,5

Compound
2-7-4 -->

2-7-4

Compound Grouping 1
2-7-4&-6&-12 -->
2-7-4, 2-7-6, 2-7-12
Compound Grouping 2
2-7-4&&-6
-->
2-7-4, 2-7-5, 2-7-6
Compound Grouping 3
2-4&-6&7-5&&-8 --> 2-4, 2-6, 7-5, 7-6, 7-7, 7-8

18

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Syntax Analyzer
The syntax check ensures that the MML command given by
the user is formally correct.
After the syntax analysis of the each parameter syntax has
been carried out, the syntax analyzer performs the semantic
check in accordance with the semantic data structure
After the analysis, the analyzer first call the execution
routine and then requests for a new command

19

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Syntax Analyzer 1
Are the given command characters permitted?
MAIN LEVEL COMMAND <___>
< ZP
/*** UNKNOWN COMMAND CLASS ***/

Command Group File

MAIN LEVEL COMMAND <___>

< ZUQ
/*** MML PROGRAM LOAD ERROR ***/
/*** UNKNOWN COMMAND GROUP ***/

Command Class File

UNIT ADMINISTRATION COMMAND <U__>

MAIN LEVEL COMMAND <___>
< ZUSP
LOADING PROGRAM VERSION 18.3-0
/*** UNKNOWN COMMAND ***/
WORKING STATE AND RESTART HANDLING COMMAND <US_>

20

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

MML Command Authority File

Syntax Analyzer 2
2. Are all the given parameters permitted in
the particular parameter block?
CWC:ANAL,START,12:AADDRC=12:RESS

/*** SYNTAX ERROR ***/

/*** INVALID PARAMETER NAME ***/

RES ....... FINAL RESULT WHEN ATTRIBUTE IS MATCHED

ANA ....... NEXT SUBANALYSIS WHEN ATTRIBUTE IS MATCHED
DEFRES .... FINAL RESULT WHEN ATTRIBUTE IS NOT MATCHED
DEFANA .... NEXT SUBANALYSIS WHEN ATTRIBUTE IS NOT MATCHED

RES OR ANA AND DEFRES OR DEFANA HAVE TO BE GIVEN */

CWC:ANAL,START,12:AADDRC=12:
21

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

Syntax Analyzer 3
3. Are extra parameters are given?
< ZUSU:STU,0:C=DSK:F=FCD

/*** SYNTAX ERROR ***/

/*** INVALID DELIMITER ***/

/* SPECIFY HOW RESTART IS CONTROLLED:

FCD .. FORCED RESTART

DEFAULT IS CONTROLLED RESTART

USU:STU,0:C=DSK:

22

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov

*/

Line editor commands

CTRL A => Change mode
CTRL D => Cursor left

CTRL B => Edit prev command

CTRL E => Cursor end of line

CTRL F => Cursor right CTRL G => Cursor down

CTRL H => Cursor home CTRL I
CTRL K => Change language

=>

Cursor up

CTRL L => Delete character

CTRL N => Curs beg of param block

CTRL O => Hardcopy

CTRL P => Page mode on/of

CTRL Q => Cont. outputting

CTRL S => Pause outputting

CTRL T => Output ringbufer

CTRL U => Empty edit bufer

CTRL X => Jump to CMD group level

CTRL Y => Interrupt CTRL Z =>

Del chars in edit bufer

BREAK => End of dialog CTRL 4 => MML testmode on/of

CTRL 7 => DX error descriptionCTRL W => Display line editor commands

23

NOKIA 1999 CTXX 1078_5.0en / 12.11.1999 / Sergei Popov