46
Software Overview
Software Overview
S ECTION 3
Software Overview
Matrix 3 Software Architecture Overview
Every Matrix 3 system is made up of the following components:
• Matrix Database Server. The Matrix 3 system uses MySql as its database. The database server runs as a Windows service*.
• Matrix Service Engine (MSE). This is the heart of Matrix 3; it performs all the application logic and fetches/saves data from/to the database. The MSE runs as a Windows service, dependent on the database service.
• Matrix Transceiver Server. This component translates RF communication with system devices like meters, tank level monitors (TLM) and pump air controls (PACs) on behalf of the MSE. The Transceiver Server runs as a Windows service, dependent on the MSE service.
• Matrix Client. This is the Matrix 3 user interface application. When launched by the user, it will run only if it can successfully connect to the MSE, which can be running locally or elsewhere on another computer on the network.
All of these components communicate with each other via network connections. Except for communication with the database server, the communication protocol used is HTTP. Intercommunication in this manner means that Matrix components are capable of running and operating in a very flexible, distributed manner.
They can all coexist on one computer or can each be installed on individual computers networked together.
*A Windows service is a software application that can be configured to start and run without user intervention. Typically, services have no means of direct user interaction and cannot be started or stopped unless a user has administrative privileges on the local machine. Matrix services are configured to start as soon as Windows starts, regardless of whether a user is logged in or not.
Starting Matrix 3.0
To start Matrix 3.0, double-click the Matrix 3.0 Client icon that was placed on your desktop during the software installation. You can also click the Start button on the Windows task bar and select All Programs / Graco /
Matrix
3.0 / Matrix 3.0 Client. The Matrix 3.0 Total Fluid Management System main application window opens
.
47
Software Overview
Main Application Window
Screen Elements
1
2
3
F IG . 61
IG
1.
System Layout Panel: The icons on the System Layout Panel are arranged in a tree-fashion. The icons displayed will vary depending on whether an administrator has logged into setup mode or the user is viewing the operating screens (“run” mode).
• Setup Mode - The system layout panel shows an icon for each distinct setup area. Details about setup mode and its screens are covered in the following chapter; the rest of this chapter assumes the application is not in setup mode.
• Run Mode - The system layout panel shows all the configured meters and tanks in the system, optionally organized by group.
2.
Information Panel: The data displayed in this panel reflects the user’s selection in the system layout panel and displays information from the last 10 days. After 10 days, data is not deleted, but user must run a Dispense History Report to get the information.
The data shown in the Information Panel is dependent on the user’s selection in the System Layout
Panel.
• If a tank or meter is selected, the information panel shows status and data for that particular tank or meter.
• If a device group is selected, the information panel shows data about the tanks and meters in that group. If the Matrix System is selected, data from all tanks and meters in the system is shown.
3.
System Event Log: This log is always visible and shows system events in chronological order.
48
Software Overview
System Administrator Screens
Go To ... Menus
The Go To . . .
menu is the only selection available on the menu bar located on the top of the Main Application Window.
F IG . 62
Selecting
Go To . . .
with the mouse displays a pull-down list of available options. Items that appear dimmed are not available for use.
F IG . 63
Setup & Reports
Once the Matrix PC software is installed, it’s necessary to synchronize the software with the other hardware components of the Matrix system. This is done by selecting Setup & Reports from the Go To . . . list.
This section is password protected and provides access to all Matrix setup screens. Only individuals with
System Administrator rights have access to this portion of the program.
1. Move the mouse pointer to the Go To . . .
menu located on the Tool Bar on the top of the Main Application Window. From the drop-down menu, select Setup & Reports .
The popup box shown in F IG . 64 appears for you to provide a User name and Password.
F IG . 64
2. Key in your user information. Click OK to close the screen and save the changes. For initial log on, type in matrix (lowercase) for user name and graco (lowercase) for the password. Click OK to close the screen and save the changes.
49
F IG . 65
50
Software Overview
Note: To maintain the security of your system, Graco strongly recommends changing the System
Administrator User name and Password during the initial setup procedure for your system. Until the
User name and Password are changed the default log on matrix / graco will provide access to the
Setup & Reports screens in your system. Once a new user account is created, the default matrix / graco account is disabled. Instructions for creating a new User name and Password are pro-
vided in the USERS configuration screen section beginning on page 71.
Hide / Display Arrows
The Main Application Window can be customized to hide the System Layout Panel and System Event Log sections of the screen if you do not want to display them. To hide these panels, click the Hide / Display
arrows shown in illustration A in F IG . 65 below. Illustration B in F IG . 65 shows how the screen appears
when the System layout Panel is hidden. To display the panel again use your mouse to move the cursor over the arrow pointing to the right and click the left mouse button once. The full System Layout Panel once again displays on the screen.
A
B
Software Overview
About Matrix
The screen in F IG . 66 displays. No User Name or Password are required to display this screen.
F IG . 66
Exit
Closes the Matrix User Interface Program. The Database, MSE, Transceiver, and Server continue to run.
51
Software Overview
Information Panel: Device Group Status
Global Workorders
NOTE: The Global Workorders tab only appears if Global Workorders is enabled on the System Default
setup screen, page 60.
If the tab is not selected, position cursor over the Global Workorders tab and click left mouse button once to select it.
F IG . 67
The Global Workorders tab displays a list of all Global Workorders that have been added to the Global
Workorder Queue. At this point these workorders have not been assigned to any specific meter - they are simply entered and define the quantity of a specific fluid. Only meters that are connected to those fluids can view these global work orders
• Timestamp: displays the month, date, year and time that the event took place
• Work Order: number assigned to the work order
• Job Code: number assigned to the job code
• Amount: quantity dispensed by the meter, measured as either Pints, Quarts, Gallons or Liters
• Fluid: type of fluid dispensed
• Group: defines which Meters in the Matrix System were assigned the Global Workorder and performed the dispenses
52
Software Overview
Dispenses Tab
If the Dispenses tab is not selected, position cursor over the Dispenses tab and click left mouse button once to select it
.
F IG . 68
The Dispenses tab displays three tables: Pending Dispenses, Completed Dispenses and Dispense Notes
(described on the following pages).
The columns displayed in the Pending Dispenses and Completed Dispenses tables are configurable. Columns can be hidden or shown, the column’s sort order can be changed according the end user’s needs.
This configuration is done in the Matrix System Setup Screens, User Interface Setup, page 67. The screen
configuration affects all Matrix clients in the system.
Pending Dispenses: Shows all started, but not completed dispenses made by any meter in the system.
When the dispense is completed, it is removed from the pending table and added to the top of the Completed Dispenses table. A user can view notes for individual dispenses by selected a completed dispense row.
• Timestamp: displays the day, month, date, time, and year that the dispense took place
• Meter Name: specific name assigned by the System Administrator on the Setup screens to identify a specific meter
• Amount: quantity dispensed by the meter, measured as either Pints, Quarts, Gallons or Liters
• Fluid: type of fluid dispensed
• Work Order: number assigned to the work order
• Job Code: number assigned to the job code
• Battery: amount of battery life remaining
53
Software Overview
Completed Dispenses: List of all dispenses that have been completed by all meters in the system.
F IG . 69
• Timestamp: displays the month, date, year and time that the event took place
• Meter Name: specific name assigned by the System Administrator on the Setup screens to identify a specific meter
• Amount: quantity dispensed by the meter, measured as either Pints, Quarts, Gallons or Liters
• Fluid: type of fluid dispensed
• Work Order: number assigned to the work order
• Job Code: number assigned to the job code
• Battery: amount of battery life remaining
•
First Note: displays the first note listed in the Dispense Note Field Tab (page 69). Up to 4 notes
can be created on the screen but only first one displays here.
.
Dispense Notes: Additional, supporting information supplied by the technician related to a dispense such as “Paid” when the dispense is billed to the business software.
Dispense Notes can only be added at the PC.
Dispense notes will only appear on the Dispense Tab once the note has been created and after the dispense has occurred.
F IG . 70
54
Software Overview
Tank Levels Tab
Position cursor over the Tank Levels tab and click left mouse button once to select it
.
F IG . 71
The Tank Levels tab displays 2 tables: Tank Levels and Tank Activity (described on the following pages).
The columns are configurable. This configuration is done in the Matrix System Setup Screens, User Inter-
face Setup, page 67.
The Tank Levels table provides a list of all configured tanks in the system. A tank level monitor (TLM) is not required for a tank to appear on the table.
F IG . 72
• Timestamp: displays the month, date, year and time that the tank level reading took place.
• Tank Name : displays each fluid storage tank in use with the Matrix system and the numbers or labels that are assigned to them.
• Fluid: displays the type of fluid stored in the tank.
• Level: displays the total amount of fluid.
• Battery displays the amount of battery life remaining.
55
Software Overview
The Activity table provides the tank level status activity for all tanks in the system. Use mouse to select a
Tank on the Tank Levels portion of the screen. In the History section of the screen, a record of events related to that tank and the times for those events are displayed. If Tank Level Monitors are used in the system, TLM readings are recorded. If TLM’s are not used in the Matrix system, only manual adjustments
are displayed (see Tanks setup screens, page 86).
F IG . 73
• Timestamp: displays the month, date, year and time that the activity took place.
• Readings & Adjustments : (when installed) report from TLM of fluid levels in tanks at specific dates and times. For all tanks, report of any manual adjustments made.
• Comment: field for technician to provide additional data related to a tank
The Manual Adjustment feature can be accessed by selecting the tank to be adjusted (in the Matrix System panel on the left side of the screen). Once the tank is selected click the Adjust Volume button. This feature is Administrator Password protected. Provide the user name and password on the Login Screen
and click the OK button. The amount of fluid can then be increased or decreased manually (F IG . 74).
F IG . 74
56
Software Overview
Events Log
The lower portion of the Screen contains the Events Log, a report of system-wide events that have occurred and the dates and times for those events. This information can be hidden if you do not wish to
routinely display it using the Hide / Display Arrows (see Hide / Display Arrows on page 49).
F IG . 75
• Timestamp : displays the month, date, year and time that the event took place.
• Event : lists type of event that occurred.
• Detail: additional information related to the event.
• Device: equipment that triggered the event report: meter, tank, TLM, PAC.
• Location: where in the Matrix Operating System the device is located.
57
