You can set parameters in the MML Settings dialog box.
4.1 Basic Concepts Related to MML Commands
The basic concepts related to man-machine language (MML) commands consist of MML commands and the Graphical User Interface (GUI) of MML commands.
4.1.1 Introduction to MML Commands
This section describes the functions, formats, and types of operations performed using man-machine language (MML) commands.
Functions of MML Commands
You can use MML commands to operate and maintain the base station. Some MML
commands can be used for all radio access technologies (RATs), and some MML commands are specific to a particular RAT. MML commands enable you to perform the following operations:
l System management l Equipment management l Alarm management
l Carrier resource management l Transmission management
Formats of MML Commands
The format of an MML command can be "Command Word: Parameter Name=Value;".
The command word is mandatory, whereas the parameter name and value are optional.
Examples of MML commands are as follows:
l An MML command with a command word and parameters: SET ALMSHLD:
AID=25600, SHLDFLG=UNSHIELDED;
l An MML command with only a command word: LST VER:;
Types of Operations Performed Using MML Commands
The MML command word format is denoted as Action + Object. Table 4-1 describes the most commonly used MML commands.
Table 4-1 Most commonly used MML commands
Action Meaning
ACT Activate
ADD Add
BKP Backup
BLK Block
Action Meaning
DLD Download
DSP Display (used for dynamic information)
LST List (used for static information)
MOD Modify
RMV Remove
RST Reset
SET Set
STP Stop or close
STR Start or open
UBL Unblock
ULD Upload
SCN Scan
CLB Calibrate
4.1.2 Components of the MML Command Window
This section describes the components of the man-machine language (MML) command window.
In the LMT main window, click the MML tab. Figure 4-1 shows the MML command window.
Figure 4-1 MML command window
Table 4-2 describes the components of the MML command window.
Table 4-2 Components of the MML command window
No. Field Description
1 Navigation Tree You can choose Common or a specific RAT.
2 Common Maintenance tab Displays the output of an MML command.
3 Operation Record tab Displays information about all the commands that have been executed by the user.
4 Help tab Displays the help topics for an MML command.
5 Command output handling options
You can click Save Result, Auto Scroll, or Clear All.
6 Pane for manual input of an MML command
Displays the manually entered command and parameter values.
7 Command History text box Records all the commands and parameters a user enters during one session.
8 Command text box Displays all the MML commands of the system.
You can select an MML command from the drop-down list or enter the command directly.
Select Use Proxy MML. You can log in to the target base station using the emergency OM channel on the proxy base station and then execute related MML commands to maintain the target base station.
NOTICE
Before Use Proxy MML is enabled, ensure that the emergency OM channel has been established. For configurations of an emergency OM channel, see 2.8 Configuring an Emergency OM Channel.
9 Area for settings parameters of an MML command
Displays all parameters that can be set in an MML command entered in the Command text box. The parameters in red are mandatory, for example, Cabinet No. in Figure 4-1. The parameters in black are optional, for example, Subrack No. in Figure 4-1.
NOTE
l The MML navigation tree changes with the RAT selected.
l For details about MML commands and their related parameters, see the MML command help.
4.2 Running a Single MML Command
You can run man-machine language (MML) commands one at a time to perform routine operation and maintenance.
Prerequisites
You have logged in to the local maintenance terminal (LMT).
Context
You can use one of the following four methods to run a single MML command:
l Enter an MML command in the Command text box.
l Select an MML command from the Command History drop-down list box.
l Choose an MML command in the MML Command Navigation Tree.
l To manually input an MML command, enter or copy it into the pane for manual input of commands.
Procedure
l Enter an MML command in the Command text box.
a. Enter an MML command in the Command text box. When typing an MML command, you can select the command from the drop-down list.
b. Press Enter or click Assist. The parameters related to the command are displayed in the area for setting the parameters of the command.
c. Set the related parameters.
d. Press F9 or click Exec to run the command. The MML command output is displayed on the Common Maintenance tab page.
l Select an MML command from the Command History drop-down list box.
a. Select a historical command from the Command History drop-down list box. Press F7 or click to select the previous command, and press F8 or click to select the next command. The parameters related to the command are displayed in the area for setting the parameters of the command.
b. Set the related parameters.
c. Press F9 or click Exec to run the command. The MML command output is displayed on the Common Maintenance tab page.
l Choose an MML command in the MML Command Navigation Tree.
a. Choose and double-click an MML command in the MML Command Navigation Tree.
b. Set the related parameters.
c. Press F9 or click Exec to run the command. The MML command output is displayed on the Common Maintenance tab page.
l To manually input an MML command, enter or copy it into the pane for manual input of commands.
a. Manually enter or copy an MML command with complete parameter settings into the pane.
b. Press F9 or click Exec to run the command. The MML command output is displayed on the Common Maintenance tab page.
NOTE
l The parameters in red are mandatory, and those in black are optional.
l To obtain information about a parameter, move the cursor to the input box of the parameter.
l When you run an MML command with a time parameter, note that the default value of the time parameter is the base station time. If required, you can change the value.
l If an MML command fails to be executed, the execution result is displayed in red on the Common Maintenance tab page.
l Setting the browser scaling to 100% is recommended.
----End
4.3 Running MML Commands in Batches
This section describes how to run MML commands in batches to perform a function or operation.
Prerequisites
l You have logged in to the LMT using an account with the required operation rights.
l The batch file is ready.
l The Java runtime environment (JRE) of the specified version has been installed.
Context
The batch file (also called data script file) is a text file. It contains a group of man-machine language (MML) command scripts for a special task. The system automatically runs the MML command scripts in sequence.
NOTE
The batch processing window is fixed in size and does not change with the web page.
Procedure
Step 1 In the LMT main window, click Batch.
Step 2 Copy a group of command scripts with complete parameter values from the batch file to the pane for entering MML commands, or manually enter a group of MML commands, or click Open... to select an MML command batch processing file.
NOTE
l Click Open... to select a file whose size is not greater than 4 MB.
l After you click New, a window is displayed indicating whether to save the content in the pane for entering MML commands.
l You can click Save to save the content in the pane for entering MML commands to a text file.
Step 3 Click Customize. In the displayed Customize dialog box, specify related parameters for batch processing.
NOTE
l Command send interval(s): specifies the interval at which two MML commands are executed.
l Save Failed Commands: specifies a text file for saving MML commands that fail to be executed.
l Save Results: specifies a text file for saving the successful or failed MML command execution results.
Step 4 Choose an execution type in the Execution Type area. Table 4-3 lists the execution types.
Table 4-3 Execution types
Execution Type Description
All The system automatically runs all MML commands one by one.
Step by Step The system runs one MML command each time you click Go.
Breakpoint In this mode, you need to click a command before which the
command execution needs to be stopped. Click Go. The system runs the MML commands from the first one to the one before the
specified command. When you click Go again, the system runs the MML commands from the specified command to the last command or another command before which the command execution needs to be stopped.
Range The system runs MML commands within a specified range.
Prompt when error occurs
l Check box selected: If an MML command is delivered to the NE but no response is returned or the return code for the MML command is not zero, a dialog box is displayed and the MML command execution stops.
l Check box deselected: If an MML command is delivered to the NE but no response is returned or the return code for the MML command is not zero, the MML command execution continues until the operation completes and the command is marked with
. NOTE
l If the return code for an MML command is 0, the MML command is successfully executed. If the return code for an MML command is not zero, the MML command fails to be executed.
l Execution of some MML commands takes a long time. After an MML command is delivered to the NE, the NE directly returns a code zero. It does not means the command has been successfully executed, and it indicates that the NE receives the MML commands and starts the execution.
Step 5 Click Go. The system runs the MML commands.
----End
4.4 Checking the Syntax
The syntax checking function enables you to check the syntax of man-machine language (MML) commands before you run the commands in batches. This function improves the maintenance efficiency.
Prerequisites
l You have logged in to the LMT using an account with the required operation rights.
l The batch file is ready.
l The Java runtime environment (JRE) of the specified version has been installed.
Context
The following items are checked: absence of colons and semicolons, incorrect MML commands, parameter redundancy, and incorrect parameters.
Procedure
Step 1 click New to create a batch file. You can edit MML commands in the command input pane.
NOTE
You can click Open to open a ready batch file.
Step 2 Click Analyze Syntax to check the batch file.
NOTE
l If no error is found, a Information dialog box is displayed to inform you that no error is found. If an error is found, a dialog box is showing the check result is displayed to inform you of the command line number and the error cause.
l You can double-click in the Result Information dialog box to locate the erroneous MML command line in the batch file.
l After the syntax is checked, appears in front of the erroneous MML command line. If you pause the mouse over , the system displays the error information.
l To check the syntax of an MML command line in the batch file, you can right-click the MML command line and choose Analyze Current Line.
Step 3 In the Result Information dialog box, click Save As to save the check result.
----End
Follow-up Procedure
To clear the syntax check marks in the batch file, right-click in the batch file and choose Clear Analyze Mark.
4.5 Setting Parameters
You can set parameters in the MML Settings dialog box.
Prerequisites
You have logged in to the LMT using an account with the required operation rights.
Procedure
Step 1 At the upper right corner of the MML tab page, click Settings.
The Settings dialog box is displayed.
Step 2 Set parameters in the System Settings and Settings areas.
NOTE
The parameter settings in the System Settings and Settings are stored at the server end and client end, respectively. Therefore, after the base staion resets or restarts, the parameter settings in System Settings resumes to the default value but the parameter settings in Settings remain unchanged.
Step 3 Click OK. The settings are complete.
----End
5 Managing Alarms and Events
About This Chapter
This chapter describes how to manage alarms or events on the local maintenance terminal (LMT) to analyze, locate, and clear faults.