NEC America, Inc. reserves the r ight to
change the specifications, functions, or
features, at any time, without notice.
NEC America, Inc. has prepared this
document for the exclusive use of its
employees and customers. The
information contained herein is the
property of NEC America, Inc . and shall
not be reproduced without prior written
approval from NEC America, Inc.
NEAX, MATWorX, DESIWorX, and D
term
are registered trademarks of NEC
Corporation.
Copyright 1997
NEC America, Inc.
Printed in the USA
All other brand or product na mes are or
may be trademarks or registered
trademarks of, and are used to identify
products or services of, the ir respective
owners.
MS-DOS and Microsoft are registered
trademarks of Microsoft Corporation.
Microsoft Windows 95 and Windows NT
are trademarks of Microsoft Corporation.
NDA-24215
December, 1997
NEAX2000 IVS
MATWorX 32 User’s Guide
Table of Contents
Page
Chapter 1About This Guide.................................. 1
Purpose of This Guide................................ 1
How This Guide is Organized..................... 1
MATWorX 32 User’s Guide
NDA-24215 Revision 1.0Page v
About This Guide
Chapter 1About This Guide
Purpose of This Guide
This user guide contains useful information that will
help you successfully install and use the MATWorX
32 program. Included are highlights about many key
features of the program including the MATWorX 32
Taskbar, PBX Access Module (PAM), Add-Ins, PBX
Configuration Wizard, MACH Script Editor,
Scheduler, DESIWorX, Extended Command Set,
Error Codes, and the Online Help System.
This guide is designed to be a supplement to the
MATWorX 32 online Help system. The Help system
provides context-sensitive information and procedures
that will help you perform ta sks using MATWo rX 32.
Refer to Chapter 10 “MATWorX 32 Online Help” for
more information about the Help system and how to
access it.
How This Guide is Organized
The MATWorX 32 User’s Guide is divided into the
following chapters:
◆
MATWorX 32 Overview describes the MATWorX
32 program, its features, buttons, Taskbar
selections, Add-Ins, and application tools.
◆
Installing MATWorX 32 describes the necessary
hardware (computer equipment) required to
efficiently run the MATWorX 32 program as well
as procedures for installing MATWorX 32 o n your
computer’s hard disk.
◆
Getting Started describes how to launch and exit
MATWorX 32 and configure a PBX using the
Wizard feature.
PBX Access Module (P AM) describes the process
of how MATWorX 32 applications communicate
with the PBX via the P AM. The PAM is a gateway
for 32-bit Microsoft Windows applications to
connect to the NEAX2000 IVS PBX.
◆
Add-Ins describes the concept of Add-Ins,
including what they are and how they work, as well
as how to add and remove them. Add-Ins are the
basic tools of MATWorX 32. Users can also create
custom Add-Ins for specialized business solutions
by purchasing a developer’s kit from NEC or an
authorized NEC dealer.
◆
MACH Script Editor describes the concept and
operation of the MOC Accelerated Command
Heap (MACH) windo w. This window is a separate
and powerful tool that is integrated into the
MATWorX 32 software. It is similar to working
with the Maintenance Operation Console (MOC),
but provides much more functionality by enabling
you to create a list of NEAX2000 IVS commands
(a script) which you can save and run at an y time.
◆
Scheduler describes the features and operations of
the Scheduler application. Using the Scheduler,
you can build a series of MOC commands and sa ve
them in a script. Then you can simply run the script
instead of manually typing them each time you
need them. You can also schedule the script to run
at certain times during a day, week, or month. You
can build complex scripts that can modify
NEAX2000 IVS behavior at scheduled times.
◆
DESIWorX describes the features and operations
of the DESIWorX application. Using DESIWorX,
you can create labels for the function keys of the
Dterm stations on your NEAX2000 IVS. These
labels are saved in a database. You can enter
function key caption information for the label, and
you can print the labels to be placed on the Dterm.
Page 2NDA-24215 Revision 1.0
MATWorX 32 User’s Guide
About This Guide
◆
MATWorX 32 Online Help describes the online
Help system in detail as well as how to access it
and print Help topics.
◆
Appendix A lists the Extended Command Set that
you can use in conjunction with the MACH Script
Editor window. The Extended Command Set
characters are modifiers you type in front of a
NEAX2000 IVS command on the MACH Script
Editor window. Using Extended Commands can
greatly reduce the number of commands needed to
perform certain tasks.
◆
Appendix B lists the error codes and related
descriptions for the entire MATWorX 32 program.
◆
Appendix C describes the directory structure, f iles,
and file locations of the MATWorX 32 suite of
applications installed on your computer.
MATWorX 32 is a 32-bit Windows-based software
application that enables you to program and maintain
an unlimited number of NEAX2000 IVS PBXs via
your computer. MATWorX 32 utilizes a client/server
architecture that allows multiple dialogs (Add-Ins) to
communicate with a PBX. You can connect to and
program up to four PBXs at the same time.
MATWorX 32 provides a graphical user interface
(GUI) to a NEAX2000 IVS. This design lets you
navigate quickly and intuitively throughout the
program, thus saving you valuable time with your
PBX maintenance tasks.
MATWorX 32 communicates with a PBX via the PBX
Access Module (PAM). The PAM is an application of
MATWorX 32 which acts as a gateway for connection
and communication between the MATWorX 32 t ools
and a specific PBX. This chain of communication is
necessary for the successful operation of all the
MATWorX 32 tools and related PBX applications.
Refer to Chapter 5 “PBX Access Module (PAM)” for
more information about the PAM.
There are three kinds of tools included in the
MATWorX 32 program: Add-Ins, MACH Script
Editor, and a PBX Configuration Wizard. These tools
are accessible from the Taskbar.
Add-Ins
Add-Ins are the basic tools of MATWorX 32. Each
one provides you with special ized capabilities to
program PBX features and f unctions. MATWorX 32
comes with more than a dozen Add-Ins that can be
accessed from the Taskbar. In addition, you can also
create custom Add-Ins for specialized business
solutions by purchasing a developer’s kit from NEC or
an authorized NEC dealer. Refer to Chapter 6 “AddIns” for more information.
MACH Script Editor
This is a powerful time-saving tool that enables you to
create a list of NEAX2000 IVS commands that
perform tasks in the PBX. This list is referred to as a
script, which can be saved and run at anytime.You ca n
also use the MACH Script Editor to perform many
other operatio ns. Refer to Chapter 7 “MACH Script
Editor” for more information.
PBX Configuration Wizard
The PBX Configuration Wizard is a custo m tool in
MATWorX 32 that enables yo u to establ ish the proper
communication settings between your computer and
the NEAX2000 IVS. The Wizard asks you simple
questions and then uses the information to
automatically configure the connection for the PC and
the PBX. Refer to “Using the PBX Configuration
Wizard” on page 29 for more information on accessing
and using the PBX Configuration Wizard.
Page 6NDA-24215 Revision 1.0
MATWorX 32 User’s Guide
MATWorX 32 Applications
MATWorX 32 software includes three separate
applications that can run independently from one
another. However, when used in conjunction with
MATWorX 32 or each other, these applications
provide a robust suite of PBX maintenance
applications.
PBX Access Module (PAM)
The PAM acts as a gateway between MATWorX 32
tools and connected NEAX2000 IVS PBXs. It
provides connection and communication links for
programming the PBX. Refer to Chapter 5 “PBX
Access Module (PAM)” for more information.
Scheduler
The Scheduler is a versatile application that can be
used stand-alone or in conjunction with the MACH
Script Editor. You can build and schedule scripts
(series of MOC commands) all within the Scheduler,
or you can b uild scr ipts usi ng the MA CH Scr ipt Edito r
and then schedule them to run using the Scheduler.
Refer to Chapter 8 “Scheduler” for more information.
MATWorX 32 Overview
DESIWorX
DESIWorX is a unique application that enables you to
create and print function key labels for your Dterm
stations. The labels are saved in a database and can be
modified and printed when necessary. Refer to
Chapter 9 “DESIWorX” for more information.
If you are new to working in Windows 95 or would
like a refresher on Windows terminology, functions,
and navigational procedures, take a minute to access
the Microsoft Windows Tuto rial Tour by following the
steps below.
1.Launch Microsoft W i nd ows 95 on your
computer .
2.Select
3.Select
under the
4.Follow the instructions on your screen.
from the
Help
Tour: Ten Minutes to Usin
Contents
Start
tab.
taskbar.
Windows
Navigating Through the MATWorX 32 Taskbar
The MATWorX 32 Taskbar (Figure 2-1) is the main
window of the program. It contains buttons and pulldown menus listing the selections available in the
program. Each button or me nu selection provides
access to the tools and applications available in the
program. To activate a selection, click on it.
The Taskbar offers dynamic functionality to the
program by allowing you to change it based on the
Add-Ins you want to use. For example, by default each
Add-In appears as a menu item and a button on the
Taskbar. If you remove an Add-In from the Taskbar
(via the Add-In Manager), it will no longer display as
a menu item or button. If you choose to add it back, it
will re-appear on the Taskbar.
The Taskbar enables you to navigate through the
program and perform various functions. It is also the
launch point for MATWorX 32 tools and applicat ions.
The default Taskbar items and correspon ding button s,
where applicable, are described on the following
pages.
Page 8NDA-24215 Revision 1.0
MATWorX 32 User’s Guide
MATWorX 32 Overview
y
y
y
Note:Some menu items (Add-In Manager, Help
Contents F1, and About MATWorX 32) do
not have a corresponding button. These
items are accessible only fr om the pull-down
menus.
Figure 2-1 MATWorX 32 Taskbar
PBX Menu
Connect
Connection to PBX
- Select this menu item to access the
dialog where you can select a
PBX from a list of available PBXs and connect to it.
You can also click the
Connect to PBX
button
to select a PBX from a list of available PBXs and
connect to it.
Disconnect
Disconnect from PBX
- Select this menu item to access the
dialog where you can
disconnect from the current PBX.
You can also click the
Disconnect from PBX
button to disconnect from the current PBX.
S
stem Menu
The
S
stem Menu
is a dynamic menu that contains
system-related Add-Ins. For information about a
particular System Add-In, access the online Help for
that Add-In.
You can also click the
S
stem Tool Palette
button to display a floating palette of bu ttons that can
launch system-related Add-Ins.
is a dynamic menu that contains
station-related Add-Ins. For information about a
particular Station Add-In, access the online Help for
that Add-In.
You can also click the
Station Tool Palette
button to display a floating palette of buttons that can
launch station-related Add-Ins.
Number Plan Menu
The
Number Plan Menu
is a dynamic menu that
contains number plan-related Add-Ins. For
information about a particular Number Plan Add-In,
access the online Help for that Add-In.
You can also click the
Palette
button to display a floating palette of buttons
Numberin
Plan Tool
that can launch number plan-related Add-Ins.
Trunk Menu
The
Trunk Menu
is a dynamic menu that contains
trunk-related Add-Ins. For information about a
particular Trunk Add-In, access the online Help for
that Add-In.
You can also click the
Trunk Tool Palette
button to display a floating palette of buttons that can
launch trunk-related Add-Ins.
Features Menu
The
Features Menu
is a dynamic menu that contains
feature-related Add-Ins. For information about a
particular Feature Add-In, access the online Help for
that Add-In.
Page 10NDA-24215 Revision 1.0
MATWorX 32 User’s Guide
MATWorX 32 Overview
g
g
You can also click the
Features Tool Palette
button to display a floating palette of bu ttons that can
launch feature-related Add-Ins.
Add-Ins Menu
Add-In Mana
Add-Ins Mana
- Select this menu item to access the
er
dialog where you can add and
er
remove Add-Ins to/from the MATWorX 32 Taskbar.
Refer to Chapter 6 “Add-Ins” for more information.
Active Add-Ins
- Select this menu item to display a
sub-menu that lists all currently active Add-Ins. Also,
you can choose to “show all”, “hide all”, and “unload
all” active Add-Ins.
Applications Menu
MACH Script Editor
the
MACH Script Edi to r
- Select this menu item to access
dialog where you can create
and save a list (script) of NEAX2000 IVS commands
to perform tasks in the PBX. You can also use the
MACH Script Editor to perform many other
operations. Refer to Chapter 7 “MACH Script Editor”
for more information.
You can also click the
button to access the
Scheduler
- Select this menu item to access the
MACH Script Editor
MATWorX 32 Scheduler
MACH Script Editor
dialog.
dialog where you can build
and schedule scripts. You can also use the MACH
Script Editor to build scripts and then schedule them to
run using the Scheduler. Refer to Chapter 8
“Scheduler” for more information.
dialog where you can create and print
function key labels for your Dterm s tations. The labels
are saved in a database and can be modified and
printed when necessary. Refer to Chapter 9
“DESIWorX” for more information.
You can also click the
access the
Confi
access the
DESIWorX
uration Wizard
PBX Confi
DESIWorX
dialog.
- Select this menu item to
uration Wiza rd
button to
where you can
establish the proper communication settings between
your computer and the NEAX2000 IVS. The Wizard
asks you simple questions and then uses the
information to automatically configure the connection
for the PC and the PBX. Refer to “Using the PBX
Configuration Wizard” on page 29 for more
information on accessing and using the PBX
Configuration Wizard.
You can also click the
button to access the
PBX Confi
Confi
uration Wizard
uration Wizard
.
Help Menu
Help Contents F1
- Select this menu item to access
the main contents page of the MATWorX 32 online
Help system. The Help system provi des you with easy
access to information about procedures, tools, AddIns, commands, values, and shortcuts.
Tip of the Da
- Select this menu item to display an
informative tip about using MATWorX 32 and related
tools and applications.
About MATWorX 32
access the
About
- Select this menu item to
box to view MATWorX 32 version
and system information.
Page 12NDA-24215 Revision 1.0
MATWorX 32 User’s Guide
MATWorX 32 Overview
Command Manual
- Select this menu item to launch
Adobe Acrobat Reader (included with MATWorX 32)
and automatically open the NEAX2000 IVS
Command Manual.
You can also click the
Acrobat Reader
button
to launch Adobe Acrobat Reader and automatically
display a menu where you can select and open the
MATWorX 32 User’s Guide, NEAX2000 IVS
Command Manual, Help on Using Acrobat Reader,
and NEC’s Copyright Notice.
Working wi th MATWorX 32 Dialogs and Buttons
The dialogs within MATWorX 32 enable you to
perform various functions in order to program a
NEAX2000 IVS PBX. Many di alogs co nt ai n bu t tons ,
fields, boxes, and other options that are described
within this guide.
You are able to move each MATWorX 32 dialog by
placing your cursor on the title bar and holding down
your left mouse butto n, drag gi ng the d i alo g to i ts new
position, and releasing the mouse button. In addition,
you are able to resize many of the MATWorX 32
dialogs and Help windows by placing your cursor on
the outside border of the dialog, and once you see
double arrows, holding down your left mouse button
and dragging the border to its new size. Refer to
“Introduction to Working in Windows 95” on page 8
for more information about basic Windows concepts.
The following buttons appear on various dialogs
within MATWorX 32. You can view What’s This?
Help for all active buttons in the program by clicking
your right mouse button while positioned over the
button in question. Listed below is a description and
function of each button.
to click on a field or button in a dialog to display
What’s This Help for the item.
Clicking the OK button saves changes
and closes the dialog.
Clicking the Lookup Data button
replaces the listed data with the most current data
contained in the PBX.
Clicking the Cancel Data button stops
the lookup process. Data replaced during the lookup
process will remain changed.
Clicking the Update Data button saves
the changes on the dialog to the PBX.
Clicking the Hide Dialog button hides
the Add-In dialog from view, but leaves it loaded in
your PC’s memory so it can appear quickly if you
launch it again. All data is retained until you close the
dialog.
Clicking the Print Data button
launches the
Print Preview
dialog where you can
preview a report before printing. You can then click
the
Print Data
button to print the displayed data to
your default printer.
Clicking the Zoom button on the
Print Preview
dialog enables you to zoom in and out on a report.
Page 14NDA-24215 Revision 1.0
MATWorX 32 User’s Guide
MATWorX 32 Overview
Clicking the Export button on the
Preview
dialog enables you to save and export the
Print
displayed report to a file.
Clicking the Email button on the
Print Preview
dialog enables you to email the report directly from
MATWorX 32 if your email system supports MAPI.
Clicking the Delete Data button clears
the displayed data on the dialog. It does not clear the
data from the PBX.
Clicking the Add button enables you to
add an Add-In to the MATWo rX 32 Task bar. Refer t o
Chapter 6 “Add-Ins” for more information.
Clicking the Remove button enables
you to remove an Add-In from the MATWorX 32
Taskbar. Refer to Chapter 6 “Add-Ins” for more
information.
Clicking the Clear Grid button completely
clears the displayed grid, but does not delete the
information from the database.
Clicking the Delete Grid button clears
the grid and deletes the information from the database.
PBX. A PBX reset is required before an update can
take effect. Note, if you reset the PBX, all existing call
connections will end. Also, if you are connected to the
PBX through a direct connection, your connection will
be lost, but will be automatically reconnected.
Clicking the Close button disregards
any changes not already sent to the PBX and closes the
dialog.
Clicking the PBX Configuration
Wizard button launches the wizard.
Clicking the Setup button displays an
easy way to determine your modem’s Initialization
and Termination strings.
Page 16NDA-24215 Revision 1.0
MATWorX 32 User’s Guide
Printing a Report
The MACH Script Editor, Sched uler, and several AddIns enable you to print reports and listup data by
clicking the
dialog (Figure 2-2) automatically di splays so you can
preview the report before printing.