223-10086 B

GCsolution Agent Version 2

Instruction Manual

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

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

This instruction manual describes how to use and operate “GCsoluition Agent” data-management
programs for CLASS-Agent Software. It assumes that the user has a basic familiarity with Windows®
95/98/NT/2000 and experience using a personal computer.

The basic terminology used in Windows® 95/98/NT/2000 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 manual or help file.

A first-time user of Windows® 95/98/NT/2000 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 Shimadzu 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 GCsolution Automatic Agent Program...................................................................... 1-2
1.1.2 Features of the GCsolution Manual Agent Program.................................................. 1-2
1.1.3 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 GCsolution Program ................................................................................. 1-6
1.2.3 About the Agent Manager Program........................................................................... 1-7

Chapter 2 Getting Started

2.1 Automatically Storing Analysis Data in a Database ............................................. 2-1
2.1.1 Starting the Automatic Agent Program...................................................................... 2-1
2.1.2 Logging In to the System........................................................................................... 2-2
2.1.3 Specifying a Database for Each Instrument............................................................... 2-4
2.1.4 Making an Analysis ................................................................................................... 2-7
2.2 Manually Storing Analysis Data in a Database..................................................... 2-8
2.2.1 Starting the Manual Agent Program .......................................................................... 2-8
2.2.2 Logging In to the System........................................................................................... 2-9
2.2.3 Specifying a Destination Database ......................................................................... 2-11
2.2.4 Selecting and Storing Analysis Data........................................................................ 2-12

Chapter 3 Automatic Agent

3.1 Starting the Program.............................................................................................. 3-1
3.2 Main Screen........................................................................................................... 3-2
3.3 Command Buttons ................................................................................................. 3-3
3.4 Status Bar .............................................................................................................. 3-5
3.5 Using the Menu List .............................................................................................. 3-6
3.5.1 Viewing the Status..................................................................................................... 3-7
3.5.2 Configuration Settings............................................................................................... 3-7
3.5.3 System Configuration Settings .................................................................................. 3-9
3.5.4 Database Assignment Settings................................................................................. 3-12
3.5.5 Sample information ................................................................................................. 3-17
3.5.6 Compressed File Settings ........................................................................................ 3-18
3.5.7 Running an Application........................................................................................... 3-19
3.5.8 Linking a Database .................................................................................................. 3-21
Chapter 4 Manual Agent
4.1 Starting the Program.............................................................................................. 4-1
4.2 Main Screen........................................................................................................... 4-2
4.3 Logging In ............................................................................................................. 4-5
4.4 Logging Out........................................................................................................... 4-6
4.5 Selecting a Database.............................................................................................. 4-7
4.6 Viewing Properties .............................................................................................. 4-13
4.7 Exiting a Program................................................................................................ 4-14
4.8 Registering to Database....................................................................................... 4-15
4.9 Adding or Deleting Compression Files ............................................................... 4-19
4.9.1 Adding Files ............................................................................................................ 4-20
4.9.2 Deleting Files .......................................................................................................... 4-20
4.10 Toolbar and Status Bar ........................................................................................ 4-21
4.11 Details Information.............................................................................................. 4-22
4.12 Reentry List ......................................................................................................... 4-23
4.13 Options ................................................................................................................ 4-24
4.13.1 Selecting a Font ....................................................................................................... 4-25
4.14 Update Information ............................................................................................. 4-26
4.15 Environment Settings .......................................................................................... 4-27
4.15.1 Configuration Settings............................................................................................. 4-28
4.15.2 Compressed File Settings ........................................................................................ 4-29
4.15.3 Running an Application........................................................................................... 4-30
4.15.4 Setting the instrument name .................................................................................... 4-32
4.15.5 Operator name ......................................................................................................... 4-32
4.15.6 Sample information ................................................................................................. 4-33
4.16 Editing a Reentry List.......................................................................................... 4-34
4.17 Help Topics ......................................................................................................... 4-35

Appendix A Supplementary Information

A.1 Compressed Files and Object Link Files.............................................................. A-1
A.2 Contents of a Database ......................................................................................... A-3
A.3 Temporary Database............................................................................................. A-5
A.4 Log Database ........................................................................................................ A-6
A.5 User Permissions .................................................................................................. A-7
A.6 AIA-format Data (Andi-format Data) .................................................................. A-8
A.7 Instrument Configuration File .............................................................................. A-9
A.8 Contents of a Sample Information Table Created When an Application is Activated
............................................................................................................................ A-10

Appendix B Additional Software

B.1 The Agent Automatic Print Program.....................................................................B-1
B.1.1 Making Initial Settings ..............................................................................................B-1
B.1.2 Test Print ...................................................................................................................B-2
B.1.3 Using an External Application to Print......................................................................B-3
B.2 The Agent Mail Carrier Program ..........................................................................B-4
B.2.1 Making Initial Settings ..............................................................................................B-4
B.2.2 Checking the Connection to Mail Server and the Test E-Mail ..................................B-7
B.2.3 Using an External Application to Send E-Mail .........................................................B-8
 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 make 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, increasing the efficiency of routine operations.

In this software, a database can be created in 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 equipment 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 GCsolution Automatic Agent Program .................................................................. 1-2
1.1.2 Features of the GCsolution Manual Agent Program .............................................. 1-2
1.1.3 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 GCsolution Program.............................................................................. 1-6
1.2.3 About the Agent Manager Program ....................................................................... 1-7
 1 Introduction

GCsolution Agent automatically registers the analysis data output in AIA (Analytical Instrument
Associate) format from target devices to a CLASS Agent common database. GCsolution Automatic
Agent reads the analysis results from a designated folder and stores data to the designated database.
The Agent Manager software that comes with GCsolution Agent makes it easier to view, print or
approve stored data, add sample information, copy data to other applications, and restore analysis files.
CLASS-AIA Agent software supports GLP/GMP compliant security capabilities and log capabilities,
making it easier to audit the operations performed by users.

1.1 Features
This program provides the following.

1. Stores analysis data automatically (saved to compressed archive files).

2. Keeps records of analysis results (analysis values are stored in databases).
3. Keeps analysis logs. The analysis logs contain data on registered user names,
displayed user names, and operations performed by each user.
See Note 1.
4. Provides security management for analysis data.
5. Stores or views analysis 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 data and chromatograms to other applications.
10. Restores analysis files and method files.
See Note 2.
11. Sends notice of analysis completion or analysis data by e-mail.
See Note 3.
12. Uploads approved data to the host.

Note 1. C2 level security protection requires MS-Windows NT/2000.

Note 2. Analysis data is manually transferred using Agent Manager.
Note 3. Use of this feature requires the creation of a data transfer program (Optional).

1-1
1 Introduction

1.1.1 GCsolution Automatic Agent Program

The use of the GCsolution Automatic Agent Program (GCsol_TT2.EXE) allows automatic
entry of analysis data obtained from another manufacturer's chromatographic analysis system
to a database.

A user can do the following:

1. Organize information on standard report form for database registration.
2. Save analysis files as archive files (Chromatogram files, Data files, Method files,
Schedule files or AIA files).
3. Assign databases to each analytical instrument.
4. Sort data by sample name, sample ID, user name or operation date and time (month).
5. Save AIA files as object link files.
6. Save GDC files as object link file at File9.
7. Save PDF files as object link file at File10.
8. Keep a log of database registration.
9. Share and control system resources on a LAN.
10. Run an application when registering data in a database.

1.1.2 Features of the GCsolution Manual Agent Program

The CLASS-VP Manual Agent Program (GCsol_MT2.EXE) allows manual entry of analysis
data obtained from another manufacturer's chromatographic analysis system and stored in an
analysis file to a specified database.

A user can do the following:

1. Store calculation result information in a database.
2. Save analysis files as archive files (Data files, Method files, Schedule files or AIA files).
3. Save AIA files as object link files.
4. Keep a log of database registration.
5. Share and control system resources on a LAN.
6. Run an application when registering data in a database.

1-2
 1 Introduction

1.1.3 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
whether 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 (AIA files, GDC file, PDF file). More than one chromatogram may
be displayed.
7. Copy displayed data or object data (chromatograph 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.) 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.

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

When using the Microsoft Access form database, 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.
When SQL Server or Oracle is used, the archives files and object link files are
stored into a database.

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 the 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 automatically 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 while 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 GCsolution Program

1. Starting the program for the first time
Settings for instrument names and database assignment are not factory-set for the
Automatic Agent Program. Before using the Automatic Agent Program, a user
who has administrative responsibilities must log in, define a Login ID and create a
database.

2. Displaying the progress meter for file compression

The progress meter for file compression is displayed while various analysis data
is compressed and saved to an archive file. For routine operations, turn off the
check box for displaying the progress meter. If that check box is turned on, the
progress meter may pop up while other applications are running, causing the
screen to flicker.

3. Using the taskbar for routine operations

For routine operations, minimize the main screen of the Automatic Agent
Program to an icon in the taskbar. If the main screen is open on the desktop, the
[Logout] button may be clicked by mistake.

4. Security protection against automatic login attempts

If an Auto-login option is selected, a login attempt can be made under any login
ID different from the one assigned to the user. Do not use an Automatic-login
option if it is necessary to control access and manage users at a login. Define and
assign a password to each user.

5. Running an external application

When settings are made for running external applications, specify applications
that meet the minimum conditions described below. If these settings are not
properly made, a particular application may start each time automatic entries are
made, leaving several instances of the same application open. This causes error
messages to appear, and makes it impossible to run other applications.
Conditions:
1. An application must automatically terminate each time a single task of data
processing is completed.
2. Data processing time ends within the intervals of scanning data for automatic
entries.
3. If two or more of a same application are open at the same time, operations can
be made each window.
4. An application should display no more messages than necessary.

6. About the fixed quantity calculation value

In GCsolution the value of the fixed quantity calculation result is displayed with a
decimal point.
However, GCsolution Agent enters the value as a long integer (Long) to be
compatible with other Agent software.
Accordingly, the portion of the value below the decimal point is not displayed.

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.
The user account with login ID “Admin” is not displayed on the user information
screen.

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 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. After these settings are made, create user accounts so that
system resources can be shared on a LAN.

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.

1-7
1 Introduction

6. Screen Saver
When this software is started after installation in the ER/ES mode, the system is
set so that the screen saver dedicated to the Agent system is automatically
activated. After this software is closed, the system returns to the original setting.

For Windows NT, the screen lock is valid. If a password is required, set a
password for the screen lock in the OS.
The default value of the time until the screen saver starts is 5 minutes. To change
this value, change “common.inf2” in "Environment Setting" of the Agent
Manager. For example, to set to 10 minutes the waiting time until the screen saver
starts, add the following two lines.

[GLP]
ScreenLock=10

7. Log Types
Log information is separated into the data log for data operations and the system
log (Log2.mdb) 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 log.
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.
• In multi-user mode of NT, all other settings should be executed for each user ID.
The Agent system administrator should login using each NT user ID and
perform the required settings.

1-8
 Chapter 2 Getting Started
2.1 Automatically Storing Analysis Data in a Database ...............................2-1
2.1.1 Starting the Automatic Agent Program .................................................................. 2-1
2.1.2 Logging In to the System ....................................................................................... 2-2
2.1.3 Specifying a Database for Each Instrument ........................................................... 2-4
2.1.4 Making an Analysis................................................................................................ 2-7
2.2 Manually Storing Analysis Data in a Database .......................................2-8
2.2.1 Starting the Manual Agent Program....................................................................... 2-8
2.2.2 Logging In to the System ....................................................................................... 2-9
2.2.3 Specifying a Destination Database ...................................................................... 2-11
2.2.4 Selecting and Storing Analysis Data .................................................................... 2-12
 2 Getting Started

2.1 Automatically Storing Analysis Data in a Database

This section introduces procedures for storing analysis data in a database using Automatic
Agent.

Flowchart of Operations

Create a user account and database in Agent Manager.

Start the Automatic Agent program.

Log in to the system.

Set up each instrument.

Set up the analysis device

Perform analysis.

Check stored data in Agent Manager.

2.1.1 Starting the Automatic Agent Program

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

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
[GCsolution Automatic Agent].

Click here.

2-1
2 Getting Started

Using a folder icon on the desktop

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

Double-click here.

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

Double-click here.

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

2-2
 2 Getting Started

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 -

Command button

Menu list

Status bar

2-3
2 Getting Started

2.1.3 Specifying a Database for Each Instrument

Assign a destination database to each instrument number in GCsolution. The following
procedure shows an example in which analysis data obtained from analytical instrument 1 is
stored in the database named C:\Agent2\example.mdb. First, create a database using Agent
Manager.
1) Click the "Assign database per instrument" menu item in the "Menu List" pane, The "Assign
database per instrument" worksheet is displayed in the right-hand pane. GCsolution is
connected to a maximum of 4 GC systems. A database is assigned to each instrument in the
right-hand pane.

- The "Assign database per instrument" pane -

2) Double-click “Instrument 1” in the first row of the "Assign database per instrument" pane, or
click the “Instrument 1” row and click the [Edit] button. The "Assign database per
instrument" dialog box is displayed.

- The "Assign database per instrument" dialog box -

2-4
 2 Getting Started

3) Instrument Name (Read from data file)

By default, the system name is Instrument1. Any system name may be specified. Do not
leave the "Instrument Name" text box blank.

4) Register data
Click the "Register data" check box so that it is turned on, as shown in the figure. If this
check box is off, data is not stored in a database.

5) Destination database
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 -

In the "Select Database" dialog box, click “example(normal).mdb” to specify the destination
database to use, and click the [OK] button.

2-5
2 Getting Started

6) In the "User Name" list box, specify a user name that accompanies data information stored
in the selected database. If the "Login user name" option is selected, the name of a user who
is currently logged in will be recorded with data information in the selected database.
Click the [OK] button in the "Assign database per instrument" dialog box to finish the
setting. The contents of the "Assign database per instrument" pane is updated, as shown
below.

- The "Assign database per instrument" pane -

2-6
 2 Getting Started

2.1.4 Making an Analysis

1) Set up the analysis instrument.

2) Click “Status” in the left-hand pane, so that the status of data being stored in the database is
displayed in the right-hand pane.

3) Perform an analysis operation or reanalyze existing data using the analysis instrument.

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

2.2 Manually Storing Analysis Data in a Database

This section introduces procedures for storing analysis data in a database using Manual Agent.

Flowchart of Operations

Create a user account and database in Agent Manager.

Start the Manual Agent program.

Log in to the system.

Specify a destination database.

Select the GCsolution analysis result file.

Select and store analysis data.

Check stored data in Agent Manager.

2.2.1 Starting the Manual Agent Program

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

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
[GCsolution Manual Agent].

Click here.

2-8
 2 Getting Started

Using a folder icon on the desktop

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

Double-click here.

(2) Double-click the icon for [GCsolution Manual Agent].

Double-click here.

2.2.2 Logging In to the System

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

- The "Login" dialog box -

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

2-9
2 Getting Started

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-10
 2 Getting Started

2.2.3 Specifying a Destination Database

Specify a destination database where the GCsolution analysis data is to be stored.
The following example illustrates how data from "Instrument1" is stored to
C:\Agent2\example(normal).mdb. A database must first be created using Agent Manager.

1) Click the "Select Database..." menu item in the "File Menu" pane.
Clicking the [Browse] button opens the "Select Database" dialog box.

- The "Select Database" dialog box -

In the "Select Database" dialog box, click “example(normal).mdb” to specify the destination
database to use, and click the [OK] button.

2-11
2 Getting Started

2) The currently selected database name is displayed in the status bar.

A data base name is displayed here.

2.2.4 Selecting and Storing Analysis Data

1) From the "Folder List" pane on the main screen, select a destination directory where analysis
data is saved. The listing of analysis data files is displayed in the upper right pane.

2) From the "File List" pane, select a file (calculated data file) to be stored in the database. To
select several files, use the Shift and Ctrl keys, as in Windows Explorer.

2-12
 2 Getting Started

3) Click the "Entry" button.

4) The selected data is stored in the selected database and a result is displayed in the lower right
pane.

Results are displayed here.

5) Check stored data using Agent Manager.

2-13
 Chapter 3 Automatic Agent
3.1 Starting the Program................................................................................3-1
3.2 Main Screen .............................................................................................3-2
3.3 Command Buttons ...................................................................................3-3
3.4 Status Bar.................................................................................................3-5
3.5 Using the Menu List ................................................................................3-6
3.5.1 Viewing the Status ................................................................................................. 3-7
3.5.2 Configuration Settings ........................................................................................... 3-7
3.5.3 System Configuration Settings............................................................................... 3-9
3.5.4 Database Assignment Settings ............................................................................. 3-12
3.5.5 Sample information .............................................................................................. 3-17
3.5.6 Compressed File Settings ..................................................................................... 3-18
3.5.7 Executing an Application ..................................................................................... 3-19
3.5.8 Linking a Database............................................................................................... 3-21
 3 Automatic Agent

3.1 Starting the Program

1) Double-click the Class-Agent Software desktop icon.

Double-click here.

2) Double-click the GCsolution Automatic Agent icon.

This icon opens a file in

Notepad, showing information
on precautions and upgrade.

Double-click here.

Agent Manager
This program is used for creating user accounts, storing
data in a database, viewing or editing stored data.

3) Follow the login procedure after staring the program.

- The "Login" dialog box. -

3-1
3 Automatic Agent

3.2 Main Screen

The following shows the main screen of the GCsolution Automatic Agent program.
The main screen is used to perform various functions.

- The main screen -

Command button
Clicking this button
executes a command.

Menu pane Status bar

This pane displays a list The operating status of the
of options for selection. program is indicated here.

3-2
 3 Automatic Agent

3.3 Command Buttons

(1) The [Taskbar] button

The GCsolution Automatic Agent main screen does not have the window
Maximize/Minimize buttons and their respective menu commands. To hide GCsolution
Automatic Agent, click the [Taskbar] button. The GCsolution Agent window will be
minimized to an icon in the taskbar.

The resident program icon in the taskbar.

Double-click or right-click the icon for GCsolution

Automatic Agent to redisplay the main screen.

Although the main screen disappears from the desktop, the task of storing data in a database
continues. The icon in the taskbar changes its color, depending on the operating status of the
program.

(2) The [Login] button

The GCsolution Automatic Agent program provides security protection that restricts system
use to previously defined authorized users, and grants permissions to restrict the operations
that users may perform. The login procedure restricts access and system use to authorized
users. User’s activities are recorded in a log database. A log database can be viewed using
Agent Manager.

The [Login] button opens the "Login" dialog box, as shown below.

- The "Login" dialog box -

3-3
3 Automatic Agent

Procedure
1) Type a login ID and password in the text boxes. Passwords are case-sensitive.

2) Click the [OK] button. A user will be allowed to gain access to the system if the login ID
and password entered meet the following conditions.

• The login ID entered matches the one registered to Agent Manager.

• The password entered matches the one assigned to the login ID entered.
• The Run Agent/GW permission has been granted to the users who have entered
his login ID.

If these conditions are not met, the user will have to make a login attempt by clicking
[Login] when the program starts. Clicking the [Cancel] button or logging in with a user
account that does not have the Run Agent/GW permission starts the program in logout
status. See the [Logout] button.

(3) The [Logout] button

This button enables a user to log out without exiting the program. The user can no longer
make settings or store data in a database; however, the user can use command buttons other
than the [Logout] button. This button is useful when several users take turns performing
operations while running the program, or when a user intentionally stops storing data in a
database throughout the system.
The [Logout] button opens the "Logout" message box, shown below.
- The "Logout" message box -

Clicking the [OK] button to log out. Clicking the [Cancel] button aborts a logout attempt.

(4) The [Help] button

This button opens the help window for a particular topic about the main screen. It is useful
when a user needs on-line help while using the program. Pressing the F1 key also opens the
help window; however, this shows the help topics related to the currently open window.

(5) The [Exit] button

This button exits the program. It automatically executes the logout procedure if the program
is directly terminated under login status.

3-4
 3 Automatic Agent

3.4 Status Bar

The status bar indicates the operating status of the program.

Login user indicator

Operating status indicator Database status indicator

1) Operating status indicator

The operating status is indicated in the following three ways. An icon in the taskbar changes
its color depending on the operating status of the program.

The “Ready” status means that the program is on standby after a login,
monitoring GCsolution data output.
Green

The “Processing” status means the program is now processing and

registering GCsolution data output to a database.
Yellow

The “OFF” status means that the program is logged out. Even if
GCsolution data is output, it will not be processed or registered to a
Gray database.

2) Login user indicator

This indicates the name of the currently logged in user. The word “Logout” is displayed after
a logout.

3) Database status indicator

This indicator counts the number of times data is written into a database. The database status
is indicated in the following three ways.
OK This indicates the number of times all data and logs are processed and registered in a
normal condition.
WA This indicates the number of times data is registered in a normal condition but log
information is not properly written. The log information is stored in a temporary log
database (TMP_LOG2.MDB).
NG This indicates the number of times data could not be registered to a database. The data
is stored in a temporary database (TMP_DT2.MDB), while the log information is
stored in a temporary log database (TMP_LOG2.MDB).

3-5
3 Automatic Agent

3.5 Using the Menu List

Menu items are listed in the left-hand pane of the main screen. Clicking a menu item displays
settings for the selected menu item in the right-hand pane. The selection of these menu items is
restricted to users having the Option/Configuration permission. If a user does not have this
permission, only the "Status" pane is displayed. Changes made to settings are saved to the
system registry, and they remain effective even after the program is exited.

The menu has the following 7 setting options.

• "Status"
• "Configuration"
• "Assign database per instrument"
• "Select database by keyword priority"
• "Data registation opetions"
• "Sample Information"
• "Select compression files"
• "Execute application"

- The main screen -

Menu List pane Menu Display pane

3-6
 3 Automatic Agent

3.5.1 Viewing the Status

- The "Status" pane -

The "Status" pane displays the status of various things, such as the registration to databases,
compressed files, login procedure, logout procedure and error information. This message box
provides no settings options. If the text displayed in this pane exceeds 100 lines, the text is saved
to the setup folder named GCsol_TT2.LOG. If the GCsol_TT2.LOG file is already available, it
is renamed GCsol_TT2.BAK each time a new log is recorded. Thus, a log of old status
information can be viewed. These log files can be retrieved using a text editor like Notepad.

3.5.2 Configuration Settings

The following describes how to make settings for basic operating conditions of the Automatic
Agent program. The use of this feature is restricted to users having the Property/Option
permission.

- The "Configuration" pane -

3-7
3 Automatic Agent

• The "Normal login" check box

If this check box is on, the "Login" dialog box is displayed when a user has started the
Automatic Agent program and has clicked the [Login] button. This check box displays the
login ID entered by a user at the last login or when the Automatic Agent program was exited.

• The "Auto login" check box

If this check box is on, a user can automatically log in to the system under the login ID and
password, defined in the "Login ID" and "Password" text boxes. Since the login ID and
password entered in these text boxes are not subject to verification, define a login ID and
password with care. If this check box is on, the "Login" dialog box does not appear when a user
starts the Automatic Agent program. The auto-login settings are useful when security
protection is not needed, but they are not recommended if security is needed. To prevent
auto-login settings from being changed, assign the Option/Configuration permission only to
users who require it.

• The "Register this program to Windows Startup" check box

This check box is used to specify to automatic activation of the Automatic Agent program after
Windows starts. If this check box is turned on as shown in the figure, the Automatic Agent
program automatically starts.

• The "Register data file after reprocessing" check box

When this check box is set to ON, both the analysis and reanalysis data of GCsolution are
registered in a database. If it is set to OFF, only the analysis result is registered.

• The "Register Acrobat file (*.PDF) to LinkFile 10 field" check box

Set this check box to ON when a PDF document file output from GCsolution is to be registered
in a database. The PDF document file is registered as an object file in Link File 10 in the
sample information table. Click the [Browse] button to display the folder selection screen, then
select the folder to which the PDF file is output from GCsolution.
To "Wait time for monitoring document," enter the delay time required until GCsolution
outputs a PDF file after it has finished analysis or reanalysis.

• The "Register GC Data file (*.GCD) to LinkFile 9 field " check box
Set this check box to ON to register a Gcsolution data file to the database.
The Gcsolution data file is registered as an object file in the Link File 9 in the sample
information table.

3-8
 3 Automatic Agent

3.5.3 System Configuration Settings

The settings for each analytical instrument may be viewed and edited. The use of this feature is
restricted to users having the Property/Option permission.

- The "Assign database per instrument " pane -

System configuration status list To widen or narrow the

The current settings are columns, drag the column
displayed here. line to the left or right.

A system configuration status list shows the status of current settings. To make changes to the
current settings, double-click the row in the system configuration status list where changes are to
be made, or click the row and click the [Edit] button. The "Assign database per instrument"
dialog box is displayed.

3-9
3 Automatic Agent

Assigning Databases to Each System

Select any item in the system configuration status list and click the [Edit] button. The "Assign
database per instrument" dialog box is displayed.

- The "Assign database per instrument" dialog box -

This dialog box is used to assign databases to each analysis system.

Although the settings made in the "Select database by keyword priority" pane are applied to
destination databases, this setting should be made in the "Assign database per instrument" dialog
box because the system configuration setting is the basic setting for database registration.
Clicking the [OK] button saves changes made and closes the "Assign database per instrument"
dialog box. Clicking the [Cannel] button or pressing the ESC key aborts changes made and
closes the "Assign database per instrument" dialog box. Clicking the [Help] button or pressing
the F1 key opens the help window.

• The "Instrument name" text box

GCsolution Software is connected to a maximum of 4 GC systems. In this text box, specify the
name of the system to use when registering data to a database.

• The "Register data" check box

If this check box is on, an import folder is monitored at regular intervals. When data is
exported from analysis software, the data exported is registered to a specified database. If this
check box is off, output data from analysis software is not registered to a specified database,
and a setting for assigning a database by keyword is disabled.

3-10
 3 Automatic Agent

• The "Destination database" text box

In this text box, specify the destination database where data is to be stored. A destination
database can be selected from a listing in the "Select Database" dialog box that is displayed by
clicking [Browse] button.

- The "Select Database" dialog box -

Database list To widen or narrow the columns, drag

the column line to the left or right.

The "Select Database" dialog box displays a list of databases created and linked in Agent
Manager. Clicking the [OK] button selects databases, and closes the "Select Database" dialog
box. Clicking the [Cancel] button or pressing the ESC key aborts changes made and closes the
"Select Database" dialog box. Clicking the [Help] button or pressing the F1 key opens the help
window. The use of the [Add to list] and [Delete from list] buttons is restricted to users having
the Make Database permission. For the procedure for using these two buttons, see “3.5.8
Linking a Database.”

• The "User name" list box

In this list box, specify a user name to be registered to a database. User names are useful as
keywords when extracting data and registering it to a database using Agent Manager. If the
pull-down button in the right-hand end of the "User name" list box is clicked, a listing of user
names is displayed.
Select any of the following 3 options.

1. "Login user name"

The registered name is login user of Automatic Agent.

2. "Gcsolution¢s user name"

The name of a user who is logged into the GCsolution program is registered to the
database.

3-11
3 Automatic Agent

3. "Register any user name"

Select a user name from a listing of the user names registered in Agent Manager. If a user
name is selected, the "Password" dialog box is displayed. If the password entered does not
match the one assigned to the login ID for the selected user, user names cannot be selected
from the listing.

- The "Password" dialog box -

3.5.4 Database Assignment Settings

The settings for assigning databases by keyword can be displayed or edited. The use of this
feature is restricted to users having the Property/Option permission.

- The "Select database by keyword priority" dialog box -

Keyword setting status list To widen or narrow the

The current settings are columns, drag the column
displayed here. line to the left or right.

3-12
 3 Automatic Agent

Select Sample Name, Sample ID or User Name as "allot key type." If the specified characters
(keyword) are included in "allot key type" of data output from analysis software, that data is
automatically registered to a specified database. A maximum of 20 settings can be made.
The keyword setting status list shows the status of current settings.

[ADD] Clicking the [ADD] button adds a new keyword to the keyword setting status list.
The "Select database by keyword priority" dialog box is displayed.
[Edit] Clicking the [Edit] button or double-clicking a previously specified item allows
changing a previously specified item. The "Select database by keyword priority"
dialog box is displayed.
[Delete] Clicking the [Delete] button deletes a row of the selected item from the keyword
setting status list. The "Caution" message box is displayed, prompting for
confirmation. Clicking the [Yes] button deletes the item. Clicking the [No] button
aborts the deletion.

- The "Caution" message box -

• The "Key item" column

This column shows either a sample ID or user name that is currently selected.

• The "Key string" column

This column shows the characters to be searched for in the data indicated in the "Key item"
column.

• The "Database name" column

This column shows database names to which data is registered if a keyword is found in the
output data from a GCsolution instrument.

• The "User name" column

This column shows the user names that are registered to a database.

3-13
3 Automatic Agent

Assigning Databases by Keyword

The "Select database by keyword priority" dialog box is used to select destination databases
according to keywords contained in sample information. The use of this feature is restricted to
users having the Property/Option permission.

- The " Select database by keyword priority " dialog box. -

If particular keywords that represent sample information, such as sample names and sample IDs
and user names, are included in output data, a destination database can be automatically changed
to another database.

• The "Key item" list box

Specify a keyword to search for in data specified in the "Key item" list box. This field is not
case-sensitive.

• The "Keyword" text box

Specify a keyword that you want to search for in data specified in the "Item key" list box. This
field is not case-sensitive.

3-14
 3 Automatic Agent

• The "Destination database" text box

Specify the database where the data is to be saved if it contains the keyword. A destination
database must be selected from a listing in the "Select Database" dialog box that is displayed
by clicking the [Browse] button.

- The "Select Database" dialog box -

Database list To widen or narrow the columns, drag

the column line to the left or right.

The "Select Database" dialog box displays a list of databases created and linked in Agent
Manager. Clicking the [OK] button selects databases, and closes the "Select Database" dialog
box. Clicking the [Cancel] button or pressing the ESC key aborts changes made and closes the
"Select Database" dialog box. Clicking the [Help] button or pressing the F1 key opens the help
window. The use of the [Add to list] and [Delete from list] buttons is restricted to users having
the Make Database permission. For the procedure for using these two buttons, see “3.5.8
Linking a Database.”

3-15
3 Automatic Agent

• The "User name" list box

In this list box, specify a user name to register to a database. User names are useful as
keywords when extracting data and registering it to a database using Agent Manager. If the
pull-down button in the right-hand end of the "User name" list box is clicked, a listing of user
names is displayed.
Select any of the following 3 options.

1. "Login user name"

The name of a user who is currently logged in is registered to a database.

2. "GCsolution¢s user name"

The name of a user is has logged into the GCsolution program at the time of data
acquisition or analysis is registered to a database.

3. "System Administrator"
Select a user name from a listing of the user names registered in Agent Manager. If a user
name is selected, the "Password" dialog box is displayed. If the password entered does not
match the one assigned to the login ID for the selected user, user names cannot be selected
from the listing.

- The "Password" dialog box -

3-16
 3 Automatic Agent

3.5.5 Sample information

Set up an item to register in the sample information table.
The GCsolution option item is on the option tab of the GCsolution batch method menu.

- The " Sample information" pane -

3-17
3 Automatic Agent

3.5.6 Compressed File Settings

When data is registered to a database, the data file can be compressed and saved to the database.
In the "Select compression files" pane, select the type of file to be compressed. The Automatic
Agent program names the compressed files with a unique filename, which will be registered to a
database. Compressed files can be decompressed at any time using Agent Manager. The
UnLHA32.dll is used for file compression. Therefore, compressed files can be viewed,
decompressed or re-compressed at any time using marketed LHA utilities programs.
For detailed information on specifications for compressed files, see “Appendix: Compressed
Files and Object Link Files.”

- The "Select compression files" pane -

All checked files are compressed.

• The "Show compression progress bar" check box

If this check box is on, a dialog box is displayed, showing the progress meter for file
compression. The progress meter does not appear while the main screen is minimized to an
icon in the taskbar. For routine operations, turn off this check box to avoid a progress-meter
being displayed when running other applications.

• The "Delete import files after data registration. (*.CDF *.PDF) " check box
When checked, import files (“*.CDF” and “*.PDF”) are deleted after registration of data to a
database is completed. Data files (“*.GDC”), method files (“*.GCM”) and schedule files
(“*.GCB”) and report files (“*.GCR”) are not deleted.

3-18
 3 Automatic Agent

3.5.7 Executing an Application

Settings may be made to run a specified application and save a sample information file in text
format when data is registered to a database. The sample information file contains information
about the sample information table registered to the database, but it does not contain the data
specified in the sample information window. The following settings are useful especially when
using a custom application to perform certain operations. Care should be taken to make settings
for executing an application, because the specified application starts running and a sample
information file is output each time measurement is performed. If this setting is not made
correctly, Windows operations may be hindered.

- The "Execute application" pane. -

• The "Execute after database registration" check box

If checked, the selected application runs, and a sample information file is output when data is
registered to a database. For routine operations, turn off this check box.

3-19
3 Automatic Agent

• The "Program file name" text box

In this text box, specify the name of the application. If you type an application name directly in
the text box, the application name must be enclosed with double quotation marks (“ ”). Up to
10 command lines can be used. Each command must be separated by a space. Clicking the
[Browse] button opens a program selection dialog box, as shown below.

- The Program Selection Dialog Box -

Double-click a filename, or click a filename and click the [Open] button.

• The "Sample information export folder" text box

In this text box, specify the name of the destination folder to output a text-formatted sample
information file. The same dialog box as shown in “3.5.3 System Configuration Settings” is
displayed.
An output file is named GCsol2D_TT2****.TXT. The asterisks (****) represent a number
between 0 and 9999. The number is reset to 0 when it exceeds 9999.

• The "Add a sample information file name in the command line" check box
If checked, a sample information filename is added to a command line for the application to be
executed. This requires the application to be able to process a command line.

3-20
 3 Automatic Agent

3.5.8 Linking a Database

This section describes how to link a database or remove the link. To make automatic entries,
create a database using Agent Manager, and link the database using the dialog box shown below.
[NOTE] • Linking a database is restricted to users having the database link permission in
Agent Manager or Automatic Agent.
• A database can only be created using Agent Manager. See the CLASS-Agent
Manager Software Instruction Manual for the procedure to create a database.

Linking a Database
Procedure (MDB database)
1) Choose [Tools] ® [Link Database].
2) Click the [Add to list] button.
3) A window for selecting and linking a database is displayed.

MDB file
selection button

Click the MDB file selection button shown above, and select the MDB file from the dialog
box.

3-21
3 Automatic Agent

The [Next] button is enabled when MDB file is selected. Click the [Next] button to continue.

Click the [Check the connection] button.

If a password has been set in MDB database, input the password before clicking the [Check
the connection] button.

4) If the connection settings are correct, the [Finish] button is enabled. Click the [Finish]
button.

3-22
 3 Automatic Agent

5) A dialog box prompting for a comment is displayed. Type a comment, if any, and click the
[OK] button.

Procedure (SQL /Oracle database)

1) Choose [Tools] ® [Link Database].

2) Click the [Add to list] button.

3) Choose [SQLServer/MSDE] or [Oracle] from the option buttons of “Selection of the

database.”
Enter the database name in the “DataBase” input box. The database name is the same as the
name that was used when the database was created on the server by Agent Manager.

4) Enter the machine name of the server where the SQL server database is stored.

3-23
3 Automatic Agent

5) Click the [Next] button. For the SQL server database, the following screen is displayed.

Choose and set the communications protocol for the SQL server. Click the [Next] button.

6) Log in to the SQL Server, using the setting made in Step 5. Define a login ID and password.
The login ID and password should be defined when making SQL Server settings. Contact
the system administrator for any questions.
Enter an ID and a password, then click the [Check the connection] button.

7) If connection settings are correct, the [Finish] button is enabled. Click the [Finish] button.

3-24
 3 Automatic Agent

8) A dialog box prompting for a comment is displayed. Type a comment, if any, and click the
[OK] button.

Removing a Linked Database

Procedure
1) From a database list, select the linked database to be removed.

2) This button opens the "Delete" dialog box to delete selected databases from a list. Clicking
the [Cancel] button aborts the deletion.
A message box prompting for confirmation is displayed.

3) Ensure that the filename of the linked database to be deleted is correct, and click the [OK]
button. The linked database is removed from the database list.
[CAUTION] Removing a linked database currently listed in a database tree leaves an icon for
that database in the "Database Tree" pane. To remove the icon, log out and log
in again.

3-25
 Chapter 4 Manual Agent
4.1 Starting the Program................................................................................4-1
4.2 Main Screen .............................................................................................4-2
4.3 Logging In ...............................................................................................4-5
4.4 Logging Out.............................................................................................4-6
4.5 Selecting a Database................................................................................4-7
4.6 Viewing Properties ................................................................................4-13
4.7 Exiting a Program..................................................................................4-14
4.8 Registering to Database .........................................................................4-15
4.9 Adding or Deleting Compression Files .................................................4-19
4.9.1 Adding Files ......................................................................................................... 4-20
4.9.2 Deleting Files ....................................................................................................... 4-20
4.10 Toolbar and Status Bar ..........................................................................4-21
4.11 Details Information................................................................................4-22
4.12 Reentry List ...........................................................................................4-23
4.13 Options...................................................................................................4-24
4.13.1 Selecting a Font.................................................................................................... 4-25
4.14 Update Information................................................................................4-26
4.15 Configuration Settings...........................................................................4-27
4.15.1 Configuration Settings ......................................................................................... 4-28
4.15.2 Compressed File Settings ..................................................................................... 4-29
4.15.3 Executing an Application ..................................................................................... 4-30
4.15.4 Setting the instrument name................................................................................. 4-32
4.15.5 Operator name...................................................................................................... 4-32
4.15.6 Sample information .............................................................................................. 4-33
4.16 Editing a Reentry List............................................................................4-34
4.17 Help Topics............................................................................................4-35
 4 Manual Agent

4.1 Starting the Program

1) Double-click the Class-Agent Software desktop icon.

Double-click here.

2) Double-click the GCsolution Manual Agent icon.

This icon opens a file in

Notepad, showing information
on precautions and upgrade.

Double-click here.

Agent Manager
This program is used for creating user accounts, storing
data in a database, viewing or editing stored data.

3) Follow the login procedure after staring the program.

- The "Login" dialog box -

4-1
4 Manual Agent

4.2 Main Screen

The following shows the GCsolution Manual Agent window, used to perform various program
functions.

- GCsolution Manual Agent Window -

Menu bar Toolbar File List pane

Status bar Detail Information pane

Functions (Menu bar)

The menu bar provides access to menu commands as follows.
1) [File] menu
[Login] See “4.3 Logging In”
[Logout] See “4.4 Logging Out”
[Select Database] See “4.5 Selecting a Database”
[Properties] See “4.6 Viewing Properties”
[Exit] See “4.7 Exiting a Program”

2) [Entry] menu
[Entry...] See “4.8 Registering to Database”
[Reentry...] See “4.8 Registering to Database”
[Wizard...] See “4.8 Registering to Database”
[Add Compression Files...] See “4.9 Adding or Deleting Compression Files”

4-2
 4 Manual Agent

3) [View] menu
[Toolbar] See “4.10 Toolbar and Status Bar”
[Status Bar] See “4.10 Toolbar and Status Bar”
[Detail Information] See “4.11 Detail Information”
[Reentry List...] See “4.12 Reentry List”
[Options...] See “4.13 Options”
[Update] See “4.14 Update Information”

4) [Tools] menu
[Configuration...] See “4.15 Configuration Settings”
[Edit Reentry List...] See “4.16 Editing a Reentry List”

5) [Help] menu commands

[Help Topics...] See “4.17 Help Topics”
[About Manual Agent...] See “4.17 Help Topics”

Functions (Toolbar)
The toolbar buttons are available as follows.
1) [Login] See “4.3 Logging In”

2) [Logout] See “4.4 Logging Out”

3) [Select] See “4.5 Selecting a Database”

4) [Entry] See “4.8 Registering to Database”

5) [Reentry] See “4.8 Registering to Database”

6) [Wizard] See “4.8 Registering to Database”

7) [Details] See “4.11 Detail Information”

Functions (Status Bar)

1) Status indicator
This indicates the operating status of this software as follows.
“Login” The system is logged in, without analysis data being read.
“Processing” The system is logged in, with analysis data being read.
“Logout” The system is not logged in.

2) Login user name indicator

This indicates the name and login ID of a user who is currently logged in.

3) Additional file number indicator

This indicates the number of compressed files added. For detailed information, see “4.9
Adding or Deleting Compression Files.”

4) Database name indicator

This indicates the name of a currently selected database.

4-3
4 Manual Agent

Functions (File List pane)

The "File List" pane displays a list of files to be saved to databases.

- The "File List" pane -

System list box File List pane File Type list box

Folder List pane

File List pane

1) The "System" list box Opens a destination folder where files for each system are stored.

2) The "Folder List" pane Opens a selected folder.

3) The "Type" list box Specifies the file type of files that are listed in the "File List"
pane.

4) The "File List" pane Displays a list of files specified in the "System" and "Type" list
boxes and the "Folder List" pane.

Operations
1) Double-click the icon for Manual Agent to open the main screen.

2) Perform data processing.

3) Click the [Exit] button to close the main screen and exit the Manual Agent Program.

4-4
 4 Manual Agent

4.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) Click the [Login] button in the toolbar, or click the [Logout] menu command in the menu
bar. The "Login" dialog box is displayed.

2) Type a login ID and password.

3) Click the [OK] button.

A user can log in to the system if the login ID and password entered meet the following two
conditions.
a) The login ID and password entered match the ones registered to Agent Manager.
b) The Run Agent/GW permission has been granted to the user.
If these conditions are not met, another login attempt should be made from the beginning.
Clicking the [Cancel] button aborts a login attempt.

About User Permissions

The user permissions are assigned to each login ID in Agent Manager. The operations that a user
may perform depend on degrees of user permissions. The user permissions include the
following.

1) Run Agent/GW permission

“ON” A user can log in.
“OFF” A user cannot log in.

2) Property/Option permission
“ON” A user can use the "Configuration" and "Reentry List" dialog boxes.
“OFF” A user cannot use the "Configuration" and "Reentry List" dialog boxes.

3) Database Management permission

“ON” A user can use the [Add to list] and [Delete from list] buttons in the "Select
Database" dialog box.
“OFF” A user cannot use the [Add to list] and [Delete from list] buttons in the "Select
Database" dialog box.
[SEE ALSO] For procedures for creating a user account and granting user permissions, see the
CLASS-Agent Manager Software Instruction Manual.

4-5
4 Manual Agent

4.4 Logging Out

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

Procedure
Click the [Logout] button in the toolbar, or click the [Logout] menu command in the menu bar.

4-6
 4 Manual Agent

4.5 Selecting a Database

The "Select Database" dialog box is used to select a database, add it to a list or delete it from the
list. The use of the [Add to list] and [Delete from list] buttons requires the Database
Management permission.

- The "Select Database" dialog box -

Procedure
1) Choose [File] ® [Select Database], or click the [Select] button in the toolbar. The "Select
Database" dialog box is displayed.

2) Select the database to use.

3) Click the [OK] button. The selected database is identified as a destination database. Clicking
the [Cancel] button clears the selection.

4) The "Select Database" dialog box closes, returning to the main screen.

4-7
4 Manual Agent

Functions
1) The [Add to list] button
This button adds the selected database to a list. This button opens the "Setting of database
connection" dialog box.

Linking a Database
Procedure (MDB database)

1) Click the [Add to list] button.

2) Select the [MDB] option button of “Selection of the database.”

MDB file
selection button

Click the MDB file selection button shown above, and select the MDB file from the
dialog box.

The [Next] button is enabled when MDB file is selected. Click the [Next] button to
continue.

4-8
 4 Manual Agent

Click the [Check the connection] button.

If a password has been set in MDB database, input the password before clicking the
[Check the connection] button.

3) If the connection settings are correct, the [Finish] button is enabled. Click the [Finish]
button.

4) A dialog box prompting for a comment is displayed. Type a comment, if any, and
click the [OK] button.is displayed

4-9
4 Manual Agent

Procedure (SQL /Oracle database)

1) Choose [Tools] > [Link Database].

2) Click the [Add to list] button.

3) Choose [SQLServer/MSDE] or [Oracle] from the option buttons of “Selection of the

database.”
Enter the database name in the “DataBase” input box. The database name is the same
as the name that was used when the database was created on the server by Agent
Manager.

4) Enter the machine name of the server where the SQL server database is stored.

5) Click the [Next] button. For the SQL server database, the following screen is
displayed.

Choose and set the protocol for the SQL server. Click the [Next] button.

4-10
 4 Manual Agent

6) Log in to the SQL Server, using the setting made in Step 5. Define a login ID and
password. The login ID and password should be defined when making SQL Server
settings. Contact the system administrator for any questions.
Enter an ID and a password, then click the [Check the connection] button.

7) If connection settings are correct, the [Finish] button is enabled. Click the [Finish]
button.

8) A dialog box prompting for a comment is displayed. Type a comment, if any, and
click the [OK] button.

4-11
4 Manual Agent

Removing a Linked Database

Procedure
1) From a database list, select the linked database to be removed.

2) The [Delete from list] button opens the "Delete" dialog box to delete selected databases from
a list. Clicking the [Cancel] button aborts the deletion.
A message box prompting for confirmation is displayed.

- The "Delete" dialog box -

3) Ensure that the filename of the linked database to be deleted is correct, and click the [OK]
button. The linked database is removed from the database list.

4-12
 4 Manual Agent

4.6 Viewing Properties

The [Properties] command is used to view information on a currently selected database, a
currently selected file or a user who is currently logged in.

- The "Properties" dialog box -

Functions
1) The "Database" tab
This sheet displays information on the destination database selected in the "Select Database"
dialog box.

2) The "User" tab

This sheet displays information on a user who is currently logged in.

3) The "File" tab

This sheet displays information on a currently selected file.

Procedure
1) Choose [File] ® [Properties] to open the "Properties" dialog box. Click any of the
"Database," "User" and "File" tabs to open its sheet.

2) Click the [OK] button. The "Properties" dialog box closes, returning to the main screen.

4-13
4 Manual Agent

4.7 Exiting a Program

The [Exit] menu command exits the Manual Agent Program.

Procedure
Chose [File] ® [Exit] to exit the Manual Agent Program.

4-14
 4 Manual Agent

4.8 Registering to Database

Analysis data contained in a file selected in the "File List" pane is registered to a database.

Functions
1) [Entry...]
Analysis data in a file is stored as “new” data in a database.

2) [Reentry...]
Analysis data in a file decompressed by Agent Manager is stored in a database. A database
can be updated in any of the following two ways:
Register analysis data as “new” data without disturbing old data stored in database.
Register analysis data as “ overwritten” data by deleting old data from a database.

[NOTE] • For a database update, select a database that contains original data.
• Pressing the [ESC] key during a database registration will abort the database
registration.
• The batch file determines the batch schedule name that is registered to a data file.
The batch file name is registered to a database by performing the batch analysis
again with GCsolution.

Procedure (Entry...)
1) Select the database analysis data is to be stored. See “4.5 Selecting a Database” for the
procedure for selecting a database.

2) Select the analysis data to be registered. See “4.2 Main Screen” for the procedure for
selecting a file.

3) Choose [Entry] ® [Entry...] in the menu bar, or click the [Entry] button in the toolbar.

4) If the "Confirm database at registration" option is [ON], the "Confirmation" dialog box is
displayed. Click the [Yes] button to register all the selected files. Click the [No] button to
abort the current selections.
If the "Confirm database at registration" option is [OFF], the "Confirmation" dialog box is
not displayed and the selected files are registered. See “4.13 Options” for the "Confirm
database at registration" setting.

- The Confirmation dialog box -

4-15
4 Manual Agent

Procedure (Reentry...)
1) Select the database where analysis data is to be stored. See “4.5 Selecting a Database” for the
procedure for selecting a database.

2) Select the analysis data to be registered. See “4.2 Main Screen” for the procedure for
selecting a file.

3) Choose [Entry] ® [Reentry...] in the menu bar, or click the [Reentry] button in the toolbar.

4) In the "Reentry List" dialog box, ensure that the contents of the selected data file is shown in
the list. Click the [OK] button to update a database.
The [Cancel] button is used to abort the database update.
The [Help] button is used to open a help file.

- The "Reentry List" dialog box -

Procedure (Using the Wizard in Database Registration)

1) Select a destination database.

2) Select a data file to be registered.

3) Click [Wizard] in the [Entry] menu, or click the [Wizard] button in the toolbar.

4-16
 4 Manual Agent

4) Select the method of registering analysis data in the database. Click the Option button to
open the [Entry Wizard]. Select the [New] or [Update] option button and click the [Next]
button.

[NOTE] The lower part of the "Entry Wizard" dialog box may be disabled if the [Reentry]
option button is not available for database update.

- Entry Wizard - Select entry kind dialog box -

5) Select additional files to be compressed. For selection of additional files, see “4.9.1 Adding
Files.” After selecting additional files, click the [Next] button.

- Entry Wizard - Addition compression Files dialog box -

4-17
4 Manual Agent

6) Make sure that all the selected files are correct. If the current selections are correct, click the
[Finish] button. All the selected files in the list are compressed and stored in a database. To
deselect a selected file, click the [Back] button to return to the previous screen.

- Entry Wizard - Confirmation dialog box -

4-18
 4 Manual Agent

4.9 Adding or Deleting Compression Files

To compress files other than those specified in “4.16.2 Compressed File Settings,” specify the
files in the "Add Compression File" dialog box.

Kind of Compressed Files

• Data files • ANDI files • Method files
• Batch schedule • Report format •Document files

- The "Add Compression File" dialog box -

Functions
1) The [Add] button
This button adds selected files to a compression files list. The selected files are displayed in
the "Add compression files list" section.

2) The [Delete] button

This button deletes selected files from a compression files list.

3) The "Clear this list after database entry" check box

ON A listing of selected files, displayed in the "Add compression files list" section, will
be cleared each time analysis data is stored in a database.
OFF A listing of selected files, displayed in the "Add compression files list" section, will
not be cleared each time analysis data is stored in a database.

Procedure
1) Choose [Entry] ® [Add Compression File]. The "Add Compression File" dialog box is
displayed.

2) Specify files to be to added or deleted.

3) Clicking the [OK] button adds or deletes the selected files and returns to the main screen.
Clicking the [Cancel] button aborts the addition or deletion. Clicking the [Help] button
opens a help file.

4-19
4 Manual Agent

4.9.1 Adding Files

The "Add File" dialog box is used to specify the files to be compressed.

- The "Add File" dialog box -

Procedure
1) Click the [Add] button in the "Add Compression File" dialog box. The "Add File" dialog
box is displayed.

2) Specify the file to be added.

3) Click the [Open] button. The selected file is registered and displayed in the "Add
compression list" section. Clicking the [Cancel] button aborts the file selection.

4.9.2 Deleting Files

The files in the "Add compression files list" section are selected and deleted using this
procedure.

Procedure
1) Specify the file to be deleted from the "Add compression files list" section.

2) Click the [Delete] button. The selected file is deleted from a listing in the "Add compression
files list" section.

[NOTE] Once deleted, files cannot be added to archive files the next time analysis data is
stored in a database.

4-20
 4 Manual Agent

4.10 Toolbar and Status Bar

The [Toolbar] and [Status Bar] commands are used to show or hide the toolbar and the status
bar.

Functions
1) Toolbar
Choose [View] and click [Toolbar] to show or hide the toolbar.

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

4-21
4 Manual Agent

4.11 Details Information

The [Details Information] command is used to display detail information on the file selected in
the upper right pane of the main screen.

- The "Details Information" pane -

Procedure
1) Select the file to view its detail information from the "File List" pane of the main screen.

2) Choose [View] ® [Details Information]. The detail information on the selected file is
displayed in the "Details Information" pane of the main screen.

4-22
 4 Manual Agent

4.12 Reentry List

The "Reentry List" dialog box displays a listing of analysis data decompressed in Agent
Manager. The analysis data displayed in the dialog box can be stored in a database by updating
or replacing.

- The "Reentry List" dialog box -

Procedure
1) Choose [View] ® [Reentry List]. The "Reentry List" dialog box is displayed.

2) Check a listing of analysis data decompressed in Agent Manager. Clicking the [Help] button
opens a help file.

3) Click the [Close] button to close the "Reentry List" dialog box.

4-23
4 Manual Agent

4.13 Options
The [Options] command is used to select option items.
- The "Options" dialog box -

Option Items
1) The "Font" section
This section is used to select a font. See “4.13.1 Selecting a Font."

2) The "Show selected folder" check box

This check box is used to specify whether to show the "Folder List" pane.
ON The "Folder List" pane is displayed.
OFF The "Folder List" pane is not displayed.

3) The "Automatically select last used database at login" check box

This check box is used to specify whether to select a database automatically at a login. The
database to be selected at a next login is the one that was previously selected under the login
ID entered at the last login.

4) The "Confirm database at registration" check box

This check box is used to specify whether to display a confirmation message box each time
data is stored in a database by adding, updating or replacing.
ON The database upload confirmation message box is displayed.
OFF The database upload confirmation message box is not displayed.

Functions
1) The [Change] button
This button is used to select a font. See “4.13.1 Selecting a Font.”

2) The [Help] button

This button is used to open a help file.

Procedure
1) Choose [View] ® [Options]. The "Options" dialog box is displayed.

2) Select the desired option items.

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

4-24
 4 Manual Agent

4.13.1 Selecting a Font

The "Font" dialog box is used to select a screen font for the main screen.

- The "Font" dialog box -

Option items
“Font name” “Font size”
“Font style” “Font script”

Default fonts
MS Sans Serif, Regular, 9 points, Western

Procedure
1) Click the [Change] button in the "Option" dialog box. The "Font" dialog box is displayed.

2) Select the desired option items.

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

4) The "Font" dialog box closes, returning to the "Option" dialog box.

4-25
4 Manual Agent

4.14 Update Information

The [Update] command is used to check the analysis data to be registered to a database.

- The "File List" pane -

Procedure
Choose [View] ® [Update]. The content of a file list is updated in the "File List" pane of the
main screen, showing the latest information.

4-26
 4 Manual Agent

4.15 Configuration Settings

This section describes how to make the configuration settings. The use of this feature requires
the Property/Option permission.

- The "Configuration" dialog box -

Menu

Option items
1) "Configuration" See “4.15.1 Configuration Settings”

2) "Select compression files" See “4.15.2 Compressed File Settings”

3) "Execute application" See “4.15.3 Execute application”

4) "Instrument name" See “4.15.4 Setting of the instrument name”

5) "Operator name" See “4.15.5 Operator name”

6) "Sample information" See “4.15.6 Sample information”

Functions
1) The "Menu" pane : Setting screen for the selected menu item is displayed.

2) The [Help] button : Opens a help file.

Procedure
1) Choose [Tools] ® [Configuration]. The "Configuration" dialog box is displayed.

2) Select the desired menu item to open its dialog box.

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

4) The "Configuration" dialog box closes, returning to the main screen.

4-27
4 Manual Agent

4.15.1 Configuration Settings

The "Configuration" pane is used to make the settings for system configuration and login
methods.

- The "Configuration" pane -

Option items
1) The "Use add compression files" check box
This check box specifies whether to allow or disallow addition of compressed files as
described in “4.9 Adding or Deleting Compression Files."
ON Allows a user to add or delete compressed files.
OFF Disallows a user to add or delete compressed files.

2) The "Login" section

The "Login" section is used to specify a login method. See “4.3 Logging In” for the login
procedure.
a) The "Normal login" radio button
If on, an automatic logging in attempt is not made at a boot-up. The "Login" dialog box
displays the user ID entered at the last login.
b) The "Auto login" radio button
If on, an automatic logging in attempt is made at a boot-up. If checked, specify a login ID
and password. The login ID and password must match the ones registered to Agent
Manager.

Procedure
1) Click "Configuration" in the left-hand pane of the "Configuration" dialog box. The
"Configuration" section is displayed in the right-hand pane.

2) Select the desired setting options.

3) Click the [OK] button to apply all the selected settings. The "Configuration" dialog box
closes. Clicking the [Cancel] button aborts all the changes made and closes the
[Configuration] dialog box.

4-28
 4 Manual Agent

4.15.2 Compressed File Settings

The "Select compression files" pane is used to specify the type of compressed files that are
created when data is registered.

- The "Select compression files" pane -

Option items
1) The "Select compression files" section
This section specifies the type of files to be compressed.
“Data files” “ANDI files”
“Method files” “Batch schedule”
“Report format” “Document files”

2) The "Show compression progress bar" check box

This check box specifies whether to display a progress meter during file compression.
ON The progress meter is displayed.
OFF The progress meter is not displayed.

Purpose

Making the appropriate settings for compressed files ensures that only the desired quantitative
results are archived.

Procedure
1) Click "Select compression files" in the left-hand pane of the "Configuration" dialog box.
The "Select compression files" section is displayed in the right-hand pane.

2) Select the desired setting options.

3) Click the [OK] button to apply all the selected setting options. The "Configuration" dialog
box closes. Clicking the [Cancel] button aborts all the changes made and closes the
[Configuration] dialog box.

4-29
4 Manual Agent

4.15.3 Executing an Application

The "Execute application" pane is used to specify applications that automatically start after
data is stored in a database.

- The "Execute application" pane -

Options items
1) The "Execute after database registration" check box
This check box specifies whether to start an application automatically after storing data in a
database (to send e-mail, or print operation results, etc.).
ON An application will automatically start. If checked, specify the name of the
application to be to started, the name of the output folder where the sample
information file will be stored, and set the "Add a sample information file name in the
command line" check box as described below.
OFF An application will not automatically start.

2) The "Add a sample information file name in the command line" check box
If the name of a sample information file is written after the end of a command line, the
sample information file is registered to an application that will automatically start.
ON The name of a sample information file is added to the end of a command line.
OFF The name of a sample information file is not added to the end of a command line.

4-30
 4 Manual Agent

Functions
1) The Application Name text box
In this text box, specify the full path name of the application to start automatically. Clicking
the [Browse] button displays the Application Selection dialog box. Select an application
name and click the [OK] button. The selected application name is registered. Clicking the
[Cancel] button aborts the selection.

- The Application Selection dialog box -

2) The "Sample information export folder" text box

Specify the full path name of the destination folder where the sample information file (a text
file that is made available for an application) will be stored. Clicking the [Browse] button
displays the "Browse for Folder " dialog box. Select an output-folder name and click the
[OK] button. The selected folder name is registered. Clicking the [Cancel] button aborts the
selection.

- The "Browse for Folder" dialog box -

4-31
4 Manual Agent

Procedure
1) Click "Execute application" in the left-hand pane of the "Configuration" dialog box. The
"Execute application" section is displayed in the right-hand pane.

2) Select the desired setting options.

3) Click the [OK] button to apply all the selected setting options. The "Conofiguration" dialog
box closes. Clicking the [Cancel] button aborts all the changes made and closes the
[Configuration] dialog box.

4.15.4 Setting the instrument name

Up to 8 analytical instruments can be managed. The name of each instrument must be
different.
- "Instrument name" Pane -

4.15.5 Operator name

The operator name specifies whether the currently logged in user or GCsolution data file
operator are selected for use when data is registered.
"Operator name" - Options

4-32
 4 Manual Agent

4.15.6 Sample information

Set up an item to register in the sample information table.
Option items must be specified on the [Option] tab of the "Batch Method" window in
GCsolution.

"Sample information" - Options

4-33
4 Manual Agent

4.16 Editing a Reentry List

The [Edit Reentry List] command is used to delete unwanted items from a Reentry List.

- The "Reentry List" dialog box -

Functions
The [Delete from List] button : Deletes selected items from a list.
The [Help] button : Opens a help file.

Procedure
1) Choose [Tools] ® [Reentry List]. The "Reentry List" dialog box is displayed.

2) Select unwanted items from a Reentry List.

3) Click the [Delete from list] button. The selected items are deleted from the Reentry List.

4) Click the [Close] button to close the "Reentry List" dialog box.

4-34
 4 Manual Agent

4.17 Help Topics

The [Help] menu command is used to open the help file.

Functions
1) [Help Topics] command
This command displays the Find tab. Typing a search word will display all related topics.
Click the topic to open it immediately. All of the checked topics are displayed.

2) [About Manual Agent] command

This command displays the "About Manual Agent" message box, which shows information
on Manual Agent, such as version number and date created.

- The "About Manual Agent" message box -

Procedure
1) Choose [Help] and click the [Help Topics] command. The help file opens.

2) Select the desired help topics as described in “"Help": Functions.”

Procedure (About Manual Agent)

1) Choose [Help] and click the [About Manual Agent]. The "About Manual Agent" message
box is displayed.

2) To close the "About Manual Agent" message box, click the [OK] button.

4-35
Appendix A Supplementary Information
A.1 Compressed Files and Object Link Files................................................A-1
A.2 Contents of a Database ...........................................................................A-3
A.3 Temporary Database...............................................................................A-5
A.4 Log Database ..........................................................................................A-6
A.5 User Permissions ....................................................................................A-7
A.6 AIA-format Data (Andi-format Data) ....................................................A-8
A.7 Instrument Configuration File ................................................................A-9
A.8 Contents of a Sample Information Table Created When an Application is
Activated...............................................................................................A-10
 Appendix A Supplementary Information

A.1 Compressed Files and Object Link Files

When running the GCsolution Automatic/Manual Agent program, analysis data is stored in a
database, and files are compressed and saved in LHA format. The files created include analysis
data files (*.GCD), method files (*.GCM), schedule files (*.GCB), report format files (*.GCR),
document files (*.PDF), and Andi (AIA) files (*.CDF). The Andi files (*.CDF) and document
files (*.PDF) are treated as object link files. They are stored in the same folder. Their filenames
are changed to the same filenames assigned to compressed files. Their extensions are changed to
the .CDF extension. These filenames are controlled using databases. The files can be viewed or
decompressed at any time by Agent Manager.
The following describes the names of storage folders and filename syntax.

Storage Folder - For an SQL or Oracle database

Compressed LHA format data and object link files are stored in a binary image field in the
database. The file name information in the sample information table is automatically defined
under the following conditions.

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

For an MSDE database, only 2GB may be stored.

Storage Folder - For an MDB database

For an MDB-format database, the data is stored as a file rather than a binary image field.
A folder having the database name (minus the 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

C:\Agent2\Shimadzu\*.CDF ® Object link file
C:\Agent2\Shimadzu\*.PDF ® Document file

Compressed File Name (*.LZH)

A filename is automatically defined under the following conditions.

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 numeral from 1 to 4 assigned to the CLASS instrument connected.
Storage date YYMMDD, 6 characters, the date on which the file is registered on a database.
Serial number 4 numeric characters from 0000 to 9999 used for all Agent programs. The
number is incremented by 1 each time a file is registered on a database.

Appendix A-1
Appendix A Supplementary Information

Object Link File (*.CDF, *.PDF)

A filename is automatically defined under the following conditions.

Filename = Computer name + Instrument number + Storage date + Serial number + Channel
name + “.CDF”
Filename = Computer name + Instrument number + Storage date + Serial number + Channel
name + “.PDF”

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

Example:
Computer name = “Shimadzu”, instrument number = 2, channel name =
“ch2”, registered on January 3, 1999, serial number = 10
Compressed file name = Shimadzu29901030010.LZH
AIA-format file name = Shimadzu29901030010.ch-2.CDF

[CAUTION] Compressed files and object link files are identified and managed in accordance
with the above-mentioned filename by Agent Manager. Do not move, delete or
rename these filenames using Windows Explorer or other utilities programs. A
copy or backup of these files may be made. If these filenames are changed,
Agent Manager may not run properly. To copy, move, or delete files, use Agent
Manager.

Appendix A-2
 Appendix A Supplementary Information

A.2 Contents of a Database

There are two database forms: a sample information table and a data information table. For
single analysis data obtained, a single record is added to a sample information table, while
records of all peak information at all channels are added to a data information table. These two
tables index the database on registration dates, workstation names and instrument names, so that
these two tables are linked to each other. If a single item of sample information is selected in
Agent Manager, multiple lines of data information are displayed.

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
Entry method Integer ManageFlag5
Operator Text Operator
Operation date Date Time OperateDate
LZH file's folder name Text LzhDirectory
LZH file's name Text LzhFile
AIA file (ch.1) name Text File1
AIA file (ch.2) name Text File2
AIA file (ch.3) name Text File3
GCD file name Text File9
PDF file name Text File10
Data file name Text FileInfo1
Batch schedule name Text FileInfo2
Method file name Text FileInfo3
Report file name Text FileInfo4
Background file name Text FileInfo5
Sample information 1-10 Text Tag1 - Tag10

Appendix A-3
Appendix A Supplementary Information

Data Information Table (DATATBL)

Data Name Data Type Field Name
Registration data Date Time RegistDate
Work station name Text WsName
Instrument name Text InstrumentName
Channel Text Property1
Line Text Property2
Peak number Single Property3
ID number Long LonData1
Height Long LongData2
Peak start height Long LongData3
Peak end height Long LongData4
Retention time Double DoubleData1
Concentration Double DoubleData2
Peak start time Double DoubleData3
Peak end time Double DoubleData4
Area percentage Double DoubleData5
Height percentage Double DoubleData6
Relative retention time Double DoubleData7
Theoretical plate number Double DoubleData8
Theoretical plate number/meter Double DoubleData9
k’ Double DoubleData10
Peak separation Double DoubleData11
Tailing factor Double DoubleData12
Symmetry coefficient Double DoubleData13
Area Double DoubleData16
Constituent name Text StringData1
Peak type Mark Text StringData2
Concentration unit Text StringData3

Appendix A-4
 Appendix A Supplementary Information

A.3 Temporary Database

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

Appendix A-5
Appendix A Supplementary Information

A.4 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. The log information is
classified into two types, the data log accompanied by data and the system log (Log2.mdb)
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 a common network system
is used, only “Log2.mdb” is created in the common folder. These databases can be used in all
types of Agent programs (Auto Agent, Manual Agent and Agent Manager).
If the system is in 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, 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 per one 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
Registration data Date Time RegistDate
Description of operations Text Operation
Description Text Comment 1

Appendix A-6
 Appendix A Supplementary Information

A.5 User Permissions

User permissions are used to identify users, and restrict the operations that users may perform.
The Automatic Agent/Manual 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 not
having this permission cannot log in to the Automatic Agent Program, and may not perform
any operations.

• Option/Configuration Permission
This permission allows an authorized user to make changes to the settings of the Automatic
Agent Program. A user not having this permission cannot use a menu of lists, but can register
data on a database at a given setting.

• Database Management Permission

This permission allows an authorized user to make changes to the settings for database
management: whether to allow or disallow use of databases. If a user not having this
permission logs in to the system, the [ADD to list] and [Delete from list] buttons in the
"Select Database" dialog box are disabled, preventing the addition or deletion of a database.

Appendix A-7
Appendix A Supplementary Information

A.6 AIA-format Data (Andi-format Data)

• Input/output of AIA-format data is processed by the library, NetCDF, developed by Unicode
data Program Center, USA. Do not use characters other than alphanumeric characters for a
filename, otherwise proper operations may be hindered. The library called NetCDF can be
obtained from the Internet address at http://www.unidata.ucar.edu.
Japanese characters may not be converted correctly in the information (on element names,
etc.) saved in data files.

• Reference materials for “the AIA Communication Standard of Chromatography Data” are
available with the following address:
The Analytical Instrument Association
225 Reinekers Lane, Suite 625
Alexandria Virginia 22314 USA

[NOTE] The name “AIA file” was changed to “ANDI file" by the Analytical Instrument
Association. Though the expression “AIA file” is used in the conventional
instruction manual, it means “ANDI file."

Appendix A-8
 Appendix A Supplementary Information

A.7 Instrument Configuration File

The instrument configuration file is used by Agent Manager and the GCsolution Automatic
Agent Program. It contains information on the maximum number of analysis devices connected,
and column headings of an information table. The contents of this file can be edited using the
Agent Manager Text Editor. Editing this file incorrectly will 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 GCsol.Inf2

[DATATBL] section
This section contains settings for column headings of a data information table in Agent Manager,
such as “Area” and “Height.”

Property (1-3) data property name

Long (1-10) long-integer data name
Double (1-20) double-precision floating-point data name
String (1-5) character-string data property name

[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-9
Appendix A Supplementary Information

A.8 Contents of a Sample Information Table Created When an

Application is Activated
The following shows the contents of a sample information table that is displayed when an
external application starts up.

Section Name Keyword Description

[DBTBL] DbFile Database name
Database Information Section DbPath Path name
Creator User name
CreateWS Work station name
DataSource Data source name
[USERTBL] LoginID Login ID
User Information Section UserName User name
MailAddress E-mail address
[SAMPLETBL] RegistDate Registration date
Sample Information Section WsName Work station name
InstrumentName Instrument name
InstrumentKind Instrument type
SampleName Sample name
SampleID Sample ID
SampleType Sample type
ManageFlag1 - ManageFlag8 Management flag 1-8
Operator Operator
OperateDate Operation date
Inspector Inspector
InspectDate Date of Inspection
Approver Approver
ApproveDate Approval date
LzhDirectory LZH folder
LzhFile LZH filename
File1 - File10 Link filename 1-10
FileInfo1 - FileInfo5 File information 1-5
Tag1 - Tag10 Sample information 1-10
Description Comment 1

Appendix A-10
 Appendix B Additional Software
B.1 The Agent Automatic Print Program...................................................... B-1
B.1.1 Making Initial Settings .............................................................................. B-1
B.1.2 Test Print ................................................................................................... B-2
B.1.3 Using an External Application to Print...................................................... B-3
B.2 The Agent Mail Carrier Program............................................................ B-4
B.2.1 Making Initial Settings .............................................................................. B-4
B.2.2 Checking the Connection to Mail Server and the Test E-Mail.................. B-7
B.2.3 Using an External Application to Send E-Mail ......................................... B-8
 Appendix B Additional Software

B.1 The Agent Automatic Print Program

This section describes how to use the Agent Automatic Print program, an external application
for the Automatic Agent/Manual Agent programs. This program it much easier to perform print
jobs.
This program is an external application designed for printing registered information on a default
printer when data is registered to a database using the automatic entry or manual entry features
provided by the CLASS-Agent software. This program can run on a personal computer that
supports the Automatic Agent/Manual Agent programs of CLASS-Agent software. This
program cannot be used on a client PC used for other management/analysis.

B.1.1 Making Initial Settings

Make the necessary initial settings to use the Agent Automatic Print program. Use Windows
Explorer to start the “Agent_pr2.exe” program file from the CLASS-Agent installation directory.
After that program starts, a dialog box is displayed, as shown below. In the dialog box, make the
settings for print jobs. These setting items are saved to the file named Agent_pr2.ini, which in
turn will be used when the Agent Automatic Print program is started during automatic or manual
entry. To make changes to the print settings, follow the same procedure as for making initial
settings.

- The "Agent Automatic Print" dialog box -

Print items

Procedure
1) Make setting for print items:
Click a print item so that its check box is checked. Information for the checked print item is
automatically printed. To clear a check mark, click its check box a second time.

2) To finish the setting:

To finish the setting, click the Close x button in the upper-right corner of the "Agent
Automatic Print" dialog box.

Appendix B-1
Appendix B Additional Software

B.1.2 Test Print

To check whether a print job can be successfully completed, prepare a test sample information
file exported by the Automatic Agent/Manual Agent programs. Specify a test sample
information file in the "Execute application" pane, without specifying an external application, as
shown below.

In these steps, the test sample information file is created. Start the “Agent_pr2.exe” program
from the CLASS-Agent installation directory using Windows Explorer. After the program starts,
a dialog box is displayed, as shown below. In the dialog box, specify the test sample information
file and click the [Print] button to start printing. Registered information is printed on the default
printer specified on the personal computer. Paper size and print orientation are determined by
the properties settings for the default printer.

Click the [Browse] button to select

Click the [Print] button to print

Appendix B-2
 Appendix B Additional Software

B.1.3 Using an External Application to Print

This section describes how to print processed information each time the information is
registered to a database by the Automatic Agent / Manual Agent programs. To print data, make
the following settings in the "Execute application" pane.

(1) Turn on the "Execute at the time of the database registration" check box.

(2) In the "Application name" text box, type the full path to the Agent Automatic Print program
“Agent_pr2.exe”

(3) In the "Output Folder of the sample information file" text box, specify an output folder.

(4) Turn on the "Add a sample information filename in the command line at the time of
execution" check box.

In this example, the Agent Automatic Print program will start each time automatic or manual
entries are made, and will print registered information. The exported sample information file is
automatically deleted after a print job is successfully completed.

- The "Execute application" pane -

Appendix B-3
Appendix B Additional Software

B.2 The Agent Mail Carrier Program

This section describes how to send e-mail using the Agent Mail Carrier program, an external
application for the Automatic Agent/Manual Agent programs. This program makes it much
easier to send e-mail.
This program is an external application designed for addressing and sending e-mail to the default
receivers specified when data is registered to a database using the automatic Agent features or
manual Agent features provided by the CLASS-Agent software. This program can run on a
personal computer that supports the Automatic Agent/Manual Agent programs of
CLASS-Agent software. This program cannot be used on a client PC used for other
management/analysis.

B.2.1 Making Initial Settings

To use the Agent Mail Carrier program, initial settings must be made. Start the “Agent_ml2.exe”
program from the CLASS-Agent installation directory using Windows Explorer. After the
program starts, a dialog box is displayed, as shown below. In the dialog box, make the settings
for essential items, such as mail server information, e-mail information, and receiver’s address
information. These settings are saved to the file named Agent_ml2.ini that in turn will be used
when the Agent Mail Carrier program is started during the automatic or manual Agent process.
To make a change to the initial settings, follow the same procedure as for making initial settings.

- The "Agent Mail Carrier" dialog box -

To address e-mail:
(1) "Subject" Type a subject........................... Essential setting item
(2) "To" Type a receiver's address. ......... Essential setting item
(3) "Cc" Type receivers' addresses to send a copy.
............................................... Optional setting item
(4) "Bcc" Type receivers' addresses to send a copy, with their addresses hidden to
other receivers.
............................................... Optional setting item
(5) "From" Type a sender's address............. Essential setting item
(6) "Full Name" Type a sender's name. ............... Optional setting item

[NOTE] Specify these essential setting items. If these settings are not correct or available,
e-mail cannot be sent properly.

Appendix B-4
 Appendix B Additional Software

Setting Option Information

Click the [Option] button in the "Agent mail carrier" dialog box. The "Option" dialog box is
displayed, as shown below. Make settings for mail server connection information, the body of an
e-mail message and a method of attaching data information (sample information file).

(1) The "Account" tab (for server connection information) .................. Essential setting items
"Server Name" Type a SMTP mail server name or IP address.
"Domain Address" Type a sender's domain name.
"Port No" Type a port number of the SMTP port for mail server.
By default, the port number is 25. No change is normally required.

(2) The "Text" tab (for e-mail body information).................................. Optional setting items
In the "Body" pane, type the body of an e-mail message. No carriage return can be specified.

Appendix B-5
Appendix B Additional Software

(3) The "Data" tab (for attached sample-information files)................... Optional setting items

a) The "Export information append" check box

Turn on this check box to attach sample information to an e-mail message.
b) The "Append to body text" radio button
If on, sample information is attached to the body of an e-mail message.
c) The "Append to attachment file" radio button
If on, sample information file is attached as an attached file.
d) The "Delete a export file by the send complete" check box
Specify this to delete the export file after a sample information file is transmitted.

Appendix B-6
 Appendix B Additional Software

B.2.2 Checking the Connection to Mail Server and the Test E-Mail
This section describes how to check that initial settings such as receiver's address and sender's
address, and Option settings are correct. Click the [Connect] and [Send] buttons to check
whether an error occurs.

(1) To check the connection to mail server:

Click the [Connect] button and check the status bar. If an error message does not appear in
the status bar, with the [Send] button enabled, everything is normal. If an error code “101” is
displayed in the status bar, the connection has previously been made.

Click the [Connect]

button to check
status.

(2) To check the test e-mail:

Click the [Send] button and check the status bar. If the message “Mail Send OK” is
displayed in the status bar, everything is normal. If any other error code is displayed in the
status bar, check the receiver's address and sender's address. For detailed information on
error codes, see the e-mail error code list.

Click the [Send]

button to check
status.

Appendix B-7
Appendix B Additional Software

B.2.3 Using an External Application to Send E-Mail

This section describes how to send processed information by e-mail each time the information is
registered to a database by the Automatic Agent/Manual Agent programs. To send e-mail, make
the following settings in the "Execute application" pane.
(1) Turn on the "Execute at the time of the database registration" check box.

(2) In the "Application name" text box, type the full path to the Agent Mail Carrier program
“Agent_ml2.exe."

(3) In the "Output Folder of the sample information file" text box, specify an output folder.

(4) Turn on the "Add a sample information filename in the command line at the time of
execution" check box.

In this example, the Agent Mail Carrier program will start each time automatic or manual entries
are made, and will send registered information by e-mail. The exported sample information file
is automatically deleted after an e-mail message is successfully sent.

- The "Execute application" pane -

Appendix B-8
 Appendix B Additional Software

E-Mail Error Code List

Code Description
101 Already initialized.
102 Could not initialize TCP/IP.
103 Could not create socket.
104 Host name error.
105 Port number error.
106 Could not connect to server.
107 Could not create socket.
108 Could not connect to host. (Sever setup error)
110 Error occurred when receiving.
112 Error occurred when sending.
121 Not connected.
133 Could not end connection. Server status or setting is in trouble.
151 No file access permission
152 Filename error.
153 Properties error.
155 Error occurred when loading a file.
161 No response from host.
171 No domain name specified.
172 No sender address (From) specified.
173 No receiver address (To) specified.
174 Domain name error.
175 Sender address (From) error.
176 Receiver address (To, Cc. Bcc) error.
177 Could not send e-mail.
181 No receiver address (To, CC. Bcc) found.
191 Multi part exceeds maximum limit.
192 Multi part number error.
200 Program ran out of memory. No workspace is available.

Appendix B-9