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

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

DANGER

WARNING

CAUTION

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

ii

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

Notes On Export Management

This product and its manuals may require an Export License/Approval by the Government of the product's country of origin for re-export from your country.

Before re-exporting the product or manuals, please contact us to confirm whether they are export-controlled items or not.

When you dispose of export-controlled items, the products/manuals need to be broken/shredded so as not to be unlawfully used for military purpose.

iv

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.

v

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 days, in advance on its website, or in writing or by e-mail.

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

vi

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

Protection Against Computer Virus Infections

Prior to the software installation

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.

When using this software 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.

-Use antivirus software.

Cautions on Proper Operation of Software

This software may not operate normally if any of the following operations are performed on your computer:

●Simultaneously running any software other than that recommended or approved by Anritsu

●Closing the lid (Laptop computer)

●Turning on the screen saver function

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

For how to turn off the functions, refer to the operation manual that came with your computer.

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.

I

Table of Contents

About This Manual ...............................................		I
	Outline of
	Scenario Edit Environment Kit.........	1-1
1.1	Outline...........................................................................	1-2
1.2	Operating Environment.................................................	1-4
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

II

		1
Appendix A Syntax of Script ...........................	A-1
		2
Appendix B Command Reference...................	B-1
Appendix C Error Messages............................	C-1	3
Appendix D Loop Processing..........................	D-1
		4
		<![if ! IE]> <![endif]>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

1

<![if ! IE]>

<![endif]>Kit Environment Edit Scenario of Outline

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.

	MX100003A		MT1000A
		Scenario file	Network Master Pro
	Scenario Edit		MT1040A
	Environment Kit		Network Master Pro

Scenario file

MT9083/MT9085 Series	MT1100A
ACCESS Master	Network Master Flex

Figure 1.1-1 Use of MX100003A

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

1.1 Outline

●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

1

<![if ! IE]>

<![endif]>Kit Environment Edit Scenario of Outline

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
OS		Microsoft Windows 7, 8, 8.1
		32 bit or 64 bit
		Microsoft Windows 10
		64 bit
Display		1024 × 768 or more

1-4.

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

2

<![if ! IE]>

<![endif]>Uninstallation and Installation

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

2.1 Installation

5.The following dialog box appears. Click Yes.

6.The following dialog box appears. Click Yes.

2

<![if ! IE]>

<![endif]>Uninstallation and Installation

7.After PC reboots, the following dialog box appears. Click 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 Install. The MX100003A window appears after the installation has finished.

2-4

2.2 Uninstallation

2.2 Uninstallation

This section describes the procedure for uninstalling MX100003A.

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

2.Click Uninstall a program.

2

<![if ! IE]>

<![endif]>Uninstallation and Installation

3.Click 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.8Editing Scenario Settings for

MT9083/MT9085 ............................................	3-35
3.5 Checking the Scenario Contents ................................	3-36

3

<![if ! IE]>

<![endif]>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 Close on the File menu.

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

3-2

3.2 Explanation of the Window

3.2 Explanation of the Window

3.2.1 Window Configurations

	Command	Menu	Toolbar
	Selections

3

<![if ! IE]>

<![endif]>Operation

Instrument Configuration Command Sequence Command Details

Display	Application Selections
	Figure 3.2.1-1 Window Components

Default language of MX100003A is English.

3-3

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
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
MT1X00A*			Ethernet, Saves the scenario in Internal folder
			of the Network Master.
Close		–	Exits MX100003A.
Settings
Select Platform		–	Selects a platform (MT1X00A or MT9083) on
			which you want to run the scenario.
MT1x00A			Checks the connection to the Network Master
Connection*			which the IP address is specified.
Instrument			Sets the configuration of the Network Master
Configuration			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
			variables can be referred from multiple
			applications executed in the scenario.
Language		–	Changes the languages of the MX100003A.
Help
About		–	Displays the MX100003A information.
*:	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

3-4

3.2 Explanation of the Window

3.2.3 Toolbar

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.

	Table 3.2.4-1 Commands List
Command	Description
Load Setup	Loads a setup file (*.cfg) of the application.
Start	Starts measurements.
Stop	Stops measurements.
Save	Saves scenario logs to files.
	Test results and Report file of the application can
	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.

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

3

<![if ! IE]>

<![endif]>Operation

Chapter 3 Operation

Figure 3.2.4-2 Correspondence Between Network Master Icons and

Commands (Standard OTDR Application)

Figure 3.2.4-3 Correspondence Between Network Master Icons and

Commands (VIP Application)

3-6

3.2 Explanation of the Window

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.6Command 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.

: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

<![if ! IE]>

<![endif]>Operation

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.

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.

3-8