You are on page 1of 81

223-10292

CLASS-Balance Agent Version 2


Instruction Manual

Read this manual carefully before operating the software, and retain it for
future reference.

SHIMADZU CORPORATION
ANALYTICAL & MEASURING INSTRUMENTS DIVISION
KYOTO, JAPAN
Before Using CLASS-Agent Software
Thank you for purchasing CLASS-Agent Software. To get the most out of this s oftware, read this manual
carefully before use.

This instruction manual describes how to use and operate CLASS-Balance Agent Version 2. It assumes
that the user has a basic familiarity with Windows® 95/98/NT/2000/XP and experience using a personal
computer.

The basic terminology used in Windows® 95/98/NT/2000/XP is used in this instruction manual to explain
procedures for using CLASS-Agent Software. For definitions of unfamiliar words, please refer to the
Windows® 95/98/NT/2000/XP manual or help file.

A first-time user of Windows® 95/98/NT/2000/XP should first obtain a basic level of understanding of
the operating system before reading this manual.

Software Restrictions
1. This Software is the proprietary property of the Shima dzu Corporation. Shimadzu Corporation retains
all rights to this Software.
2. No part of this Software may be copied or reproduced in any form or by any means, except for
installation and routine backup. No part of this Software may be leased, assigned, transferred,
recompiled or altered in any form or by any means.
3. Shimadzu Corporation shall not be liable to the purchaser or any other person for any loss or damage
arising out of the use or operation of this Software.
Contents
Preface
About CLASS-Agent Software
About the Instruction Manual
Important Information

Chapter 1 Introduction
1.1 Features.........................................................................................................1-1
1.1.1 Features of the Balance Gateway Program...............................................1-2
1.1.2 Features of Agent Manager.....................................................................1-3
1.2 Handling Precautions .......................................................................................1-4
1.2.1 Before Using CLASS-Agent Software.....................................................1-4
1.2.2 About the Balance Agent Program...........................................................1-6
1.2.3 About the Agent Manager Program..........................................................1-7

Chapter 2 Getting Started


2.1 Balance Agent Program Set Up.......................................................................2-1
2.2 Storing Weighing Data in a Database ...............................................................2-3
2.2.1 Starting the CLASS-Balance Agent Program............................................2-3
2.2.2 Logging In to the System .........................................................................2-5
2.2.3 Specifying a Database for Each Instrument...............................................2-6
2.2.4 Making Measurements ............................................................................2-8

Chapter 3 Operations
3.1 Introduction ....................................................................................................3-1
3.2 Main Screen ...................................................................................................3-2
3.3 Logging In ......................................................................................................3-3
3.4 Logging Out....................................................................................................3-4
3.5 Creating or Opening a Template File ................................................................3-5
3.5.1 Selecting Data Formats.................................................................................................3-5
3.5.2 Editing a Template File ..................................................................................................3-7
3.6 Deleting a File...............................................................................................3-17
3.7 Printing.........................................................................................................3-18
3.7.1 Defining Cell Size .......................................................................................................3-20
3.7.2 Selecting a Font (Print Font)........................................................................................3-21
3.8 Setting Transfer Protocol...............................................................................3-22
3.9 Defining a Balance Name ..............................................................................3-23
3.10 Making Measurements..................................................................................3-24
3.10.1Starting Measureme nts ...............................................................................................3-24
3.10.2Select Template file Screen.........................................................................................3-25
3.10.3Filtering Screen..........................................................................................................3-26
3.10.4Measurement Screen..................................................................................................3-27
3.10.5Interrupt Measurement ...............................................................................................3-29
3.10.6Complete Measurement ..............................................................................................3-30
3.11 Select Database............................................................................................3-31
3.12 Customizing the Screen Display .....................................................................3-36
3.11.1Showing or Hiding the Toolbar or the Status Bar...........................................................3-36
3.12.2Selecting a Font ..........................................................................................................3-37
3.13 Configuration ................................................................................................3-38
3.14 Default folder ...............................................................................................3-40
3.15 Defining the Number of Decimal Places .........................................................3-41
3.16 Restrictions on Key-ins..................................................................................3-42
3.17 Managing Windows.......................................................................................3-43
3.18 Windows Lock..............................................................................................3-45
3.19 Help Topics..................................................................................................3-46

Appendix A
A.1 Weighed Data Files, Template Files and Paused Files .......................................A-1
A.2 Structure of the Weighed Data File .................................................................A-2
A.3 Contents of a Database ..................................................................................A-4
A.4 Compressed Files for Register Data ................................................................A-6
A.5 Temporary Database......................................................................................A-7
A.6 Log Database................................................................................................A-7
A.7 User Permissions for the Balance Agent Program............................................A-8
A.8 Instrument Configuration File ..........................................................................A-9
Preface
About CLASS-Agent Software
CLASS-Agent Software is database management software designed to create a link between data
processing application software and a database. It provides various database management
functions and capabilities. Data can be automatically stored in a database that is created in a format
used in general-purpose database applications, such as MS-Access 97 and MS SQL Server and
Oracle . Data stored in the database can be sorted by sample, instrument or user. This makes it
easier for the user to sort analysis/measurement data (analysis/measurement files) that are read
from any Shimadzu chromatogram data processing product (CLASS-VP, LABsolutions) or from
any balance.

With this software, the user can perform an analysis without having to decide where to store
analysis results and what to specify as a filename. The user is able to analyze data stored in a
database, summarize analysis results, and prepare detailed printed reports like test reports,
summary reports, and daily routine reports. These data management capabilities are designed to
relieve the user from the burden of storing and recording data, thereby increasing the efficiency of
routine operations.

In this software, a database can be created in a format used by commercially available


general-purpose database applications. The user is able to create a personalized database using
such application software as MS-Access, MS-Excel and MS-Word.

About the Instruction Manual


The authors have used their best efforts to prepare this document and provide current information.
However, the information and software discussed in this document are subject to change. For the
latest information, read the contents of the "README2.TXT" file in the program directory of this
software.

The names of data processing software and equipme nt are expressed generically. Model names
and type names are indicated where it is necessary to identify software or equipment.

This software package is referred to as "CLASS-Agent Software" in this manual.

Important Information
The following conventions are used throughout this instruction manual to indicate important
information.

[CAUTION] indicates a potentially hazardous situation where damage to property may occur if
precautions are not followed.

[NOTE] emphasizes additional information that increase the efficiency of operations or


expand the understanding of topics.
Chapter 1 Introduction
1.1 Features.................................................................................................... 1-1
1.1.1 Features of the Balance Agent Program.......................................................................... 1-2
1.1.2 Features of Agent Manager ............................................................................................... 1-3
1.2 Handling Precautions............................................................................... 1-4
1.2.1 Before Using CLASS-Agent Software............................................................................ 1-4
1.2.2 About the Balance Agent Program .................................................................................. 1-6
1.2.3 About the Agent Manager Program ................................................................................. 1-7
1 Introduction

CLASS-Balance Agent is software that comes with two component programs as listed below. It is
designed to: read weighing capacity values from an electronic balance through a RS -232 interface to a
personal computer; perform spreadsheet calculations; report spreadsheet data and store data in a
database.
CLASS-Agent Manager software makes it easier to view, print or approve stored data, add sample
information, copy data to other applications and restore analysis files.
CLASS-Balance Agent software supports GLP/GMP-compliant security capabilities and log
capabilities, making it easier to audit the operations performed by users.

Component Programs
• Balance Agent program
• Agent Manager program

1.1 Features
CLASS-Balance Agent provides the following features.

1. Stores mass files automatically (stores compressed archive files automatically).


2. Records mass information automatically (registers analysis values to a database).
3. Keeps logs of operations performed automatically (a log contains data on registered
user names, displayed user names, and operations performed by each user).
See Note 1.
4. Provides security management for mass data.
5. Stores or views mass data and logs on a LAN.
6. Extracts, views, sorts or prints stored data.
7. Executes approval workflow.
8. Adds sample information (lot number, sampling place, time, etc.).
9. Transfers sample information to other applications.
10. Restores analysis files and method files.
11. Sends notice of analysis completion or analysis data by e-mail. See Note 2.
See Note 3.
12. Uploads approved data to the host.

Note 1. Analysis data is manually transferred using Agent Manager.


Note 2. Use of this feature requires the creation of a data transfer program (Optional).

1-1
1 Introduction

1.1.1 Features of the Balance Agent Program


The Balance Agent program (BAL_MT.EXE) enables a user to read mass data obtained from
various electronic balances to a personal computer , perform spreadsheet calculations, add
sample information and retain the results in a database.

A user can do the following:


1. Organize information on standard report form for database registration.
2. Perform spreadsheet calculations and report spreadsheet data using weighing capacity
template file.
3. Add sample information.
4. Pause the execution of a weighing capacity template file, or restart a paused job.
5. Keep a log of operations performed.

1. Organize information on standard report form for database registration.


2. Save analysis files as archive files. (template files, Paused files).
3. Database registration and Management of template files, Paused files.
3. Creation of analysis report in pdf-file form.
4. Save html files of analysis data and paused log in an object link request file as object link
files.
5. Keep a log of database registration.
6. Share and control system resources on a LAN.

1-2
1 Introduction

1.1.2 Features of Agent Manager


The Agent Manager program (Agentman2.exe) enables a user to view analysis data in a database
from a personal computer in a local area network. This feature can be used on all personal
computers to which the Agent Manager program has been installed, regardless of w hether the
Automatic Agent Program is installed. An Administrative CLASS-Agent Software License is
required.

A user can do the following:


1. View a list of databases.
2. View, extract, sort or print sample information/analysis values stored in a database.
3. View a combination of data information and sample information, and display several rows
of a data information/sample information table.
4. Copy, move, or delete information contained in a database.
5. Decompress compressed files, or restore analysis files.
6. View object link files.
7. Copy displayed data or object data (chromatogram data) to the Clipboard.
8. Set an approval flag to data according to the approval flowchart.
9. Add sample tag information (lot number, sampling place, etc.) for up to 10 items.
10. View or print a log of stored data.
11. Send analysis data by e-mail.
12. Create user accounts and user groups (for security protection).
13. Create new databases in MDB format (SQL format requires the use of accessory programs).
14. Make backups of databases.
15. Register additional system logs.
16. Shift from a LAN environment to a local environment.
17. Link objects with filename extensions.

For detailed information, see the CLASS-Agent Manager Software Instruction Manual.

1-3
1 Introduction

1.2 Handling Precautions


When using CLASS-Agent Software, the following precautions should always be followed.

1.2.1 Before Using CLASS-Agent Software


1. Using CLASS-Agent Software on a LAN
(1) CLASS-Agent Software recognizes a network computer name as a registered
instrument name. Do not connect PCs on a LAN if they have the same name.
(2) Use a unique name for an analysis device that can read by the Automatic
Agent Program. The unique name should be identified in the database.

2. About Archive Files and Object Link Files


CLASS-Agent Software supports MS -Windows' long filenames (up to 255
characters).

3. About Database Name and Subdirectories


CLASS-Agent Software automatically creates a directory where a database is
stored and subdirectories where archives files and object link files are stored, so
that these files are linked to databases. Do not change database names and
directory names using Windows Explorer. If a database name or directory name is
changed, the files cannot be found by the CLASS-Agent software and archive
files cannot be decompressed.

4. Using the Accessory Programs


CLASS-Agent Software comes with accessory programs. Do not use these
accessory programs in any other application software. Use the accessory
programs in accordance with their respective manuals.

5. Running Other Applications


Do not run CLASS-Agent Software and other applications that are not supported
by CLASS-Agent Software at the same time. Even if CLASS-Agent Software and
applications supported by CLASS-Agent Software are used at the same time, an
error may be caused due to heavy load, depending on CPU speed, memory space
and use of a LAN. Use only a PC that meets the minimum system requirements.

6. About Database Size


• For an MDB-format database, set the maximum number of records in a sample
information table to somewhere around 10,000. If records exceed the maximum
number, create a new database so that the records can be divided between the
two databases . Use CLASS-Agent Software to create the new database.
• For an MSDE (Microsoft Database Engine) database, the upper limit of the
database size is 2 GB. If data to be saved exceeds this, the data is saved in an
MDB-format temporary database. The administrator should check the database
size temporarily, and change the settings of the Agent system so that the data is
saved to a new database before the database size reaches 2 GB. Alternatively,
the administrator should make a backup of the database, then delete unnecessary
data to increase free space in the database. To handle databases of 2 GB or more,
replace the current system with the SQL Server system (sold separately).

1-4
1 Introduction

7. Restriction in Character Codes Available in a Database


In the display field of a database table, codes for “|” (pipe), line feed and tab
cannot be input. If these codes are included in an element name or comment, they
are replaced with a space.
Example ElementA|ElementB

ElementA ElementB

8. About Setting the Date


When using Class-Agent, do not set the day of the week in "Short date style"
available by choosing [Control Panel] → [Region Settings] → [Date].
Example (Valid) yy/MM/dd
(Invalid) yy/MM/dd’(ddd’)’
In Agent Ver. 2, any time in the date field of a database is stored as the GMT
(Greenwich Mean Time).
To display the local time w hile the database is directly accessed, adjust the stored
GMT time.

9. Changing the Password Using the Database Software


When the password of a database is changed using the database software
(MS-Access, SQL Server or Oracle), the database link setting in the Agent
Manager and the Automatic/Manual Agent should be reset.

1-5
1 Introduction

1.2.2 About the Balance Agent Program


1. Starting the program for the first time
Set the method of transmission, balance names, destination database for each
balance and restrictions on key-ins before using this program. A user having
administrative permissions must log in and make the settings. In addition, a Login
ID must be defined and a database must be created.

2. About Template Files


Several example weighing capacity template files are created during installation.
The template files are available for a reference purpose only and may not contain
everything that is needed. Use the template files as examples when creating
template files.

3. Security protection against auto login attempts


If an auto-login option is selected in the "Options " dialog box, a login attempt can
be made under any login ID different from the one assigned to the user. Do not use
an auto-login option if it is necessary to control access and manage users at a
login. A password must be defined for each user.

4. Weighing Data Registration Destination


When data is registered, the following data are changed for compatibility with the
Ver. 1.
(1) For method 1 (BAL_1), the data was registered in "DoubleData1"
conventionally. In Ver. 2, data is registered in "DoubleData16."
(2) For method 2 (BAL_2), the data was registered in "FloatData1" to
"FloatData15" conventionally. In Ver. 2, data is registered in "DoubleData1"
to "DoubleData15."
(3) For method 2 (BAL_2), in Ver. 2, the data can be registered also in
"DoubleData16" to "DoubleData20." Therefore, up to 20 data can be
registered.

5. Weighing data loading date/time


In Agent Ver. 2, the time in the date field of the database is stored using GMT
(Greenwich Mean Time), however, the weighing data loading date/time in the
method 1 is stored in the character string field, and is saved using local time.

1-6
1 Introduction

1.2.3 About the Agent Manager Program


1. About the Default System Administrator
If running CLASS-Agent Manager for the first time, log in to CLASS-Agent
Manager using the following: ID= “Admin” and Password= “” (blank). After
starting CLASS-Agent Manager, change this login ID's password. The login ID
“Admin ” is the Supervisor account that has the system administration permission
for CLASS-Agent Software. The login ID “Admin” is created during installation.
2. Sharing a Database on a LAN
To share files on a local area network (LAN), set up the network capabilities in the
"Configuration" dialog box in CLASS-Agent Manager after the installation of
CLASS-Agent Software is completed. If folders are shared on a LAN after
CLASS-Agent Manager is installed, care should be taken to select the appropriate
options, otherwise the settings for instrument information and log information
may be overwritten.
3. Creating a User Account
Specify a login ID, user name and security level when creating a user account.
The creation of a user account is limited to users having the Administrator
permission. Each user can change his or her own password at any time after
logging in to CLASS-Agent Manager.
4. Creating a Database
In the "New MDB Database" dialog box in CLASS-Agent Manager, create an
MDB database to store analysis data. The creation of a database is limited to users
having the Administrator permission. To create an MS SQL Server formatted
database or MSDE (Microsoft Database Engine) formatted database, use the
CLASS-Agent Manager accessory program for creating an SQL database.
5. Listing and Viewing Log Databases or Temporary Databases
Three default databases are displayed on a database-list screen in CLASS-Agent
Manager. They include the system log database, temporary data database
(Temp_Dt2.mdb) and temporary log database (Temp_Log2.mdb). They are
created during installation, with passwords assigned. These databases cannot be
viewed using MS Access or any other application. These databases can only be
viewed in CLASS-Agent Manager.
6. Screen Saver
This software is equipped with automatic logoff function (version 2.20 or later).
Accordingly, the special screen saver for Agent system that was effective in the
version before 2.11 does not function immediately after installation.

To change this value, change “common.inf2” in "Configuration Setting" of the


Agent Manager. For example, to set to 10 minutes the waiting time until the
screen saver starts, change “ScreenLock” value to “10”.
[GLP]
ScreenLock=10

To make the setup valid, save this setup and restart this software.
If the password is required at releasing the screen saver, set up the password for
screen saver using the setup screen on operating system.

1-7
1 Introduction

7. Log Types
Log information is separated into the data log for data operations and the system
log where logs related to the system are saved.
When the contents of the database storing the data acquired from the analysis
instrument are changed, the history of such changes is stored in the data log.
When the contents of options not directly related to the data are changed, the
history of such changes is stored in the system lo g.
Click the log on the database tree to display the log information on the sample
information table.
8. Precautions for Multiple Users in Windows NT
The common network settings offered by choosing [Tool] → [Configuration] on
the Agent Manager menu should be executed by a user having the NT “Power
Users” or “Administrators” permission.
9. Changing the toolbar
Due to restrictions in the application, nothing is displayed in “Available buttons”
in the left part of the toolbar change screen. When changing the displayed
buttons, press the [Reset] button to display all buttons, then delete or add buttons.
If “Separator” is added to “Available buttons”, buttons will not be displayed on its
right side. Do not add “Separator”.
10. PDF Signature
When changing the approval flag in the signature processing for “Confirm”,
“Review” or “Approve”, if a PDF file is present in the signature target sample, the
signature can be automatically written to the PDF file by prior setting. Execute
the prior setting in “PDF Signature” on the “Configuration” dialog started from
the “Configuration” submenu of the “Tool” menu.
11. Installing the Acrobat 5.0
The Acrobat 5.0 (product version) is required to execute the [Acrobat Print] menu
and the PDF signature processing.
12. Database name in the Agent Manager
A database name (file name) must be within 64 characters. (When database
names are backed up in a CD-R, they are compatible with the JULIET format.)
13. Creating the Oracle database in the ER/ES mode
To create Oracle database table in the ER/ES mode without using Oracle-format
database creation program(DB Utility for Oracle), use “ora_eres.sql” saved in the
CD-ROM as the SQL for creating tables.
14. Starting the application by double-clicking
Double-click a link file string in the sample information to start up the application
in accordance with the extension.
For use of a database in the MDB format, a started-up file is automatically
updated if the contents are changed because the file was directly opened. In this
case, the history of modifications is not left. After version 2.2, even with MDB
format, optional function to open the file that has been copied in the temporary
area is added.
For use of a database in the SQL or Oracle format, a started-up file is not updated
even if the contents are changed because the file was copied to a temporary area
once, then opened. In other words, the contents cannot be changed.

1-8
Chapter 2 Getting Started
2.1 Balance Agent Program Set Up............................................................... 2-1
2.2 Storing Weighing Data in a Database ..................................................... 2-3
2.2.1 Starting the CLASS-Balance Agent Program ................................................................ 2-3
2.2.2 Logging In to the System ................................................................................................... 2-5
2.2.3 Specifying a Database for Each Instrument .................................................................... 2-6
2.2.4 Making Measurements ....................................................................................................... 2-8
2 Getting Started

2.1 Balance Agent Program Set Up


The Balance Agent program must be configured before use. This section describes how to
configure the Balance Agent program.

1. Setting a Destination Folder


Click the [Default folder] tab of the [Options] dialog box. Specify a database name for the
Template Database, the Balance1 Result Database, the Balance2 Result Database, and the
Pause database..

Template Database The template files are registered in this database.


Balance1 Result Database Data acquired in the balance1 are stored in this database.
Balance2 Result Database Data acquired in the balance2 are stored in this database.
Pause database The interruption Data are stored in this database.

2-1
2 Getting Started

2. Setting a Balance Name


Choose [File] → [Propert ies] and click the [Balance Name] tab. Specify the balance name to
which each channel is connected. The balance name specifies information contained in a
database. Default settings are automatically entered in the "Instrument 1" and " Instrument
2" text boxes.

3. Setting Balance Type and Data Transfer Protocol


Choose [File] → [Properties] and click the [RS -232C Settings] tab. Specify the balance type to
which each channel is connected, and communications parameters (data transfer protocol) for
the RS-232C interface between the electronic balance and a personal computer. Even if the
balance type is specified, the data transfer protocol must be specified identically to that
specified for each balance.

2-2
2 Getting Started

2.2 Storing Weighing Data in a Database


This section introduces procedures for storing weighing data in a database.

Flowchart of Operations

Create a user account and database in Agent Manager.

Start the CLASS-Balance Agent program.

Log in to the system.

Set up each instrument.

Register data in the CLASS-Balance Agent program

Check registered data in Agent Manager.

2.2.1 Starting the CLASS-Balance Agent Program


1. Before using the program
Before using CLASS-Balance Agent, create a user account and database using the Agent
Manager program. Specify a user ID and password at a login to the system. For these
procedures, see the CLASS-Agent Manager Software Instruction Manual.

2-3
2 Getting Started

2. Starting the program


The following shows two typical methods of starting the program.
Using the Start button
Click the [Start] button, point to [Programs] → [Class-Agent Software Ver.2.0] and click
[Balance Agent].

Click here.

Using a folder icon on the desktop


(1) On the desktop, double-click the icon for the CLASS-Agent Software. The
CLASS-Agent Software folder opens.

Double-click here.

(2) Double-click the icon for [Public Automatic Agent].

Double-click here.

2-4
2 Getting Started

2.2.2 Logging In to the System


After the program starts, the "Login" dialog box is displayed.

- The "Login" dialog box -

Type a login ID and password in the text boxes. Regardless of the characters typed, only
asterisks (*) appear in the "Password" text box. The password must be correctly entered.
Passwords are case-sensitive.

Click the [OK] button. The login ID and password are checked against the ones recorded for the
user account. If they match the stored entries, the main screen is displayed under login status.
Clicking the [Cancel] button aborts a login attempt, but the main screen is displayed. To gain
access to the system, follow the login procedure from the main screen.

- The main screen -

2-5
2 Getting Started

2.2.3 Specifying a Database for Each Instrument


The database which stores the template, the interruption data, and the result of the amount of the
scale data of each device is set. To amount of the scale “C:\Agent2\Shimadzu_01.Mdb" in
device 1 here data which is, the storage example is described (The Agent manager should make
the data base beforehand).

1) [Tool]-[Option] menu is selected, and The “Default folder” tag is clicked by "Option
setting" dialog. It becomes the following set screens. The database is set in CLASS-Balance
Agent program corresponding to the template, the interruption data, the data of the amount
of the balance1 or balance2.

- The “Default folder" pane in the "Option” dialog box -

3. In the "Destination database " list box, specify a database in which to store data. Clicking
the [Browse] button opens the "Select Database" dialog box.

- The "Select Database" dialog box -

2-6
2 Getting Started

In the "Select Database" dialog box, click “Test1.mdb” to specify the destination
database, and click the [OK] button.

4. The database which stores the template, the interruption data, and the result of the
amount of the scale data of each device is set.
- The <Browse for Folder> dialog box. -

2-7
2 Getting Started

2.2.4 Making Measurements


1) Set up the Balance Agent program. For detailed information, see the CLASS-Balance Agent
Instruction Manual.
2) Check on the “View”-"Status ” item of the tool menu, and "Status display" window is
displayed the data base registration must be comprehensible.
3) Open a template file using the CLASS-Balance Agent program, and import weighed values
from an electronic balance. Values may be entered manually.
- The Balance Agent pane -

4) The "Status" pane displays the status of compressed files, copied files and registered
databases.
- The "Status" pane -

5) Check the database using Agent Manager.

2-8
Chapter 3 Operations
3.1 Introduction ............................................................................................. 3-1
3.2 Main Screen............................................................................................. 3-2
3.3 Logging In............................................................................................... 3-3
3.4 Logging Out ............................................................................................. 3-4
3.5 Creating or Opening a Template File ...................................................... 3-5
3.5.1 Selecting Data Formats ...................................................................................................... 3-5
3.5.2 Editing a Template File...................................................................................................... 3-7
3.6 Deleting a File ........................................................................................3-17
3.7 Printing ...................................................................................................3-18
3.7.1 Defining Cell Size.............................................................................................................3-20
3.7.2 Selecting a Font (Print Font)...........................................................................................3-21
3.8 Setting Transfer Protocol........................................................................3-22
3.9 Defining a Balance Name .......................................................................3-23
3.10 Making Measurements ...........................................................................3-24
3.10.1 Starting Measurements .....................................................................................................3-24
3.10.2 Select Template file Screen.............................................................................................3-25
3.10.3 Filtering Screen .................................................................................................................3-26
3.10.4 Measurement Screen.........................................................................................................3-27
3.10.5 Interrupt Measurement .....................................................................................................3-29
3.10.6 Complete Measurement ...................................................................................................3-30
3.11 Select Database.......................................................................................3-31
3.12 Customizing the Screen Display ............................................................3-36
3.11.1 Showing or Hiding the Toolbar or the Status Bar .......................................................3-36
3.12.2 Selecting a Font .................................................................................................................3-37
3.13 Configuration..........................................................................................3-38
3.14 Default folder..........................................................................................3-40
3.15 Defining the Number of Decimal Places ................................................3-41
3.16 Restrictions on Key-ins ..........................................................................3-42
3.17 Managing Windows................................................................................3-43
3.18 Windows Lock........................................................................................3-45
3.19 Help Topics ............................................................................................3-46
3 Operations

3.1 Introduction
The Balance Agent program is designed to create request test files (“weighed data files”) that are
used to register weighed values to a database using CLASS-Balance Agent, one of the
components of CLASS-Agent Software. The weighed values are exported from an electronic
balance through an RS-232C interface to a personal computer.
When weighed values are obtained from an electronic balance, the Balance Agent program
performs calculations using specified formulas. After all weighing processes are completed,
sample information, weighed values, and calculations are saved to a weighed data file, which
will be read and registered by CLASS-Balance Agent to a database. After database registration,
weighed data can be viewed, edited or printed using Agent Manager.

The following files are compressed when weighed data is registered to a database.

• Template file
• Paused file
• Weighed data file

These compressed files can be decompressed at any time using Agent Manager.

The following lists the electronic balances that can be connected to the Balance Agent program.

• SHIMADZU models
AEU/AEL series, AEM/AEG series,
AW series, AX series, AY series
BW series, BX series,
AT/MT/UMT series, AB/PB/SB series,
PG/SG series, PR/SR series

• METTLER models
AE series, AG series, AT series,
PM series

• Sartrius models
ME series
CP series

[NOTE] • For the AT/MT/UMT Series, AB/PB/SB Series, PG/SG Series and PR/SR Series,
such series can be connected when an equivalent product manufactured by
METTLER is selected as the transmission protocol.
• Other models of electronic balances are not supported by this program.
To connect any other model, contact your Shimadzu representative.

3-1
3 Operations

3.2 Main Screen


The following shows the CLASS-Balance Agent Agent window, the main screen used to
perform various functions.

- The main screen -

Menu bar Toolbar

Status bar Status display Detail Information

Procedure
1) Double-click the icon for [Balance Agent] to open the main screen.

2) When the "Normal login" radio button in the "Configuration" tab of the "Options" dialog
box (See “3.14 Default User ”) is turned on, the main screen is displayed, followed by the
"login" dialog box (See “3.3 Logging In”).

After login, all functions may be used. When the "Automatic login" radio button in the
"Configuration" tab is turned on, the main screen does not appear because the login is
automatically performed using the specified login ID.

3-2
3 Operations

3.3 Logging In
A login is used to identify a user.
The [Login] menu command is executed from "Logout" status. The current user must log out
before another user can log in.

- The "Login" dialog box -

Procedure
1) After starting the Balance Agent program, choose [File] → [Login] in the main screen. The
"Login" dialog box is displayed. When the "Automatic login" radio button in the
"Configuration " tab is turned on, the main screen does not appear. See “3.16 Configuration”

2) Type a login ID and password.

3) Click the [OK] button.


A user is identified as an authorized user if the login ID and password entered meet the
following two conditions: the login ID and password entered match the ones registered to
Agent Manager; and the user has the Run Agent/GW permission. If these conditions are not
met, another login attempt should be made from the beginning.
Clicking the [Cancel] button aborts a login attempt.

[NOTE] For procedures for creating a user account and granting user permissions, see the
CLASS-Agent Manager Software Instruction Manual.

3-3
3 Operations

3.4 Logging Out


A logout exits the "Login" state.
The [Logout] menu command is executed from login status.

Procedure
1) Choose [File] → [Logout] in the main screen.
The "Logout" message box is displayed.

- The "Logout" message box -

2) Click the [Yes] button to logout. Click the [No] button to cancel logout.

3) logout is executed. After logout, no functions of the Balance Agent program are available.

3-4
3 Operations

3.5 Creating or Opening a Template File


A template file is used for defining the data format of a sample information table or data
information table (the number of digits and formulas). With a template file, weighed data is
obtained from an electronic balance when measurements are made.
The created template file should be preserved on the disk once as the file, and to use it by an
actual analysis, register the preserved file in the database.

• [New Template]
This command is used to create a template file. The "Database Save Form" dialog box is used
to select the data format of a template file. The "Edit Template" dialog box is used to edit a
template file.
• [Open Template]
This command is used to open the "Editing of template file" dialog box and select a template
file.

The use of these features is restricted to users having the Edit Template/Schedule permission.

3.5.1 Selecting Data Formats


Data obtained from an electronic balance is written in a data information table.
The "Database Save Form" dialog box is used to select the format of the data information table.

- The "Database Save Form" dialog box -

3-5
3 Operations

Option Items
1) The Data Format section
This section is used to specify the data format of a data information table.
Select either the "Form 1" radio button or the "Form 2" radio button.

• The "Form 1" radio button


If this check box is ON, up to 999 rows and 26 columns can be used for data entry. A single
record constitutes 1 piece of weighed data. For example, If data is organized in 4 rows and
3 columns, 12 records of data is entered in a data information table.

• The "Form 2" radio button


If this check box is ON, up to 999 rows and 20 columns can be used for data entry. A single
record constitutes 1 row of data. For example, if data is organized in 4 rows and 3 columns,
4 records of data is entered in a data information table.

2) The "More than one sample mode" check box


If the "Form 1" radio button is checked, turn on the "M ore than one sample mode" check
box. If this check box is ON, a template file will contain several pieces of sample
information. A single piece of sample information is entered in a single column of a data
information table.

Procedure
1) Choose [File] → [New Template]. The "Database Save Form" dialog box is displayed.

2) Turn on either the "Form 1" or "Form 2" radio button.


If the "Form 1" radio button is checked, turn on the "More than one sample mode" check
box.

3) Click the [OK] button to open the "Edit Template" dialog box.
Clicking the [Cancel] button aborts the creation of a template file and closes the "Database
Save Form" dialog box.

3-6
3 Operations

3.5.2 Editing a Template File


This section describes how to edit a template file.

- The "Edit Template" dialog box -

Option Items
1) The "Sample Information" section
This section is used to enter data in a cell. Data items can be keyed in or selected from a list
box.
• Sample name • Operator
• Sample ID • Description
• Sample type • Sample info. 1-10

Before selecting data items from a list box, open the definition file named “Common.Inf2”
that defines the sample information format, and the options for each item. For detailed
information, see the Agent Manager Instruction Manual.
When data is registered in the database, the login user name is automatically set as for
the operator's name.

[NOTE] For Sample Information 1-10, the column headings may be edited. For the procedure
to define items and editing column headings of a sample information table, see the
Agent Manager Instruction Manual.

2) The "Data Information" section


This section provides the following options of measured data.
• rows/columns (sample size) • formula
• row heading/column heading • the number of digits
• manual input(Prohibit/Permission)

3-7
3 Operations

Procedure
1) To open the "Edit Template" dialog box, follow either of the following steps.
• Choose [New Template] and click the [OK] button in the "Database Save Form" dialog
box.
• Choose [File] → [Open Template].

2) Make the setting in the "Sample Information" and "Data Information" sections and save
changes made by selecting [Save] or [Save As].

3) Choose [File]-[Regist database] in the "edit of the template" screen, and the template is
registered to the data base. It is necessary to set the database beforehand by "Option setting"
at the registration destination.

3) In the "Editing of template file" dialog box, choose [File] → [Exit] to close the dialog box.

Functions
1) Save and Save As
These commands save and name a template file.

2) Register to the database for template sheets


The edited template sheet is registered in the database for the template.

3) Rows and Columns (Sample Size)


These commands define the number of rows and columns of a data information table, or
define sample size if the "More than one sample mode" check box is checked.

4) Row/Column Headings
These commands edit a row/column heading.

5) Formulas
This command enter s a formula in a cell. Note that data obtained from an electronic balance
will not be entered in the cell that contains a formula.

6) The Number of Decimal Places


This command defines the number of decimal places. The number of decimal places is
defined for cells, rows or columns.

7) Prohibiting of inputting
Whether the cell which selects it is prohibited from inputting the hand or it permits is set.

8) Cut, Copy, Paste and Delete


These commands are used to edit a sample information table or data information table.

3-8
3 Operations

3.5.2.1 Saving and Naming a Template File


This section describes how to save and name a template file.
• [Save] : This command replaces an existing file.
• [Save As] : This command saves a file under a new filename.

- The "Save As" dialog box -

Procedure
1) In the "Edit Template" dialog box, choose [File] → [Save] or [Save As].

2) If [Save] is clicked, the file is replaced. If [Save As] is clicked, the "Save As" dialog
box is displayed. Specify a filename and click the "Save" button. Clicking the
[Cancel] button aborts the save.

3.5.2.2 Register to the database for template sheets


The edited template sheet is registered in the database for the template.

- Setting of Sample information -

3-9
3 Operations

1) Choose [File]-[Regist database] in the edit of the template screen. It is assumed to the
sample information setting screen that the file name which excludes the extension of
the registered file is an initial value of the sample name and is displayed.

[attention]
It is necessary to set the data base for the template beforehand by "Option setting".

2) The Sample information setting screen is displayed. When the sample name, sample
ID, sample information1-10, and the comment of the template are set and "OK" is
clicked, the template is registered in the database for the template. Please do the
unique setting retrieved easily to sample information set here to use it as a search
condition when the template of the analysis execution is selected.

3.5.2.3 Defining Rows and Columns (Sample Size)


This section describes how to define the number of rows and columns of a data
information table, or how to define sample size if the "More than one sample mode"
check box is checked.

- The "Max Rows/Max Cols" dialog box -

3-10
3 Operations

Procedure
1) In the "Edit Template" dialog box, choose [Edit] → [Max Rows/Max Cols]. The
"Max Rows/Max Cols" dialog box is displayed.

2) Specify the maximum number of rows in the "Max Rows" list box, and the maximum
number of columns in the "Max Cols" list box.

3) Click the [OK] button to apply the setting. Clicking the [Cancel] button aborts the
changes.

3.5.2.4 Editing a Row/Column Heading


This section describes how to edit a row/column heading.

- The "Title" dialog box -

Procedure
1) In the "Edit Template" dialog box, click the row head cell or the column head cell,
which contains data information to edit.

2) [Edit] → [Edit Title]. The "Title" dialog box is displayed.

3) Specify a row/column heading.

4) Click the [OK] button to apply the setting. Clicking the [Cancel] button aborts the
changes.

3-11
3 Operations

3.5.2.5 Defining a Formula


This section describes how to enter a formula in a cell.

[NOTE] The data obtained from an electronic balance will not be entered in a cell that
contains a formula.

- The "Calculation" dialog box -

The formula text box

The list of available functions

Functions
• Cell Notation (cell reference)
The position of a cell is defined by a combination of a column number and a row
number. Columns are labeled with alphabetic character s, starting from Column A.
Rows are labeled with numbers, starting from Row 1. Do not leave space between a
column number and a row number ; otherwise, the position will not be identified as cell
referenc e.

• Operator
The following operators are used for a formula.
Operator Example Description
+ -* / A1+B2 addition, subtraction, multiply, division
^ A1^B2 Involution
& A1&B2 logical product
| A1|B2 logical sum
: A1:B2 cell block

Note: A formula can be expressed with a wild card in the following way.
• To enter a formula in Cell C1 : A1*B1 → A#*B#
• To enter a formula in Cell C3 : C1+C2 → #1+#2

3-12
3 Operations

• Function
The following functions can be used to create a formula. In the table shown below,
“Formula 1” is replaced with a function like A1>B1, while “Formulas 2 and 3” are
replaced with a cell reference or a function that includes a cell reference.

Function Description
ABS (Formula 2) Returns the absolute value of Cell B.
ADD (Formula 1, Formula 2) Adds two variables.
IF (Formula 1, Formula 2, Formula 3) Returns Formula 2 if Formula 1 is evaluated
as a nonzero value. Returns Formula 3 if
Formula 1 is evaluated as a zero value.
Formula 1 may include a relative operator,
equals sign, less than sign, or greater than
sign.
ISEMPTY (Formula 2) Returns 1 if Formula 2 is not found. Returns
0 if Formula 2 is found.
MAX (Formula 1, Formula 2, ...) Returns the maximum value of all variables .
Variables are either Integer variables or
Real variables.
MIN (Formula 1, Formula 2, ...) Returns the minimum value of all variables.
Variables are either Integer variables or
Real variables.
NEG (Formula 2) Reverses the sign of Formula 2.
NOT (Formula 2) Returns 1 if Formula 2 is evaluated as a
zero value. Returns 0 if Formula 1 is
evaluated as a nonzero value.
ROUNDUP (Formula 2, Formula 4) Rounds up the fractional part of the value for
Formula 2, followed by Formula 4.
ROUND (Formula 2, Formula 4) Rounds the fractional part of the value of
Formula 2, followed by Formula 4.
SUM (Formula 2, Formula 3, ...) Returns the total of cells and cell blocks.
TRUNCATE (Formula 2, Formula 4) Truncates the fractional part of the value of
Formula 2, followed by Formula 4.
StDev(Formula 2) Evaluates the samples in the population and
calculates standard deviation.
StDevP(Formula 2) Evaluates the population and calculates
standard deviation.

3-13
3 Operations

• Samples of Formulas
This section describes an example in which data is organized in 4 rows and 3 columns
of a table. Columns are labeled with alphabetic characters, staring from A. Rows are
labeled with numbers, starting from 1.
1. The sum of a block of cells between the first cell and the third cell in Column A :
SUM(A1:A3)
2. The sum of a block of cells between the first cell and the third cell in Column A and
Column B : SUM(A1:B3)
More examples are found for many functions in the "Calculation" dialog box.

3-14
3 Operations

Procedure
1) In the "Edit Template" dialog box, click the cell that contains data information to be
edited.

2) [Edit] → [Calculation]. The "Calculation" dialog box is displayed.

3) Specify the formula to enter in the selected cell. Select a function from the listing of
available functions in the list box, and click the [Paste] button, to paste the selected
function to the cell at the cursor position.

4) Click the [OK] button to apply the setting. Clicking the [Cancel] button aborts the
setting.

3.5.2.6 Defining the Number of Decimal Places


This section describes how to define the number of decimal places. The number of
decimal places is defined for cells, rows or columns.
- The "Format" dialog box -

[NOTE] • Numbers are not significant. The number of characters and the position of
decimal places are significant.
• The fractional part of a numeric value is rounded off to the decimal place
specified by the setting in the "Format" dialog box.
Procedure
1) In the "Edit Template" dialog box, click the cell (row or column) that contains data
information to edit.

2) Select [Edit] → [Format]. The "Format" dialog box is displayed.

3) Specify the number of decimal places for the selected call.

4) Click the [OK] button to apply the setting. Clicking the [Cancel] button aborts the
setting.

3-15
3 Operations

3.5.2.7 Prohibiting the manual input


Prohibition/permission of the manual input of each cell is set.

Functions
1) The cell of edited data information is clicked in “Edit template” screen.

2) The cell which selects it becomes a light blue shown if the item of “manual input ” is
clicked, and the “manual input” is prohibited. Moreover, The “manual input” of the
“Edit” menu is checked on.

3) The cell which selects it becomes a white display if “manual input” of the [edit] menu
is clicked again, and the hand input is permitted. Moreover, the check on “manual
input” of [ the edit ] menu comes off.

3.5.2.8 Cut, Copy, Paste and Delete


The commands, [Cut], [Copy], [Paste] and [Delete], are used to edit a sample information
table or data information table.

Functions
1) Select the cell in of the data information in the “Edit template” windows.

2) The selected cells becomes a light blue shown if "Manual input" is chosen in the
"Edit" menu, the manual input is prohibited.
Moreover, the [Edit]-[Manual input] menu is checked on.

3) The selected cells becomes a white shown if again "Manual input" is chosen in the
"Edit" menu, the manual input is permissed.
Moreover, the [Edit]-[Manual input] menu is checked off.

4) [Delete]
This command deletes a selected character string.

3-16
3 Operations

3.6 Deleting a File


A template file or paused file can be deleted. The use of this feature is restricted to users having
the Edit Template/Schedule permission.

- The "Delete template" dialog box -

Procedure
1) Choose [File] → [Delete template]. The "Delete template" dialog box is displayed.

2) Select the file to delete.

3) Click the [OK] button. The selected file is deleted. Clicking the [Cancel] button aborts the
deletion.

3-17
3 Operations

3.7 Printing
This section describes how to print weighed data.

- "The establishment of the printing form" dialog box -

Option Items
Select any of the following options so that their check boxes are checked.
• "Intake time"
• "Date" in the "Header" section
• "Template name" in the "Header" section
• "Page" in the "Footer" section

Functions
• "Cell size": This button defines the cell size of a printout. See “3.7.1 Defining Cell Size.”
• "Fonts": This button selects a font that is applied to a printout. See “3.7.2 Selecting a
Font.”
• "Settings": Sets the page.
• "Preview": Previews the printing.
• "Printing": Displays the "Print" screen.
• "Cancel": Cancels the printing.

Procedure
1) In the main screen, choose [File] → [Print]. "The establishment of the printing form" dialog
box is displayed.

2) Define the desired settings and click the [Printing] button. Another "The establishment of
the printing form" dialog box is displayed.

3) Clicking the [Cancel] button returns to the previous dialog box named "The establishment of
the printing form."

3-18
3 Operations

- "Print" dialog box -

Option Items
• "Printer" : Specify a printer name in this list box.
• "Orientation" : Select either "Portrait" or "Landscape" from this section.
• "Margins" : Specify left and right margins in this section.

Procedure
1) In "The establishment of the printing form" dialog box, click the [Printing] button. The
"Print" dialog box is displayed.

2) Select the desired options and click the [Print] button to print weighed data. Clicking the
[Cancel] button returns to the previous dialog box named "The establishment of the printing
form ."

" Example "Printing


A printing example of the sample template (Form1_OneSample_WaterRate.Shh) is shown
below.

2000/12/14 14:35:38

Form1_OneSample_WaterRate.Shh
Sample Name Ink(GREEN)
Sample ID Ink-Green
Sample Type
Operator Taro Shimadzu
Comment
Sample Tag 1
Sample Tag 2
Sample Tag 3
Sample Tag 4
Sample Tag 5
Sample Tag 6
Sample Tag 7
Sample Tag 8
Sample Tag 9
Sample Tag 10

Sample 1 Sample 2 Sample 3


Tare weight 7.6147 2000/12/14 15:30:36 7.5811 2000/12/14 15:30:58 7.5857 2000/12/14 15:15:15
Before 12.33 75 2000/12/14 15:31:21 12.4802 2000/12/14 15:30:58 12.3812 2000/12/14 15:30:58
After 11.8764 2000/12/14 15:31:58 12.0147 2000/12/14 15:30:58 11.9171 2000/12/14 15:30:58
The amount 0.4611 2000/12/14 15:31:58 04655 2000/12/14 15:30:58 0.4641 2000/12/14 15:30:58
Water rate 3.74 2000/12/14 15:31:58 3.73 2000/12/14 15:30:58 3.75 2000/12/14 15:30:58

-1-

3-19
3 Operations

3.7.1 Defining Cell Size


This section describes how to define the size of a cell in which weighed data is entered.

- The "Cell size" dialog box -

Option Items
• The "Col width" or "Row height" section
Click either the "Auto Fit " radio button or the "Specify the width of the cols " radio button. If
the "Specify the width of the cols" radio button is selected, enter a value for a column width (or
for a row height).
• The "Select col" section
This section is used to specify the applicable range of a selected column width. Click the "All
Cols" or "Specify a range, and set up col width" radio button. If the "Specify a range, and set up
col width" radio button is selected, specify an applicable range.
Procedure
1) In "The establishment of the printing form" dialog box, click the [Cell size] button. The
"Cell size" dialog box is displayed. Click the "Col width" or "Row height" tab.
2) Select the desired options and click the [Apply] button to update the setting.
3) Clicking the [OK] button updates the setting and closes the "Cell size" dialog box. Clicking
the [Cancel] button aborts the changes.

3-20
3 Operations

3.7.2 Selecting a Font (Print Font)


This section describes how to select a font
- The "Font" dialog box -

Option Items
• font name • font size
• font style • script type
Procedure
1) In "The establishment of the printing form" dialog box, click the [Fonts] button. The "Font"
dialog box is displayed.
2) Select the desired options.
3) Click the [OK] button to update the setting. Clicking the [Cancel] button aborts the setting.

3-21
3 Operations

3.8 Setting Transfer Protocol


This section describes how to define communications parameters for an interface between an
electronic balance and a data processing device. The use of this feature is restricted to users
having the Property/Option permission.

- The "RS-232C Settings" tab of the "Properties " dialog box -

Option Items
• COM • Data bit • Type
• Baud Rate • Stop bit • "Use a balance 1 or 2"
• Parity bit • Delimiter

If the model of an electronic balance is specified, communications parameters are automatically


selected. S pecify data transfer protocol in accordance with the settings of an electronic balance.

Procedure
1) In the main screen, choose [File] → [Properties]. The "Properties" dialog box is displayed.
Click the "RS-232C Settings" tab to specify transfer protocol.

2) Select the desired options. If the "Use a balance (1)" or "Use a balance (2)" check box is
turned on, options can be selected.

3) Click the [OK] button to update the setting. Clicking the [Cancel] button aborts the setting.

3-22
3 Operations

3.9 Defining a Balance Name


This section describes how to define a balance name for System 1 or System 2. The use of this
feature is restricted to users having the Property/Option permission.

- The "Balance Name" tab of the "Properties" dialog box -

Procedure
1) In the main screen, choose [File] → [Properties]. The "Properties" dialog box is displayed.
Click the "Balance Name" tab to specify a balance name.

2) Specify a balance name in the "Instrument 1" and "Inistrument 2" text boxes.

3) Click the [OK] button to update the setting. Clicking the [Cancel] button aborts the setting.

[NOTE] The setting made here is applicable to instrument names for Instrument 1 and
Instrument 2 in another program

3-23
3 Operations

3.10 Making Measurements


The Balance Agent program can be connected to a maximum of two electronic balances.
Measurement screens are available for each electronic balance, so that measurements can be
made separately. The use of this feature is restricted to users having the Run Template/Schedule
permission.

3.10.1 Starting Measurements


The [Run] command menu provides the following buttons for the control of operations of
System 1 or System 2.

• [Run] : This command opens a measurement screen, so that a user can start making
measurements.
• [Pause] : This command saves weighed values to a paused file and closes the measurement
screen. The weighed values are not registered to a database.
• [Stop] : This command saves weighed values to a weighed data file and closes the
measurement screen. The weighed values are register to a database.

[NOTE] A weighed data file is saved as an archive file and is then deleted from the export
folder.

- The main screen, showing the menu bar and buttons in the toolbar -

3-24
3 Operations

Procedure
1) Choose [Run] → [Run], or click the [Run] button in the toolbar. A measurement screen for
System 1 or System 2 is displayed.

2) Make measurements in the measurement screen. See “3.10.2 Measurement Screen.”

3) Choosing [Run] → [Pause], or clicking the [Pause] button in the toolbar, saves weighed
values to a paused file and the measurement process is paused. Save the paused file.
Weighed values are not registered to a database. Use the [Pause] command only to pause a
measurement process temporarily.

4) Choos ing [Run] → [Stop], or clicking the [Stop] button in the toolbar, saves weighed values
to a weighed data file and the measurement process is finished. Weighed values are then
registered by CLASS-Balance Agent.

3.10.2 Select Template file Screen


The template or the interruption data to execute the measurement is selected.

- Selecting template sheets -

Procedure
1) When [execution ] of [ execution ] menu or [ execution ] button is clicked, [ the selection of
the template ] screen is shown. And the result of the retrieval from the database for templates
is shown on the template tab screen.
No filtering condition.
The setting of limiting the indication records is the same in the previous filtering.
The setting of Showing only the latest information is the same in the previous filtering.
The setting of is the same in the previous filtering.
The setting of “Only the approved template is displayed ” in the “Option ” menu is the same in
the previous filtering.
The setting of “a reject and an invalid template do not displayed” in the “Option ” menu is the
same in the previous filtering.

2) The "template" tab is selected when a new measurement is made and when the interruption
data is restarted, the "Pause data" tab is selected.

3-25
3 Operations

3) When the [Filter] button is clicked, the [Fileter] screen is displayed. When the condition is
set and the [OK] button is clicked, the list of the filtered template (Or, Pause data) is
displayed.

4) When the template which wants to be measured is selected from the list and the [OK] button
is clicked, the "measurement" screen is displayed.

3.10.3 Filtering Screen


The search condition of the template or the Pause data is set.

- Filtering Screen -

Setting items
The display function is limited.
The number displayed to turn on the check in the template list can be limited.

Filtering condition
The filtering condition is set, and the check item name is turned on.
Only the item which turns on the check is set as a filtering condition.

View only set item


Only the item to which the filtering condition is set, is displayed on the
screen.

Only latest information is displayed


Only latest information is displayed when there is two or more data of the same template file
name when the check is turned on.

3-26
3 Operations

Procedure

1) When the [Filter] button is clicked on the "select template file" screen, [Filter] screen is
displayed.

2) The filtering condition is set.

3) When the [OK] button is clicked, the list of the template (Or, interruption data) is displayed
on "select template file" screen.

3.10.4 Measurement Screen


A measurement screen is used to read, view, or calculate weighed values obtained from an
electronic balance. The data format of weighed values is determined by the selected template.

- The measurement screen -

3-27
3 Operations

Functions (Data Input)


1) Reading data immediately
If the "Timer(sec)" check box is OFF, weighed values are read immediately. Click the [Print]
button or press the PRINT key on the electronic balance to start reading weighed values.

2) Reading data at regular intervals


If the "Timer(sec)" check box is ON, weighed values are read at regular intervals. Specify a
time interval in the "Time" list box that is displayed. Click the [Start] button to start reading
weighed values at regular intervals (in seconds). The reading process finishes only when
data is entered in all cells in the "Data Information" section. While reading data, the [Start]
button changes into the [Pause] button. Clicking the [Pause] button pauses the reading
process.
Any number of seconds between 1 and 3600 can be selected for the regular intervals at
which the reading process starts.

[NOTE] An error of ± 1 second may occur in the regular intervals for reading data.

- The measurement screen, reading data at regular intervals -

3-28
3 Operations

Functions: Direction of Reading Data in Cells


Specify the direction in which data is read from a cell to another. Click the [Down] or [Right]
button to specify the direction of movement. If you turn on either of these two buttons, the other
button will be automatically turned off.

The following shows an example in which data in 3 rows and 3 columns is read one after
another.

The order of reading data in cells: down


1 4 7
2 5 8
3 6 9

The order of reading data in cells: right


1 2 3
4 5 6
7 8 9

3.10.5 Interrupt Measurement


The examination measured on the way is registered to the database as interruption data,
and the measurement is ended temporarily.

- A setting of sample information -

Procedure

1) When "Pause" menu or the [Pause] button is clicked while measuring it, the "setting of
sample information" screen is displayed.

2) "Sample name", "Sample ID", "Sample information1-10", and "Comment" are set. The
content set here is used as a filtering condition when the "Pause data" restarts, and set that it
is easy to retrieve it later, please. It is necessary to set either the "Sample name" or "Sample
ID".

3-29
3 Operations

3) The data is registered in the database for the "Pause data" when the [OK] button is clicked,
and the measurement is ended.

3.10.6 Complete Measurement


The result of the amount of the scale data which does the measurement completion is
registered to the data base, and the measurement is ended.

- a validation of a regist database -

Procedure

1) When "Complete" menu or the [Complete] button is clicked while measuring it, "a
validation of a regist database" screen is displayed.

2) The database is confirmed at the displayed registration destination. When it wants to register
in another database, the database is selected with the [Select db] button.

3) The result of the amount of the scale is registered in the database when the [OK] button is
clicked, and the measurement is ended.

3-30
3 Operations

3.11 Select Database

In this screen, we can select a database, add it to the list, and delete it from the list . This
operation is a common operation when the database in "CLASS-Balance Agent" is selected.
The [Select database],[Add to list], and [Delete from list] buttons can be used by the user
who has an authority of "Database Management".

<Select Database dialog box>

<Procedure>
1. Add to list
Adds selected databases to the database list. If [Add to list] is clicked, the "Select
Database" dialog box will be displayed.

Specify the type and name of the database to be added to the displayed list, then click [Next].
Clicking [Cancel] will abort the operation to add the database. The following procedures are
specific for each type of database. Perform the subsequent operations described below
according to the selected database type.

3-31
3 Operations

<Procedure: MDB>
1) Select the "MDB" option in the "Setting of database connection" dialog box. The
[MDB File Selection] button will be available for selection only when [MDB] is selected.
Click the [MDB File Selection] button.

MDB File
Selection
button

2) In the "Select the database which links" dialog box, select the desired database
(MDB file, *.mdb), and click [Open].

3) The [Next] button is enabled when an MDB file is selected. Click it to continue.

3-32
3 Operations

4) Click the [Check the connection] button.


If the database is password protected, enter the password before clicking [Check the
connection].

5) If the connection to the database can be properly made, the [Finish] button is enabled.
Click it to continue.
6) The "Comment" dialog box appears. Enter comments as desired, then click [OK].

<Procedure: SQL/Oracle>
1) Select the "SQL Server/MSDE" or "Oracle" option in the "Select Database" dialog box
according to the type of database. Enter the name of the database, then click [Next].

2) Enter the name or IP address of the server computer hosting the database, then click
[Next].

3-33
3 Operations

3) When the database type is SQL, the following dialog box is displayed. Select the
network communications protocol, then click [Next].

4) The settings specified in the preceding steps are used to establish the connection to the
database. Enter the login ID and the password for the database. (These were defined when
the database was set up. If they are not known, contact the system administrator.) Click
[Check the connection].

5) If the connection to the database can be properly made, the [Finish] button is enabled.
Click it to continue.
6) The [Comment] dialog box is displayed. Enter comments as desired, then click [OK].

3-34
3 Operations

2. Delete from list


This button is used to delete selected databases from the database list. This does not delete
the database file, it just removes the database name from the list. Therefore, the database can
be added back to the list by selecting the [Add to list] button and performing the required
operations. This operation is the same regardless of database types.

1) Select a database to be removed from the list in the "Select Database" dialog box, then
click [Delete from list].
2) The dialog box to confirm the removal is displayed. Check the database name, then
click [OK].
<Delete dialog box>

3) The selec ted database is removed from the list in the "Select Database" dialog box.

3-35
3 Operations

3.12 Customizing the Screen Display


This section describes how to show or hide the toolbar or the status bar, and how to select a font
that is applied to the "Sample Information" and "Data Information" sections of the Balance
Agent window (the measurement screen).

3.11.1 Showing or Hiding the Toolbar or the Status Bar


The toolbar or the status bar can be shown or hidden.

- The screen without the toolbar and the status bar -

Procedure
1) Toolbar
Choose [View] → [Toolbar] to alternately show or hide the toolbar.

2) Status Bar
Choose [View] → [Status bar] to alternately show or hide the status bar.

3-36
3 Operations

3.12.2 Selecting a Font


This section describes how to select a screen font that is applied to the "Sample Information" and
"Data Information" sections of the Balance Agent window (the measurement screen).

- The "Font" dialog box -

Option Items
• font name • effects
• font style • font color
• font size • script type

Procedure
1) Choose [View] → [Font]. The "Font" dialog box is displayed.

2) Select the desired options.

3) Click the [OK] button to update the setting. Clicking the [Cancel] button aborts the
selection.

3-37
3 Operations

3.13 Configuration
This section describes how to define the login procedure that should be followed when the
CLASS-Balance Agent program starts running.
Moreover, it is set whether to convert the result report of the amount of the scale image into the
PDF file when the data base of the result of the amount of the scale is registered.
These function can be used only by the user with "Property/Option/Configuration" authority.
- The "Configuration" tab of the "Options" dialog box -

Option Items
1) The "Normal login" radio button
If this radio button is ON, the "Login" dialog box is displayed, enabling a user to make a
login attempt. By default, the login ID entered at the last login will be automatically entered
in the "Login ID" text box.
[NOTE] • In the ER/ES mode, the default of the login ID is not displayed.

2) The "Automatic login" radio button


If this radio button is ON, a user is allowed to make a login attempt automatically. If this
radio button is checked, define a login ID and password in the text boxes.

3) The result of the amount of the scale image is output as PDF file when the "PDF conversion"
measurement is completed, and whether it registers in the database is set.

- non : The PDF file is not output.


- PDF Distiller : PDF Distiller is used.
- PDF Writer : PDF Writer is used.
- Adobe PDF : Adobe PDF is used.Please set the printer name when you have changed the printer
name of the PDF port. (Acrobat6)

3-38
3 Operations

[NOTE] • It is necessary to install “PDF Distiller" or “PDF Writer" beforehand to output the
PDF file. “PDF Writer" must not be installed if it is not a custom installation.
(Acrobat5)

[NOTE] • Please set it when you have changed the printer name of the PDF port.
It is not output when the printer name is different, the error occurs, and confirm
whether must the name of the printer, please.
(Acrobat6)

4) Open the same template used when last execution was comleted
After the result of the amount of the scale is registered in the database by the measurement
completion, the open template is opened by the automatic operation again.

5) Only the approved template is displayed


Only the template approved by the Agent manager is displayed at the time of narrowing the
template.
This setting does not influence filtering the pause data.

6) A reject and an invalid template do not display


Neither a rejected nor an invalid template are displayed as Agent manager at the time of
filtering the template.
This setting does not influence filtering the pause data.

Procedure
1) In the main screen, choose [Tools] → [Options]. The "Options" dialog box is displayed.
Click the [Configuration] tab to specify the login procedure at a boot up.

2) If the "Automatic login" radio button is turned on, define a login ID and password in the text
boxes.

3) Click the [OK] button to update the setting. Clicking the [Cancel] button aborts the setting.

3-39
3 Operations

3.14 Default folder


This section describes how to specify a destination databases where template files and weighed
data files are stored. The use of this feature is restricted to users having the Property/Option
permission.

- The "Default folder" tab of the "Options" dialog box -

Setting Items
1) Template Database
The data base which registration/retrieves the template is specified.

2) Result Database(Balance1 Result Database, Balance2 Result Database)


The database which registers the result of the amount of the scale of each balance, is specified.
It is also possible to specify another database when registering.

3) Pause Database
The database which registration/retrieves the interruption data is specified.

4) Pause data are not deleted


When the interruption data is restarted, it deletes it from the data base for the interruption when
the check is removed..

Procedure
1) In the main screen, choose [Tools] → [Options]. The "Options" dialog box is displayed.
Click the "Default folder" tab to specify a default database for saving the template file or
weighed data file.

2) Specify the desired database names.

3) Click the [OK] button to update the setting. Clicking the [Cancel] button aborts the setting.

3-40
3 Operations

3.15 Defining the Number of Decimal Places


This section describes how to define the number of decimal places of weighed values. If the
number of decimal places is not specified in the "Edit Template" dialog box, the setting made
here becomes effective. The use of this feature is restricted to users having the Property/Option
permission.

- The "Default format" tab of the "Options" dialog box -

Procedure
1) In the main screen, choose [Tools → [Options]. The "Options" dialog box is displayed. Click
the "Default format" tab to specify the number of decimal places of weighed values.

2) Specify the number of decimal place in the "Default format" text box.

3) Click the [OK] button to update the setting. Clicking the [Cancel] button aborts the setting.

3-41
3 Operations

3.16 Restrictions on Key-ins


This section describes how to specify whether to restrict key-ins in the measurement screen. The
use of this feature is restricted to users having the Property/Option permission.

- The "Manual input" tab of the "Options" dialog box -

1) Permission/Prohibit
Option Items
• Sample name • Description
• Sample ID • Sample info. 1-10
• Sample type • Data field
• Operator

Procedure
1) In the main screen, choose [Tools] → [Options]. The "Options" dialog box is displayed.
Click the "Manual Input" tab to specify w hether to restrict key-ins in the measurement
screen.
2) Select the desired options [Manual Input] to allow or disallow key-ins.
3) Click the [OK] button to update the setting. Clicking the [Cancel] button aborts the
selection.

2) Prohibit overwrite data


Option Items
It is prohibited that taking again data (Or, input the value) into the cell of taking data on the
measurement screen when the “Prohibit overwrite data” item is check on.

Procedure
1) When the “Option” of the “Tool” menu is selected on the main screen, the “Option”
window is shown., select the “Manual input” tab.
2) The every particular item is set.
3) When the “OK” button is clicked, the setting is updated. When the “cancel” button is
clicked, the setting is discontinued.

3-42
3 Operations

3.17 Managing Windows


This section describes how to manage open windows (measurement screens) for System 1 and
System 2.

- Each open window above shows a measurement screen. [Cascade] -

Option Items
1) [Cascade]
Open windows overlap one another. You can bring any open window to the foreground by
clicking anywhere in that open window.

2) [Horizontal]
Two open windows are arranged horizontally. An open window for System 1 is arranged in
the left-hand part of the entire screen, w hile an open window for System 2 is arranged in the
right-hand part of the entire screen.

3) [Vertical]
Two open windows are arranged vertically. An open window for System 1 is arranged in the
upper-half part of the entire screen, while an open window for System 2 is arranged in the
lower half of the entire screen.

4) [Align Icon]
The command arranges all icons for minimized windows.

Procedure: [Cascade/Horizontal /Vertical]


1) When two windows for System 1 and System 2 are open, click the [Window ] button in the
menu bar.

2) Click on [Cascade], [Horizontal] or [Vertical] submenu command.

3) The two open widows are arranged accordingly.

3-43
3 Operations

Procedure: [Align Icon]


1) When two windows for System 1 and System 2 are icon (minimized), click the [Window]
button in the menu bar and choose [Align Icon].

2) Two icons for minimized windows for System 1 and System 2 are arranged along the lower
edge of the window.

3-44
3 Operations

3.18 Windows Lock


The screen lock function at the leave seat is achieved. All functions of "CLASS-Balance Agent"
cannot be used until being unlocked by the password input.

- About Balance Agent -

Procedure
1) The [OK] button is clicked, and the attestation dialog is displayed.

2) The [OK] button is clicked specifying the ID and the password.

3) When the ID and the password is attested, the lock is released, and using "CLASS-Balance
Agent" becomes possible. The lock message of the screen is displayed again in case of
password wrong, and the [cancel] button.

3-45
3 Operations

3.19 Help Topics


The [Help] menu command is used to open the help file or view version information.

- The <About Balance Agent Ver.2> message box -

Functions
1) In the main screen, choose [Help] and click the [Help Topics] command. A table of contents
is displayed. Click a particular topic will go to the help entry for the particular topic.

2) In the main screen, choose [Help] and click the [About Balance Agent]. The " About
Balance Agent Ver.2" message box is displayed, showing version information (version
number and date prepared).

3-46
Appendix A
A.1 Weighed Data Files, Template Files and Paused Files........................... A-1
A.2 Structure of the Weighed Data File ........................................................ A-2
A.3 Contents of a Database ........................................................................... A-4
A.4 Compressed Files for Register Data ....................................................... A-6
A.5 Temporary Database............................................................................... A-7
A.6 Log Database .......................................................................................... A-7
A.7 User Permissions for the Balance Agent Program................................. A-8
A.8 Instrument Configuration File ................................................................ A-9
Appendix A

A.1 Weighed Data Files, Template Files and Paused Files


The Balance Agent program creates a weighed data file (*.TXT), a template file (*.Sh*) and a
paused file (*.Ph*) when performing a single weighing job.

Destination Folder
A weighed data file, a template file and a paused file are saved to the folder specified in the
"Default folder" tab of the "Options" dialog box.

Example: where the folder name is C:\Agent2\Data.


C:\Agent2\Data\*.Txt Weighed data file
C:\Agent2\Data\*.Shh Template file (for sample information)
C:\Agent2\Data\*.Shd Template file (for data information)
C:\Agent2\Data\*.Phh Paused file (for sample information)
C:\Agent2\Data\*.Phd Paused file (for data information)

Filename
A filename is automatically defined as follows.
Filename = year + month + day + hour + minute + second + “.” + extension
Year/month/day/hour/minute/second are expressed in two-digit numbers.

Example: where the weighing is completed at 10:59:24 on January 3, 2001.


Weighed data file = 990103105924.Txt
Template file (for sample information) = 990103105924.Shh
Template file (for data information) = 990103105924.Shd
Paused file (for sample information) = 990103105924.Phh
Paused file (for data information) = 990103105924.Phd

Compressed File Name (*.LZH)


A filename is automatically defined as follows.

Filename = Computer name + Instrument number + Storage date + Serial number + “.LZH”

Computer name The name determined in the Properties settings on a network computer.
Instrument number A number from 1 to 2 assigned to the Balance Agent program connected.
Storage date YYMMDD, 6 numerical characters, the date on which the file is registered on
a database.
Serial number 4 numerical characters from 0 to 9999 used for all Agent programs. It is
incremented by 1 each time the file is registered on a database.

Appendix A-1
Appendix A

A.2 Structure of the Weighed Data File


A weighed data file is a registration request text file that is exported to the Public Agent program
for registering weighed data to a database. Its file structure is shown in the table.

List of Record Identification Information


Date Name Record Identification Information
Instrument No. "InstrumentNo"
Instrument name "InstrumentName"
Data type "InstrumentKind"
Sample name "SampleName"
Sample ID "SampleID"
Sample type "SampleType"
Operator "Operator"
Date acquired "Date acquired"
Reviewer "Reviewer"
Reviewed Date "Reviewed Date"
Compressed file 1 (template file - sample information) "LzhFile1"
Compressed file 2 (template file - data information) "LzhFile2"
Compressed file 3 (paused file - sample information) "LzhFile3"
Compressed file 4 (paused file - data information) "LzhFile4"
Compressed file 5 (weighed data file) "LzhFile5"
Deleted file 1 (template file - sample information) "DelFile1"
Deleted file 2 (template file - data information) "DelFile2"
Deleted file 3 (paused file - sample information) "DelFile3"
Deleted file 4 (paused file - data information) "DelFile4"
Deleted file 5 (weighed data file) "DelFile5"
Original template name "FileInfo1"
Description "Comment 1"
Tag information 1-10 "Tag1" - "Tag10"
Data information "Data"

[NOTE] Details about data information are shown in the list of block identification
information.

Appendix A-2
Appendix A

List of Block Identification Information


Data Name Block Identification Information
Column heading /P1=
Column number /P2=
Row number /P3=
Weighed value or calculated value (when data format is System 1) /D16=
Weighed value or calculated value (when data format is System 2) /F1= - /F20
Row heading /S1=
Date on which weighed values are acquired. /S2=

[NOTE] Blocks are separated by the “TAB”delimiter.

Example: When the weighed result of 3 columns and 3 rows is registered with Method 2 of
data type:

"InstrumentNo" 1
"InstrumentName" Balance_01
"InstrumentKind" BAL_2
"SampleName" Sample information
"SampleID" Sample ID
"SampleType" Sample type
"Operator" Ken Shimadzu
"Date acquired" 10/30/2000 11:39:55
"LzhFile1" C:\Agent2\Data1\981030113955.Shh
"LzhFile2" C:\Agent2\Data1\981030113955.Shd
"LzhFile3" C:\Agent2\Data1\981030113955.Phh
"LzhFile4" C:\Agent2\Data1\981030113955.Phd
"LzhFile5" C:\Agent2\Data1\981030113955.Txt
"DelFile1" C:\Agent2\Data1\981030113955.Shh
"DelFile2" C:\Agent2\Data1\981030113955.Shd
"DelFile3" C:\Agent2\Data1\981030113955.Phh
"DelFile4" C:\Agent2\Data1\981030113955.Phd
"DelFile5" C:\Agent2\Data1\981030113955.Txt
"FileInfo1" Weight_Test.Shh
"Comment1" Comment1
"Tag1" Tag information 1
"Tag2" Tag information 2
"Tag3" Tag information 3
"Tag4" Tag information 4
"Tag5" Tag information 5
"Tag6" Tag information 6
"Tag7" Tag information 7
"Tag8" Tag information 8
"Tag9" Tag information 9
"Tag10" Tag information 10
"Data" /P3=1 /F1=10.000 /F2=30.000 /F3=50.000 /S1=1st line
"Data" /P3=2 /F1=20.000 /F2=40.000 /F3=60.000 /S1=2nd line
"Data" /P3=3 /F1=30.000 /F2=70.000 /F3=110.000 /S1=3rd line

Appendix A-3
Appendix A

A.3 Contents of a Database


The weighed result from the registration request text file is stored in the database in the
following style.

Sample Information Table (SAMPLETBL)


Data Name Data Type Field Name
Registration data Date Time RegistDate
Work station name Text WsName
Instrument name Text InstrumentName
Data process type Text InstrumentKind
Sample name Text SampleName
Sample ID Text SampleID
Sample type Text SampleType
Operator Text Operator
Date acquired Date Time Date acquired
LZH file's folder ‘s path Text LzhDirectory
LZH file name Text LzhFile
Original template name Text FileInfo1
Tag information 1-10 Text Tag1 - 10
Description Text Comment 1

[NOTE] Data format: System 1:BAL_1 / System 2: BAL_2

Data Information Table (DATATBL)


- Method 1 -
Data Name Data Type Field Name
Registration data Date Time RegistDate
Work station name Text WsName
Instrument name Text InstrumentName
Column heading Text Property1
Column number Single Property2
Row number Single Property3
Weighed value or Calculated value Double DoubleData16
Row heading Text StringData1
Date on which weighed values are acquired. Text StringData2

[NOTE] Weighed values or calculated values are registered in a cell labeled with a column
number and a row number.

Appendix A-4
Appendix A

Data Information Table (DATATBL)


- Method 2 -
Data Name Data Type Field Name
Reg. data Date Time RegistDate
Work station name Text WsName
Instrument name Text InstrumentName
Row number Single Property3
Weighed value or Calculated value Single DoubleData1 - 20
Row heading Text StringData1

[NOTE] Weighed values or calculated values are sequentially registered in a column labeled
with a column number, starting from “DoubleDatal” in the first column.

Data Log Information Table (DATALOGTBL)


Data Name Data Type Field Name
ID ID ID
Log date Date Time LogDate
User name Text UserName
Destination database name Text DBFile
Sample name Text SampleName
Sample ID Text SampleID
Sample type Text SampleType
Instrument name Text InstrumentName
Work station name Text WsName
Reg. data Date Time RegistDate
Operat ion Text Operation
Result Text Result
Information Text Information
Description Text Comment1

Appendix A-5
Appendix A

A.4 Compressed Files for Register Data


The Balance Agent program compresses a weighed data file (*.TXT), a template file (*.Sh*)
and a paused file (*.Ph*) in LHA format when registering weighed data to a database.

Storage Folder
For an MDB-format database, a folder having the database name (without its extension) is
created in the same folder as the database. Compressed files are stored in this folder.

Example: database = C:\Agent2\Shimadzu.mdb


C:\Agent2\Shimadzu\*.LZH → Compressed file

LZH File Name (*.LZH)


A filename is automatically defined as follows.
Filename = Computer name + Instrument number + Storage date + Serial number + “.LZH”

Computer name The name determined in the Properties settings on a network computer.
Instrument number A number from 1 to 2 as signed to the instrument connected.
Storage date YYMMDD, 6 numerical characters, the date on which the file is registered
on a database.
Serial number 4 numerical characters from 0 to 9999 used for all Agent programs. It is
incremented by 1 each time the file is registered on a database.

CAUTION
The CLASS-Public Agent program monitors the availability of request text files and registers
the requested data to a database. Do not move, delete or rename files using Windows Explorer or
other utilities programs. A backup or copy may be made. If files are moved, deleted or renamed,
they may not be registered to the database.

Appendix A-6
Appendix A

A.5 Temporary Database


A temporary database is used to temporarily store data when the data cannot be stored in a
specified database. Its filename is TEMP_DT2.MDB, a Microsoft Access type database. It is
automatically created in the setup folder during installation. Compressed files and object link
files are created in the temporary database under the same conditions as if they were being
properly registered. For detailed information, see database information. Data contained in the
temporary database can be restored by Agent Manager. For data restoration, see the Agent
Manager Instruction Manual.

A.6 Log Database


A log database is used to store logs of operations performed by each user. It contains information
on user names and dates and times, descriptions of operations performed. Log information is
classified into two types, the data log accompanied by data and the system log (Log2.mdb) for
storing logs related to the system.

Usually, two log databases, “Log2.mdb” and “Temp log2.mdb," are automatically created in
Microsoft Access format in the folder specified during installation. If the network common
system is constructed, only “Log2.mdb” is created in the common folder. These databases can
be used for all types of Agent programs (Auto Agent, Manual Agent and Agent Manager).
If the system is in the normal status, logs are stored in “Log2.mdb." However, if the log
information cannot be stored in “Log2.mdb” due to errors in the network, etc., the log
information is stored in a spare log database “Temp log2.mdb."

Structure of Log Databases (LOG2.MDB / TEMP_LOG2.MDB)


The system log database consists of one table shown below that contains one log item per record.
The data log storing processes related to data is contained in the database storing the sample
information. The table structure is similar to that shown below.

Contents of a Log Information Table


Log Information Table (LOGTBL / TEMP_LOG2.MDB
Data Name Data Type Field Name
Log date Date Time LogDate
User name Text UserName
Destination database name Text DbFile
Sample name Text SampleName
Sample ID Text SampleID
Sample type Text SampleType
Instrument name Text InstrumentName
Work station name Text WsName
Reg. data Date Time RegistDate
Description of operations Text Operation
Description Text Comment 1

Appendix A-7
Appendix A

A.7 User Permissions for the Balance Agent Program


User permissions can be set up when a user is registered with Agent Manager Program. User
permissions are used to identify users and restrict the operations that users may perform.
The Balance Agent Program recognizes the following permissions granted to users.

• Run Agent/GW Permission


This permission allows an authorized user to register analysis data in a database.
A user who has not obtained this permission cannot log in to the Balance Agent Program and
may not perform any operations.

• Properties/Option/Configuration Permission
This permission allows an authorized user to make changes to the settings of the Balance
Agent program.
A user not having this permission cannot change the Property/Option/Configuration settings.
The user may only request data read or data registration under a given setting.

• Edit Template/Schedule Permission


This permission allows an authorized user to create or modify a template sheet for weighing.
If a user not having this permission logs in to the system, the menu for creating, editing, or
deleting a template sheet will be disabled.

• Run Template/Schedule Permission


This permission allows an authorized user to execute a template or schedule for weighing.
If a user not having this permission logs in to the system, the [Execute] button (menu) will be
disabled.

Appendix A-8
Appendix A

A.8 Instrument Configuration File


The instrument configuration file is used by Agent Manager, the CLASS-Public Automatic
Agent Program and the Balance Agent program. It contains the settings for column names of the
table used by the Balance Agent program. The contents of this file can be edited using the Agent
Manager Text Editor. Editing this file incorrectly may prevent the programs from running
properly. Do not make any change to the settings other than the ones described below.

File Structure
Folder Location : Folder where an application is installed.
Filename : BAL_1.Inf2 and BAL_2.Inf2

[DATATBL] section
This section defines column headings that appear in a table when Agent Manager is running.

For System 1
• Data property name
Property 1 = weighing capacity/average
Property 2 = number of times/number of times (maximum)
Property 3 = ID number (column number)

• Long integer data name


Long 1-6 = reserved

• Double-precision floating-point data name


Double 1-15 = weighed value
Double 16 = reserved
Double 17-20 = reserved

• Character string data name


String 1 = constituent name
String 2-5 = reserved

For System 2
• Data property name
Property 1/2 = reserved
Property 3 = ID number (column number)

• Long integer data name


Long 1-6 = reserved

• Single-precision floating-point data name


Float 1-15 = number of times

• Double-precision floating-point data name


Double 1-5 = reserved

• Character string data name


String 1 = constituent name
String 2-5 = reserved

Appendix A-9
Appendix A

[Format] section (for a floating point only)


This section contains settings for the number of decimal places.

Property (2-3) : the number of decimal places


Double (1-20) : the number of decimal places

Appendix A-10

You might also like