Post on 27-Dec-2015
description
NetNumen M31(RAN)Mobile Network Element Management System
MML Command Reference
Version: 12.10.032
ZTE CORPORATIONNO. 55, Hi-tech Road South, ShenZhen, P.R.ChinaPostcode: 518057Tel: +86-755-26771900Fax: +86-755-26770801URL: http://ensupport.zte.com.cnE-mail: support@zte.com.cn
LEGAL INFORMATIONCopyright © 2011 ZTE CORPORATION.
The contents of this document are protected by copyright laws and international treaties. Any reproduction or
distribution of this document or any portion of this document, in any form by any means, without the prior written
consent of ZTE CORPORATION is prohibited. Additionally, the contents of this document are protected by
contractual confidentiality obligations.
All company, brand and product names are trade or service marks, or registered trade or service marks, of ZTE
CORPORATION or of their respective owners.
This document is provided “as is”, and all express, implied, or statutory warranties, representations or conditions
are disclaimed, including without limitation any implied warranty of merchantability, fitness for a particular purpose,
title or non-infringement. ZTE CORPORATION and its licensors shall not be liable for damages resulting from the
use of or reliance on the information contained herein.
ZTE CORPORATION or its licensors may have current or pending intellectual property rights or applications
covering the subject matter of this document. Except as expressly provided in any written license between ZTE
CORPORATION and its licensee, the user of this document shall not acquire any license to the subject matter
herein.
ZTE CORPORATION reserves the right to upgrade or make technical change to this product without further notice.
Users may visit ZTE technical support website http://ensupport.zte.com.cn to inquire related information.
The ultimate right to interpret this product resides in ZTE CORPORATION.
Revision History
Revision No. Revision Date Revision Reason
R1.0 2011-02-28 First Edition
R1.1 2011-05-06 First Revision
Serial Number: SJ-20101227165724-015
Publishing Date: 2011-05-06(R1.1)
ContentsAbout This Manual ......................................................................................... I
Chapter 1 A ................................................................................................. 1-11.1 ADD DEPARTMENT .......................................................................................... 1-1
1.2 ADD INDEX ....................................................................................................... 1-2
1.3 ADD MEASTASK ............................................................................................... 1-6
1.4 ADD PERIODIC TASK........................................................................................ 1-9
1.5 ADD QOSTASK ................................................................................................1-11
1.6 ADD TIMING TASK .......................................................................................... 1-16
1.7 ADD USER...................................................................................................... 1-19
1.8 ALARM CLEAR................................................................................................ 1-22
1.9 ALARM SYNC ................................................................................................. 1-23
Chapter 2 B ................................................................................................. 2-12.1 BACKUP AND DELETE ALARM DATA................................................................ 2-1
2.2 BACKUP AND DELETE LOG DATA .................................................................... 2-2
2.3 BACKUP BASICDB............................................................................................ 2-2
2.4 BACKUP FILE ................................................................................................... 2-3
2.5 BACKUP WHOLE DB STRUCTURE ................................................................... 2-3
Chapter 3 D ................................................................................................. 3-13.1 DEL DEPARTMENT ........................................................................................... 3-1
3.2 DEL INDEX........................................................................................................ 3-2
3.3 DEL MEASTASK................................................................................................ 3-3
3.4 DEL QOSTASK.................................................................................................. 3-4
3.5 DEL SESSION................................................................................................... 3-5
3.6 DEL TASK ......................................................................................................... 3-5
3.7 DEL USER ........................................................................................................ 3-6
Chapter 4 E.................................................................................................. 4-14.1 EXEC DIRECTORY MONITOR ........................................................................... 4-1
4.2 EXPORT COMMAND LOG................................................................................. 4-2
4.3 EXPORT SECURITY LOG.................................................................................. 4-4
4.4 EXPORT SYSTEM LOG..................................................................................... 4-5
4.5 EXPORTCMDLOG............................................................................................. 4-7
Chapter 5 G ................................................................................................. 5-15.1 GET COUNTER................................................................................................. 5-1
I
5.2 GET INDEXLIST ................................................................................................ 5-3
5.3 GET MEASOBJ ................................................................................................. 5-5
5.4 GET MEASOBJTYPE......................................................................................... 5-6
5.5 GET MEASTASKLIST ........................................................................................ 5-7
5.6 GET MEASTYPE ............................................................................................... 5-9
5.7 GET NELOC.................................................................................................... 5-10
5.8 GET QOSTASKLIST .........................................................................................5-11
5.9 GET TYPELIST................................................................................................ 5-12
Chapter 6 H ................................................................................................. 6-16.1 HELP ................................................................................................................ 6-1
Chapter 7 Q ................................................................................................. 7-17.1 QUERY BYTASK ............................................................................................... 7-1
7.2 QUERY PMDATA ............................................................................................... 7-3
Chapter 8 R ................................................................................................. 8-18.1 RUNBATCH....................................................................................................... 8-1
Chapter 9 S.................................................................................................. 9-19.1 SET................................................................................................................... 9-2
9.2 SET AMO .......................................................................................................... 9-4
9.3 SET CURRENT USER INFORMATION ............................................................... 9-5
9.4 SET DEPARTMENT ........................................................................................... 9-6
9.5 SET INDEX........................................................................................................ 9-7
9.6 SET MEASTASK...............................................................................................9-11
9.7 SET MEASTASKSTATUS ................................................................................. 9-13
9.8 SET PERIODIC TASK ...................................................................................... 9-14
9.9 SET QOSTASK................................................................................................ 9-15
9.10 SET QOSTASKSTATUS ................................................................................. 9-19
9.11 SET TIMING TASK ......................................................................................... 9-20
9.12 SET USER..................................................................................................... 9-23
9.13 SET USER RIGHT ......................................................................................... 9-25
9.14 SET USER STATE ......................................................................................... 9-26
9.15 SET USER VIEW LOG RANGE ...................................................................... 9-26
9.16 SHOW ROLE................................................................................................. 9-27
9.17 SHOW ROLE SET ......................................................................................... 9-28
9.18 SHOW ALARM DETAIL .................................................................................. 9-29
9.19 SHOW ALL ROLES........................................................................................ 9-30
9.20 SHOW ALL ROLE SETS ................................................................................ 9-31
9.21 SHOW ALL SESSIONS .................................................................................. 9-32
II
9.22 SHOW ALL TASK........................................................................................... 9-32
9.23 SHOW ALL USERS........................................................................................ 9-33
9.24 SHOW AMO .................................................................................................. 9-34
9.25 SHOW COMMAND LOG ................................................................................ 9-35
9.26 SHOW CPU RATIO ........................................................................................ 9-37
9.27 SHOW CURRENT ALARM ............................................................................. 9-38
9.28 SHOW DB RATIO .......................................................................................... 9-41
9.29 SHOW DEPARTMENT ................................................................................... 9-41
9.30 SHOW DIRECTORY MONITOR TASK NAME.................................................. 9-42
9.31 SHOW HD USAGE......................................................................................... 9-43
9.32 SHOW HISTORY ALARM............................................................................... 9-44
9.33 SHOW INDEX................................................................................................ 9-46
9.34 SHOW MEASTASK ........................................................................................ 9-47
9.35 SHOW NETWORK DATA................................................................................ 9-48
9.36 SHOW NETWORK PORT............................................................................... 9-49
9.37 SHOW QOSTASK .......................................................................................... 9-50
9.38 SHOW RAM USAGE...................................................................................... 9-51
9.39 SHOW SECURITY LOG ................................................................................. 9-52
9.40 SHOW SYSTEM LOG .................................................................................... 9-53
9.41 SHOW USER................................................................................................. 9-55
9.42 SYNCH MEASTASK....................................................................................... 9-56
Tables .............................................................................................................. I
Glossary ........................................................................................................ III
III
About This ManualThe NetNumen M31 Mobile Network Element Management System (hereinafter calledNetNumen M31 or EMS for short) is a network management system for managing mobilenetwork elements. It is an intermediate system between the upper-layer operation supportsystem and lower-layer network element management systems. By using NetNumenM31,you may perform the integrated and centralised management operations on the networkelements, including:
l Configuration managementl Fault managementl Performance managementl Security managementl Log managementl Report management
NetNumen M31 uses object-oriented technologies. It is designed on the advanced J2EEplatform, providing unified standard interfaces to external devices.
Purpose
This manual explains all MML commands used for operations on the EMS for yourreference, including the function, syntax, input parameters, output parameters, examplesand remarks.
Intended Audience
l Maintenance Engineerl Debugging Engineer
What Is in This Manual
This manual contains the following chapters:
Chapter Summary
Chapter 1, A Introduces the MML commands which start with the letter A,
including command function, format, command example, and the
description of input/output parameters.
Chapter 2, B Introduces the MML commands which start with the letter B,
including command function, format, command example, and the
description of input/output parameters.
Chapter 3, D Introduces the MML commands which start with the letter D,
including command function, format, command example, and the
description of input/output parameters.
I
Chapter Summary
Chapter 4, E Introduces the MML commands which start with the letter E,
including command function, format, command example, and the
description of input/output parameters.
Chapter 5, G Introduces the MML commands which start with the letter G,
including command function, format, command example, and the
description of input/output parameters.
Chapter 6, H Introduces the MML commands which start with the letter H,
including command function, format, command example, and the
description of input/output parameters.
Chapter 7, Q Introduces the MML commands which start with the letter Q,
including command function, format, command example, and the
description of input/output parameters.
Chapter 8, R Introduces the MML commands which start with the letter R,
including command function, format, command example, and the
description of input/output parameters.
Chapter 9, S Introduces the MML commands which start with the letter S,
including command function, format, command example, and the
description of input/output parameters.
Conventions
ZTE documents employ the following typographical conventions.
Typeface Meaning
Italics References to other manuals and documents.
“Quotes” Links on screens.
Bold Menus, menu options, function names, input fields, option button names, check
boxes, drop-down lists, dialog box names, window names.
CAPS Keys on the keyboard and buttons on screens and company name.
Note: Provides additional information about a certain topic.
Checkpoint: Indicates that a particular step needs to be checked before
proceeding further.
Tip: Indicates a suggestion or hint to make things easier or more productive
for the reader.
II
Chapter 1ATable of Contents
ADD DEPARTMENT ..................................................................................................1-1ADD INDEX ...............................................................................................................1-2ADD MEASTASK .......................................................................................................1-6ADD PERIODIC TASK ...............................................................................................1-9ADD QOSTASK .......................................................................................................1-11ADD TIMING TASK ..................................................................................................1-16ADD USER ..............................................................................................................1-19ALARM CLEAR........................................................................................................1-22ALARM SYNC..........................................................................................................1-23
1.1 ADD DEPARTMENTFunction
Creates a new department.
Syntax
ADD DEPARTMENT: NAME= < NAME> [ , DESCRIPTION= < DESCRIPTION> ] [ , SUPERDEPART= < SUPERDEPART> ] ;
Input Parameters
Parameter Description
NAME (Mandatory) Specifies the name of the new department.
Value type: String
Value range: 1-50
Instance count: 1
DESCRIPTION (Optional) Adds a description of the new department.
Value type: String
Value range: 0-100
Instance count: 1
SUPERDEPARTMENT (Optional) Specifies the superior department of the new department.
Value type: String
Value range: 1-50
Instance count: 1
1-1
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Output Parameter
Parameter Description
RESULT Returns the result of creating the new department.
Value type: String
Instance count: 1
ExampleTo create a new department whose name is “Routine Maintenance” and superiordepartment is “Maintenance”, type the following command:
ADD DEPARTMENT:NAME=”Routine Maintenance”,DESCRIPTION=”Departme
nt responsible for routine maintenance”;SUPERDEPART=”Maintenanc
e”;
1.2 ADD INDEXFunctionCreates a performance index.
Syntax
ADD INDEX: INDEXNAME= < INDEXNAME> , VALUETYPE= < VALUETYPE> , MEASOBJTYPEID= < MEASOBJTYPEID> , FORMULA= < FORMULA> , INDEXTYPE= < INDEXTYPE> [ , DIRECTION= < DIRECTION> ] [ , SETCRITICAL= < SETCRITICAL> ] [ , ALARMCRITICAL= < ALARMCRITICAL> ] [ , ALARMCRITICALDELTA= < ALARMCRITICALDELTA> ] [ , SETMAJOR= < SETMAJOR> ] [ , ALARMMAJOR= < ALARMMAJOR> ] [ ,ALARMMAJORDELTA= < ALARMMAJORDELTA> ] [ , SETMINOR= < SETMINOR> ] [ ,ALARMMINOR= < ALARMMINOR> ] [ , ALARMMINORDELTA= < ALARMMINORDELTA>] [ , SETWARN= < SETWARN> ] [ , ALARMWARN= < ALARMWARN> ] [ , ALARMWARNDELTA= < ALARMWARNDELTA> ] [ , EXCEPTIONVALUE= < EXCEPTIONVALUE> ] [ ,INDEXDESC= < INDEXDESC> ] ;
Input Parameters
Parameter Description
INDEXNAME (Mandatory) Specifies the name of the new index.
Value type: String
Value range: 1-100
Instance count: 1
VALUETYPE (Mandatory) Specifies the value type of the new index.
Value type: Enumeration
Value range: INTEGER, FLOAT, PERCENT, BOOLEAN, and STATISTIC
Instance count: 1
1-2
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 1 A
Parameter Description
MEASOBJTYPEID (Mandatory) Specifies the type ID of the measure object of the new index.
Value type: String
Value range: 1-100
Instance count: 1
FORMULA (Mandatory) Sets the formula of the new index.
Value type: String
Value range: 1-2000
Instance count: 1
INDEXTYPE (Mandatory) Specifies the type of the new index.
Value type: Enumeration
Value range: PI, KPI, and SPI
Instance count: 1
DIRECTION (Optional) Sets the direction attribute of threshold crossing alarms based
on the new index.
Value type: Enumeration
Value range:
l UP (upward): An alarm occurs when the index value is higher than
the preset threshold.
l DOWN (downward): An alarm occurs when the index value is lower
than the preset threshold.
l ALL (upward and downward): An alarm occurs when the index value
is higher than the preset upper threshold or lower than the preset
lower threshold.
Default value: UP
Instance count: 1
SETCRITICAL (Optional) Enables the setting of threshold and delta for critical threshold
crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Default value: Y
Instance count: 1
ALARMCRITICAL (Optional) Sets the threshold of the new index for reporting a critical
threshold crossing alarm when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Default value: 0.0
Instance count: 1
1-3
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
ALARMCRITICALDEL
TA
(Optional) Sets a hysteresis value for the threshold to avoid frequent
switching between generation and removal of critical alarm. A threshold
with a delta actually provides two thresholds: an upper threshold and a
lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Default value: 0.0
Instance count: 1
SETMAJOR (Optional) Enables the setting of threshold and delta for major threshold
crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Default value: Y
Instance count: 1
ALARMMAJOR (Optional) Sets the threshold of the new index for reporting a major
threshold crossing alarm when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Default value: 0.0
Instance count: 1
ALARMMAJORDELTA (Optional) Sets a hysteresis value for the threshold to avoid frequent
switching between generation and removal of major alarm. A threshold
with a delta actually provides two thresholds: an upper threshold and a
lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Default value: 0.0
Instance count: 1
SETMINOR (Optional) Enables the setting of threshold and delta for minor threshold
crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Default value: Y
Instance count: 1
1-4
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 1 A
Parameter Description
ALARMMINOR (Optional) Sets the threshold of the new index for reporting a minor
threshold crossing alarm when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Default value: 0.0
Instance count: 1
ALARMMINORDELTA (Optional) Sets a hysteresis value for the threshold to avoid frequent
switching between generation and removal of minor alarm. A threshold
with a delta actually provides two thresholds: an upper threshold and a
lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Default value: 0.0
Instance count: 1
SETWARN (Optional) Enables the setting of threshold and delta for threshold crossing
warning.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Default value: Y
Instance count: 1
ALARMWARN (Optional) Sets the threshold of the new index for reporting a threshold
crossing warning when the index value is higher or lower than the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Default value: 0.0
Instance count: 1
ALARMWARNDELTA (Optional) Sets a hysteresis value for the threshold to avoid frequent
switching between generation and removal of threshold crossing warning.
A threshold with a delta actually provides two thresholds: an upper
threshold and a lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Default value: 0.0
Instance count: 1
EXCEPTIONVALUE (Optional) Sets the exception value of the new index, that is, the calculation
result when the denominator of the index formula is zero.
Value type: Float
Value range: -999999999.999 to 999999999.999
Default value: 0.0
Instance count: 1
1-5
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
INDEXDESC (Optional) Adds a description of the new index.
Value type: String
Value range: 1-100
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of creating the new performance index.
Value type: String
Instance count: 1
Example
To create an index whose name is “Call Drop Rate”, type the following command:
ADD INDEX:INDEXNAME="Call Drop Rate",VALUETYPE=PERCENT,MEASOBJTYP
E=8,FORMULA="(C301050164+C301050165)/(C301050203+C301050204)",IND
EXTYPE=KPI,DIRECTION=UP,SETCRITICAL=Y,ALARMCRITICAL=0.05,ALARMCRI
TICALDELTA=0.002,SETMAJOR=Y,ALARMMAJOR=0.04,ALARMMAJORDELTA=0.00
2,SETMINOR=Y,ALARMMINOR=0.03,ALARMMINORDELTA=0.002,SETWARN=Y,ALAR
MWARN=0.02,ALARMWARNDELTA=0.002,EXCEPTIONVALUE=0.0,INDEXDESC="Ca
ll Drop Rate";
1.3 ADD MEASTASKFunction
Creates a measurement task for collecting specific performance data.
Syntax
ADD MEASTASK: MEASTYPEID= < MEASTYPEID> , LOCTYPE= < LOCTYPE> , NELOC= < NELOC> , NETYPEID= < NETYPEID> [ , TASKNAME= < TASKNAME> ] [ , PERFORMANCEOBJECT= < PERFORMANCEOBJECT> ] [ , STARTDATE= < STARTDATE> ] [ ,ENDDATE= < ENDDATE> ] [ , STATUS= < STATUS> ] [ , GRAN= < GRAN> ] [ , DATEMASK= < DATEMASK> ] [ , TIMEMASK= < TIMEMASK> ] ;
1-6
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 1 A
Input Parameters
Parameter Description
MEASTYPEID (Mandatory) Specifies the type of the measure object involved in the
new measurement task. You can use wildcard characters to specify the
measure object type ID.
Value type: String
Value range: 1-100
Instance count: 1
LOCTYPE (Mandatory) Selects the type of NE location for specifying the location of
NE(s) involved in the new measurement task.
Value type: Enumeration
Value range: COMMON (common location), and GROUP (group location)
Default value: COMMON
Instance count: 1
NELOC (Mandatory) Specifies the location of NE(s) involved in the new
measurement task.
Value type: String
Value range: 1-10000
Instance count: 1
NETYPEID (Mandatory) Specifies the type of NE(s) involved in the new measurement
task.
Value type: String
Value range: 1-100000
Instance count: 1
TASKNAME (Mandatory) Specifies the name of the new measurement task.
Value type: String
Value range: 0-80
Instance count: 1
PERFORMANCEOBJE
CT
(Mandatory) Specifies the performance object(s) involved in the new
measurement task.
Value type: String
Value range: 1-100
Instance count: 1
STARTDATE (Optional) Sets the start time of the new measurement task.
Value type: Date
Instance count: 1
ENDDATE (Optional) Sets the end time of the new measurement task.
Value type: Date
Instance count: 1
1-7
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
STATUS (Optional) Specifies the initial status of the new measurement task.
Value type: Enumeration
Value range: ACTIVE, SUSPEND
Default value: ACTIVE
Instance count: 1
GRAN (Optional) Specifies the data collection granularity of the new measurement
task.
Value type: Integer
Default value: 15 (minutes)
Instance count: 1
DATEMASK (Optional) Sets the running date of the new measurement task.
Value type: String
Value range: 0-31
Default value: 1111111111111111111111111111111
Instance count: 1
TIMEMASK (Optional) Sets the running period of the new measurement task during
a day. The actual start time of the measurement task depends on the
granularity. For example, if you set the start time to 12:05 and the
granularity is 15 minutes, the actual start time of the task is 12:15.
Value type: String
Value range: 0-216
Default value: 00:00:00-24:00:00
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of creating the new periodic task.
Value type: String
Instance count: 1
Example
To create a measurement task according to the following information:
l Task Name: testl Measurement Type: cn.wcn.cs.50088l Performance Object: 42049l Measurement Period: from "2010-04-25 09:50:55" to "2010-04-27 09:50:55"l Task Status: activatedl Collection Granularity: 5 minutesl Running Time: the task runs all day and on every day in a month.
Type the command as follows:
1-8
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 1 A
ADD MEASTASK: MEASTYPEID= "cn.wcn.cs.50088", NELOC= "cn.wcn:OMMOI
D=SIM UAMO-CNBIG-501:elementid=5011000$cn.wcn:OMMOID=SIMUAMO-CNB
IG-501:elementid =5011001$cn.wcn:OMMOID=SIMUAMO-CNBIG-500:elemen
tid=5001000$cn.wcn:OMMOID =SIMUAMO-CNBIG-500:elementid=5001001",
NETYPEID= "cn.wcn.cs.mscs", TASKNAME= "test", PERFORMANCEOBJJECT=
"42049", STARTDATE= "2010-04-25 09:50:55", ENDDATE= "2010-04-27
09:50:55", STATUS= ACTIVE, GRAN= 5, DATEMASK= "111111111111111111
1111111111111", TIIMEMASK= "00:00:00,24:00:00";
Note:l Measure object supports wildcard.l Task type is created by NE as a default way.l Start time uses the next granularity as the default value.l The validity of granularity input is checked on the server.
1.4 ADD PERIODIC TASKFunctionCreates a periodic task for running specific MML command(s) periodically.
Syntax
ADD PERIODIC TASK: POLICYNAME= < POLICYNAME> , POLICYSTATUS= < POLICYSTATUS> , STARTTIME= < STARTTIME> , INTERVALTIME= [ < DAY> ] [ - < HOUR> ] [ -< MINUTE> ] [ - < SECOND> ] , MMLSTR= < MMLSTR> [ , ENDTIME= < ENDTIME> ] ;
Input Parameters
Parameter Description
POLICYNAME (Mandatory) Specifies the name of the new periodic task.
Value type: String
Value range: 1-50
Instance count: 1
POLICYSATUS (Mandatory) Specifies the initial status of the new periodic task.
Value type: Enumeration
Value range: Active, Suspend
Default value: Suspend
Instance count: 1
STARTTIME (Mandatory) Sets the start time of the new periodic task.
Value type: Date
Instance count: 1
1-9
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
DAY (Optional) Sets the day of the start time.
Value type: Integer
Value range: 1-366
Default value: 1
Instance count: 1
HOUR (Optional) Sets the hour of the start time.
Value type: Integer
Value range: 0-23
Default value: 0
Instance count: 1
MINUTE (Optional) Sets the minute of the start time.
Value type: Integer
Value range: 0-59
Default value: 0
Instance count: 1
SECOND (Optional) Sets the second of the start time.
Value type: Integer
Value range: 0-59
Default value: 0
Instance count: 1
INTERVALTIME (Mandatory) Sets the running cycle of the new periodic task.
Value type: Complex
Value range: 0-1000
Instance count: 1
MMLSTR (Mandatory) Specifies the MML command(s) for the new periodic task.
Value type: String
Value range: 1-1600
Instance count: 1
ENDTIME (Optional) Sets the end time of the new periodic task.
Value type: Date
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of creating the new periodic task.
Value type: String
Instance count: 1
Example
To create a periodic task whose name is “test”, type the following command:
1-10
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 1 A
ADD PERIODIC TASK:POLICYNAME="test",POLICYSTATUS=ACTIVE,STARTTIME
="2009-12-16 15:25:17",INTERVALTIME="1"-"0"-"8"-"0",MMLSTR="set";
1.5 ADD QOSTASKFunction
Creates a QoS task, that is, a threshold task. After a threshold task is created andactivated, the element management system monitors the performance object as specifiedin the task. Once the value of the performance object exceeds the preset threshold in thetask, a QoS alarm will be raised.
Syntax
ADDQOSTASK:MEASOBJTYPEID= <MEASOBJTYPEID> ,MEASOBJMOI= < NELOC>[ - <MEASOBJLIST> ] , THRESHOLD= < INDEXID> [ - <DIRECTION> ] [ - < SETCRITICAL>] [ - < ALARMCRITICAL> ] [ - < ALARMCRITICALDELTA> ] [ - < SETMAJOR> ] [ - < ALARMMAJOR> ] [ - < ALARMMAJORDELTA> ] [ - < SETMINOR> ] [ - < ALARMMINOR> ] [ - <ALARMMINORDELTA> ] [ - < SETWARN> ] [ - < ALARMWARN> ] [ - < ALARMWARNDELTA>] [ - < SUGGESTION> ] [ , TASKNAME= < TASKNAME> ] [ , TASKTYPE= < TASKTYPE> ] [ ,MONITORTYPE= <MONITORTYPE> ] [ ,CONDITION= <CONDITION> ] [ , STARTDATE=< STARTDATE> ] [ , ENDDATE= < ENDDATE> ] [ , STATUS= < STATUS> ] [ , GRAN= <GRAN> ] [ , DATEMASK= < DATEMASK> ] [ , TIMEMASK= < TIMEMASK> ] , NETYPEID=< NETYPEID> ;
Input Parameters
Parameter Description
MEASOBJTYPEID (Mandatory) Specifies the type of the measure object involved in the
new QoS task.
Value type: String
Value range: 1-100
Instance count: 1
MEASOBJMOI (Mandatory) Specifies the Managed Object Instance (MOI) of the
measure object involved in the new QoS task. You can use wildcard
characters to specify the MOI of the measure object.
Value type: Complex
Instance count: 1-1000000
NELOC (Mandatory) Specifies the location of NE(s) involved in the new QoS task.
Value type: String
Value range: 1-10000
Instance count: 1
1-11
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
MEASOBJLIST (Mandatory) Specifies the measure objects involved in the new QoS
task. You can use wildcard characters to specify the measure object
list. If you specify a parent measure object node, the child nodes of this
parent node are selected by default.
Value type: String
Value range: 0-100000
Instance count: 1
THRESHOLD (Mandatory) Sets the alarm threshold for the new QoS task.
Value type: Complex
Instance count: 1-1000000
INDEXID (Mandatory) Specifies the index(es) involved in the new QoS task.
Value type: String
Value range: 1-100
Instance count: 1
DIRECTION (Mandatory) Sets the direction attribute of threshold crossing alarms for
the specified index.
Value type: Enumeration
Value range:
l UP (upward): An alarm occurs when the index value is higher than
the preset threshold.
l DOWN (downward): An alarm occurs when the index value is lower
than the preset threshold.
l ALL (upward and downward): An alarm occurs when the index value
is higher than the preset upper threshold or lower than the preset
lower threshold.
Instance count: 1
SETCRITICAL (Mandatory) Enables the setting of threshold and delta for critical
threshold crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Default value: Y
Instance count: 1
ALARMCRITICAL (Optional) Sets the threshold of the specified index for reporting a critical
threshold crossing alarm when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Default value: 0.0
Instance count: 1
1-12
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 1 A
Parameter Description
ALARMCRITICALDELTA (Optional) Sets a hysteresis value for the threshold to avoid frequent
switching between generation and removal of critical alarm. A threshold
with a delta actually provides two thresholds: an upper threshold and a
lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Default value: 0.0
Instance count: 1
SETMAJOR (Mandatory) Enables the setting of threshold and delta for major threshold
crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Default value: Y
Instance count: 1
ALARMMAJOR (Optional) Sets the threshold of the specified index for reporting a major
threshold crossing alarm when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Default value: 0.0
Instance count: 1
ALARMMAJORDELTA (Optional) Sets a hysteresis value for the threshold to avoid frequent
switching between generation and removal of major alarm. A threshold
with a delta actually provides two thresholds: an upper threshold and a
lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Default value: 0.0
Instance count: 1
SETMINOR (Mandatory) Enables the setting of threshold and delta for minor threshold
crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Default value: Y
Instance count: 1
1-13
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
ALARMMINOR (Optional) Sets the threshold of the specified index for reporting a minor
threshold crossing alarm when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Default value: 0.0
Instance count: 1
ALARMMINORDELTA (Optional) Sets a hysteresis value for the threshold to avoid frequent
switching between generation and removal of minor alarm. A threshold
with a delta actually provides two thresholds: an upper threshold and a
lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Default value: 0.0
Instance count: 1
SETWARN (Mandatory) Enables the setting of threshold and delta for threshold
crossing warning.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Default value: Y
Instance count: 1
ALARMWARN (Optional) Sets the threshold of the specified index for reporting a
threshold crossing warning when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Default value: 0.0
Instance count: 1
ALARMWARNDELTA (Optional) Sets a hysteresis value for the threshold to avoid frequent
switching between generation and removal of threshold crossing warning.
A threshold with a delta actually provides two thresholds: an upper
threshold and a lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Default value: 0.0
Instance count: 1
SUGGESTION (Optional) Adds the handling suggestion of threshold crossing alarms.
Value type: String
Value range: 0-200
Instance count: 1
1-14
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 1 A
Parameter Description
TASKNAME (Mandatory) Specifies the name of the new QoS task.
Value type: String
Value range: 0-100
Instance count: 1
CONDITION (Optional) Specifies the active condition index of the new QoS task.
Value type: Integer
Instance count: 1
STARTDATE (Mandatory) Sets the start time of the new QoS task.
Value type: Date
Instance count: 1
ENDDATE (Mandatory) Sets the end time of the new QoS task.
Value type: Date
Instance count: 1
STATUS (Optional) Sets the initial status of the new QoS task.
Value type: Enumeration
Value range: ACTIVE, and SUSPENSIVE
Default value: ACTIVE
Instance count: 1
GRAN (Optional) Sets the data granularity of the new QoS task.
Value type: Integer
Default value: 15 (minutes)
Instance count: 1
DATEMASK (Optional) Sets the running date of the new QoS task.
Value type: String
Value range: 0-31
Default value: 1111111111111111111111111111111
Instance count: 1
TIMEMASK (Optional) Sets the running period of the new QoS task.
Value type: String
Value range: 0-216
Default value: 00:00:00-24:00:00
Instance count: 1
NETYPEID (Mandatory) Specifies the NE type concerned in the new QoS task.
Value type: String
Value range: 1-216
Instance count: 1
1-15
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Output Parameter
Parameter Description
RESULT Returns the result of creating the new QoS task.
Value type: String
Instance count: 1
Example
To create a QoS task according to the following information:
l Task Name: UltranCell Qos01l Measure Object Type: 401UtranCell(TD)l Measure Object List: It contains all measure objects of “RncFunction1867” of the NE
100, Subnetwork 100, Server100001.l Alarm Threshold: The indexes “36061-Call Completion Ratio, PS” and “36062-Call
Completion Ratio, CS” with the default settings of thresholds are used.l Activating Condition: 33000l Measurement Period: From "2008-01-01 00:00:00" to "2008-01-22 00:00:00".l Task Status: Activel Collection Granularity: 15 minutesl Running Time: The QoS task runs all day and on every day in a month.
Type the command as follows:
ADD QOSTASK: MEASOBJJTYPEID=401, MEASOBJJMOI="100001$fqokmcs4-1
$100001$1 00$100"-"1867", THRESHOLD=36061&36062, TASKNAME="Ultra
nCell Qos01", CONDITIION=33000, STARTDATE="2008-01-01 00:00:00",
ENDDATE="2008-01-22 00:00:00", STATUS=“Active”, GRAN=“15”,
NETYPEID="cn.wcn.cs.mscs";
Note:l Measure object support wildcard.l Task type is created by NE as a default way.l Start time uses the next granularity as the default value.l The validity of granularity input is checked on the server.
1.6 ADD TIMING TASKFunction
Creates a timing task, which may be run only once, once a day, once a week, or once amonth.
1-16
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 1 A
Syntax
ADD TIMING TASK: POLICYNAME= < POLICYNAME> , POLICYSTATUS= < POLICYSTATUS> , ONLYONCE= < ONLYONCE> , MMLSTR= < MMLSTR> ;
Input Parameters
Parameter Description
POLICYNAME (Mandatory) Specifies the name of the new timing task.
Value type: String
Value range: 1-50
Instance count: 1
POLICYSTATUS (Mandatory) Specifies the initial status of the new timing task.
Value type: Enumeration
Value range: Active, Suspend
Default value: Suspend
Instance count: 1
ONLYONCE Sets the running time of the new task. When this parameter is set, the new
timing task will be run only once when the preset time is up.
Value type: Date
Instance count: 1
ONCEDAY Sets the running day of the new task. When this parameter is set, the new
timing task will be run at the preset time once a day.
Value type: Date
Instance count: 1
WEEK Sets the running day of the new task. This parameter specifies the day of
a week.
Value type: Enumeration
Value range: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday,
Saturday
Default value: Sunday
Instance count: 1
SHORTTIME1 Sets the task-running time.
Value type: Date
Instance count: 1
ONCEWEEK Sets the running day of the new task. When this parameter is set, the new
timing task will be run at the preset time once a week.
Value type: Date
Instance count: 1
1-17
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
DAY1 Sets the running day of the new task. This parameter specifies the day
of a month.
Value type: Enumeration
Value range: 1–32 (32 refers to the last day)
Instance count: 1
SHORTTIME2 Sets the task-running time.
Value type: Date
Instance count: 1
ONCEMONTH Sets the running time of the new task. When this parameter is set, the new
timing task will be run once a month.
Value type: Complex
Instance count: 1
MONTH Sets the running time of the new task. This parameter specifies the
month(s) of a year.
Value type: Enumeration
Value range: 1–12
Instance count: 1
DAY2 Sets the running day of the new task. This parameter specifies the day
of a month.
Value type: Enumeration
Value range: 1–31
Instance count: 1
SHORTTIME3 Sets the task-running time.
Value type: Date
Instance count: 1
MMLSTR (Mandatory) Specifies the MML command(s) for the new timing task.
Value type: String
Value range: 1-1600
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of creating the new timing task.
Value type: String
Instance count: 1
Remarkss
l You can only set one of the parameters ONLYONCE, ONCEDAY, ONCEWEEK andONCEMONTH to specify the running time of the timing task, or set none of them.
1-18
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 1 A
l The date format of ONLYONECE is “yyyy-mm-dd hour:minute:second”, for example,“2008-10-17 15:27:36”.
l The date format of ONCEDAY is “hour:minute:second”, for example, “04:00:00”.l If you set ONCEWEEK, select a day in the week (Sunday, Monday, Tuesday,
Wednesday, Thursday, Friday, or Saturday), and then set the time, for example,“Monday”-”05:00:00”.
l If you set ONCEMONTH, select a day in the month (1 through 32), and then set thetime, for example, “25”-”06:00:00”. The day “32” indicates the last day of each month.
Example
To create a timing task whose name is “test”, type the following command:
ADD TIMING TASK:POLICYNAME="test",POLICYSTATUS=Active,ONLYONCE="2
008-10-13 16:07:22",MMLSTR="set";
1.7 ADD USERFunction
Creates a user.
Syntax
ADD USER: NAME= < NAME> [ , PASSWORD= < PASSWORD> ] [ , FULLNAME= < FULLNAME> ] [ , DESCRIPTION= < DESCRIPTION> ] [ , PHONENUMBER= < PHONENUMBER> ] [ , EMAILADDRESS= < EMAILADDRESS> ] [ , DEPARTMENT= < DEPARTMENT> ][ , USERVALIDDAYS= < USERVALIDDAYS> ] [ , PASSWORDVALIDDAYS= < PASSWORDVALIDDAYS> ] [ , DISABLE= < DISABLE> ] [ , USERSTOPACCDAYS= < USERSTOPACCDAYS> ] [ , ROLEARRAY= < ROLEARRAY> ] [ , ROLESETARRAY= < ROLESETARRAY>] [ , CONFIRMPASSWORD= < CONFIRMPASSWORD> ] ;
Input Parameters
Parameter Description
NAME (Mandatory) Specifies the name of the new user.
Value type: String
Value range: 1-30
Instance count: 1
PASSWORD (Optional) Sets the password of the new user.
Value type: String
Value range: 0-20
Instance count: 1
1-19
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
CONFIRMPASSWORD (Optional) Confirms the password of the new user.
Value type: String
Value range: 0-20
Instance count: 1
FULLNAME (Optional) Adds the full name of the new user.
Value type: String
Value range: 0-100
Instance count: 1
DESCRIPTION (Optional) Adds a description of the new user.
Value type: String
Value range: 0-100
Instance count: 1
PHONENUMBER (Optional) Specifies the phone number of the new user.
Value type: String
Value range: 0-20
Instance count: 1
EMAILADDRESS (Optional) Specifies the Email address of the new user.
Value type: String
Value range: 0-100
Instance count: 1
DEPARTMENT (Optional) Specifies the department to which the new user belongs.
Value type: String
Value range: 1-50
Instance count: 1
USERVALIDDAYS (Optional) Sets the validity period of the new user account. If the parameter
value is set to zero, the new user account will never expire.
Value type: Integer
Value range: 0-500
Default value: 0
Instance count: 1
PASSWORDVALIDDA
YS
(Optional) Sets the validity period of the new user account’s password. If
the parameter value is set to zero, the user password never expire.
Value type: Integer
Value range: 0-500
Default value: 0
Instance count: 1
1-20
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 1 A
Parameter Description
PASSWORDKEEPDAY
S
(Optional) Sets the reservation period of the new user account’s password.
Value type: Integer
Value range: 0-499
Default value: 0
Instance count: 1
DISABLE (Optional) Sets the initial status of the new user account, enabled or
disabled.
Value type: Boolean
Value range: True, False
Default value: False
Instance count: 1
USERSTOPACCDAYS (Optional) Sets the account suspended duration (days).
Value type: Integer
Value range: 0–500
Default value: 0
Instance count: 1
ROLEARRAY (Optional) Assigns role(s) to the new user.
Value type: String
Value range: 0-50
Instance count: 1-100
ROLESETARRAY (Optional) Assigns role set(s) to the new user.
Value type: String
Value range: 0-50
Instance count: 1-100
LOGROLEARRAY (Optional) Sets the role(s) so that the new user can view the logs of
existing users who are assigned with the role(s).
Value type: String
Value range: 0-50
Instance count: 1-100
LOGROLESETARRAY (Optional) Sets the role set(s) so that the new user can view the logs of
existing users who are assigned with the role set(s).
Value type: String
Value range: 0-50
Instance count: 1-100
Output Parameter
Parameter Description
RESULT Returns the result of creating the new user.
Value type: String
Instance count: 1
1-21
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
ExampleTo create a new user with the name of “user 1”, type the following command:
ADD USER:NAME="user 1",PASSWORD="0",CONFIRMPASSWORD="0",FULLNAME
="1",DESCRIPTION="1",PHONENUMBER="12345678901",EMAILADDRESS="some
body@unknown.com",DEPARTMENT="1",USERVALIDDAYS=0,PASSWORDVALIDDAY
S=0,DISABLE=False,USERSTOPACCDAYS=0,ROLEARRAY="1",ROLESETARRAY="1
",LOGROLEARRAY="1",LOGROLESETARRAY="1";
1.8 ALARM CLEARFunctionClears an alarm.
Syntax
ALARM CLEAR: ID= < ID> ;
Input Parameters
Parameter Description
ID (Mandatory) Specifies the alarm ID.
Value type: Integer
Instance count: 1–255
Output Parameters
Parameter Description
INFO Returns alarm clearing information.
Value type: Complex
Instance count: 1–255
RESULT Returns alarm clearing result.
Value type: String
Instance count: 1
ExampleTo clear an alarm whose ID is “1169630078865”, type the following command:
ALARM CLEAR: ID= 1169630078865;
Note:
You can use the “show current alarm” command to get the value of “ID”.
1-22
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 1 A
1.9 ALARM SYNCFunction
Synchronizes the alarms of one or more NE(s) to the element management system.
Note:
You can use this command to synchronize the alarms of up to 100 NEs to the networkelement management system at a time.
Syntax
ALARM SYNC: POSITION= < POSITION;
Input Parameter
Parameter Description
POSITION (Mandatory) Specifies the position(s) of NE(s) where the alarms needs to
be synchronized to the system, that is, the OID of NE(s).
Value type: String
Value range: 1-10000
Instance count: 1-100
Output Parameter
Parameter Description
INFO Displays the alarm synchronization information.
Value type: Complex
Instance count: 1-255
RESULT Returns the synchronization result of alarms.
Value type: String
Instance count: 1
Example
To synchronize the alarms of two NEs (1000, and 1001), type the following command:
ALARM SYNC:POSITION="IpNode=1000"&"IpNode=1001";
1-23
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
This page intentionally left blank.
1-24
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 2BTable of Contents
BACKUP AND DELETE ALARM DATA ......................................................................2-1BACKUP AND DELETE LOG DATA ...........................................................................2-2BACKUP BASICDB....................................................................................................2-2BACKUP FILE............................................................................................................2-3BACKUP WHOLE DB STRUCTURE..........................................................................2-3
2.1 BACKUP AND DELETE ALARM DATAFunction
Backs up and delete alarm data in the network element management system.
Syntax
BACKUP AND DELETE ALARM DATA;
Input Parameter
None
Output Parameter
Parameter Description
EXECRESULT Returns the result of backing up and deleting alarm data.
Value type: String
Instance count: 1-10000
Example
To back up and then delete the alarm data in the network element management system,type the following command:
BACKUP AND DELETE ALARM DATA;
2-1
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
2.2 BACKUP AND DELETE LOG DATAFunctionBacks up and delete log data in the network element management system, such asoperation log, system log, and security log.
SyntaxBACKUP AND DELETE LOG DATA;
Input ParameterNone
Output Parameter
Parameter Description
EXECRESULT Returns the result of backing up and deleting log data.
Value type: String
Instance count: 1-10000
ExampleTo back up and then delete the log data in the network element management system, typethe following command:
BACKUP AND DELETE LOG DATA;
2.3 BACKUP BASICDBFunctionBacks up the basic data in the database of the network element management system.
SyntaxBACKUP BASICDB;
Input ParameterNone
Output Parameter
Parameter Description
EXECRESULT Returns the result of backing up the basic data of the database.
Value type: String
Instance count: 1-10000
2-2
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 2 B
ExampleTo back up the basic data of the database of the network element management system,type the following command:
BACKUP BASICDB;
2.4 BACKUP FILEFunctionBacks up version files, configuration files, and runtime files in the network elementmanagement system.
SyntaxBACKUP FILE;
Input ParameterNone
Output Parameter
Parameter Description
EXECRESULT Returns the result of backing up files.
Value type: String
Instance count: 1-10000
ExampleTo back up the version files, configuration files, and runtime files in the network elementmanagement system, type the following command:
BACKUP FILE;
2.5 BACKUP WHOLE DB STRUCTUREFunctionBacks up the whole database of the network element management system.
SyntaxBACKUP WHOLE DB STRUCTURE;
Input ParameterNone
2-3
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Output Parameter
Parameter Description
EXECRESULT Returns the result of backing up the whole database structure.
Value type: String
Instance count: 1-10000
Example
To back up the whole database of the network element management system, type thefollowing command:
BACKUP WHOLE DB STRUCTURE;
Note:
When the database structure breaks down, you can use the offline recovery tool under\ums-server\utils\usf-backup to restore the whole database structure.
2-4
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 3DTable of Contents
DEL DEPARTMENT...................................................................................................3-1DEL INDEX ................................................................................................................3-2DEL MEASTASK........................................................................................................3-3DEL QOSTASK ..........................................................................................................3-4DEL SESSION ...........................................................................................................3-5DEL TASK..................................................................................................................3-5DEL USER.................................................................................................................3-6
3.1 DEL DEPARTMENTFunction
Deletes a department.
Syntax
DEL DEPARTMENT: NAME= < NAME> ;
Input Parameter
Parameter Description
NAME (Mandatory) Types the name of the department you want to delete.
Value type: String
Value range: 1-50
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of deleting a department.
Value type: String
Instance count: 1
Example
To delete the department whose name is “1”, type the following command:
DEL DEPARTMENT: NAME="1";
3-1
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
3.2 DEL INDEXFunction
Deletes a user-defined performance index.
Syntax
DEL INDEX: INDEXID= < INDEXID> ;
Input Parameter
Parameter Description
INDEXID (Mandatory) Types the ID of the performance index you want to delete.
Value type: String
Value range: 1-100
Instance count: 1
Output Parameters
Parameter Description
DETAIL Returns the details of the deleted index.
Value type: Complex
Instance count: 1
INDEXID Displays the ID of the deleted index.
Value type: String
Instance count: 1
INDEXNAME Displays the name of the deleted index.
Value type: String
Instance count: 1
RESULT Returns the result of deleting the index.
Value type: String
Instance count: 1
Remarkss
l The deletion of an index will not be allowed if the index is used in a QoS task, querytemplate or the performance index topology.
l You can not delete any default index provided by the system.
Example
To delete the user-defined index whose ID is 33000, type the following command:
DEL INDEX:INDEXID=33000;
3-2
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 3 D
3.3 DEL MEASTASKFunctionDeletes measurement task(s).
Note:
You can use this command to delete up to 100 measurement tasks at a time.
Syntax
DEL MEASTASK: TASKID= < BEGINID> [ - < ENDID> ] ;
Input Parameters
Parameter Description
TASKID (Mandatory) Types the ID of the measurement task or the ID range of the
measurement tasks that you want to delete.
Value type: Complex
Instance count: 1-100000
BEGINID (Mandatory) Sets the start ID of the measurement tasks that you want
to delete.
Value type: Integer
Instance count: 1
ENDID (Optional) Sets the end ID of the measurement tasks that you want to
delete.
Value type: Integer
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of deleting measurement task(s).
Value type: String
Instance count: 1
Examples
l To delete the measurement task with the ID 125, type the following command:
DEL MEASTASK:TASKID=125;
l To delete the measurement tasks with the IDs ranging from 100 to 120, from 150 to155, and the ID 200 and 210, type the command as follows:
3-3
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
DEL MEASTASK:TASKID=100-120&150-155&200&210;
3.4 DEL QOSTASKFunctionDeletes QoS task(s).
Note:
You can use this command to delete at most 100 QoS tasks at a time.
Syntax
DEL QOSTASK: TASKID= < BEGINID> [ - < ENDID> ] ;
Input Parameter
Parameter Description
TASKID (Mandatory) Types the ID of the QoS task or the ID range of the QoS tasks
that you want to delete.
Value type: Complex
Instance count: 1-100000
BEGINID (Mandatory) Sets the start ID of the QoS tasks that you want to delete.
Value type: Integer
Instance count: 1
ENDID (Optional) Sets the end ID of the QoS tasks that you want to delete.
Value type: Integer
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of deleting QoS task(s).
Value type: String
Instance count: 1
Examples
l To delete the QoS task with the ID 125, type the following commands:
DEL QOSTASK:TASKID=125;
l To delete the QoS tasks with the IDs ranging from 100 to 120, from 150 to 155, andthe ID 200 and 210, type the command as follows:
3-4
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 3 D
DEL QOSTASK:TASKID=100-120&150-155&200&210;
3.5 DEL SESSIONFunction
Deletes a session.
Syntax
DEL SESSION: SESSIONID= < SESSIONID> ;
Input Parameter
Parameter Description
SESSIONID (Mandatory) Types the ID of the session that you want to delete.
Value type: Integer
Value range: 0-32767
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of deleting the session.
Value type: String
Instance count: 1
Example
To delete the session whose ID is 0, type the following command:
DEL SESSION:SESSIONID=0;
3.6 DEL TASKFunction
Deletes a task.
Syntax
DEL TASK: POLICYNAME= < POLICYNAME> ;
3-5
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Input Parameter
Parameter Description
POLICYNAME (Mandatory) Types the name of the task that you want to delete.
Value type: String
Value range: 1-50
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of deleting the task.
Value type: String
Instance count: 1
Example
To create a task whose name is “task a”, type the following command:
DEL POLICY: POLICYNAME="task a";
3.7 DEL USERFunction
Deletes a user.
Syntax
DEL USER: NAME= < NAME> ;
Input Parameter
Parameter Description
NAME (Mandatory) Types the name of the user that you want to delete.
Value type: String
Value range: 1-30
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of deleting the user.
Value type: String
Instance count: 1
3-6
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 3 D
Example
To delete a user whose name is “user 1”, type the following command:
DEL USER:NAME="user 1";
3-7
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
This page intentionally left blank.
3-8
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 4ETable of Contents
EXEC DIRECTORY MONITOR ..................................................................................4-1EXPORT COMMAND LOG ........................................................................................4-2EXPORT SECURITY LOG .........................................................................................4-4EXPORT SYSTEM LOG ............................................................................................4-5EXPORTCMDLOG.....................................................................................................4-7
4.1 EXEC DIRECTORY MONITORFunction
Runs a directory monitoring task.
Syntax
EXEC DIRECTORY MONITOR: TASKNAME= < TASKNAME> ;
Input Parameter
Parameter Description
TASKNAME (Mandatory) Types the name of the directory monitoring task that you
want to run.
Value type: String
Value range: 1-50
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of running the directory monitoring task.
Value type: String
Instance count: 1
Example
To run a directory monitoring task whose name is “0”, type the following command:
EXEC DIRECTORY MONITOR:TASKNAME=0;
4-1
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
4.2 EXPORT COMMAND LOGFunction
Exports operation logs.
Syntax
EXPORT COMMAND LOG: FILEPATH= < FILEPATH> [ , USERNAME= < USERNAME>] [ , IP= < IP> ] [ , LOGSTARTDATE_FROM= < LOGSTARTDATE_FROM> ] [ , LOGSTARTDATE_TO= < LOGSTARTDATE_TO> ] [ , CMDCODE= < CMDCODE> ] [ , CONMODE=< CONMODE> ] [ , ISSUCCESS= < ISSUCCESS> ] [ , LOGRANK= < LOGRANK> ] [ , FILETYPE= < FILETYPE> ] [ , COUNT= < COUNT> ] ;
Input Parameter
Parameter Description
USERNAME (Optional) Types the name of the user who performs the operation.
Value type: String
Value range: 0–100
Instance count: 1–50
IP (Optional) Sets the IP address of the host.
Value type: String
Value range: 0–60
Instance count: 1–100
LOGSTART-
DATE_FROM
(Optional) Sets the operation start time range (from).
Value type: Date
Instance count: 1
LOGSTARTDATE_TO (Optional) Sets the operation start time range (to).
Value type: Date
Instance count: 1
CMDCODE (Optional) Sets the command code.
Value type: String
Value range: 0–20
Instance count: 1–100
CONMODE (Optional) Sets the connection mode.
Value type: Enumeration
Value range: GUI, TELNET, SSH, NDA (North Access), ERT
Instance count: 1–4
ISSUCCESS (Optional) Sets the operation result.
Value type: Enumeration
Value range: 0 (succeeded), 1 (failed), 2 (not finished)
Instance count: 1–3
4-2
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 4 E
Parameter Description
LOGRANK (Optional) Sets the log rank.
Value type: Enumeration
Value range: 1 (very important), 2 (important), 3 (notice), 4 (normal)
Instance count: 1–4
FILEPATH (Mandatory) Sets the log file path.
Value type: String
Value range: 1–255
Instance count: 1
FILETYPE (Optional) Sets the log file path.
Value type: Enumeration
Value range: EXCEL, TXT, HTM, PDF, CSV, XML
Default value: 4
Instance count: 1
COUNT (Optional) Sets the number of records you want to export from the
operation log.
Value type: Integer
Value range: 1–100000
Default value: 10000
Instance count: 1
Output Parameter
Parameter Description
FILES Returns the name of the file where the log records are exported.
Value type: String
Instance count: 1–100
Example
EXPORT COMMAND LOG:
USERNAME="a",IP="10.75.64.44",LOGSTARTDATE_FROM="2009-12-23
16:22:31",LOGSTARTDATE_TO="2009-12-24
16:22:31",CMDCODE="1012",CONMODE="GUI",ISSUCCESS="0",LOGRANK="1",FILEPATH="/filePath",FILETYPE=CSV,COUNT=10000;
Note:l By default, this command exports 10000 log records if you do not set the value of
COUNT.l The exporting operation must be done on the server. Therefore, the FILEPATH must
be set with a path that you have the written authority on the server.
4-3
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
4.3 EXPORT SECURITY LOGFunction
Exports security logs.
Syntax
EXPORT SECURITY LOG: FILEPATH= < FILEPATH> [ , USERNAME= < USERNAME>] [ , IP= < IP> ] [ , LOGSTARTDATE_FROM= < LOGSTARTDATE_FROM> ] [ ,LOGSTARTDATE_TO< LOGSTARTDATE_TO> ] [ , CONMODE= < CONMODE> ] [ ,FILETYPE= < FILETYPE> ] [ , COUNT= < COUNT> ] ;
Input Parameter
Parameter Description
USERNAME (Optional) Types the name of the user who performs the operation.
Value type: String
Value range: 0–100
Instance count: 1–50
IP (Optional) Sets the host IP address.
Value type: String
Value range: 0–60
Instance count: 1–100
LOGSTART-
DATE_FROM
(Optional) Sets the operation start time range (from).
Value type: Date
Instance count: 1
LOGSTARTDATE_TO (Optional) Sets the operation start time range (to).
Value type: Date
Instance count: 1
CONMODE (Optional) Sets the connection mode.
Value type: Enumeration
Value range: GUI, TELNET, SSH, NDA (North Access), ERT
Instance count: 1–4
FILEPATH (Mandatory) Sets the log file path.
Value type: String
Value range: 1–255
Instance count: 1
FILETYPE (Optional) Sets the log file path.
Value type: Enumeration
Value range: EXCEL, TXT, HTM, PDF, CSV, XML
Default value: 4
Instance count: 1
4-4
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 4 E
Parameter Description
COUNT (Optional) Sets the number of records you want to export from the
operation log.
Value type: Integer
Value range: 1–100000
Default value: 10000
Instance count: 1
Output Parameter
Parameter Description
FILES Returns the name of the file where the log records are exported.
Value type: String
Instance count: 1–100
Example
EXPORT SECURITY LOG: USERNAME= "a", IP= "10.75.64.44",
LOGSTARTDATE_FROM= "2009-12-24 16:40:36", LOGSTARTDATE_TO=
"2009-12-25 16:40:37", CONMODE = "TELNET", FILEPATH= "/filePath",
FILETYPE= CSV, COUNT= 10000;
Note:l By default, this command exports 10000 log records if you do not set the value of
COUNT.l The exporting operation must be done on the server. Therefore, the FILEPATH must
be set with a path that you have the written authority on the server.
4.4 EXPORT SYSTEM LOGFunction
Exports security logs.
Syntax
EXPORT SYSTEM LOG: FILEPATH= < FILEPATH> [ , IP= < IP> ] [ ,LOGSTARTDATE_FROM< LOGSTARTDATE_FROM> ] [ , LOGSTARTDATE_TO<LOGSTARTDATE_TO> ] [ , LOGRANK= < LOGRANK> ] [ , LOGSOURCE= <LOGSOURCE> ] [ , TASKNAME= < TASKNAME> ] [ , FILETYPE= < FILETYPE> ] [ ,COUNT= < COUNT> ] ;
4-5
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Input Parameter
Parameter Description
IP (Optional) Sets the host IP address.
Value type: String
Value range: 0–60
Instance count: 1–100
LOGRANK (Optional) Sets the log rank.
Value type: Enumeration
Value range:
l 1–EMERGENCY
l 2–ALERT
l 3–ERROR
l 4–WARNING
l 5–NOTIFICATION
l 6–INFORMATION
Instance count: 1–6
LOGSTART-
DATE_FROM
(Optional) Sets the operation start time range (from).
Value type: Date
Instance count: 1
LOGSTARTDATE_TO (Optional) Sets the operation start time range (to).
Value type: Date
Instance count: 1
LOGSOURCE (Optional) Sets the log source.
Value type: String
Value range: 0–100
Instance count: 1–100
TASKNAME (Optional) Sets the task name.
Value type: String
Value range: 0–100
Instance count: 1–100
FILEPATH (Mandatory) Sets the log file path.
Value type: String
Value range: 1–255
Instance count: 1
FILETYPE (Optional) Sets the log file path.
Value type: Enumeration
Value range: EXCEL, TXT, HTM, PDF, CSV, XML
Default value: 4
Instance count: 1
4-6
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 4 E
Parameter Description
COUNT (Optional) Sets the number of records you want to export from the
operation log.
Value type: Integer
Value range: 1–100000
Default value: 10000
Instance count: 1
Output Parameter
Parameter Description
FILES Returns the name of the file where the log records are exported.
Value type: String
Instance count: 1–100
Example
EXPORT SYSTEM LOG: IP="10.75.64.44", LOGRANK="6",
LOGSTARTDATE_TO="2009-12-24 16:41:13", ENDTIME="2009-12-25
16:41:13", LOGSOURCE="logmodule", TASKNAME="aa"&"bb",
FILEPATH="/filePath", FILETYPE=CSV, COUNT=10000;
Note:l By default, this command exports 10000 log records if you do not set the value of
COUNT.l The exporting operation must be done on the server. Therefore, the FILEPATH must
be set with a path that you have the written authority on the server.
4.5 EXPORTCMDLOGFunction
Exports operation logs from an Access Managed Object (AMO), that is, an NE agent.
Syntax
EXPORTCMDLOG: [ AMONAME= < AMONAME> ] [ , STARTTIME= < STARTTIME> ] [ ,ENDTIME= < ENDTIME> ] ;
4-7
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Input Parameters
Parameter Description
AMONAME (Optional) Specifies the name of the AMO.
Value type: String
Value range: 0-100000
Instance count: 1-100
STARTTIME (Optional) Sets the start time of the period for exporting the operation logs
during this period.
Value type: Date
Instance count: 1
ENDTIME (Optional) Sets the end time of the period for exporting the operation logs
during this period.
Value type: Date
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the result of exporting the operation logs.
Value type: String
Instance count: 1
Example
To export the operation logs from an AMO (10.61.97.10), type the following command:
EXPORTCMDLOG:AMONAME="10.61.97.10",STARTTIME="2010-04-16 11:35:56
",ENDTIME="2010-04-17 11:35:56";
4-8
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 5GTable of Contents
GET COUNTER .........................................................................................................5-1GET INDEXLIST ........................................................................................................5-3GET MEASOBJ..........................................................................................................5-5GET MEASOBJTYPE ................................................................................................5-6GET MEASTASKLIST ................................................................................................5-7GET MEASTYPE .......................................................................................................5-9GET NELOC ............................................................................................................5-10GET QOSTASKLIST ................................................................................................5-11GET TYPELIST........................................................................................................5-12
5.1 GET COUNTERFunction
Gets the list of counters of a specific measure object type or measurement type.
Syntax
GET COUNTER: [ NETYPENAME= < NETYPENAME >] ;
Input Parameters
Parameter Description
NETYPENAME (Mandatory) Specifies the NE type for listing all counters of this NE type.
Value type: String
Value range: 0-100
Instance count: 1
MEASOBJTYPEID Specifies the measure object type for listing all counters of this MO type.
Value type: String
Value range: 0-100
Instance count: 1
MEASTYPEID Specifies the measurement type for listing all counters of this measurement
type.
Value type: String
Value range: 0-100
Instance count: 1
5-1
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Output Parameters
Parameter Description
DETAIL Returns the counter list you want, including count ID, counter name,
measurement type ID, measurement type name, measure object type
ID, and measure object type name.
Value type: Complex
Instance count: 1-1000000
COUNTERID Returns the counter ID.
Value type: String
Instance count: 1
COUNTERNAME Returns the counter’s name.
Value type: String
Instance count: 1
MEASTYPEID Returns the measurement type ID.
Value type: String
Instance count: 1
MEASTYPENAME Returns the name of the measurement type.
Value type: String
Instance count: 1
MEASOBJTYPEID Returns the ID of the measured object.
Value type: String
Instance count: 1
MEASOBJTYPENAME Returns the name of the measured object.
Value type: String
Instance count: 1
Remarks
l The parameters MEASOBJTYPEID and MEASTYPEID are mutually exclusive. Thatmeans you can only set one of the two parameters in the command.
Examples
l To get the list of all counters of the NE “CG”, with the CG load as its measurementtype (object id = cn.wcn.cs.50550), type the following command:
GET COUNTER: NETYPENAME= cg, MEASOBJTYPEID= cn.wcn.cs.50500;
l To get the list of counters subject to the current RNC type (MEASOBJTYPEID=8),type the command as follows:
GET COUNTER: NETYPENAME= cg, MEASOBJTYPEID = 8;
l To get the list of counters subject to the current PVC cell type(MEASOBJTYPEID=32010), type the command as follows:
5-2
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 5 G
GET COUNTER: NETYPENAME= cg, MEASTYPEID=32010;
5.2 GET INDEXLISTFunction
Gets the list of performance indexes.
Syntax
GET INDEXLIST: [ NETYPENAME= < NETYPENAME> ] [ , MEASOBJTYPEID= < MEASOBJTYPEID> ] [ , ISSYS= < ISSYS> ] [ , ISKPI= < ISKPI> ] [ , VALUETYPE= < VALUETYPE>] ;
Input Parameters
Parameter Description
NETYPENAME (Mandatory) Specifies the type of NE whose performance index list is
needed.
Value type: String
Value range: 1-100
Instance count: 1
MEASOBJTYPEID (Optional) Specifies the type of measure object whose performance index
list is needed.
Value type: String
Value range: 0-1000
Instance count: 1
ISSYS (Optional) Selects the attribute of indexes you want to view: user-defined
indexes or default indexes provided by the system.
Value type: Enumeration
Value range: USER, SYS
Instance count: 1
ISKPI (Optional) Selects the type of indexes you want to view: Key Performance
Index (KPI), Performance Index (PI), or Statistical Performance Index (SPI).
Value type: Enumeration
Value range: KPI, PI and SPI
Instance count: 1
VALUETYPE (Optional) Selects the value type of indexes you want to view: integer,
float, percent, boolean (true/false), or statistic (1/0).
Value type: Enumeration
Value range: INTEGER, FLOAT, PERCENT, BOOLEAN, and STATISTIC
Instance count: 1
5-3
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Output Parameter
Parameter Description
DETAIL Displays the list of performance indexes, including index ID, index name,
NE type, measure object type ID, measure object type name, and index
attributes.
Value type: Complex
Instance count: 1-100000
INDEXID Displays the index ID.
Value type: String
Instance count: 1
INDEXNAME Displays the index name.
Value type: String
Instance count: 1
NETYPE Displays the NE type.
Value type: String
Instance count: 1
MEASOBJTYPEID Displays the ID of measured object type.
Value type: String
Instance count: 1
MEASOBJTYPENAME Displays the name of measured object type.
Value type: String
Instance count: 1
ISSYS Displays the attribute of the index.
Value type: Enumeration
Value range: USER, SYS
Instance count: 1
ISKPI Displays the index type.
Value type: Enumeration
Value range: KPI, PI and SPI
Instance count: 1
VALUETYPE Displays the value type of the index.
Value type: Enumeration
Value range: INTEGER, FLOAT, PERCENT, BOOLEAN(true/false), and
STATISTIC(1/0)
Instance count: 1
Examples
l To get the list of performance indexes subject to RNC NE type (NETYPEID= CG),type the command as follows:
5-4
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 5 G
GET INDEXLIST: NETYPENAME="CG";
l To get the list of performance indexes subject to RNC type (MEASOBJTYPEID= 8),type the command as follows:
GET INDEXLIST: NETYPENAME="CG", MEASOBJTYPEID=8;
l To get the list of all current KPIs, type the command as follows:
GET INDEXLIST: NETYPENAME="CG", ISKPI=TRUE;
l To get the list of performance indexes whose value type is percent, type the commandas follows:
GET INDEXLIST: NETYPENAME="CG", VALUETYPE=PERCENT;
5.3 GET MEASOBJFunction
Gets the list of the measured objects.
Syntax
GET MEASOBJ: NELOC= < NELOC> , MEASOBJTYPEID= < MEASOBJTYPEID> ;
Input Parameters
Parameter Description
NELOC (Mandatory) Specifies the location of the NE whose measure objects are
needed.
Value type: String
Value range: 1-10000
MEASOBJTYPEID Specifies the type of the measured objects you want to view.
Value type: String
Value range: 0-100
MEASTYPEID Specifies the measurement type of the measured objects you want to view.
Value type: String
Value range: 0-100
Output Parameter
Parameter Description
RESULT Returns the measured objects list as required.
Value type: String
Instance count: 1-1000000
5-5
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Remarks
The parameters MEASOBJTYPEID and MEASTYPEID are mutually exclusive. Thatmeans you can only set one of the two parameters in the command.
Examples
l To get the list of measure objects of the RNC type (measure object type ID=8) of anRNC managed element (NE location=100001), type the command as follows:
GET MEASOBJ:NELOC="100001",MEASOBJTYPEID=8;
l To get the list of measured objects of the RNC traffic statistics type (measurement typeID=30116) of an RNC managed element (NE location=100001), type the commandas follows:
GET MEASOBJ:NELOC="100001",MEASTYPEID=30116;
5.4 GET MEASOBJTYPEFunction
Gets the list of measurement object types of a specific NE type.
Syntax
GET MEASOBJTYPE: [ NETYPENAME= < NETYPENAME >] ;
Input Parameter
Parameter Description
NETYPENAME (Optional) Specifies the type of the NE whose measure object types are
needed.
Value type: String
Value range: 0-100
Instance count: 1
Output Parameter
Parameter Description
DETAIL Returns the list of required measure object types, including the ID, name of
the measure object type, and the ID and name of the NE type.
Value type: Complex
Instance count: 1-100000
MEASOBJTYPEID The ID of the measured objects.
Value type: String
Instance count: 1
5-6
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 5 G
Parameter Description
MEASOBJTYPENAME The name of the measured objects.
Value type: String
Instance count: 1
NETYPEID The ID of the NE type.
Value type: String
Instance count: 1
NETYPENAME The name of the NE type.
Value type: String
Instance count: 1
Examples
l To get the list of measure object types subject to the RNC NE type(NETYPEID=rncMeasureElement), type the following command:
GET MEASOBJTYPE:NETYPENAME="rncManagedElement";
l To get the list of measurement object types subject to all NE types, type the followingcommand:
GET MEASOBJTYPE;
5.5 GET MEASTASKLISTFunction
Gets the list of measurement tasks on a specific NE location.
Syntax
GET MEASTASKLIST: [ NELOC= < NELOC> ] [ ;
Input Parameter
Parameter Description
NELOC (Mandatory) Specifies the location of the NE whose measurement tasks
are needed. You can use wildcard characters to specify the NE location.
To get the NE location, you can use the GET NELOC command.
Value type: String
Value range: 1-10000
Instance count: 1-100000
5-7
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Output Parameter
Parameter Description
DETAIL Returns the list of required measurement tasks, including task ID, task
name, node ID, creator, creation time, modification time, task status, NE
type ID, granularity, begin date, end date, running date and running time.
Value type: Complex
Instance count: 1-1000000
TASKID Task ID
Value type: Integer
Instance count: 1
TASKNAME Task name
Value type: String
Instance count: 1
NODEID Node ID (the server where the task is created)
Value type: String
Instance count: 1
CREATOR Task creator
Value type: String
Instance count: 1
CREATETIME The time when the task is created.
Value type: String
Instance count: 1
MODIFYTIME The time when the task is modified.
Value type: String
Instance count: 1
STATUS The task status.
Value type: Enumeration
Value range: ACTIVE, SUSPENSIVE, FINISH
Instance count: 1
NETYPEID The NE type.
Value type: String
Instance count: 1
GRAN The collecting granularity.
Value type: Integer
Instance count: 1
5-8
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 5 G
Parameter Description
BEGINDATE The task start time.
Value type: String
Instance count: 1
ENDDATE The task end time.
Value type: String
Instance count: 1
DATEMASK The task running date.
Value type: String
Instance count: 1
TIMEMASK The task running time.
Value type: String
Instance count: 1
ExampleTo query all measurement tasks of the node with subnetwork ID 100 and NE ID 101 underServer 100001, type the following command:
GET MEASTASKLIST:NELOC="100001$100$101";
5.6 GET MEASTYPEFunctionGets the list of measurement types of a specific measurement object type.
Syntax
GET MEASTYPE: NETYPENAME= < NETYPENAME> [ , MEASOBJTYPEID= MEASOBJTYPEID] ;
Input Parameters
Parameter Description
NETYPEID (Mandatory) Specifies the type of NE whose measurement types are
needed.
Value type: String
Value range: 0-100
Instance count: 1
5-9
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
MEASOBJTYPEID (Optional) Specifies the ID of measure object type to which the
measurement types relate.
Value type: String
Value range: 0-100
Instance count: 1
Output Parameter
Parameter Description
DETAIL Returns the list of required measurement types, including the ID and name
of measurement type, and the ID and name of the measured object type.
Value type: Complex
Instance count: 1-1000000
Examples
l To get the measurement type list subject to the MscServer output ticket type(measured object id = cn.wcn.cs.50501) of the NE “CG”, type the followingcommands:
GET MEASTYPE:NETYPENAME=cg,MEASOBJTYPEID=cn.wcn.cs.50501;
l To get the list of measurement types subject to all measurement object types of currentapplication, type the command as follows:
GET MEASTYPE:NETYPENAME=cg;
5.7 GET NELOCFunction
Gets the location of NEs of an NE type.
Syntax
GET NELOC: [ NETYPENAME= < NETYPENAME >] ;
Input Parameter
Parameter Description
NETYPENAME (Optional) Specifies the type of NEs whose location is needed.
Value type: String
Value range: 0-100
Instance count: 1
5-10
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 5 G
Output Parameter
Parameter Description
DETAIL Returns the list of required NE location, including the topology ID of NE,
NE name, NE type ID, and NE type name.
Value type: Complex
Instance count: 1-100000
Examples
l To get the location list of all NEs, type the following command:
GET NELOC;
l To get the location list of all NEs subject to a certain NE type (NETYPENAME= “CG”),type the following command:
GET NELOC:NETYPENAME="CG";
Note:
You should add the character "\" in front of "$" in the batch command file.
5.8 GET QOSTASKLISTFunction
Gets the list of all QoS tasks at a specific NE location.
Syntax
GET QOSTASKLIST: [ NELOC= < NELOC> ] [ ;
Input Parameter
Parameter Description
NELOC (Mandatory) Specifies the location of the NE whose QoS tasks are needed.
You can use wildcard characters to specify the NE location.
Value type: String
Value range: 1-10000
Instance count: 1-100000
5-11
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Output Parameter
Parameter Description
DETAIL Returns the list of required QoS tasks, including task ID, task name,
node ID, creator, creation time, modification time, task status, NE type,
granularity, begin date, end date, running date and running time.
Value type: Complex
Instance count: 1-1000000
Example
To get the list of QoS tasks on “server (ID=100001)/subnetwork (ID=100)/NE (ID=101)”and “server 100001/subnetwork (ID=300)/NE (ID=300)”, type the following command:
GET QOSTASKLIST:NELOC="100001$100$101"&"100001$300$300";
5.9 GET TYPELISTFunction
Gets the type parameter list of a specific measured object or measurement type, includingtask type, QoS monitoring type, performance data query mode, data collection mode.
Syntax
GET TYPELIST: NETYPENAME= < NETYPENAME> , MEASOBJTYPEID= < MEASOBJTYPEID> ;
Input Parameters
Parameter Description
NETYPENAME (Mandatory) Types the ID of the NE type.
Value type: String
Value range: 1-100
Instance count: 1
MEASOBJTYPEID Specifies the ID of the measured object type.
Value type: String
Value range: 0-100
Instance count: 1
MEASTYPEID Specifies the ID of the measurement type.
Value type: String
Value range: 0-100
Instance count: 1
5-12
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 5 G
Output Parameters
Parameter Description
DETAIL Displays the details of the type parameters.
Value type: String
Instance count: 1
TASKBY Displays the task type, including the No., ID, and name of task types.
Value type: Complex
Instance count: 1-100000
MONITOR Displays the QoS monitoring type, including the No., ID, and name of QoS
monitoring types.
Value type: Complex
Instance count: 1-100000
QUERYBY Displays the data query mode, including the No., ID, and name of data
query modes.
Value type: Complex
Instance count: 1-100000
GROUPBY Displays the data grouping mode, including the No., ID, and the name of
data grouping modes.
Value type: Complex
Instance count: 1-100000
Remarks
The parameters MEASOBJTYPEID and MEASTYPEID are mutually exclusive. Thatmeans you can only set one of these two parameters in the command.
Examples
l To obtain the list of type parameters corresponding to the object type "108-RNC Type"of a WCDMA RNC NE, type the command as follows:
GET TYPELIST:NETYPENAME="rncManagedElement",MEASOBJTYPEID=108;
l To obtain the list of type parameters corresponding to themeasurement type "35004-IuConnection Statistics" of a TDSCDMA RNC NE, type the command as follows:
GET TYPELIST:NETYPENAME="TRncManagedElement",MEASTYPEID=35004;
5-13
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
This page intentionally left blank.
5-14
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 6HTable of Contents
HELP .........................................................................................................................6-1
6.1 HELPFunction
Gets the help information of a command.
Syntax
HELP : [ CMD= < CMD> ] ;
Input Parameter
Parameter Description
CMD (Optional) Types the name of the command you want to know.
Value type: String
Value range: 0-100
Instance count: 0-1
Output Parameters
Parameter Description
CMD Displays the command you want to know.
Value type: Complex
Instance count: 1-10000000
DETAILINFO Displays the help information of the command.
Value type: String
Instance count: 1-100
Example
To get the help information of the command “SET”, type the following command:
HELP:CMD=SET;
6-1
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
This page intentionally left blank.
6-2
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 7QTable of Contents
QUERY BYTASK........................................................................................................7-1QUERY PMDATA .......................................................................................................7-3
7.1 QUERY BYTASKFunction
Queries performance data by measurement task, and saves the result to a file in the PMQUERY folder under the FTP directory on the server. The files containing queried resultsare grouped by login users.
Syntax
QUERY BYTASK: TASKID= < TASKID> [ , MEASOBJLIST= < MEASOBJLIST> ] [ , COUNTER= < COUNTER> ] [ , STARTDATE= < STARTDATE> ] [ , ENDDATE= < ENDDATE> ][ , FILETYPE= < FILETYPE> ] ;
Input Parameters
Parameter Description
TASKID (Mandatory) Specifies the ID of the measurement task you want to use
for performance data query.
Value type: Integer
Instance count: 1
MEASOBJLIST (Optional) Specifies the list of measure objects you want to query. You can
use wildcard characters to specify the measure object list. If a parent node
is selected, all its child nodes are selected too by default.
Value type: String
Value range: 0-100000
Instance count: 1
COUNTER (Optional) Specifies the counter(s) you want to query.
Value type: Integer
Instance count: 1-100000
7-1
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
STARTDATE (Optional) Sets the start date of the period during which the performance
data is required.
Value type: Date
Instance count: 1
ENDDATE (Optional) Sets the end date of the period during which the performance
data is required.
Value type: Date
Instance count: 1
FILETYPE (Optional) Sets the file type for the query result.
Value type: Enumeration
Value range: CSV
Default value: CSV
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the query result, including the used time and file path.
Value type: Complex
Instance count: 1
Remarkss
l The query results, grouped by login user name, are saved in files of specified formatunder the FTP\PMQUERY directory on the server.
l This command queries the performance data during the latest day by default.l The measured objects specified in the measurement task are used by default when
no parameter is specified in this command.l All counters of the measurement type specified in the measurement task are used by
default when no counter is set in this command.
Examples
l To query performance data according to the default measurement task (ID: 106),which specifies the following items:
à Counter: all counters of the objects and measurement types in the task
à Query Period: from 01/21/2008 00:00:00 to 01/31/2008 00:00:00
Type the command as follows:
QUERY BYTASK:STARTDATE="2008-1-1 00:00:00",ENDDATE="2008-1-31
00:00:00",TASKID=106,FILETYPE=CSV;
l To query performance data according to the default measurement task (ID: 106),which specifies the following items:
7-2
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 7 Q
à Measured Object: RNC RRM object (ID=100)-cell (ID=9301) and RNC RRMobject (ID=100)-cell (ID=9302)
à Counter: Cell AM RLC Packets Sent (ID=301370565) and Cell AM RLC PacketsReceived (ID=301370568)
à Query Period: from 01/21/2008 00:00:00 to 01/31/2008 00:00:00
Type the command as follows:
QUERY BYTASK:STARTDATE="2008-1-1 00:00:00",ENDDATE="2008-1-31
00:00:00",TASKID=106,MEASOBJLIST="100-9301,100-9302",COUNTER
="301370565"&"301370568",FILETYPE=CSV;
7.2 QUERY PMDATAFunction
Queries performance data by customised conditions, and saves the query result to a filein the PMQUERY folder under the FTP directory on the server.
Syntax
QUERY PMDATA: MEASOBJTYPEID= < MEASOBJTYPEID> , QUERYITEMLIST= < QUERYITEMTYPE> - < QUERYITEMID> [ - < FILTEROPERATOR> ] [ - < FILTERVALUE> ] [, FILTERTYPE= < FILTERTYPE> ] [ , TOPNBYTYPE= < TOPNBYTYPE> ] [ , QUERYBYTYPE= < QUERYBYTYPE> ] [ , MEASOBJMOI= < NELOC> [ - < MEASOBJLIST> ] ] [ ,GROUPBYTYPE= < GROUPBYTYPE> ] [ , STARTDATE= < STARTDATE> ] [ , ENDDATE=< ENDDATE> ] [ , SEGMENT= < SEGMENT> ] [ , QUERYGRAN= < QUERYGRAN> ] [ ,FILETYPE= < FILETYPE> ] ;
Input Parameters
Parameter Description
MEASOBJTYPEID (Mandatory) Specifies the type ID of measure objects you want to query.
Value type: String
Value range: 1-100
Instance count: 1
7-3
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
QUERYITEMLIST (Mandatory) Specifies the items you want to query, including the item type,
item ID, filter operator, and filter value.
l Item type (QUERYITEMTYPE) (Enumeration): COUNTER (default
value)
l Item ID (QUERYITEMID) (String): 1-100
l Filter operator (Enumeration): GREAT, GREAT AND EQUAL, LESS,
LESS AND EQUAL, EQUAL, NOT EQUAL, TOP MAX, TOP MIN,
TRUE, and FALSE
l Filter value (Float)
Value type: Complex
Instance count: 1-500
FILTERTYPE (Optional) Sets the filtering type for performance data query.
Value type: Enumeration
Value range: AND, OR, and TOPN
Default value: AND
Instance count: 1
TOPNBYTYPE (Optional) Sets the Top N sorting mode of the query result.
Value type: Enumeration
Value range: NONE, TIME, and OBJECT
Default value: NONE
Instance count: 1
QUERYBYTYPE (Optional) Specifies the query type.
Value type: String
Value range: 0-100
Instance count: 1
MEASOBJMOI (Mandatory) Specifies the MOI of the measure objects you want to query,
including the NE location and measure object list.
l NE location (NELOC) (String): 1-10000
l Measure object list (MEASOBJLIST) (String): 0-100000; you can use
wildcard characters to specify the measure object list. If a parent node
is selected, all its child nodes are selected too by default.
Value type: Complex
Instance count: 1-1000000
GROUPBYTYPE (Optional) Specifies the grouping type of the query result.
Value type: String
Value range: 0-100
Instance count: 1
STARTDATE (Optional) Sets the start date of the period during which the performance
data is required.
Value type: Date
Instance count: 1
7-4
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 7 Q
Parameter Description
ENDDATE (Optional) Sets the end date of the period during which the performance
data is required.
Value type: Date
Instance count: 1
SEGMENT (Optional) Sets the time period for filtering the performance data.
Value type: String
Value range: 0-1728
Instance count: 1
QUERYGRAN (Optional) Sets the query granularity.
Value type: Integer
Instance count: 1
FILETYPE (Optional) Sets the file type for the query result.
Value type: Enumeration
Value range: CSV
Default value: CSV
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the query result, including the used time and the path of the output
file.
Value type: Complex
Instance count: 1
Remarkss
l The query results, grouped by login user name, are saved as files in the specified fileformat under the FTP\PMQUERY directory on the server.
l This command is used to query the performance data during the day by default.l The query result is grouped by original collection object by default.l The system queries performance data from all NEs by default according to this
command.l The query result will not be grouped if “TOPN” is set as the filter type.
Example
To query the performance data according to the following conditions:
l Measured Object Type: CELL (ID=10)l Measured Object MOI: server (ID=100001)/ subnetwork (ID=100)/ NE (ID=100), RNC
RRM object (ID=100)-serving cell (ID=9301) and RNC RRM object (ID=100)-servingcell (ID=9302)
7-5
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
l Query Items: Radio Access Success Rate (KPI ID=30008), Number of CompletedRAB Release (counter ID=301240940), and all counters of the measurement type“Cell UE Quantity Statistics (ID=30138)”
l Query Period: from 03/06/2008 00:00:00 to 03/07/2008 00:00:00l Query Granularity: summarize the performance data by hourl Filter Segment: "08:00:00-11:00:00” and “13:00:00-16:00:00”l Query Type: query performance data by NEl Group Type: group the query result by NEl File Type: save the query result in a CSV file
Type the command as follows:
QUERY PMDATA:MEASOBJTYPEID=10,MEASOBJMOI="100001$100$100"-"100
",QUERYITEMLIST="INDEX"-"30008"--&"COUNTER"-"301240940"--&"MEAS
TYPE"-"30138"--,STARTDATE="2008-3-6 00:00:00",ENDDATE="2008-3-7
00:00:00",QUERYGRAN=HOURSUM,QUERYBYTYPE=BYNE,GROUPBYTYPE=NE,SEGME
NT="08:00:00,11:00:00;13:00:00,16:00:00",FILETYPE=CSV;
7-6
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 8RTable of Contents
RUNBATCH ...............................................................................................................8-1
8.1 RUNBATCHFunction
Runs a batch script.
Syntax
RUNBATCH: FILENAME= < FILENAME> [ , ARGS= < ARGS> ] [ , OUTFILENAME= <OUTFILENAME> ] , SHOWRESULT= < SHOWRESULT> ;
Input Parameters
Parameter Description
FILENAME (Mandatory) Specifies the name of the batch script file (*.txt) you want to
run.
Value type: String
Value range: 1-50
Instance count: 1-10
ARGS (Optional) Sets the arguments.
Value type: String
Value range: 1-500
Instance count: 1-100
OUTFILENAME (Optional) Specifies the name of the output file.
Value type: String
Value range: 1-50
Instance count: 1
SHOWRESULT (Optional) Sets whether to show the running result on the Upload Messagetab in the client window of the EMS.
Value type: Boolean
Default value: False
Instance count: 1
8-1
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Output Parameter
Parameter Description
Result Displays the running result of the batch script.
Value type: String
Instance count: 1
ExampleTo run a batch script whose name is “batch file 1”, type the following command:
RUNBATCH:FILENAME="batch file 1",ARGS="1"&"1",OUTFILENAME="1"&"1
",SHOWRESULT=False;
RemarkssPay attention to the following items when using this command:
1. Be sure to save the batch script file to be run under the path ...\ums-server\works\global\runtime\ppus\uca.ppu\uca-mml.pmu\mmlbatchfiles on theserver in advance.
2. The FILENAME is the batch script file to be run (corresponding to the "FILENAME="MML sentence). The format of the file name must be *.txt.
3. Enter multiple instances (parameters) for "ARGS=" on the MML sentence. Theycorrespond to argus[0], argus[1]... in the script according to the input sequence.
4. The default name format of the output result file is: <input file name> + "_output" +<time stamp> + ".txt". The saving path of the result file is displayed in the commandexecuting result.
The following gives an introduction to the syntax of batch scripts.
l Execute MML Commands
Execute an MML sentence in the format of exec("mml sentence", isReport,
isWrite).
à isReport: it is an optional parameter of boolean type, indicating whether to showthe execution result of this MML command and report it to the message page.
à isWrite: it is an optional parameter of boolean type, indicating whether to writethe execution result of this MML command to a result file.
For example: to search for a cell, enter exec("get cell;") in the batch script file.
l Global Variables
The input values of the ARGUS parameter are global variables. Multiple values canbe set for the parameter. When the system calls the batch script, it receives the inputvalues in the sequence of argus[0], argus[1]....
For example: two values are set for the parameter, corresponding to ARGS=a&b onthe MML sentence. Then the batch script can use the variables argus[0] and argus[1],whose values are “a” and “b” respectively.
8-2
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 8 R
l Local Variables
You can define local variables in the batch script. The qualifier is def.
For example, def a=0.
Note:
The prefix "$" is required when a variable (global variable or local variable) is used asthe parameter value in an MML sentence. In other cases, the prefix is unnecessary.
For example:
exec("get cell : rncid = ${argus[0]};")
l If...Else Condition
The batch script supports if..else condition.
For example:
if(argus[0]. equals("1")) { exec("get rnccell: rncid =
${argus[1]};",true,true) } else { exec("get rnccell: rncid =
${argus[2]};",true,true) }
In this sentence, argus[0], argus[1] and argus[2] are three values of the parameter"ARGS".
l For Loop
The batch script supports for loop.
For example:
for(cellno in argus[1]..argus[2]) { exec("set cell: rncid=${a
rgus[0]}, cellno=$cellno, userlabel=${argus[3]};") }
In this sentence, argus[0], argus[1], argus[2] and argus[3] are four values of theparameter "ARGS".
l While Loop
The batch script supports while loop.
For example:
def x=1; while(x<argus[0]) { exec ("get cell: rncid=$x;") }
In this sentence, argus[0] is the value of the parameter "ARGS".
l Transaction Processing
The batch script supports the transaction processing mode. It is required to completethe following settings in the batch script first:
1. Add Transaction (STARTTRANS)
8-3
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Be sure to add the start transaction sentence before the commands for enablingthe transaction processing mode, for example, exec("STARTTRANS").
2. Commit Transaction (COMMITTRANS)
Be sure to add the commit transaction sentence at the end of the commandsfor executing the commands in the transaction processing mode, for example,exec("COMMITTRANS").
3. Cancel Transaction (CANCELTRANS)
When the script already runs to process the transaction, one can add the canceltransaction sentence after the specified command to cancel the transactionprocessing mode, for example, exec("CANCELTRANS").
For example, to set the transaction processing mode for a part of commands in thescript, you can modify the script file as follows:
def x=1; exec("STARTTRANS") for(cellno in argus[1]..argus[2])
{ exec("set cell: rncid=${argus[0]}, cellno=$cellno, userlabe
l=${argus[3]};") } exec("COMMITTRANS")
In this script, argus[0], argus[1], argus[2] and argus[3] are four values of the parameter"ARGS".
l Show the Processing Result
To show the execution result of MML commands in a batch script on the messagepage of the MML terminal view, set the SHOWRESULT parameter to “TRUE” in thecorresponding MML command, or add one of the following sentences in the batchscript file:
à exec("getcmdlog;",true)
à exec("getcmdlog;",true,false)
l Record the Processing Result
To save the execution result of the MML commands in a batch script, add one of thefollowing sentences in the batch script file:
à exec("getcmdlog;",false,true)
à exec("getcmdlog;",true,true)
l Obtain the Execution Result of MML Commands
Any of the commands ADD, GET, BATCHGET, SET, BATCHSET, ACTION, DEL,and SHOW can be used to get the execution result. A string array is returned (forexample, results[]) after you run exec(). The element with the ID 0 in the array(result[0] for example) indicates whether the command is successfully executed.The value 1 of this element indicates that the system has successfully executedthis command; while the value 0 indicates that the system failed to execute thiscommand. The other elements (results[1], results[2], ...) are the name/value pairsof the returned parameters.
8-4
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 8 R
à When the returned parameters are simple parameters, each parameter occupiesone element in the array. Multiple instances are separated by ",". The format isas follows:
ParamName=ParamValue1,ParamValue2,ParamValue3
à When the returned parameters are complex parameters, multiple virtualparameters occupy multiple elements in the array. Multiple instances of a virtualparameter are separated by ",". The format is as follows:
ComplexParamName:VirtualParamName1=Value1,Value2,Value3
The following introduces the methods to get the execution result and parameter value.
à getResult(String[] results): add this sentence in the script to get theexecution result. The system returns the result of the integer type. "1" indicatessuccessful execution; while "0" indicates execution failure.
à getParam(String[] results, String paramName): add this sentencein the script to get the value of a parameter. The system returns the value in theformat of string array.
The following gives an example of how to obtain the execution result. Suppose thatthe output parameters of the get test command include:
à A (real parameter, string type)
à B (real parameter, integer type)
à C (complex parameter, including virtual parameter C1 and C2)
à C1 (virtual parameter, belongs to C), C2 (virtual parameter, belongs to C)
Then use the following commands to get the desired result:
à def results = exec("get test"): gets the total returned result. "results"is displayed as a string array.
à def isSuccess = getResult(results): gets the execution result of thecommand. "inSuccess" is a parameter of int data type. "1" indicates successfulexecution; while "0" indicates execution failure.
à def a = getParam(results, "A"): gets the value of the parameter A. "a"is a string array, in which each element is an instance. If it only contains oneinstance, only a[0] can be obtained. Using "a.size()" can get the instance numberof the parameter.
à def b = getParam(results, "B"): gets the value of the parameter B. "a"is a string array, in which each element is an instance. If it only contains oneinstance, only b[0] can be obtained. Using "b.size()" can get the instance numberof the parameter. To convert the element values of "b" into values of int data type,use "toInt(b[0])".
à def c = getParam(results, "C"): gets the values of all virtualparameters of the parameter C. "c" is a string array, whose elements include "C1= Value1, Value2", and "C2 = Value3, Value4, Value5".
8-5
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
à def c1 = getParam(c, "C1"): gets the value of the parameter C1. "c1" isa string array.
à def c2 = getParam(c, "C2"): gets the value of the parameter C2. "c2" isa string array.
l Print Log
à debug(String): print the logs of the DEBUG level in the log file.
à info(String): print the logs of the INFO level in the log file.
à warn(String): print the logs of the WARN level in the log file.
à error(String): print the logs of the ERROR level in the log file.
à output(String): print the logs to the output file of batch commands.
l Convert the Data Type of Variables
à Use toInt(String) in the script to convert a string to an integer value.
à Use toFloat(String) in the script to convert a string to a float value.
l Set Timeout Time
Add setTimeout(int) at the first row of the script to set the timeout time of thescript. The script will end if it has not been completed when the set time is up.
The default time for the timeout of a script is one hour.
l Comment
The script supports the same format of comments used in Java.
à Single-line comment: starts at a "//".
à Multiline comment: included between "/*" and "*/".
l Script Keywords
In batch scripts, it is required to add the escape character "\" before the characters inMML sentences, which are the same as the keywords defined for the scripts, such as" and $. For example,
exec("ADD MEASTASK:MEASTYPEID=30105,MEASOBJMOI=\"100001\$1000
\$1000\",STATUS=ACTIVE, GRAN=15MIN,DATEMASK=\"1111111111111111
111111111111111\", TIMEMASK=\"00:00:00,24:00:00\";");
8-6
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9STable of Contents
SET............................................................................................................................9-2SET AMO...................................................................................................................9-4SET CURRENT USER INFORMATION......................................................................9-5SET DEPARTMENT...................................................................................................9-6SET INDEX ................................................................................................................9-7SET MEASTASK......................................................................................................9-11SET MEASTASKSTATUS.........................................................................................9-13SET PERIODIC TASK..............................................................................................9-14SET QOSTASK ........................................................................................................9-15SET QOSTASKSTATUS...........................................................................................9-19SET TIMING TASK...................................................................................................9-20SET USER...............................................................................................................9-23SET USER RIGHT ...................................................................................................9-25SET USER STATE ...................................................................................................9-26SET USER VIEW LOG RANGE ...............................................................................9-26SHOW ROLE ...........................................................................................................9-27SHOW ROLE SET ...................................................................................................9-28SHOW ALARM DETAIL............................................................................................9-29SHOW ALL ROLES..................................................................................................9-30SHOW ALL ROLE SETS..........................................................................................9-31SHOW ALL SESSIONS............................................................................................9-32SHOW ALL TASK.....................................................................................................9-32SHOW ALL USERS .................................................................................................9-33SHOW AMO.............................................................................................................9-34SHOW COMMAND LOG..........................................................................................9-35SHOW CPU RATIO..................................................................................................9-37SHOW CURRENT ALARM.......................................................................................9-38SHOW DB RATIO ....................................................................................................9-41SHOW DEPARTMENT.............................................................................................9-41SHOW DIRECTORY MONITOR TASK NAME..........................................................9-42SHOW HD USAGE ..................................................................................................9-43SHOW HISTORY ALARM ........................................................................................9-44SHOW INDEX..........................................................................................................9-46SHOW MEASTASK..................................................................................................9-47SHOW NETWORK DATA.........................................................................................9-48SHOW NETWORK PORT ........................................................................................9-49SHOW QOSTASK....................................................................................................9-50
9-1
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
SHOW RAM USAGE................................................................................................9-51SHOW SECURITY LOG...........................................................................................9-52SHOW SYSTEM LOG..............................................................................................9-53SHOW USER...........................................................................................................9-55SYNCH MEASTASK ................................................................................................9-56
9.1 SETFunction
Sets environment variables.
Syntax
SET: [ REQUESTTIMEOUT= < REQUESTTIMEOUT> ] [ , SESSIONTIMEOUT= < SESSIONTIMEOUT> ] [ , CONNECTTIMEOUT= < CONNECTTIMEOUT> ] [ , FORMAT= < FORMAT>] [ , WAITRESTIMEOUT= < WAITRESTIMEOUT> ] [ , NEID= < NEID> ] ;
Input Parameters
Parameter Description
REQUESTTIMEOUT (Optional) Sets the request timeout limit (unit: 10s).
Value type: Integer
Value range: 1-360
Instance count: 1
SESSIONTIMEOUT (Optional) Sets the session timeout limit (unit: 10s).
Value type: Integer
Value range: 30-1440
Instance count: 1
CONNECTTIMEOUT (Optional) Sets the connection timeout limit (unit: 10s).
Value type: Integer
Value range: 12-720
Instance count: 1
FORMAT (Optional) Sets the output format.
Value type: Enumeration
Value range: TBL, ETBL, UNI, MML, HI1, OP, NDFMML, and FILE
l TBL: table
l ETBL: erect table
l UNI: uniemi
l MML: MML command line
l HI1: HI1 file format
l OP: optimized format
Instance count: 1
9-2
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Parameter Description
WAITRESTIMEOUT (Optional) Sets the resource waiting timeout limit (unit: 10s).
Value type: Integer
Value range: 1-60
Instance count: 1
TELNETBYPAGE (Optional) Enables telnet by page or not.
Value type: Enumeration
Value range: true, false
Instance count: 1
NEID (Optional) Specifies the ID of the NE you want to set.
Value type: Integer
Value range: 0-255
Instance count: 1
Output Parameters
Parameter Description
REQUESTTIMEOUT Displays the request timeout (unit: 10 seconds).
Value type: Integer
Instance count: 1
SESSIONTIMEOUT Displays the session timeout (unit: 10 seconds).
Value type: Integer
Instance count: 1
CONNECTTIMEOUT Displays the connection timeout (unit: 10 seconds).
Value type: Integer
Instance count: 1
FORMAT Displays the output format.
Value type: Enumeration
Value range: TBL, ETBL, UNI, MML, HI1, OP, NDFMML, and FILE
Instance count: 1
WAITRESTIMEOUT Displays the resource waiting timeout (unit: 10 seconds).
Value type: Integer
Instance count: 1
TELNETBYPAGE Displays the status of telnet by page.
Value type: Enumeration
Value range: true, false
Instance count: 1
NEID Displays the NE ID.
Value type: Integer
Instance count: 1
9-3
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
RUNTIME Displays the running time.
Value type: Integer
Instance count: 1
ERRCODE Displays the error code.
Value type: Integer
Instance count: 1
ERRMSG Displays the result information.
Value type: String
Instance count: 1
ERRTEXT Displays the result details.
Value type: String
Instance count: 1
SYSTIME Displays the system time of the server.
Value type: Date
Instance count: 1
Example
To set some environment variables, type the following command:
SET: REQUESTTIMEOUT=1,SESSIONTIMEOUT=30,CONNECTTIMEOUT=12,FORMAT
=MML,WAITRESTIMEOUT=1,NEID=0,TELNETBYPAGE=TRUE;
9.2 SET AMOFunction
Connects to an Access Managed Object (AMO) for performing operations on NEsconnected to the EMS via the AMO.
Syntax
SET AMO: [ NAME= < NAME> ] [ , MOI= < MOI> ] ;
Input Parameter
Parameter Description
NAME Specifies the name of the AMO you want to connect.
Value type: String
Value range: 1–100
Instance count: 1
9-4
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Parameter Description
MOI Specifies the MOI of the OMM you want to connect.
Value type: String
Value range: 1–100
Instance count: 1
Output Parameter
None
Remarks
The parameters NAME andMOI are mutually exclusive. That means you can only set oneof these two parameters in the command.
Example
To connect the AMO with the name of “1”, or with the MOI “1”, type the following command:
SET AMO : NAME="1"; Or SET AMO : MOI="1";
9.3 SET CURRENT USER INFORMATIONFunction
Sets the information of the current login user.
Syntax
SET CURRENT USER INFORMATION: [ EMAILADDRESS= < EMAILADDRESS> ] [ , PHONENUMBER= < PHONENUMBER> ] [ , OLDPASSWORD= < OLDPASSWORD> ] [ , NEWPASSWORD= < NEWPASSWORD> ] [ , CONFIRMPASSWORD= < CONFIRMPASSWORD>] ;
Input Parameters
Parameter Description
EMAILADDRESS (Optional) Sets the Email address of the current user.
Value type: String
Value range: 0-100
Instance count: 1
PHONENUMBER (Optional) Sets the phone number of the current user.
Value type: String
Value range: 0-20
Instance count: 1
9-5
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
OLDPASSWORD (Optional) Types the old password of the current user.
Value type: String
Value range: 0-20
Instance count: 1
NEWPASSWORD (Optional) Sets the new password for the current user.
Value type: String
Value range: 0-20
Instance count: 1
CONFIRMPASSWORD (Optional) Confirms the new password of the current user.
Value type: String
Value range: 0-20
Instance count: 1
Output Parameter
Parameter Description
RESULT Displays the setting result of the current user.
Value type: String
Instance count: 1
Example
To set the Email address, phone number and password of the current login user, type thefollowing command:
SET CURRENT USER INFORMATION:EMAILADDRESS="somebody@unknown.com
",PHONENUMBER="12345678901",OLDPASSWORD="1",NEWPASSWORD="0",CONFI
RMPASSWORD="0";
9.4 SET DEPARTMENTFunction
Modifies the information of a department.
Format
SET DEPARTMENT: NAME= < NAME> [ , DESCRIPTION= < DESCRIPTION> ] [ , SUPERDEPART= < SUPERDEPART> ] [ , NEWNAME= < NEWNAME> ] ;
9-6
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Input Parameters
Parameter Description
NAME (Mandatory) Specifies the name of the department you want to modify.
Value type: String
Value range: 1-50
Instance count: 1
DESCRIPTION (Optional) Modifies the description of the department.
Value type: String
Value range: 0-100
Instance count: 1
SUPERDEPART (Optional) Changes the superior department of the department.
Value type: String
Value range: 1-50
Instance count: 1
NEWNAME (Optional) Modifies the name of the department.
Value type: String
Value range: 1-50
Instance count: 1
Output Parameter
Parameter Description
RESULT Displays the modification result of the department.
Value type: String
Instance count: 1
Remarkss
For the root department, you can only modify its name. For common departments, youcan only modify its description and superior department.
Example
To modify a common department with the name of “1”, type the following command:
SET DEPARTMENT: NAME="1",DESCRIPTION="1",SUPERDEPART="2";
9.5 SET INDEXFunction
Modifies the settings of a user-defined performance index.
9-7
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Note:
Only user-defined performance indexes can be modified.
Syntax
SET INDEX: INDEXID= < INDEXID> [ , INDEXNAME= < INDEXNAME> ] [ , INDEXDESC=< INDEXDESC> ] [ , FORMULA= < FORMULA> ] [ , INDEXTYPE= < INDEXTYPE> ] [ ,DIRECTION= < DIRECTION> ] [ , SETCRITICAL= < SETCRITICAL> ] [ , ALARMCRITICAL= < ALARMCRITICAL> ] [ , ALARMCRITICALDELTA= < ALARMCRITICALDELTA> ] [ ,SETMAJOR= < SETMAJOR> ] [ , ALARMMAJOR= < ALARMMAJOR> ] [ , ALARMMAJORDELTA= < ALARMMAJORDELTA> ] [ , SETMINOR= < SETMINOR> ] [ , ALARMMINOR=< ALARMMINOR> ] [ , ALARMMINORDELTA= < ALARMMINORDELTA> ] [ , SETWARN=< SETWARN> ] [ , ALARMWARN= < ALARMWARN> ] [ , ALARMWARNDELTA= < ALARMWARNDELTA> ] [ , EXCEPTIONVALUE= < EXCEPTIONVALUE> ] ;
Input Parameters
Parameter Description
INDEXID (Mandatory) Specifies the ID of the performance index you want to modify.
Value type: String
Value range: 1-100
Instance count: 1
INDEXNAME (Optional) Specifies the name of the performance index you want to modify.
Value type: String
Value range: 0-100
Instance count: 1
INDEXDESC (Optional) Changes the description of the performance index.
Value type: String
Value range: 0-100
Instance count: 1
FORMULA (Optional) Modifies the formula of the performance index.
Value type: String
Value range: 0-2000
Instance count: 1
9-8
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Parameter Description
DIRECTION (Optional) Changes the direction attribute of threshold crossing alarms
related to the performance index.
Value type: Enumeration
Value range:
l UP (upward): An alarm occurs when the index value is higher than
the preset threshold.
l DOWN (downward): An alarm occurs when the index value is lower
than the preset threshold.
l ALL (upward and downward): An alarm occurs when the index value
is higher than the preset upper threshold or lower than the preset
lower threshold.
Instance count: 1
SETCRITICAL (Optional) Enables or disables the setting of threshold and delta for critical
threshold crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Instance count: 1
ALARMCRITICAL (Optional) Modifies the threshold of the performance index for reporting a
critical threshold crossing alarm when the index value is higher or lower
than the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Instance count: 1
ALARMCRITICALDEL
TA
(Optional) Modifies the hysteresis value of the threshold to avoid frequent
raising and clearing of a critical alarm. A threshold with a delta actually
provides two thresholds: an upper threshold and a lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Instance count: 1
SETMAJOR (Optional) Enables or disables the setting of threshold and delta for major
threshold crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Instance count: 1
ALARMMAJOR (Optional) Modifies the threshold of the performance index for reporting
a major threshold crossing alarm when the index value is higher or lower
than the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Instance count: 1
9-9
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
ALARMMAJORDELTA (Optional) Modifies the hysteresis value for the threshold to avoid frequent
switching between generation and removal of major alarm. A threshold
with a delta actually provides two thresholds: an upper threshold and a
lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Instance count: 1
SETMINOR (Optional) Enables or disables the setting of threshold and delta for minor
threshold crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Instance count: 1
ALARMMINOR (Optional) Modifies the threshold of the performance index for reporting
a minor threshold crossing alarm when the index value is higher or lower
than the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Instance count: 1
ALARMMINORDELTA (Optional) Modifies the hysteresis value for the threshold to avoid frequent
switching between generation and removal of minor alarm. A threshold
with a delta actually provides two thresholds: an upper threshold and a
lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Instance count: 1
SETWARN (Optional) Enables or disables the setting of threshold and delta for
threshold crossing warning.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Instance count: 1
ALARMWARN (Optional) Modifies the threshold of the performance index for reporting a
threshold crossing warning when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Instance count: 1
9-10
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Parameter Description
ALARMWARNDELTA (Optional) Modifies the hysteresis value for the threshold to avoid frequent
switching between generation and removal of threshold crossing warning.
A threshold with a delta actually provides two thresholds: an upper
threshold and a lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Instance count: 1
EXCEPTIONVALUE (Optional) Modifies the exception value of the performance index, that is,
the calculation result when the denominator of the index formula is zero.
Value type: Float
Value range: -999999999.999 to 999999999.999
Instance count: 1
Output Parameter
Parameter Description
RESULT Displays the modification result of the performance index.
Value type: String
Instance count: 1
Example
To modify a user-defined performance index whose ID is 33008, type the followingcommand:
SET INDEX:INDEXID=33008,SETCRITICAL=Y,ALARMCRITICAL=0.06,ALARMCRI
TICALDELTA=0.01,EXCEPTIONVALUE=1;
9.6 SET MEASTASKFunction
Modifies the information of a suspended measurement task
Syntax
SETMEASTASK: TASKID= < TASKID> [ , NELOC= < NELOC> ] [ , TASKNAME= < TASKNAME> ] [ , ENDDATE= < ENDDATE> ] [ , DATEMASK= < DATEMASK> ] [ , TIMEMASK=< TIMEMASK> ] ;
9-11
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Input Parameters
Parameter Description
TASKID (Mandatory) Specifies the ID of the measurement task you want to modify.
Value type: Integer
Instance count: 1
NELOC (Optional) Modifies the NEs involved in the measurement task.
Value type: String
Value range: 1-10000
Instance count: 1
TASKNAME (Optional) Modifies the name of the measurement task.
Value type: String
Value range: 0-80
Instance count: 1
ENDDATE (Optional) Resets the end time of the measurement task.
Value type: Date
Instance count: 1
DATEMASK (Optional) Resets the running date of the measurement task. Use 7 or 31
“1”s and “0”s to specify the running date, for example, “0110000”, which
indicates the system runs the measurement task every Monday and
Tuesday in each month.
Value type: String
Value range: 0-31
Instance count: 1
TIMEMASK (Optional) Resets the running period of the measurement task during a day.
Value type: String
Value range: 0-216
Instance count: 1
Output Parameter
Parameter Description
RESULT Displays the modification result of the measurement task.
Value type: String
Instance count: 1
Examples
l To modify the following information of the measurement task with the ID 118:
à The end time of the task is “2008-03-22 00:00:00”.
à The task runs from 09:00:00 to 12:00:00 and from 14:00:00 to 18:00:00 everyMonday and Tuesday.
Type the command as follows:
9-12
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
SET MEASTASK:TASKID=118,ENDDATE="2008-03-22 00:00:00",DATEMASK
="0110000", TIMEMASK="09:00:00,12:00:00;14:00:00,18:00:00";
9.7 SET MEASTASKSTATUSFunction
Changes the status of measurement task(s).
Syntax
SET MEASTASKSTATUS: TASKID= < BEGINID >-< ENDID >, STATUS= < STATUS >;
Input Parameters
Parameter Description
TASKID (Mandatory) Specifies the ID of the measurement task or the ID range of
multiple measurement tasks whose status needs to be changed.
Value type: Complex
Instance count: 1-100000
BEGINID (Mandatory) Specifies the begin ID of the range when you want to change
the status of multiple measurement tasks at a time.
Value type: Integer
Instance count: 1
ENDID (Optional) Specifies the end ID of the range when you want to change the
status of multiple measurement tasks at a time.
Value type: Integer
Instance count: 1
STATUS (Mandatory) Changes the status of the measurement task(s).
Value type: Enumeration
Value range: ACTIVE, and SUSPENSIVE
Instance count: 1
Output Parameters
Parameter Description
RESULT Displays the modification result of the measurement task(s).
Value type: String
Instance count: 1
Example
To activate the measurement task whose ID is 125, type the following command:
SET MEASTASKSTATUS:TASKID=125,STATUS=ACTIVE;
9-13
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
9.8 SET PERIODIC TASKFunction
Modifies the settings of a periodic task.
Syntax
SET PERIODIC TASK: POLICYNAME= < POLICYNAME> [ , POLICYSTATUS= < POLICYSTATUS> ] [ , STARTTIME= < STARTTIME> ] [ , INTERVALTIME= [ < DAY> ] [ - < HOUR>] [ - <MINUTE> ] [ - < SECOND> ] ] [ ,MMLSTR= <MMLSTR> ] [ , ENDTIME= < ENDTIME>] ;
Input Parameters
Parameter Description
POLICYNAME (Mandatory) Specifies the name of the periodic task you want to modify.
Value type: String
Value range: 1-50
Instance count: 1
POLICYSATUS (Optional) Changes the status of the periodic task.
Value type: Enumeration
Value range: Active, Suspend
Default value: Suspend
Instance count: 1
STARTTIME (Optional) Resets the start time of the periodic task. The format of the
start time is “yyyy-mm-dd hour:minute:second”, for example, “2010-08-17
09:00:00”.
Value type: Date
Instance count: 1
INTERVALTIME (Optional) Resets the running cycle of the periodic task. The format of
interval is “day-hour-minute-second”, for example, “1”-”0”-”0”-”0”, which
indicates that the system runs the periodic task once a day.
Value type: Complex
Instance count: 1
MMLSTR (Optional) Modifies the MML command(s) in the periodic task.
Value type: String
Value range: 0–1600
Instance count: 1
9-14
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Parameter Description
ENDTIME (Optional) Resets the end time of the periodic task. The format of the
start time is “yyyy-mm-dd hour:minute:second”, for example, “2010-08-17
10:00:00”.
Value type: Date
Instance count: 1
Output Parameter
Parameter Description
RESULT Displays the modification result of the periodic task.
Value type: String
Instance count: 1
Example
To change the status of a periodic task whose name is “test a” to “Suspend”, type thefollowing command:
SET PERIODIC TASK:POLICYNAME="test a",POLICYSTATUS=Suspend;
9.9 SET QOSTASKFunction
Modifies the settings of a suspended QoS task, also called threshold task.
Syntax
QOSTASK: TASKID= < TASKID> [ , TASKNAME= < TASKNAME> ] [ , THRESHOLD= <INDEXID> [ - < DIRECTION> ] [ - < SETCRITICAL> ] [ - < ALARMCRITICAL> ] [ - < ALARMCRITICALDELTA> ] [ - < SETMAJOR> ] [ - < ALARMMAJOR> ] [ - < ALARMMAJORDELTA> ] [- < SETMINOR> ] [ - < ALARMMINOR> ] [ - < ALARMMINORDELTA> ] [ - < SETWARN> ] [ - <ALARMWARN> ] [ - < ALARMWARNDELTA> ] [ - < SUGGESTION> ] ] [ , SETCONDITION=< SETCONDITION> ] [ , CONDITION= < CONDITION> ] [ , STARTDATE= < STARTDATE>] [ , ENDDATE= < ENDDATE> ] [ , DATEMASK= < DATEMASK> ] [ , TIMEMASK= < TIMEMASK> ] ;
Input Parameters
Parameter Description
TASKID (Mandatory) Specifies the ID of the QoS task you want to modify.
Value type: Integer
Instance count: 1
9-15
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
TASKNAME (Optional) Specifies the name of the task you want to modify.
Value type: String
Value range: 0-100
Instance count: 1
THRESHOLD (Optional) Resets the alarm threshold for the QoS task.
Value type: Complex
Instance count: 1-1000000
INDEXID (Mandatory) Resets the index IDs involved in the QoS task.
Value type: String
Value range: 1-100
Instance count: 1-1000000
DIRECTION (Mandatory) Resets the direction attribute of threshold crossing alarms for
the specified index.
Value type: Enumeration
Value range:
l UP (upward): An alarm occurs when the index value is higher than
the preset threshold.
l DOWN (downward): An alarm occurs when the index value is lower
than the preset threshold.
l ALL (upward and downward): An alarm occurs when the index value
is higher than the preset upper threshold or lower than the preset
lower threshold.
Instance count: 1
SETCRITICAL (Mandatory) Enables or disables the setting of threshold and delta for
critical threshold crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Instance count: 1
ALARMCRITICAL (Optional) Resets the threshold of the specified index for reporting a critical
threshold crossing alarm when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Instance count: 1
ALARMCRITICALDEL
TA
(Optional) Resets the hysteresis value for the threshold to avoid frequent
switching between generation and removal of critical alarm. A threshold
with a delta actually provides two thresholds: an upper threshold and a
lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Instance count: 1
9-16
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Parameter Description
SETMAJOR (Mandatory) Enables or disables the setting of threshold and delta for
major threshold crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Instance count: 1
ALARMMAJOR (Optional) Resets the threshold of the specified index for reporting a major
threshold crossing alarm when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Instance count: 1
ALARMMAJORDELTA (Optional) Resets the hysteresis value for the threshold to avoid frequent
switching between generation and removal of major alarm. A threshold
with a delta actually provides two thresholds: an upper threshold and a
lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Instance count: 1
SETMINOR (Mandatory) Enables or disables the setting of threshold and delta for
minor threshold crossing alarm.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Instance count: 1
ALARMMINOR (Optional) Resets the threshold of the specified index for reporting a minor
threshold crossing alarm when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Instance count: 1
ALARMMINORDELTA (Optional) Resets the hysteresis value for the threshold to avoid frequent
switching between generation and removal of minor alarm. A threshold
with a delta actually provides two thresholds: an upper threshold and a
lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Instance count: 1
SETWARN (Mandatory) Enables or disables the setting of threshold and delta for
threshold crossing warning.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Instance count: 1
9-17
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
ALARMWARN (Optional) Resets the threshold of the specified index for reporting a
threshold crossing warning when the index value is higher or lower than
the threshold.
Value type: Float
Value range: -999999999.999 to 999999999.999
Instance count: 1
ALARMWARNDELTA (Optional) Resets the hysteresis value for the threshold to avoid frequent
switching between generation and removal of threshold crossing warning.
A threshold with a delta actually provides two thresholds: an upper
threshold and a lower threshold.
Value type: Float
Value range: 0 to 999999999.999
Instance count: 1
SUGGESTION (Optional) Modifies the handling suggestion of threshold crossing alarms.
Value type: String
Value range: 1-200
Instance count: 1
SETCONDITION (Optional) Sets whether to use the active condition.
Value type: Enumeration
Value range: Y (Yes) and N (No)
Instance count: 1
CONDITION (Optional) Modifies the active condition index of the QoS task.
Value type: Integer
Instance count: 1
STARTDATE (Mandatory) Resets the start time of the QoS task.
Value type: Date
Instance count: 1
ENDDATE (Mandatory) Resets the end time of the QoS task.
Value type: Date
Instance count: 1
DATEMASK (Optional) Resets the running date of the QoS task.
Value type: String
Value range: 0-31
Instance count: 1
TIMEMASK (Optional) Resets the running period of the QoS task.
Value type: String
Value range: 0-216
Instance count: 1
9-18
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Output Parameter
Parameter Description
RESULT Displays the modification result of the QoS task.
Value type: String
Instance count: 1
Example
To modify the following information of the QoS task with the ID 118:
l Change the end time of the task to “2008-03-22 00:00:00”.l Change the running date and time to: from 09:00:00 to 12:00:00 and from 14:00:00
to 18:00:00 every Monday and Tuesday.l Change the measured object list, including NodeB configuration object 1 of the RNC
radio resource managed object 200;l The alarm thresholds are based on the index 30225–Iub uplink bandwidth utilization.
No index is used as the triggering condition.
Type the command as follows:
SET QOSTASK:TASKID=118,ENDDATE="2008-03-22 00:00:00",DATEMASK="0
110000", TIMEMASK="09:00:00,12:00:00;14:00:00,18:00:00",THRESHOL
D=30225;
9.10 SET QOSTASKSTATUSFunction
Changes the status of QoS task(s).
Syntax
SET QOSTASKSTATUS: TASKID= < BEGINID >-< ENDID >, STATUS= < STATUS >;
Input Parameters
Parameter Description
TASKID (Mandatory) Specifies the ID of the QoS task or ID range of multiple QoS
tasks whose status need to be changed.
Value type: Complex
Instance count: 1-100000
BEGINID (Mandatory) Specifies the begin ID of the range when you want to change
the status of multiple QoS tasks at a time.
Value type: Integer
Instance count: 1
9-19
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
ENDID (Optional) Specifies the end ID of the range when you want to change the
status of multiple QoS tasks at a time.
Value type: Integer
Instance count: 1
STATUS (Mandatory) Changes the status of the QoS task(s).
Value type: Enumeration
Value range: ACTIVE, SUSPENSIVE
Instance count: 1
Output Parameters
Parameter Description
RESULT Displays the modification result of the QoS task(s).
Value type: String
Instance count: 1
Examples
l To activate the QoS task with the ID 125, type the following command:
SET QOSTASKSTATUS:TASKID=125,STATUS=ACTIVE;
l To activate the QoS tasks with the IDs range from 100 to 120, and from 150 to 155,type the following command:
SET QOSTASKSTATUS:TASKID=100-120&150-155,STATUS=ACTIVE;
l To suspend the QoS tasks with the IDs ranging from 100 to 120, and the QoS taskswith the ID 145 and 148, type the following command:
SET QOSTASKSTATUS:TASKID=100-120&145&148,STATUS=SUSPENSIVE;
9.11 SET TIMING TASKFunction
Modifies the settings of a timing task.
Syntax
SET TIMING TASK: POLICYNAME= < POLICYNAME> [ , POLICYSTATUS= < POLICYSTATUS> ] [ , ONLYONCE= < ONLYONCE> ] [ , MMLSTR= < MMLSTR> ] ;
9-20
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Input Parameters
Parameter Description
POLICYNAME (Mandatory) Specifies the name of the new timing task.
Value type: String
Value range: 1-50
Instance count: 1
POLICYSTATUS (Optional) Specifies the initial status of the new timing task.
Value type: Enumeration
Value range: Active, Suspend
Default value: Suspend
Instance count: 1
ONLYONCE Sets the running time of the new task. When this parameter is set, the new
timing task will be run only once when the preset time is up.
Value type: Date
Instance count: 1
ONCEDAY Sets the running day of the new task. When this parameter is set, the new
timing task will be run at the preset time once a day.
Value type: Date
Instance count: 1
WEEK Sets the running day of the new task. This parameter specifies the day of
a week.
Value type: Enumeration
Value range: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday,
Saturday
Default value: Sunday
Instance count: 1
SHORTTIME1 Sets the task-running time.
Value type: Date
Instance count: 1
ONCEWEEK Sets the running day of the new task. When this parameter is set, the new
timing task will be run at the preset time once a week.
Value type: Date
Instance count: 1
DAY1 Sets the running day of the new task. This parameter specifies the day
of a month.
Value type: Enumeration
Value range: 1–32 (32 refers to the last day)
Instance count: 1
SHORTTIME2 Sets the task-running time.
Value type: Date
Instance count: 1
9-21
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
ONCEMONTH Sets the running time of the new task. When this parameter is set, the new
timing task will be run once a month.
Value type: Complex
Instance count: 1
MONTH Sets the running time of the new task. This parameter specifies the
month(s) of a year.
Value type: Enumeration
Value range: 1–12
Instance count: 1
DAY2 Sets the running day of the new task. This parameter specifies the day
of a month.
Value type: Enumeration
Value range: 1–31
Instance count: 1
SHORTTIME3 Sets the task-running time.
Value type: Date
Instance count: 1
MMLSTR (Mandatory) Specifies the MML command(s) for the new timing task.
Value type: String
Value range: 0–1600
Instance count: 1
Output Parameter
Parameter Description
RESULT Returns the modification result of the timing task.
Value type: String
Instance count: 1
Remarkss
l You can only set one of the parameters ONLYONCE, ONCEDAY, ONCEWEEK andONCEMONTH to specify the running time of the timing task, or set none of them.
l The date format of ONLYONECE is “yyyy-mm-dd hour:minute:second”, for example,“2008-10-17 15:27:36”.
l The date format of ONCEDAY is “hour:minute:second”, for example, “04:00:00”.l If you set ONCEWEEK, select a day in the week (Sunday, Monday, Tuesday,
Wednesday, Thursday, Friday, or Saturday), and then set the time, for example,“Monday”-”05:00:00”.
l If you set ONCEMONTH, select a day in the month (1 through 32), and then set thetime, for example, “25”-”06:00:00”. The day “32” indicates the last day of each month.
9-22
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
ExampleTo modify the timing task whose name is “test a”, type the following command:
SET TIMING TASK:POLICYNAME="test a",POLICYSTATUS=Active,ONLYONCE
="2008-10-17 15:27:36";
9.12 SET USERFunctionModifies the information of a user.
Syntax
SET USER: NAME= < NAME> [ , FULLNAME= < FULLNAME> ] [ , DESCRIPTION= <DESCRIPTION> ] [ , PHONENUMBER= < PHONENUMBER> ] [ , EMAILADDRESS= <EMAILADDRESS> ] [ , DEPARTMENT= < DEPARTMENT> ] [ , USERVALIDDAYS= < USERVALIDDAYS> ] [ , PASSWORDVALIDDAYS= < PASSWORDVALIDDAYS> ] [ , PASSWORDKEEPDAYS= < PASSWORDKEEPDAYS> ] [ , USERSTOPACCDAYS= < USERSTOPACCDAYS> ] ;
Input Parameters
Parameter Description
NAME (Mandatory) Specifies the name of the user you want to modify.
Value type: String
Value range: 1-30
Instance count: 1
FULLNAME (Optional) Modifies the full name of the user.
Value type: String
Value range: 0-100
Instance count: 1
DESCRIPTION (Optional) Modifies the description of the user.
Value type: String
Value range: 0-100
Instance count: 1
PHONENUMBER (Optional) Modifies the phone number of the user.
Value type: String
Value range: 0-20
Instance count: 1
EMAILADDRESS (Optional) Modifies the Email address of the user.
Value type: String
Value range: 0-100
Instance count: 1
9-23
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
DEPARTMENT (Optional) Changes the department to which the user belongs.
Value type: String
Value range: 0-50
Instance count: 1
USERVALIDDAYS (Optional) Resets the validity period of the user account. The account never
expires if the number of days that the account is valid (“USERVALIDDAYS”)
is set to 0.
Value type: Integer
Value range: 0-500
Instance count: 1
PASSWORDVALIDDA
YS
(Optional) Resets the validity period of the password. The password never
expires if the parameter value is set to 0.
Value type: Integer
Value range: 0-500
Instance count: 1
PASSWORDKEEPDAY
S
(Optional) Resets the reservation period of the password.
Value type: Integer
Value range: 0-500
Instance count: 1
USERSTOPACCDAYS (Optional) Sets the account suspended duration (days).
Value type: Integer
Value range: 0–500
Instance count: 1
Output Parameter
Parameter Description
RESULT Displays the modification result of the user information.
Value type: String
Instance count: 1
Example
To modify the information of the user “user 1”, type the following command:
SET USER:NAME="1",FULLNAME="1",DESCRIPTION="1",PHONENUMBER="1",E
MAILADDRESS="1",DEPARTMENT="1",USERVALIDDAYS=0,PASSWORDVALIDDAYS
=0,USERSTOPACCDAYS=0;
9-24
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Note:
The input value ‘0’ of USERVALIDDAYS indicates that the account never expires.Similarly, the input value ‘0’ of PASSWORDVALIDDAYS indicates that the passwordnever expires.
9.13 SET USER RIGHTFunction
Sets the right of a user.
Syntax
SET USER RIGHT : NAME= < NAME> [ , ROLEARRAY= < ROLEARRAY> ] [ , ROLESETARRAY= < ROLESETARRAY> ] ;
Input Parameters
Parameter Description
NAME (Mandatory) Specifies the name of the user to which you want to assign
the role or role set.
Value type: String
Value range: 1-30
Instance count: 1
ROLEARRAY (Optional) Specifies the role that you want to assign to the user.
Value type: String
Value range: 0-50
Instance count: 1-100
ROLESETARRAY (Optional) Specifies the role set that you want to assign to the user.
Value type: String
Value range: 0-50
Instance count: 1-100
Output Parameter
Parameter Description
RESULT Displays the setting result of the user.
Value type: String
Instance count: 1
9-25
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Example
To set the right of a user, type the following command:
SET USER RIGHT:NAME="1",ROLEARRAY="0",ROLESETARRAY="0";
9.14 SET USER STATEFunction
Sets the state of a user.
Syntax
SET USER STATE : NAME= < NAME> , DISABLE= < DISABLE> ;
Input Parameters
Parameter Description
NAME (Mandatory) Specifies the name of the user you want to set.
Value type: String
Value range: 1-30
Instance count: 1
DISABLE (Mandatory) Sets the state of the user to ‘disabled’.
Value type: Boolean
Value range: TRUE, FALSE
Instance count: 1
Output Parameter
Parameter Description
RESULT Displays the setting result of the user.
Value type: String
Instance count: 1
Example
To enable the user with the name of “1”, type the following command:
SET USER STATE:NAME="1",DIISABLE=false;
9.15 SET USER VIEW LOG RANGEFunction
Sets the log-viewing authority for a user by specifying role(s) or/and role set(s).
9-26
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Syntax
SET USER VIEW LOG RANGE: NAME= < NAME> [ , LOGROLEARRAY= < LOGROLEARRAY> ] [ , LOGROLESETARRAY= < LOGROLESETARRAY> ] ;
Input Parameters
Parameter Description
NAME (Mandatory) Specifies the name of the user who you want to set the
log-viewing authority for.
Value type: String
Value range: 1-30
Instance count: 1
LOGROLEARRAY (Optional) Specifies the role(s), and the logs of the users assigned with
the role(s) can be viewed.
Value type: String
Value range: 0-50
Instance count: 1-100
LOGROLESETARRAY (Optional) Specifies the role set(s), and the logs of the users assigned
with the role set(s) can be viewed.
Value type: String
Value range: 0-50
Instance count: 1-100
Output Parameter
Parameter Description
RESULT Displays the setting result.
Value type: String
Instance count: 1
Example
To set the range of role and role set for viewing logs of users assigned with the role androle set, type the following command:
SET USER VIEW LOG RANGE:NAME="1",LOGROLEARRAY="0",LOGROLESETARRAY
="0";
9.16 SHOW ROLEFunction
Shows the details of a specific role.
9-27
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Syntax
SHOW ROLE: NAME= < NAME> ;
Input Parameter
Parameter Description
NAME (Mandatory) Specifies the name of the role you want to view.
Value type: String
Value range: 1–50
Instance count: 1
Output Parameter
Parameter Description
NAME Displays the role name.
Value type: String
Instance count: 1
DESCRIPTION Displays the description of the role.
Value type: String
Instance count: 1
LOCKED Displays whether the role is locked.
Value type: Boolean
Instance count: 1
ROLEINFO Displays the role information.
Value type: Complex
Instance count: 1–100
Example
To show a role (NAME= “1”), type the following command:
SHOW ROLE : NAME= "1";
9.17 SHOW ROLE SETFunction
Shows the details of a specific role set.
Syntax
SHOW ROLE SET: NAME= < NAME> ;
9-28
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Input Parameter
Parameter Description
NAME (Mandatory) Specifies the name of the role set you want to view.
Value type: String
Value range: 1–50
Instance count: 1
Output Parameter
Parameter Description
NAME Displays the role set name.
Value type: String
Instance count: 1
DESCRIPTION Displays the description of the role set.
Value type: String
Instance count: 1
LOCKED Displays whether the role set is locked.
Value type: Boolean
Instance count: 1
ROLESETINFO Displays the role set information.
Value type: Complex
Instance count: 1–100
Example
To show a role set (NAME= “1”), type the following command:
SHOW ROLE SET: NAME= "1";
9.18 SHOW ALARM DETAILFunction
Shows the details of a current alarm.
Syntax
SHOW ALARM DETAIL: ID= < ID> ;
9-29
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Input Parameter
Parameter Description
ID (Mandatory) Specifies the ID of the alarm you want to view. You can use
the SHOW CURRENTALARM command to get the ID of an alarm from
the returned information.
Value type: Integer
Value range: 0-9223372036854775807
Instance count: 1
Output Parameter
Parameter Description
INFO Displays the details of the alarm, including the system type, original
alarm ID, alarm ID, occurrence position, alarm type, cause code, code
information, occurrence time, severity, additional information, and
acknowledgement state.
Value type: Complex
Instance count: 1
Example
To show the details of the alarm with the ID 1169630078865, type the following command:
SHOW ALARM DETAIL:ID=1169630078865;
9.19 SHOW ALL ROLESFunction
Queries the information of all roles.
Note:
This command supports the query of up to 1000 roles.
Syntax
SHOW ALL ROLES;
Input Parameter
None
9-30
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Output Parameter
Parameter Description
ROLEINFO Displays the information of all roles, including the role name, description,
and locking status.
Value type: Complex
Instance count: 1-1000
Example
To show the information of all roles in the EMS, type the following command:
SHOW ALL ROLES;
9.20 SHOW ALL ROLE SETSFunction
Queries the information of all role sets.
Note:
This command supports the query of up to 1000 role sets.
Syntax
SHOW ALL ROLE SETS;
Input Parameter
None
Output Parameter
Parameter Description
ROLESETINFO Displays the information of all role sets, including the name of role set,
description, and the locking status.
Value type: Complex
Instance count: 1-1000
Example
To show the information of all role sets in the EMS, type the following command:
SHOW ALL ROLE SETS;
9-31
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
9.21 SHOW ALL SESSIONSFunction
Shows the information of all sessions on the server.
Note:
This command supports the query of up to 1000 sessions.
Syntax
SHOW ALL SESSIONS;
Input Parameter
None
Output Parameter
Parameter Description
SESSIONINFO Displays the information of all sessions, including session ID, user name,
the IP address of related client, connection mode of the client, login time,
and idle time(unit: minute).
Value type: Complex
Instance count: 1-1000
Example
To show the information of all sessions on the server, type the following command:
SHOW ALL SESSIONS;
9.22 SHOW ALL TASKFunction
Queries the information of all periodic tasks in the EMS.
Syntax
SHOW ALL TASK: [ POLICYNAME= < POLICYNAME> ] ;
9-32
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Input Parameter
Parameter Description
POLICYNAME (Optional) Specifies the name of the periodic task you want to query.
Value type: String
Instance count: 1
POLICYSTATUS (Optional) Selects to query active or suspended periodic tasks.
Value type: Enumeration
Value range: Suspend, and Active
Instance count: 1
Output Parameter
Parameter Description
INFO Displays the information of all periodic tasks, including task name and
task info.
Value type: Complex
Instance count: 1-1000
Remarks
You can only set one of the two parameters (POLICYNAME and POLICYSTATUS) at atime in this command. Or set neither of them to query all periodic tasks in the EMS.
Example
To view the information of the periodic task with the name of “aaa”, type the followingcommand:
SHOW ALL TASK:POLICYNAME=”aaa”;
9.23 SHOW ALL USERSFunction
Queries the information of all users.
Note:
This command supports the query of at most 1000 users.
Syntax
SHOW ALL USERS;
9-33
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Input Parameter
None
Output Parameter
Parameter Description
USERINFO Displays the information of all users, including user name, description,
and status (enabled or disabled).
Value type: Complex
Instance count: 1-1000
Example
To show the information of all users of the EMS, type the following command:
SHOW ALL USERS;
9.24 SHOW AMOFunction
Shows the names of Access Managed Objects (AMOs) that are connected to the EMSserver and have been started.
Syntax
SHOW AMO;
Input Parameter
None
Output Parameter
Parameter Description
AMONAME Displays the names of all started AMOs connected to the server.
Value type: String
Instance count: 1-100
Example
To show all the started AMOs connected to the EMS server, type the following command:
SHOW AMO;
9-34
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
9.25 SHOW COMMAND LOGFunction
Queries the operation logs in the EMS.
Syntax
SHOWCOMMANDLOG: [ USERNAME= < USERNAME> ] [ , IP= < IP> ] [ , LOGSTARTDATE_FROM= < LOGSTARTDATE_FROM> ] [ , LOGSTARTDATE_TO= < LOGSTARTDATE_TO> ] [ , CMDCODE= < CMDCODE> ] [ , CONMODE= < CONMODE> ] [ , ISSUCCESS=< ISSUCCESS> ] [ , LOGRANK= < LOGRANK> ] ;
Input Parameters
Parameter Description
USERNAME (Optional) Specifies the name of the user for querying the operation logs
related to this user.
Value type: String
Value range: 0-100
Instance count: 1-50
IP (Optional) Specifies the IP address of the client for querying the operation
logs related to this client.
Value type: String
Value range: 0-60
Instance count: 1-100
LOGSTARTDATE_FR
OM
(Optional) Sets the start time of a period for querying the operation logs
during this period.
Value type: Date
Instance count: 1
LOGSTARTDATE_TO (Optional) Sets the end time of a period for querying the operation logs
during this period.
Value type: Date
Instance count: 1
CMDCODE (Optional) Specifies the command code for querying related operation logs.
Value type: String
Value range: 0-20
Instance count: 1-100
CONMODE (Optional) Specifies the connection mode of the client.
Value type: Enumeration
Value range: GUI, TELNET, NDA (North Access), SSH
Instance count: 1-4
9-35
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
ISSUCCESS (Optional) Selects to query the operation logs related to successful, failed,
or unfinished operations.
Value type: Enumeration
Value range: 0, 1, and 2
l 0: success
l 1: failure
l 2: unfinished
Instance count: 1-3
LOGRANK (Optional) Specifies the rank of the operation logs you want to query.
Value type: Enumeration
Value range: 1, 2, 3, and 4
l Rank 1: Very important
l Rank 2: Important
l Rank 3: Notice
l Rank 4: Normal
Instance count: 1-4
Output Parameter
Parameter Description
LOGRANK Displays the log rank.
Value type: Enumeration
Instance count: 1
USERNAME Displays the user name
Value type: String
Instance count: 1
CMDCODE Displays the command.
Value type: String
Instance count: 1
OPSET Displays the operation.
Value type: String
Instance count: 1
ISSUCCEED Displays the operation result.
Value type: Enumeration
Instance count: 1
FAILREASON Displays the reason for failure.
Value type: String
Instance count: 1
CLIENTIP Displays the host address.
Value type: String
Instance count: 1
9-36
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Parameter Description
CONMODE Displays the connection mode.
Value type: Enumeration
Instance count: 1
STARTTIME Displays the operation start time.
Value type: String
Instance count: 1
OPRES Displays the operated object.
Value type: String
Instance count: 1
RESOURCEIP Displays the NE address.
Value type: String
Instance count: 1
LOG Displays the log.
Value type: Complex
Instance count: 1–10000
Example
To show the command logs of the user “a” on the server 10.75.64.44, type the followingcommand:
SHOW COMMAND LOG:USERNAME="a",IP="10.75.64.44",LOGSTARTDATE_FROM
="2009-12-23 16:22:31",LOGSTARTDATE_TO="2009-12-24 16:22:31",CMDC
ODE="1012",CONMODE="GUI",ISSUCCESS="0",LOGRANK="1";
9.26 SHOW CPU RATIOFunction
Shows the CPU usage of the server.
Syntax
SHOW CPU RATIO: IP= < IP> ;
Input Parameter
Parameter Description
IP (Optional) Specifies the IP address of the server.
Value type: Address
Instance count: 1
9-37
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Output Parameter
Parameter Description
CPURATION Displays the CPU usage in percentage.
Value type: String
Instance count: 1
Example
To show the CPU usage of the server 10.75.72.153, type the following command:
SHOW CPU RATIO:IP=10.75.72.153;
9.27 SHOW CURRENT ALARMFunction
Queries current alarms.
Note:
This command supports the query of at most 500 current alarm records.
Syntax
SHOW CURRENT ALARM: [ ALARMTYPE= < ALARMTYPE> ] [ , SEVERITY= < SEVERITY> ] [ , ALARMRAISEBEGINTIME= < ALARMRAISEBEGINTIME> ] [ , ALARMRAISEENDTIME= < ALARMRAISEENDTIME> ] [ , POSITION= < POSITION> ] [ , PROBABLECAUSECODE= < PROBABLECAUSECODECODE> ] [ , ACKSTATE= < ACKSTATE> ] [ , ACKBEGINTIME= < ACKBEGINTIME> ] [ , ACKENDTIME= < ACKENDTIME> ] [ , ISVISIBLE= <ISVISIBLE> ] [ , SYSTEMTYPE= < SYSTEMTYPE> ] ;
Input Parameters
Parameter Description
ALARMTYPE (Optional) Specifies the type of current alarms that you want to query.
Value type: Enumeration
Value range: COMMUNICATION_ALARM, PROCESSING_ER-
ROR_ALARM, QUALITY_OF_SERVICE_ALARM, EQUIPMENT_ALARM,
ENVIRONMENTAL_ALARM, OMC_ALARM, INTEGRITY_VIOLATION,
OPERATIONAL_VIOLATION, PHYSICAL_VIOLATION, SECURITY_VIO-
LATION, and TIME_DOMAIN_VIOLATION
Instance count: 1-11
9-38
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Parameter Description
SEVERITY (Optional) Specifies the severity of current alarms that you want to query.
Value type: Enumeration
Value range: SEVERITY_CRITICAL, SEVERITY_MAJOR,
SEVERITY_MINOR, and SEVERITY_WARNING
Instance count: 1
ALARMRAISEBEGINT
IME
(Optional) Sets the start time of a period for querying the current alarms
occurring in this period. The begin time must be set if the end time is set.
Value type: Date
Instance count: 1
ALARMRAISEENDTIM
E
(Optional) Sets the end time of a period for querying the current alarms
occurring in this period.
Value type: Date
Instance count: 1
POSITION (Optional) Specifies the occurrence position of the current alarms you want
to query. Use the symbol "," to separate the fields while typing the string
of a specific position, which may include the information of subnetwork,
office, and module.
Value type: String
Value range: 0-10000
Instance count: 1-10
ALARMCODE (Optional) Specifies the alarm code for querying corresponding current
alarms. Be sure to set the system type if you want to use the alarm code
as a query condition. If you do not set the system type, this parameter is
invalid.
Value type: Integer
Value range: 0-9223372036854775807
Instance count: 1-100
ACKSTATE (Optional) Selects to query unacknowledged current alarms only,
acknowledged current alarms only, or all current alarms.
Value type: Enumeration
Value range: ALL, UNACKNOWLEDGE, and ACKNOWLEDGE
Instance count: 1
ACKBEGINTIME (Optional) Sets the start time of the period for querying the acknowledged
or unacknowledged current alarms that have been acknowledged or
unacknowledged during this period.
Value type: Date
Instance count: 1
9-39
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
ACKENDTIME (Optional) Sets the end time of the period for querying the acknowledged
or unacknowledged current alarms that have been acknowledged or
unacknowledged during this period.
Value type: Date
Instance count: 1
ISVISIBLE (Optional) Specifies the visibility of the current alarms you want to query.
Value type: Boolean
Value range: TRUE, FALSE
Instance count: 1
SYSTEMTYPE (Optional) Specifies the type of the system where the current alarms you
want to query were raised. Be sure that the value of this parameter is
greater than zero.
Value type: Integer
Value range: 0-32767
Instance count: 1
Output Parameter
Parameter Description
INFO Displays the information of all current alarms, including the system type,
original alarm ID, alarm ID, alarm type, alarm code, alarm description,
severity, occurrence position, occurrence time, additional information, and
acknowledgement status.
Value type: Complex
Instance count: 1-100000
Remarks
You can only query “CLEARED” (Severity) current alarms when the query mode supportsthe query of cleared alarms.
Example
To show the current major alarms of OMS type during the period from 2009-12-16 10:31:34to 2009-12-19 10:31:34, type the following command:
SHOW CURRENT ALARM:ALARMTYPE=”OMS_ALARM”,SEVERITY=SEVERITY_MAJO
R,ALARMRAISEBEGINTIME="2009-12-16 10:31:34",ALARMRAISEENDTIME="20
09-12-19 10:31:34",POSITION="IpNode=1008",PROBABLECAUSECODE="1011
",ACKSTATE=UNACKNOWLEDGE,ISVISIBLE=TRUE,SYSTEMTYPE=6;
9-40
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
9.28 SHOW DB RATIOFunctionShows the usage of the Oracle database.
Syntax
SHOW DB RATIO;
Input Parameter
Parameter Description
DBINFO (Optional) Specifies the information of the database instance you want
to view.
Value type: Complex
Instance count: 1
IP (Mandatory) Specifies the IP address of the database server.
Value type: Address
Instance count: 1
SID (Mandatory) Specifies the SID of the database.
Value type: String
Value range: 0–1000
Instance count: 1
Output Parameter
Parameter Description
SPACE Displays the usage information of the database.
Value type: String
Instance count: 1-10000
ExampleTo show the usage of the database, type the following command:
SHOW DB RATIO;
9.29 SHOW DEPARTMENTFunctionShows the information of a department.
Syntax
SHOW DEPARTMENT: NAME= < NAME> ;
9-41
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Input Parameter
Parameter Description
NAME (Mandatory) Specifies the name of the department you want to view.
Value type: String
Value range: 1-50
Instance count: 1
Output Parameter
Parameter Description
DEPARTMENTINFO Displays the information of the department, including its name, description,
and superior department.
Value type: Complex
Instance count: 1
Example
To show the information of the department whose name is “department 1”, type thefollowing command:
SHOW DEPARTMENT:NAME="1";
9.30 SHOW DIRECTORY MONITOR TASK NAMEFunction
Shows the names of directory monitoring tasks defined in the EMS.
Syntax
SHOW DIRECTORY MONITOR TASK NAME;
Input Parameter
None
Output Parameter
Parameter Description
DIRECTORYTASKNA
ME
Displays the names of all directory monitoring tasks in the system,
Value type: Complex
Instance count: 1-50
TASKNAME Returns the director-monitoring task names.
Value type: String
Instance count: 1
9-42
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Example
To show the names of all directory monitoring tasks in the system, type the followingcommand:
SHOW DIRECTORY MONITOR TASK NAME;
9.31 SHOW HD USAGEFunction
Shows the hard disk usage on the server.
Syntax
SHOW HD USAGE: [ : IP= “IP”, ] [ DISK= “DISK”] ;
Input Parameters
Parameter Description
IP (Optional) Specifies the IP address of the server.
Value type: Address
Instance count: 1
DISK (Optional) Specifies the disk descriptor.
Value type: String
Value range: 1-100
Instance count: 1
Output Parameter
Parameter Description
HDINFO Displays the information of the hard disk, including
l DISK: the disk descriptor
l DISSIZE: the size of the disk
l USEDSIZE: the size of the used disk
l UNUSED: the size of the free disk space
l PER: the disk usage shown in percentage
l HANG: the mount point
Value type: Complex
Instance count: 1-20
Remarkss
The format of disk descriptor in a Solaris operating system is /dev/sda1; while the formatin a Windows operating system is c:/.
9-43
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Example
To show the usage information of the hard disk in the server, type the following command:
SHOW HD USAGE;
9.32 SHOW HISTORY ALARMFunction
Query history alarms.
Note:
This command supports the query of at most 500 history alarm records.
Syntax
SHOW HISTORY ALARM: [ ALARMTYPE= < ALARMTYPE> ] [ , SEVERITY= < SEVERITY> ] [ , ALARMRAISEBEGINTIME= < ALARMRAISEBEGINTIME> ] [ , ALARMRAISEENDTIME= < ALARMRAISEENDTIME> ] [ , CLEARBEGINTIME= < CLEARBEGINTIME> ] [ ,CLEARENDTIME= < CLEARENDTIME> ] [ , POSITION= < POSITION> ] [ , PROBABLECAUSECODE= < PROBABLECAUSECODE> ] [ , ACKSTATE= < ACKSTATE> ] [ , ACKBEGINTIME= < ACKBEGINTIME> ] [ , ACKENDTIME= < ACKENDTIME> ] [ , SYSTEMTYPE=< SYSTEMTYPE> ] ;
Input Parameters
Parameter Description
ALARMTYPE (Optional) Specifies the type of history alarms that you want to query.
Value type: Enumeration
Value range: COMMUNICATION_ALARM, PROCESSING_ER-
ROR_ALARM, QUALITY_OF_SERVICE_ALARM, EQUIPMENT_ALARM,
ENVIRONMENTAL_ALARM, OMC_ALARM, INTEGRITY_VIOLATION,
OPERATIONAL_VIOLATION, PHYSICAL_VIOLATION, SECURITY_VIO-
LATION, and TIME_DOMAIN_VIOLATION
Instance count: 1-11
SEVERITY (Optional) Specifies the severity of history alarms that you want to query.
Value type: Enumeration
Value range: SEVERITY_CRITICAL, SEVERITY_MAJOR,
SEVERITY_MINOR, and SEVERITY_WARNING
Instance count: 1
9-44
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Parameter Description
ALARMRAISEBEGINT
IME
(Optional) Sets the start time of a period for querying the history alarms
occurring in this period. The begin time must be set if the end time is set.
Value type: Date
Instance count: 1
ALARMRAISEENDTIM
E
(Optional) Sets the end time of a period for querying the history alarms
occurring in this period.
Value type: Date
Instance count: 1
CLEARBEGINTIME (Optional) Sets the start time of a period for querying the history alarms
that have been cleared in this period.
Value type: Date
Instance count: 1
CLEARENDTIME (Optional) Sets the end time of a period for querying the history alarms that
have been cleared in this period.
Value type: Date
Instance count: 1
POSITION (Optional) Specifies the occurrence position of the history alarms you want
to query. Use the symbol "," to separate the fields while typing the string
of a specific position, which may include the information of subnetwork,
office, and module.
Value type: String
Value range: 0-10000
Instance count: 1-10
ALARMCODE (Optional) Specifies the cause code for querying corresponding history
alarms. Be sure to set the system type if you want to use the cause code
as a query condition. If you do not set the system type, this parameter is
invalid.
Value type: Integer
Value range: 0-9223372036854775807
Instance count: 1-100
ACKSTATE (Optional) Selects to query unacknowledged history alarms only,
acknowledged history alarms only, or all history alarms.
Value type: Enumeration
Value range: ALL, UNACKNOWLEDGE, and ACKNOWLEDGE
Instance count: 1
ACKBEGINTIME (Optional) Sets the start time of the period for querying the acknowledged
or unacknowledged history alarms that have been acknowledged or
unacknowledged during this period.
Value type: Date
Instance count: 1
9-45
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Parameter Description
ACKENDTIME (Optional) Sets the end time of the period for querying the acknowledged
or unacknowledged current alarms that have been acknowledged or
unacknowledged during this period.
Value type: Date
Instance count: 1
SYSTEMTYPE (Optional) Specifies the type of the system where the history alarms you
want to query were raised. Be sure that the value of this parameter is
greater than zero.
Value type: Integer
Value range: 0-32767
Instance count: 1
Output Parameters
Parameter Description
INFO Displays the information of the history alarms you want, including the
system type, original alarm ID, alarm ID, alarm type, probable cause code,
description, severity, occurrence position, occurrence time, removal time,
additional information, begin time and end time of the query.
Value type: Complex
Instance count: 1-1000000
DATERANGE Displays the time period during which the history alarms have been
removed.
Value type: Complex
Instance count: 1
Example
To show specific history alarms, type the following command:
SHOW HISTORY ALARM:ALARMTYPE="OMS_ALARM",SEVERITY=SEVERITY_CRITIC
AL,ALARMRAISEBEGINTIME="2009-12-14 16:13:23",ALARMRAISEENDTIME="2
009-12-21 16:13:23",CLEARBEGINTIME="2009-12-14 16:13:23",CLEAREND
TIME="2009-12-21 16:13:23",POSITION="IpNode=1003",PROBABLECAUSECO
DE="1011",ACKSTATE=ACKNOWLEDGE,SYSTEMTYPE=6;
9.33 SHOW INDEXFunction
Shows the information of a performance index.
9-46
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Syntax
SHOW INDEX: INDEXID= INDEXID;
Input Parameter
Parameter Description
INDEXID (Mandatory) Specifies the ID of the performance task you want to view.
Value type: String
Value range: 1-100
Instance count: 1
Output Parameter
Parameter Description
DETAIL Displays the details of the performance index, including the index ID, index
name, index description, NE type, measure object type, formula code,
formula name, index attribute (system index or not), value type, exception
value, index type, direction, settings of critical, major, minor, and warning
alarms, and Remarks.
Value type: Complex
Instance count: 1
Example
To view the details of the performance index whose ID is 30000, type the followingcommand:
SHOW INDEX:INDEXID=30000;
9.34 SHOW MEASTASKFunction
Shows the information of a measurement task.
Syntax
SHOW MEASTASK: TASKID= < TASKID >;
Input Parameter
Parameter Description
TASKID (Mandatory) Specifies the ID of the measurement task you want to view.
Value type: Integer
Instance count: 1
9-47
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Output Parameter
Parameter Description
DETAIL Displays the details of the measurement task, including
l TASKID: the task ID
l TASKNAME: the task name
l NODEID: ID of the server where the task is created
l CREATOR: the creator
l CREATETIME: the task creating time
l MODIFYTIME: modification time
l STATUS: the task status
l GRAN: the collection granularity
l BEGINDATE: the task start date
l ENDDATE: the task end date
l DATEMASK: the running date
l TIMEMASK: the running time
l MEASOBJTYPE: the measured object type
l MEASTYPE: the measurement type
l NETYPE: the NE type
l LOCTYPE: the location type
l NELOC: the NE location
Value type: Complex
Instance count: 1
Example
To show the details of the measurement task whose ID is 125, type the following command:
SHOW MEASTASK:TASKID=125;
9.35 SHOW NETWORK DATAFunction
Shows the information of data packets sent and received by a network adapter.
Syntax
SHOW NETWORK DATA: [ PERIOD= < PERIOD> ] [ , TIMES= < TIMES> ] IP= < IP> ;
9-48
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Input Parameters
Parameter Description
PERIOD (Optional) Specifies the sampling period (unit: second) for viewing the
data packets.
Value type: Integer
Value range: 2-60
Instance count: 1
TIMES (Optional) Specifies the number of sampling times.
Value type: Integer
Value range: 1-10
Instance count: 1
IP (Optional) Specifies the IP address of the server.
Value type: Address
Instance count: 1
Output Parameter
Parameter Description
NETWORKINFO Displays the information of data packets, including the sent error packets,
received error packets, sent data packets, received data packets, and
the name of the network adapter.
Value type: Complex
Instance count: 1-10
Remarks
The first sampling cycle is PERIOD*2 because the period of sending this command is 2seconds.
Example
To show the network information of the server 10.75.72.153, type the following command:
SHOW NETWORK DATA:PERIOD=2,TIMES=1,IP=10.75.72.153;
9.36 SHOW NETWORK PORTFunction
Shows the information of the port used by the EMS.
Syntax
SHOW NETWORK PORT: IP= < IP> ;
9-49
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Input Parameter
Parameter Description
IP (Optional) Specifies the IP address of the EMS server.
Value type: Address
Instance count: 1
Output Parameter
Parameter Description
PORTINFO Displays the information of the network port, including the port number, port
description, port state, the process occupying the port, and the description
of the process.
Value type: Complex
Instance count: 1-100
Example
To show the network port information of a server (10.75.72.153), type the followingcommand:
SHOW NETWORK PORT:IP=10.75.72.153;
9.37 SHOW QOSTASKFunction
Shows the details of a QoS task.
Format
SHOW QOSTASK: TASKID= <TASKID>;
Input Parameter
Parameter Description
TASKID (Mandatory) Specifies the ID of the QoS task you want to view.
Value type: Integer
Instance count: 1
9-50
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Output Parameters
Parameter Description
DETAIL Displays the details of the QoS task, including the task ID, task name, the
ID of the server where the QoS task was created, creator, creation time,
modification time, status, granularity, start date, end date, running date,
running time, measure object type, NE type, task type, monitoring type,
NE location, measure object list, condition, thresholds, index ID, index
name, direction, value type, the settings of critical, major, minor, warning
alarms, and the handling suggestion.
Value type: Complex
Instance count: 1
THRESHOLD Displays the thresholds set in the QoS task.
Value type: Complex
Instance count: 1-100000
Example
To view the details of a QoS task whose ID is 125, type the following command:
SHOW QOSTASK:TASKID=125;
9.38 SHOW RAM USAGEFunction
Shows the RAM utilization of the server.
Syntax
SHOW RAM USAGE: IP= < IP> ;
Input Parameter
Parameter Description
IP (Optional) Specifies the IP address of the server.
Value type: Address
Instance count: 1
9-51
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Output Parameter
Parameter Description
MEM Displays the utilization information of the RAM, including the size of the
available memory, the physical memory of the system, the size of the swap
space, and the size of the used space.
Value type: Complex
Instance count: 1
Example
To show the RAM utilization of the server 10.75.72.153, type the following command:
SHOW RAM USAGE:IP=10.75.72.153;
9.39 SHOW SECURITY LOGFunction
Shows the information of security logs.
Syntax
SHOW SECURITY LOG: [ USERNAME= < USERNAME> ] [ , IP= < IP> ] [ , LOGSTARTDATE_FROM= < LOGSTARTDATE_FROM> ] [ , LOGSTARTDATE_TO= < LOGSTARTDATE_TO> ] [ , CONMODE= < CONMODE> ] ;
Input Parameters
Parameter Description
USERNAME (Optional) Specifies the name of the user for viewing the security logs
related to the user.
Value type: String
Value range: 0-100
Instance count: 1-50
IP (Optional) Specifies the IP address of the client for viewing the information
of security logs related to the client.
Value type: String
Value range: 0-60
Instance count: 1-100
LOGSTARTDATE_FR
OM
(Optional) Sets the start time of the period for viewing the information of
security logs during this period.
Value type: Date
Instance count: 1
9-52
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Parameter Description
LOGSTARTDATE_TO (Optional) Sets the end time of the period for viewing the information of
security logs during this period.
Value type: Date
Instance count: 1
CONMODE (Optional) Specifies the connection mode for querying corresponding
security logs.
Value type: Enumeration
Value range: GUI, TELNET, NDA and SSH
Instance count: 1-4
Output Parameter
Parameter Description
LOG Displays the information of the first 500 security logs in the query result,
including the user name, the IP address of the client, the start time, the end
time, and the connection mode of the client.
Value type: Complex
Instance count: 1-10000
Example
To view the information of security logs during the period from 2009-12-24 16:40:36 to2009-12-25 16:40:37 on the host 10.75.64.44, type the following command:
SHOW SECURITY LOG:USERNAME="a",IP="10.75.64.44",LOGSTARTDATE_FROM
="2009-12-24 16:40:36",LOGSTARTDATE_TO="2009-12-25 16:40:37",CON
MODE="TELNET";
9.40 SHOW SYSTEM LOGFunction
Shows the information of system logs.
Syntax
SHOW SYSTEMLOG: [ IP= < IP> ] [ , LOGSTARTDATE_FROM= < LOGSTARTDATE_FROM> ] [ , LOGSTARTDATE_TO= < LOGSTARTDATE_TO> ] [ , LOGRANK= < LOGRANK>] [ , LOGSOURCE= < LOGSOURCE> ] [ , TASKNAME= < TASKNAME> ] ;
9-53
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
Input Parameters
Parameter Description
IP (Optional) Specifies the IP address of the host for viewing the information
of system logs on the host.
Value type: String
Value range: 0-60
Instance count: 1-100
LOGRANK (Optional) Specifies the rank of system logs you want to view.
Value type: Enumeration
Value range: 1, 2, 3, 4, 5, 6
l Rank 1: Emergency
l Rank 2: Alert
l Rank 3: Error
l Rank 4: Warning
l Rank 5: Notification
l Rank 6: Information
Instance count: 1-6
LOGSTARTDATE_FR
OM
(Optional) Sets the start time of the period for viewing the information of
system logs during this period.
Value type: Date
Instance count: 1
LOGSTARTDATE_TO (Optional) Sets the end time of the period for viewing the information of
system logs during this period.
Value type: Date
Instance count: 1
LOGSOURCE (Optional) Specifies the source of the system logs you want to view.
Value type: String
Value range: 0-100
Instance count: 1-100
TASKNAME (Optional) Specifies the name of the system logs you want to view.
Value type: String
Value range: 0-100
Instance count: 1-100
Output Parameter
Parameter Description
LOG Displays the information of the first 500 system logs in the query result,
including the log rank, log name, log source, host name, start time, end
time, and description.
Value type: Complex
Instance count: 1-10000
9-54
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
Chapter 9 S
Example
To view the information of system logs (rank 6) during the period from 2009-12-24 16:41:13to 2009-12-25 16:41:13 on the host 10.75.64.44, type the following command:
SHOW SYSTEM LOG:IP="10.75.64.44",LOGSTARTDATE_FROM="2009-12-24
16:41:13",LOGSTARTDATE_TO="2009-12-25 16:41:13",LOGRANK="6",LOGSO
URCE="logmodule";
9.41 SHOW USERFunction
Shows the information of a user.
Syntax
SHOW USER : NAME= < NAME> ;
Input Parameter
Parameter Description
NAME (Mandatory) Specifies the name of the user you want to view.
Value type: String
Value range: 1-30
Instance count: 1
Output Parameter
Parameter Description
USERINFO Displays the information of the user, including the name, creator, full name,
description, phone number, Email address, department, valid period of the
user account, validity period of the password, the reservation period of
the password, initial status of the user account, assigned role(s) and role
set(s), in the blacklist or not, account stop days, and related roles/role
sets for viewing logs.
Value type: Complex
Instance count: 1
Example
To view the information of the user whose name is “user 1”, type the following command:
SHOW USER:NAME="user 1";
9-55
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential
NetNumen M31(RAN) MML Command Reference
9.42 SYNCH MEASTASKFunction
Synchronises a measurement task from the EMS to the corresponding NEs.
Syntax
SYNCH MEASTASK: [ TASKID= < TASKID> ] ;
Input Parameter
Parameter Description
TASKID (Mandatory) Specifies the ID of the measurement task you want to
synchronise to the corresponding NE(s).
Value type: Integer
Instance count: 1
Output Parameter
Parameter Description
RESULT Displays the synchronisation result.
Value type: Complex
Instance count: 1
Example
To synchronise the measurement task with the ID of 100 to the corresponding NE(s), typethe following command:
SYNCH MEASTASK:TASKID=100;
9-56
SJ-20101227165724-015|2011-05-06(R1.1) ZTE Proprietary and Confidential