ANRITSU MX100003A Operation Manual

MX100003A

Scenario Edit

Environment Kit

Operation Manual

Second Edition

●

For safety and warning information, please read this

manual before attempting to use the equipment.

●

Additional safety and warning information is provided

within the MT1000A Transport Modules Operation Manual, MT1000A Network Master Pro OTDR Modules Operation Manual, MT1100A Network Master Flex Operation Manual, or MT1040A Transport Modules Operation Manual. Please also refer to them before using the equipment.

●

Keep this manual with the equipment.

ANRITSU CORPORATION

Document No.: M-W4042AE-2.0

Safety Symbols

DANGER

WARNING

CAUTION

To prevent the risk of personal injury or loss related to equipment malfunction, Anritsu Corporation uses the following

safety symbols to indicate safety-related information. Ensure that you clearly understand the meanings of the

symbols BEFORE using the equipment. Some or all of the following symbols may be used on all Anritsu equipment.

In addition, there may be other labels attached to products that are not shown in the diagrams in this manual.

Symbols used in manual

This indicates a very dangerous procedure that could result in serious injury or death if not performed properly.

This indicates a hazardous procedure that could result in serious injury or death if not performed properly.

This indicates a hazardous procedure or danger that could result in light-to-severe injury, or loss related to equipment malfunction, if proper precautions are not taken.

Safety Symbols Used on Equipment and in Manual

The following safety symbols are used inside or on the equipment near operation locations to provide information

about safety items and operation precautions. Ensure that you clearly understand the meanings of the symbols and

take the necessary precautions BEFORE using the equipment.

This indicates a prohibited operation. The prohibited operation is indicated

symbolically in or near the barred circle.

This indicates an obligatory safety precaution. The obligatory operation is indicated

symbolically in or near the circle.

This indicates a warning or caution. The contents are indicated symbolically in or

near the triangle.

This indicates a note. The contents are described in the box.

These indicate that the marked part should be recycled.

MX100003A Scenario Edit Environment Kit Operation Manual

21 July 2020 (First Edition) 5 March 2021 (Second Edition)

Copyright © 2020-2021, ANRITSU CORPORATION. All rights reserved. No part of this manual may be reproduced without the prior written permission of the publisher. The operational instructions of this manual may be changed without prior notice. Printed in Japan

Equipment Certificate

Anritsu Corporation guarantees that this equipment was inspected at

shipment and meets the published specifications.

Anritsu Warranty

● During the warranty period, Anritsu Corporation will repair or exchange this

software free-of-charge if it proves defective when used as described in the

operation manual.

● The warranty period is 6 months from the purchase date.

● The warranty period after repair or exchange will remain 6 months from

the original purchase date, or 30 days from the date of repair or exchange,

depending on whichever is longer.

● This warranty does not cover damage to this software caused by Acts of

God, natural disasters, and misuse or mishandling by the customer.

In addition, this warranty is valid only for the original equipment purchaser. It is not transferable if the equipment is resold.

Anritsu Corporation shall assume no liability for damage or financial loss of the customer due to the use of or a failure to use this equipment, unless the damage or loss is caused due to Anritsu Corporation’s intentional or gross negligence.

Anritsu Corporation Contact

In the event of this equipment malfunctions, please contact an Anritsu Service and Sales office. Contact information can be found on the last page of the printed version of this manual, and is available in a separate file on the PDF version.

iii

This product and its manuals may require an Export License/Approval by

the

country.

Before re-exporting the product or manuals, please contact us to confirm

whether they are export

When you dispose of export

ts/manuals need

to be broken/shredded so as not to be unlawfully used for military

purpose.

Notes On Export Management

Government of the product's country of origin for re-export from your

-controlled items or not.

-controlled items, the produc

Software End-User License Agreement (EULA)

Please carefully read and accept this Software End-User License Agreement (hereafter this EULA) before using (includes executing, copying, installing, registering, etc.) this Software (includes programs, databases, scenarios, etc., used to operate, set, etc., Anritsu electronic equipment, etc.). By using this Software, you shall be deemed to have agreed to be bound by the terms of this EULA, and Anritsu Corporation (hereafter Anritsu) hereby grants you the right to use this Software with the Anritsu specified equipment (hereafter Equipment) for the purposes set out in this EULA.

Article 1. Grant of License and Limitations

1. You may not to sell, transfer, rent, lease, lend, disclose, sublicense, or otherwise distribute this Software to third parties, whether or not paid therefor.

2. You may make one copy of this Software for backup purposes only.

3. You are not permitted to reverse engineer, disassemble, decompile, modify or create derivative works of this Software.

4. This EULA allows you to install one copy of this Software on one piece of Equipment.

Article 2. Disclaimers

To the extent not prohibited by law, in no

event shall Anritsu be liable for direct, or any incidental, special, indirect or consequential damages whatsoever, including, without limitation, damages for loss of profits, loss of data, business interruption or any other commercial damages or losses, and damages claimed by third parties, arising out of or related to your use or inability to use this Software, unless the damages are caused due to Anritsu’s intentional or gross negligence.

Article 3. Limitation of Liability

1. If a fault (bug) is discovered in this Software, failing this Software to operate as described in the operation manual or specifications even though you have used this Software as described in the manual, Anritsu shall at its own discretion, fix the bug, or replace the software, or suggest a workaround, free-of-charge, provided, however, that the faults caused by the following items and any

of your lost or damaged data whatsoever shall be excluded from repair and the warranty.

i) If this Software is deemed to be used for

purposes not described in the operation manual or specifications.

ii) If this Software has been used in

conjunction with other non-Anritsu-approved software.

iii) If this Software or the Equipment has

been modified, repaired, or otherwise altered without Anritsu's prior approval.

iv) For any other reasons out of Anritsu's

direct control and responsibility, such as but not limited to, natural disasters, software virus infections, or any devices other than this Equipment, etc.

2. Expenses incurred for transport, hotel, daily allowance, etc., for on-site repairs or replacement by Anritsu engineers necessitated by the above faults shall be borne by you.

3. The warranty period for faults listed in Section 1 of this Article shall be either 6 months from the date of purchase of this Software or 30 days after the date of repair or replacement, whichever is longer.

Article 4. Export Restrictions

You shall not use or otherwise export or

re-export directly or indirectly this Software except as authorized by the laws and regulations of Japan and the United States, etc. In particular, this Software shall not be exported or re-exported (a) into any Japan or US embargoed countries or (b) to anyone restricted by the Japanese export control regulations, or the US Treasury Department's list of Specially Designated Nationals or the US Department of Commerce Denied Persons List or Entity List. In using this Software, you warrant that you are not located in any such embargoed countries or on any such lists. You also agree that you will not use or otherwise export or re-export this Software for any purposes prohibited by the Japanese and US laws and regulations, including, without limitation, the development, design and manufacture or production of missiles or nuclear, chemical or biological weapons of mass destruction, and conventional weapons.

Article 5. Change of Terms

Anritsu may change without your approval

the terms of this EULA if the changes are for the benefit of general customers, or are reasonable in light of the purpose of this EULA and circumstances of the changes. At the time of change, Anritsu will inform you of those changes and its effective date, as a general rule 45 website, or in writing or by e-mail.

days, in advance on its

Article 6. Termination

1. Anritsu may terminate this EULA immediately if you violate any conditions described herein. This EULA shall also be terminated immediately by Anritsu if there is any good reason that it is deemed difficult to continue this EULA, such as your violation of Anritsu copyrights, patents, etc. or any laws and ordinances, or if it turns out that you belong to an antisocial organization

or has a socially inappropriate relationship with members of such organization.

2. You and Anritsu may terminate this EULA by a written notice to the other party 30 days in advance.

Article 7. Damages

If Anritsu suffers any damages or loss,

financial or otherwise, due to your violation of the terms of this EULA, Anritsu shall have the right to seek proportional damages from you.

Article 8. Responsibility after Termination

Upon termination of this EULA in

accordance with Article 6, you shall cease all uses of this Software immediately and shall as directed by Anritsu either destroy or return this Software and any backup copies, full or partial, to Anritsu.

Article 9. Negotiation for Dispute

Resolution

If matters of interpretational dispute or

items not covered under this EULA arise, they shall be resolved by negotiations in good faith between you and Anritsu.

Article 10. Governing Law and Court of

Jurisdiction

This EULA shall be governed by and

interpreted in accordance with the laws of Japan without regard to the principles of the conflict of laws thereof, and any disputes arising from or in relation to this EULA that cannot be resolved by negotiation described in Article 9 shall be subject to and be settled by the exclusive agreed jurisdiction of the Tokyo District Court of Japan.

Revision History:

February 29th, 2020

Prior to the software installation

When using this software

Use antivirus software.

This software may not operate normally if any of the following operations

are performed

running any software other than that recommended or

For how to turn off the functions, refer to the

with your computer.

Protection Against Computer Virus Infections

Before installing this software or any other software recommended or

approved by Anritsu, run a virus scan on your computer, including

removable media (e.g. USB flash drive and CF memory card) you

want to connect to your computer.

and connecting with the measuring instrument

● Copying files and data

On your computer, do not save any copies other than the following:

- Files and data provided by Anritsu

- Files created by this software

- Files specified in this document

Before copying these files and/or data, run a virus scan, including

removable media (e.g. USB flash drive and CF memory card).

● Connecting to network

Connect your computer to the network that provides adequate

protection against computer viruses.

● Protection against malware (malicious software such as viruses).

To connect your computer to network, the following is advised.

- Activate Firewall.

- Install important updates of Windows.

Cautions on Proper Operation of Software

● Simultaneously

approved by Anritsu

● Closing the lid (Laptop computer)

● Turning on the screen saver function

● Turning on the battery-power saving function (Laptop computer)

on your computer:

operation manual that came

vii

viii

About This Manual

This operation manual explains the operation of the MX100003A Scenario Edit Environment Kit.

For the operation of the Network Master, refer to the following operation manual.

MT1000A Transport Modules Operation Manual (M-W3933AE)

MT1000A Network Master Pro OTDR Modules Operation Manual

(M-W3810AE)

MT1100A Network Master Flex Operation Manual (M-W3735AE)

MT1040A Transport Modules Operation Manual (M-W4038AE)

For the SCPI commands, refer to the following operation manual.

MT1000A Network Master Pro MT1100A Network Master Flex Remote

Scripting Operation Manual (M-W3736AE)

MT1000A Network Master Pro OTDR Modules Remote Scripting

Operation Manual (M-W3859AE)

MT1000A/MT1100A/MT1040A Remote Scripting Operation Manual

(M-W4041AE)

This manual assumes that readers has the following knowledge.

●

How to operate the Network Master

●

Basic of software programming

Experience of programming (using C or BASIC etc.) Knowledge of variable, subroutine, IF sentence, etc.

●

Operation on Microsoft Windows

Able to operate the mouse (click, drag, drop), file (load, copy), etc.

About This Manual ............................................... I

Outline of

Scenario Edit Environment Kit

1.1 Outline ........................................................................... 1-2

1.2 Operating Environment ................................................. 1-4

......... 1-1

Chapter 2 Installation and Uninstallation ........ 2-1

2.1 Installation ..................................................................... 2-2

2.2 Uninstallation ................................................................ 2-5

Operation .......................................... 3-1

3.1 Starting and Exiting ....................................................... 3-2

3.2 Explanation of the Window ........................................... 3-3

3.3 Connecting with the Network Master ............................ 3-8

3.4 Editing the Scenario ...................................................... 3-9

3.5 Checking the Scenario Contents ................................ 3-36

Chapter 4 Running the Scenario ...................... 4-1

4.1 Copying the Scenario Files ........................................... 4-2

4.2 Registering and Running the Scenario ......................... 4-3

4.3 Result Files ................................................................... 4-9

2 3

Appendix A Syntax of Script ........................... A-1

Appendix B Command Reference ................... B-1

Appendix C Error Messages ............................ C-1

Appendix D Loop Processing .......................... D-1

Appendix

III

IV.

Outline of Scenario Edit Environment Kit

This section outlines the operation environment and functions of MX100003A Scenario Edit Environment Kit (hereinafter referred to as “MX100003A”).

1.1

Outline ........................................................................... 1-2

1.2 Operating Environment ................................................. 1-4

1-1

MT1000A

MT1100A Network Master Flex

MX100003A Scenario Edit Environment

Scenario file

MT9083/MT9085 Series ACCESS Master

Chapter 1 Outline of Scenario Edit Environment Kit

1.1 Outline

MX100003A is the editing software of the scenario which runs on the following products.

●

MT1000A Network Master Pro

●

MT1040A Network Master Pro

●

MT1100A Network Master Flex

●

MT9083/MT9085 Series ACCESS Master

Scenario is the program which describes the following: the process order of the commands and applications (sequence), the pass/fail thresholds values, the loading file name, and the saving file names. By running the scenario created by MX100003A on the Network Master, the test automation will be realized.

Kit

Figure 1.1-1 Use of MX100003A

Network Master Pro MT1040A Network Master Pro

1-2

Features

●

Sequence can be edited by the drag & drop operation.

●

Allows to edit the file stored in the Network Master by connecting to

the Network Master via Ethernet.

●

The scenario can be described by using the SCPI command used for

remote controlling of the Network Master.

1.1 Outline

Outline of Scenario Edit Environment Kit

●

Editing the script by using the test command allows creating the

scenario which is suitable measurement method or judgement condition to your purpose. MX100003A can load the scripts from the file created by the text editor such as Note Pad of Windows.

1-3

Microsoft Windows 7, 8, 8.1

64 bit

Display

1024 × 768 or more

Chapter 1 Outline of Scenario Edit Environment Kit

1.2 Operating Environment

The following table shows the operating environment of MX100003A.

Table 1.2-1 Operating Environment

Item Specifications

32 bit or 64 bit

Microsoft Windows 10

1-4.

Installation and Uninstallation

Chapter 2 Installation and Uninstallation

This chapter describes the installation and uninstallation of MX100003A, using examples when the OS of the personal computer (hereafter, PC) is Windows 7.

2.1

Installation ..................................................................... 2-2

2.2 Uninstallation ................................................................ 2-5

2-1

Chapter 2 Installation and Uninstallation

2.1 Installation

Install the MX100003A by the following procedure.

When NET Framework 4.6 is not installed in the PC

1. Copy MX100003A_xxx.zip (xxx is replaced by the version name) to PC.

2. Double-click the copied zip file to the PC.

3. Double-click “Setup.exe” in the uncompressed folder. Double-click the “Setup.exe” in the extracted folder.

4. The following dialog box appears. Click

Accept.

2-2

Installation and Uninstallation

5. The following dialog box appears. Click Yes.

2.1 Installation

6. The following dialog box appears. Click

7. After PC reboots, the following dialog box appears. Click

Yes .

Install.

The MX100003A window appears after the installation has finished.

2-3

Chapter 2 Installation and Uninstallation

When NET Framework 4.6 is installed in the PC

1. Copy MX100003A_xxx.zip (xxx is replaced by the version name) to PC.

2. Double-click the copied zip file to the PC.

3. Double-click “Setup.exe” in the uncompressed folder. Double-click the “Setup.exe” in the extracted folder.

4. Click has finished.

Install. The MX100003A window appears after the installation

2-4

Installation and Uninstallation

2.2 Uninstallation

This section describes the procedure for uninstalling MX100003A.

2.2 Uninstallation

1. Select

2. Click

3. Click

Control Panel in the Start menu to open the Control Panel.

Uninstall a program.

MX100003A (SEEK) in the list, and click Uninstall/Change.

2-5

Chapter 2 Installation and Uninstallation

4. Click OK on the following dialog box.

2-6.

Operation

This chapter explains the operations of the MX100003A.

3.1

Starting and Exiting ....................................................... 3-2

3.1.1 How to Start the Software ................................ 3-2

3.1.2 How to Exit the Software .................................. 3-2

3.2 Explanation of the Window ........................................... 3-3

3.2.1 Window Configurations .................................... 3-3

3.2.2 Menu ................................................................. 3-4

3.2.3 Toolbar ............................................................. 3-5

3.2.4 Command Selections ....................................... 3-5

3.2.5 Application Selections ...................................... 3-7

3.2.6 Command Sequence ........................................ 3-7

3.2.7 Command Details ............................................. 3-7

3.3 Connecting with the Network Master ............................ 3-8

3.4 Editing the Scenario ...................................................... 3-9

3.4.1 Instrument Configuration .................................. 3-9

3.4.2 Scenario Settings ........................................... 3-11

3.4.3 Report Settings ............................................... 3-13

3.4.4 Global Variables ............................................. 3-14

3.4.5 Editing the Sequence ..................................... 3-16

3.4.6 Editing the Application .................................... 3-21

3.4.7 Editing the Command ..................................... 3-22

3.4.8 Editing Scenario Settings for

MT9083/MT9085 ............................................ 3-35

3.5 Checking the Scenario Contents ................................ 3-36

Operation

3-1

Chapter 3 Operation

3.1 Starting and Exiting

This section describes startup procedure and exit procedure of the MX100003A.

3.1.1 How to Start the Software

Click Start Menu, and click MX100003A (SEEK).

Figure 3.1.1-1 The Button on the Start Menu

3.1.2 How to Exit the Software

Exit the MX100003A by one of following operation.

● Click

● Click at right-top of the window.

If the scenario on the way of editing has not saved, confirming message appears. Yes : Exits with saving the scenario. No: Exits without saving the scenario. Cancel: Cancels exiting the MX100003A.

Close on the File menu.

3-2

Operation

3.2 Explanation of the Window

Menu Command Sequence

Command Details Application Selections

Command Selections

Instrument Configuration Display

Toolbar

3.2.1 Window Configurations

3.2 Explanation of the Window

Figure 3.2.1-1 Window Components

Default language of MX100003A is English.

3-3

File

New

Creates the new scenario.

Open

Loads the scenario from the file.

Save

Saves the scenario to the file.

Save As

–

Saves the scenario to a file as another file.

Save To

–

When the Network Master is connected via

of the Network Master.

–

Exits MX100003A.

Settings

Select Platform

–

Selects a platform (MT1X00A or MT9083) on which you want to run the scenario.

MT1x00A Connection*

Checks the connection to the Network Master which the IP address is specified.

Instrument Configuration

Sets the configuration of the Network Master and modules where the scenario will run.

Scenario Settings*

Sets the name and icon displayed on the Network Master.

Report Settings*

Sets the Report file information used when the report file is saved.

Global Variables*

Sets the variables used in the scenario. The

applications executed in the scenario.

Language

–

Changes the languages of the MX100003A.

Help

About

–

Displays the MX100003A information.

Chapter 3 Operation

3.2.2 Menu

Menu configuration and icons displayed on the toolbar are shown following table.

Table 3.2.2-1 Menu Configuration

Menu Icon Description

MT1X00A*

*: Not displayed when MT9083 is selected for Select Platform.

Note:

When loading a scenario file, the Network Master identifies the string up to the period as the file name. For example, the Network Master identifies all the following scenario file names as “ETH_10G”. Therefore, only one of these scenario files can be loaded to the Network Master. ETH_10G.BERT.obcfg ETH_10G.BERT.IPv4.obcfg ETH_10G.RFC2544.obcfg

Ethernet, Saves the scenario in Internal folder

variables can be referred from multiple

3-4

Operation

3.2.3 Toolbar

Load Setup

Loads a setup file (*.cfg) of the application.

Start

Starts measurements.

Stop

Stops measurements.

Save

Saves scenario logs to files.

be also saved.

Message

Displays a message.

Request

Displays a dialog box to enter a value.

Action

Performs the user defined action.

Judge

Judges the test result of the application. If judged as “Fail”, the running scenario stops.

On the toolbar, icons of File menu items and Setting menu items are placed. For the correspondence between the icon and the menu item, refer to Table 3.2.2-1 “Menu Configuration”.

3.2.4 Command Selections

“Command” is the operation to the application. The following commands are prepared in Command Selector.

3.2 Explanation of the Window

Table 3.2.4-1 Commands List

Command Description

Test results and Report file of the application can

The correspondence between icons on the Network Master screen and the commands is shown in the following figure. There are no icons corresponding to Message, Request, and Action.

Figure 3.2.4-1 Correspondence Between Network Master Icons and

Commands (Except Standard OTDR and VIP Applications)

3-5

Chapter 3 Operation

Figure 3.2.4-2 Correspondence Between Network Master Icons and

Commands (Standard OTDR Application)

3-6

Figure 3.2.4-3 Correspondence Between Network Master Icons and

Commands (VIP Application)

Operation

3.2.5 Application Selections

In Application Selections, the lists of application are displayed. You can open the list by operating as below to the button of OTN, Ethernet, Fibre Channel, SDH/SONET/PDH/DSn, CPRI, Optical-Fiber Testing, and Other.

● Click .

● Click the button and press the right arrow key of the keyboard.

● Double-click the button.

You can close the list by operating as below.

● Click .

● Click the button and press the left arrow key of the keyboard.

● Double-click the button.

3.2.6 Command Sequence

Edit the order of processing by placing commands and applications to this area. An application or a command can be placed by drag & drop operation. The mouse icon changes to when an application or a command cannot be placed.

You can open or close the list in Command Sequence in the same manner described in Application Selections. The copy button and the paste button are located under the area.

3.2 Explanation of the Window

: copies an application or a command.

: pastes the copied application or command.

3.2.7 Command Details

Clicking the command or the application placed in Command Sequence displays the setting items on this area.

For contents of displayed items, refer to 3.4.5.2 “Copy and Paste” and

3.4.7 “Editing the Command”.

3-7

Chapter 3 Operation

3.3 Connecting with the Network Master

MX100003A can access the folder of the Network Master by connecting to the Network Master via Ethernet.

1. Select Ethernet Enabled on the Network Master, confirm the IP address.

2. Select Share File System on the Network Master.

3. Connect Network Master and PC using the Ethernet cable.

4. Click MT1x00A Connection on MX100003A.

3-8

5. Enter the Network Master IP address confirmed in step 1 and click Test . If MX100003A has connected to the Network Master, Success message appears.

+ 90 hidden pages

ANRITSU MX100003A Operation Manual

About This Manual

Table of Contents

1.1 Outline

1.2 Operating Environment

Chapter 2 Installation and Uninstallation

2.1 Installation

2.2 Uninstallation

3.1 Starting and Exiting

3.1.1 How to Start the Software

3.1.2 How to Exit the Software

3.2 Explanation of the Window

3.2.1 Window Configurations

3.2.2 Menu

3.2.3 Toolbar

3.2.4 Command Selections

3.2.5 Application Selections

3.2.6 Command Sequence

3.2.7 Command Details

3.3 Connecting with the Network Master