SJ-20101227165724-015-NetNumen M31 (RAN) (V12.10.032) MML Command Reference

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: [email protected]

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,



Chapter 3, D Introduces the MML commands which start with the letter D,



I

Chapter Summary

Chapter 4, E Introduces the MML commands which start with the letter E,



Chapter 5, G Introduces the MML commands which start with the letter G,



Chapter 6, H Introduces the MML commands which start with the letter H,



Chapter 7, Q Introduces the MML commands which start with the letter Q,



Chapter 8, R Introduces the MML commands which start with the letter R,



Chapter 9, S Introduces the MML commands which start with the letter S,



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


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


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


Chapter 1 A


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 range: PI, KPI, and SPI

Instance count: 1

DIRECTION (Optional) Sets the direction attribute of threshold crossing alarms based

on the new index.


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 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




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.



Default value: Y

Instance count: 1

ALARMMAJOR (Optional) Sets the threshold of the new index for reporting a major


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


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.



Default value: Y

Instance count: 1

1-4


Chapter 1 A


ALARMMINOR (Optional) Sets the threshold of the new index for reporting a minor


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


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.



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




INDEXDESC (Optional) Adds a description of the new index.

Value type: String

Value range: 1-100

Instance count: 1

Output Parameter


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


Chapter 1 A

Input Parameters


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 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


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




STATUS (Optional) Specifies the initial status of the new measurement task.


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


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


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


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 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




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


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


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


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


Instance count: 1

1-11




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


Instance count: 1

THRESHOLD (Mandatory) Sets the alarm threshold for the new QoS task.

Value type: Complex


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 range:







lower threshold.

Instance count: 1

SETCRITICAL (Mandatory) Enables the setting of threshold and delta for critical

threshold crossing alarm.



Default value: Y

Instance count: 1

ALARMCRITICAL (Optional) Sets the threshold of the specified index for reporting a critical


the threshold.

Value type: Float

Value range: -999999999.999 to 999999999.999

Default value: 0.0

Instance count: 1

1-12


Chapter 1 A


ALARMCRITICALDELTA (Optional) Sets a hysteresis value for the threshold to avoid frequent



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.



Default value: Y

Instance count: 1

ALARMMAJOR (Optional) Sets the threshold of the specified index for reporting a major


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



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.



Default value: Y

Instance count: 1

1-13




ALARMMINOR (Optional) Sets the threshold of the specified index for reporting a minor


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



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.



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




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


Chapter 1 A


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 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



Output Parameter


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.


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


Chapter 1 A

Syntax

ADD TIMING TASK: POLICYNAME= < POLICYNAME> , POLICYSTATUS= < POLICYSTATUS> , ONLYONCE= < ONLYONCE> , MMLSTR= < MMLSTR> ;

Input Parameters


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.




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 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




DAY1 Sets the running day of the new task. This parameter specifies the day

of a month.


Value range: 1–32 (32 refers to the last day)

Instance count: 1


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 range: 1–12

Instance count: 1


of a month.


Value range: 1–31

Instance count: 1


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


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


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


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




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


Chapter 1 A


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


ROLESETARRAY (Optional) Assigns role set(s) to the new user.

Value type: String

Value range: 0-50


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


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


Output Parameter


RESULT Returns the result of creating the new user.

Value type: String

Instance count: 1

1-21



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

[email protected]",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


ID (Mandatory) Specifies the alarm ID.

Value type: Integer

Instance count: 1–255

Output Parameters


INFO Returns alarm clearing information.

Value type: Complex


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


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


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



Output Parameter


INFO Displays the alarm synchronization information.

Value type: Complex


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



This page intentionally left blank.

1-24


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


EXECRESULT Returns the result of backing up and deleting alarm data.

Value type: String


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



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


EXECRESULT Returns the result of backing up and deleting log data.

Value type: String


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


EXECRESULT Returns the result of backing up the basic data of the database.

Value type: String


2-2


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


EXECRESULT Returns the result of backing up files.

Value type: String


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



Output Parameter


EXECRESULT Returns the result of backing up the whole database structure.

Value type: String


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


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


NAME (Mandatory) Types the name of the department you want to delete.

Value type: String

Value range: 1-50

Instance count: 1

Output Parameter


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



3.2 DEL INDEXFunction

Deletes a user-defined performance index.

Syntax

DEL INDEX: INDEXID= < INDEXID> ;

Input Parameter


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


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


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


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


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


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



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


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


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


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


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


SESSIONID (Mandatory) Types the ID of the session that you want to delete.

Value type: Integer


Instance count: 1

Output Parameter


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



Input Parameter


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


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


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


RESULT Returns the result of deleting the user.

Value type: String

Instance count: 1

3-6


Chapter 3 D

Example

To delete a user whose name is “user 1”, type the following command:

DEL USER:NAME="user 1";

3-7




3-8


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


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


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



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


USERNAME (Optional) Types the name of the user who performs the operation.

Value type: String



IP (Optional) Sets the IP address of the host.

Value type: String

Value range: 0–60


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


CONMODE (Optional) Sets the connection mode.


Value range: GUI, TELNET, SSH, NDA (North Access), ERT


ISSUCCESS (Optional) Sets the operation result.


Value range: 0 (succeeded), 1 (failed), 2 (not finished)


4-2


Chapter 4 E


LOGRANK (Optional) Sets the log rank.


Value range: 1 (very important), 2 (important), 3 (notice), 4 (normal)


FILEPATH (Mandatory) Sets the log file path.

Value type: String


Instance count: 1

FILETYPE (Optional) Sets the log file path.


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


Default value: 10000

Instance count: 1

Output Parameter


FILES Returns the name of the file where the log records are exported.

Value type: String


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



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


USERNAME (Optional) Types the name of the user who performs the operation.

Value type: String



IP (Optional) Sets the host IP address.

Value type: String

Value range: 0–60


LOGSTART-

DATE_FROM


Value type: Date

Instance count: 1


Value type: Date

Instance count: 1

CONMODE (Optional) Sets the connection mode.


Value range: GUI, TELNET, SSH, NDA (North Access), ERT



Value type: String


Instance count: 1




Default value: 4

Instance count: 1

4-4


Chapter 4 E



operation log.

Value type: Integer



Instance count: 1

Output Parameter



Value type: String


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;




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



Input Parameter


IP (Optional) Sets the host IP address.

Value type: String

Value range: 0–60


LOGRANK (Optional) Sets the log rank.


Value range:

l 1–EMERGENCY

l 2–ALERT

l 3–ERROR

l 4–WARNING

l 5–NOTIFICATION

l 6–INFORMATION


LOGSTART-

DATE_FROM


Value type: Date

Instance count: 1


Value type: Date

Instance count: 1

LOGSOURCE (Optional) Sets the log source.

Value type: String



TASKNAME (Optional) Sets the task name.

Value type: String




Value type: String


Instance count: 1




Default value: 4

Instance count: 1

4-6


Chapter 4 E



operation log.

Value type: Integer



Instance count: 1

Output Parameter



Value type: String


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;




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



Input Parameters


AMONAME (Optional) Specifies the name of the AMO.

Value type: String



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


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


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


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



Output Parameters


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


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


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


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 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 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 range: INTEGER, FLOAT, PERCENT, BOOLEAN, and STATISTIC

Instance count: 1

5-3



Output Parameter


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


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 range: USER, SYS

Instance count: 1

ISKPI Displays the index type.


Value range: KPI, PI and SPI

Instance count: 1

VALUETYPE Displays the value type of the index.


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


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


NELOC (Mandatory) Specifies the location of the NE whose measure objects are

needed.

Value type: String


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


RESULT Returns the measured objects list as required.

Value type: String


5-5



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


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


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


MEASOBJTYPEID The ID of the measured objects.

Value type: String

Instance count: 1

5-6


Chapter 5 G


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


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



5-7



Output Parameter


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


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 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


Chapter 5 G


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


NETYPEID (Mandatory) Specifies the type of NE whose measurement types are

needed.

Value type: String

Value range: 0-100

Instance count: 1

5-9




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


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


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


NETYPENAME (Optional) Specifies the type of NEs whose location is needed.

Value type: String

Value range: 0-100

Instance count: 1

5-10


Chapter 5 G

Output Parameter


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


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


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



5-11



Output Parameter


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


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


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


Chapter 5 G

Output Parameters


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


MONITOR Displays the QoS monitoring type, including the No., ID, and name of QoS

monitoring types.

Value type: Complex


QUERYBY Displays the data query mode, including the No., ID, and name of data

query modes.

Value type: Complex


GROUPBY Displays the data grouping mode, including the No., ID, and the name of

data grouping modes.

Value type: Complex


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




5-14


Chapter 6HTable of Contents

HELP .........................................................................................................................6-1

6.1 HELPFunction

Gets the help information of a command.

Syntax

HELP : [ CMD= < CMD> ] ;

Input Parameter


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


CMD Displays the command you want to know.

Value type: Complex


DETAILINFO Displays the help information of the command.

Value type: String


Example

To get the help information of the command “SET”, type the following command:

HELP:CMD=SET;

6-1




6-2


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


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


Instance count: 1

COUNTER (Optional) Specifies the counter(s) you want to query.

Value type: Integer


7-1




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 range: CSV

Default value: CSV

Instance count: 1

Output Parameter


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


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


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


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


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




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


FILTERTYPE (Optional) Sets the filtering type for performance data query.


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 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


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


Chapter 7 Q


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 range: CSV

Default value: CSV

Instance count: 1

Output Parameter


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



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


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


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


FILENAME (Mandatory) Specifies the name of the batch script file (*.txt) you want to

run.

Value type: String

Value range: 1-50


ARGS (Optional) Sets the arguments.

Value type: String

Value range: 1-500


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



Output Parameter


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


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



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


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



à 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


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



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


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


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 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


Chapter 9 S


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 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


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 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 range: true, false

Instance count: 1

NEID Displays the NE ID.

Value type: Integer

Instance count: 1

9-3




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


NAME Specifies the name of the AMO you want to connect.

Value type: String


Instance count: 1

9-4


Chapter 9 S


MOI Specifies the MOI of the OMM you want to connect.

Value type: String


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


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




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


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="[email protected]

",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


Chapter 9 S

Input Parameters


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


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



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


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


Chapter 9 S


DIRECTION (Optional) Changes the direction attribute of threshold crossing alarms

related to the performance index.


Value range:







lower threshold.

Instance count: 1

SETCRITICAL (Optional) Enables or disables the setting of threshold and delta for critical




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




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




ALARMMAJORDELTA (Optional) Modifies the hysteresis value for the threshold to avoid frequent



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




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



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.



Instance count: 1

ALARMWARN (Optional) Modifies the threshold of the performance index for reporting a


the threshold.

Value type: Float

Value range: -999999999.999 to 999999999.999

Instance count: 1

9-10


Chapter 9 S


ALARMWARNDELTA (Optional) Modifies the hysteresis value for the threshold to avoid frequent




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


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



Input Parameters


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


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


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.


9-12


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


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


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 range: ACTIVE, and SUSPENSIVE

Instance count: 1

Output Parameters


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



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


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.




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


Instance count: 1

9-14


Chapter 9 S


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


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


TASKID (Mandatory) Specifies the ID of the QoS task you want to modify.

Value type: Integer

Instance count: 1

9-15




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


INDEXID (Mandatory) Resets the index IDs involved in the QoS task.

Value type: String

Value range: 1-100


DIRECTION (Mandatory) Resets the direction attribute of threshold crossing alarms for

the specified index.


Value range:







lower threshold.

Instance count: 1

SETCRITICAL (Mandatory) Enables or disables the setting of threshold and delta for

critical threshold crossing alarm.



Instance count: 1

ALARMCRITICAL (Optional) Resets the threshold of the specified index for reporting a critical


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



lower threshold.

Value type: Float

Value range: 0 to 999999999.999

Instance count: 1

9-16


Chapter 9 S


SETMAJOR (Mandatory) Enables or disables the setting of threshold and delta for

major threshold crossing alarm.



Instance count: 1

ALARMMAJOR (Optional) Resets the threshold of the specified index for reporting a major


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



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.



Instance count: 1

ALARMMINOR (Optional) Resets the threshold of the specified index for reporting a minor


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



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.



Instance count: 1

9-17




ALARMWARN (Optional) Resets the threshold of the specified index for reporting a


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




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.



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


Chapter 9 S

Output Parameter


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.


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


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


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




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 range: ACTIVE, SUSPENSIVE

Instance count: 1

Output Parameters


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


Chapter 9 S

Input Parameters


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.




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 range: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday,

Saturday

Default value: Sunday

Instance count: 1


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


of a month.


Value range: 1–32 (32 refers to the last day)

Instance count: 1


Value type: Date

Instance count: 1

9-21




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 range: 1–12

Instance count: 1


of a month.


Value range: 1–31

Instance count: 1


Value type: Date

Instance count: 1

MMLSTR (Mandatory) Specifies the MML command(s) for the new timing task.

Value type: String


Instance count: 1

Output Parameter


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


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


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




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


Instance count: 1

Output Parameter


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


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


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


ROLESETARRAY (Optional) Specifies the role set that you want to assign to the user.

Value type: String

Value range: 0-50


Output Parameter


RESULT Displays the setting result of the user.

Value type: String

Instance count: 1

9-25



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


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


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


Chapter 9 S

Syntax

SET USER VIEW LOG RANGE: NAME= < NAME> [ , LOGROLEARRAY= < LOGROLEARRAY> ] [ , LOGROLESETARRAY= < LOGROLESETARRAY> ] ;

Input Parameters


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


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


Output Parameter


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



Syntax

SHOW ROLE: NAME= < NAME> ;

Input Parameter


NAME (Mandatory) Specifies the name of the role you want to view.

Value type: String

Value range: 1–50

Instance count: 1

Output Parameter


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


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


Chapter 9 S

Input Parameter


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


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


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



Input Parameter


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


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


Chapter 9 S

Output Parameter


ROLEINFO Displays the information of all roles, including the role name, description,

and locking status.

Value type: Complex


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


ROLESETINFO Displays the information of all role sets, including the name of role set,

description, and the locking status.

Value type: Complex


Example

To show the information of all role sets in the EMS, type the following command:

SHOW ALL ROLE SETS;

9-31



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


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


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


Chapter 9 S

Input Parameter


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 range: Suspend, and Active

Instance count: 1

Output Parameter


INFO Displays the information of all periodic tasks, including task name and

task info.

Value type: Complex


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



Input Parameter

None

Output Parameter


USERINFO Displays the information of all users, including user name, description,

and status (enabled or disabled).

Value type: Complex


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


AMONAME Displays the names of all started AMOs connected to the server.

Value type: String


Example

To show all the started AMOs connected to the EMS server, type the following command:

SHOW AMO;

9-34


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


USERNAME (Optional) Specifies the name of the user for querying the operation logs

related to this user.

Value type: String

Value range: 0-100


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


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


CONMODE (Optional) Specifies the connection mode of the client.


Value range: GUI, TELNET, NDA (North Access), SSH

Instance count: 1-4

9-35




ISSUCCESS (Optional) Selects to query the operation logs related to successful, failed,

or unfinished operations.


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 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


LOGRANK Displays the log rank.


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.


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


Chapter 9 S


CONMODE Displays the connection mode.


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


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


IP (Optional) Specifies the IP address of the server.

Value type: Address

Instance count: 1

9-37



Output Parameter


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


ALARMTYPE (Optional) Specifies the type of current alarms that you want to query.


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


9-38


Chapter 9 S


SEVERITY (Optional) Specifies the severity of current alarms that you want to query.


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



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


ACKSTATE (Optional) Selects to query unacknowledged current alarms only,

acknowledged current alarms only, or all current alarms.


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




ACKENDTIME (Optional) Sets the end time of the period for querying the acknowledged



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


Instance count: 1

Output Parameter


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


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


Chapter 9 S

9.28 SHOW DB RATIOFunctionShows the usage of the Oracle database.

Syntax

SHOW DB RATIO;

Input Parameter


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


Instance count: 1

Output Parameter


SPACE Displays the usage information of the database.

Value type: String


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



Input Parameter


NAME (Mandatory) Specifies the name of the department you want to view.

Value type: String

Value range: 1-50

Instance count: 1

Output Parameter


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


DIRECTORYTASKNA

ME

Displays the names of all directory monitoring tasks in the system,

Value type: Complex


TASKNAME Returns the director-monitoring task names.

Value type: String

Instance count: 1

9-42


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



Value type: Address

Instance count: 1

DISK (Optional) Specifies the disk descriptor.

Value type: String

Value range: 1-100

Instance count: 1

Output Parameter


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


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



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


ALARMTYPE (Optional) Specifies the type of history alarms that you want to query.


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


SEVERITY (Optional) Specifies the severity of history alarms that you want to query.


Value range: SEVERITY_CRITICAL, SEVERITY_MAJOR,

SEVERITY_MINOR, and SEVERITY_WARNING

Instance count: 1

9-44


Chapter 9 S


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



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


ACKSTATE (Optional) Selects to query unacknowledged history alarms only,

acknowledged history alarms only, or all history alarms.


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


Value type: Date

Instance count: 1

9-45




ACKENDTIME (Optional) Sets the end time of the period for querying the acknowledged



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


Instance count: 1

Output Parameters


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


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


Chapter 9 S

Syntax

SHOW INDEX: INDEXID= INDEXID;

Input Parameter


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


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


TASKID (Mandatory) Specifies the ID of the measurement task you want to view.

Value type: Integer

Instance count: 1

9-47



Output Parameter


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


Chapter 9 S

Input Parameters


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


Value type: Address

Instance count: 1

Output Parameter


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


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



Input Parameter


IP (Optional) Specifies the IP address of the EMS server.

Value type: Address

Instance count: 1

Output Parameter


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


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


TASKID (Mandatory) Specifies the ID of the QoS task you want to view.

Value type: Integer

Instance count: 1

9-50


Chapter 9 S

Output Parameters


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


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



Value type: Address

Instance count: 1

9-51



Output Parameter


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


USERNAME (Optional) Specifies the name of the user for viewing the security logs

related to the user.

Value type: String

Value range: 0-100


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


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


Chapter 9 S


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 range: GUI, TELNET, NDA and SSH

Instance count: 1-4

Output Parameter


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


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



Input Parameters


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


LOGRANK (Optional) Specifies the rank of system logs you want to view.


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


TASKNAME (Optional) Specifies the name of the system logs you want to view.

Value type: String

Value range: 0-100


Output Parameter


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


9-54


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


NAME (Mandatory) Specifies the name of the user you want to view.

Value type: String

Value range: 1-30

Instance count: 1

Output Parameter


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



9.42 SYNCH MEASTASKFunction

Synchronises a measurement task from the EMS to the corresponding NEs.

Syntax

SYNCH MEASTASK: [ TASKID= < TASKID> ] ;

Input Parameter


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


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


Tables

I

Tables


GlossaryAMO- Access Managed Object

EMS- Network Element Management System

GUI- Graphical User Interface

J2EE- JAVA 2 platform Enterprise Edition

MML- Man Machine Language

OMM- Operation & Maintenance Module

OMS- Operation and Maintenance Subsystem

RAM- Random Access Memory

SSH- Secure Shell

III

SJ-20101227165724-015-NetNumen M31 (RAN) (V12.10.032) MML Command Reference

Documents

Transcript of SJ-20101227165724-015-NetNumen M31 (RAN) (V12.10.032) MML Command Reference