You are on page 1of 113

223-10094A

GCMSsolution Agent
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 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 Features of the GCMSsolution Automatic Agent Program........................................ 1-2
1.1.2 Features of the GCMSsolution 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 Automatic Agent Program ........................................................................ 1-6
1.2.3 About the Manual Agent Program............................................................................. 1-7
1.2.4 About the Agent Manager Program........................................................................... 1-8

Chapter 2 Getting Started


2.1 GCMSsolution Setup............................................................................................. 2-1
2.2 Automatically Storing Analysis Data in a Database ............................................ 2-2
2.2.1 Starting the Automatic Agent Program...................................................................... 2-2
2.2.2 Logging In to the System........................................................................................... 2-3
2.2.3 Specifying a Database for Each Instrument............................................................... 2-4
2.2.4 Making an Analysis ................................................................................................... 2-7
2.3 Manually Storing Analysis Data in a Database..................................................... 2-8
2.3.1 Starting the Manual Agent Program .......................................................................... 2-8
2.3.2 Logging in to the System........................................................................................... 2-9
2.3.3 Specifying a Destination Database .......................................................................... 2-11
2.3.4 Selecting and Storing Analysis Data........................................................................ 2-12

Chapter 3 Automatic Agent


3.1 Introduction ........................................................................................................... 3-1
3.2 Main Screen........................................................................................................... 3-2
3.3 Command Buttons ................................................................................................. 3-3
3.4 Status Bar .............................................................................................................. 3-7
3.5 Using the Menu List .............................................................................................. 3-8
3.5.1 Viewing the Status..................................................................................................... 3-9
3.5.2 Configuration Settings............................................................................................. 3-10
3.5.3 System Configuration Settings ................................................................................ 3-12
3.5.4 Database Assignment Settings................................................................................. 3-16
3.5.5 Compressed File Settings ........................................................................................ 3-19
3.5.6 Running an Application........................................................................................... 3-20
3.5.7 Select Chromatograms To Be Saved ....................................................................... 3-23
3.5.8 Sample Information ................................................................................................. 3-24
Chapter 4 Manual Agent
4.1 Introduction ........................................................................................................... 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 a Database .................................................................................... 4-15
4.9 Registration Using the Wizard ............................................................................ 4-17
4.10 Adding or Deleting Compression Files ............................................................... 4-20
4.10.1 Adding Files ............................................................................................................ 4-21
4.10.2 Deleting Files .......................................................................................................... 4-21
4.11 Toolbar and Status Bar ........................................................................................ 4-22
4.12 Details Information.............................................................................................. 4-23
4.13 Reentry List ......................................................................................................... 4-24
4.14 Options ................................................................................................................ 4-25
4.14.1 Selecting a Font ....................................................................................................... 4-26
4.15 Update Information ............................................................................................. 4-27
4.16 Environment Settings .......................................................................................... 4-28
4.16.1 Configuration Settings............................................................................................. 4-29
4.16.2 Compressed File Settings ........................................................................................ 4-30
4.16.3 Running an Application........................................................................................... 4-31
4.16.4 Instrument name ...................................................................................................... 4-32
4.16.5 Operator................................................................................................................... 4-34
4.16.6 Selecting a Chromatogram ...................................................................................... 4-35
4.16.7 Sample Information ................................................................................................. 4-36
4.17 Editing a Reentry List.......................................................................................... 4-37
4.18 Help ..................................................................................................................... 4-38

Appendix A Supplementary Information


A.1 Compressed 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 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 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 perform an analysis without having to decide where to store
analysis results and what to specify as a filename. The user is able to analyze data stored in a
database, summarize analysis results, and prepare detailed printed reports like test reports,
summary reports, and daily routine reports. These data management capabilities are designed to
relieve the user from the burden of storing and recording data, thereby increasing the efficiency
of routine operations.

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


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

About the Instruction Manual


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

The names of data processing software and 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 Features of the GCMSsolution Automatic Agent Program.................................... 1-2
1.1.2 Features of the GCMSsolution 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 Automatic Agent Program..................................................................... 1-6
1.2.3 About the Manual Agent Program ......................................................................... 1-7
1.2.4 About the Agent Manager Program ....................................................................... 1-8
1 Introduction

GCMSsolution Agent is software designed to make entries of analysis results obtained from a
GCMSsolution system to a database shared by all types of CLASS-Agent Software. This software
consists of two programs:
· The Automatic Agent program that registers analysis data imported from calculated data files or
their related files created by the GCMSsolution to a database without user intervention
· The Manual Agent program that registers stored analysis files to a database manually
The Agent Manager software that comes with GCMSsolution Agent makes it much easier to view, print
or approve stored data, add sample information, copy data to other applications and restore analysis files.
GCMSsolution 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 Features of the GCMSsolution Automatic Agent Program


GCMSsolution Automatic Agent Program (GMsol_tt2.exe) allows automatic entry of analysis
data obtained from a GCMSsolution system to a database.

A user can do the following:


1. Store calculation result information in a database.
2. Save analysis files as archive files (data file, method file, batch file, report format file, ANDI
file).
3. Assign databases to each analytical instrument.
4. Sort data by sample name, sample ID, user name or operation date (Month).
5. Keep a log of database registration.
6. Share and control system resources on a LAN.
7. Run an application when registering data to a database.

1.1.2 Features of the GCMSsolution Manual Agent Program


The GCMSsolution Manual Agent Program (GMsol_mt2.exe) allows manual entry of analysis
data obtained from a GCMSsolution 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 (chromatograph file, data file, method file, schedule file,
ANDI file).
3. Keep a log of database registration.
4. Share and control system resources on a LAN.
5. 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 on 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 with filename extensions (AIA files and META files).
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.) for up to 10 items.
10. View or print a log of stored data.
11. Send analysis data by e-mail.
12. Create user accounts and user groups (for security protection).
13. Create new databases in MDB format (SQL format requires the use of optional programs).
14. Make backups of databases.
15. Register additional system logs.
16. Shift from a LAN environment to a local environment.

[NOTE] When ER/ES mode is selected at installation, the above functions are restricted.

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


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

4. Using the Accessory Programs


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

5. Running Other Applications


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

6. About Database Size


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

1-4
1 Introduction

7. Restriction in Character Codes Available in a Database


In the display field of a database table, codes for “|” (pipe), line feed and tab
cannot be input. If these codes are included in an element name or comment, they
are 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 Automatic Agent 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 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 registering data to a
database 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. Making ANDI files


This software uses the GCMSsolution program file "QGAiaCvt.dll" when ANDI
files are created. In GCMSsolution Version 1, the system path does not contain a
reference to the folder containing this file. Therefore, to create ANDI files, the
directory containing the file (the "Program" folder for the GCMSsolution
installation) must be added to the system path.

1-6
1 Introduction

1.2.3 About the Manual Agent 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. 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.

3. Executing 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. If two or more of a same application are open at the same time, operations can
be made each window.
3. An application should display no more messages than necessary.

4. Making ANDI files


This software uses the GCMSsolution program file "QGAiaCvt.dll" when ANDI
files are created. In GCMSsolution Version 1, the system path does not contain a
reference to the folder containing this file. Therefore, to create ANDI files, the
directory containing the file (the "Program" folder in the GCMSsolution install
folder) must be added to the system path.

1-7
1 Introduction

1.2.4 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 the installation of
CLASS-Agent Software is completed. If folders are shared on a LAN after
CLASS-Agent Manager is installed, care should be taken to select the appropriate
options, otherwise the settings for instrument information and log information
may be overwritten. 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


By default, three 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-8
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.

9. CDFView.exe
Three-dimensional chromatogram inside the file (*.CDF) which was converted
into ANDI format by GCMSsolution can't be read with CDFView.exe attached to
Agent Manager in the standard.

1-9
Chapter 2 Getting Started
2.1 GCMSsolution Setup...............................................................................2-1
2.2 Automatically Storing Analysis Data in a Database ..............................2-2
2.2.1 Starting the Automatic Agent Program .................................................................. 2-2
2.2.2 Logging In to the System ....................................................................................... 2-3
2.2.3 Specifying a Database for Each Instrument ........................................................... 2-4
2.2.4 Making an Analysis................................................................................................ 2-7
2.3 Manually Storing Analysis Data in a Database .......................................2-8
2.3.1 Starting the Manual Agent Program....................................................................... 2-8
2.3.2 Logging in to the System ....................................................................................... 2-9
2.3.3 Specifying a Destination Database....................................................................... 2-11
2.3.4 Selecting and Storing Analysis Data .................................................................... 2-12
2 Getting Started

2.1 GCMSsolution Setup


This program makes changes to GCMSsolution settings so that analysis data can be
automatically registered by GCMSsolution. If a setting has already been made for data
collection from this system (GCMS device), analysis data will be automatically registered after
the completion of each analysis. To do so, perform a sample schedule analysis or single analysis
in GCMSsolution after starting Automatic Agent.
For GCMSsolution operation, see the GCMSsolution Instruction Manual.

2-1
2 Getting Started

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

Login to the system.

Set up each instrument.

Create GCMSsolution sample batch.

Start single analysis.

Analyze the sample batch.

Check stored data in Agent Manager.

2.2.1 Starting the Automatic Agent Program

1. Before using the program


Before using the GCMSsolution Automatic Agent program, create a user account and
database using Agent Manager. 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
[GCMSsolution Automatic Agent].

Click here.

2-2
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 [GCMSsolution Automatic 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 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-3
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.2.3 Specifying a Database for Each Instrument


A destination database must be assigned to an instrument number in GCMSsolution. The
following procedure shows an example in which analysis data obtained from analytical
instrument 1 is stored in the database named C:\Agent2\example(normal).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.

2-4
2 Getting Started

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

1. Instrument Name
"Read from Data File" check box is used to get the instrument name from
GCMSsolution's data file. If unchecked, the instrument name in the "Name" text box.
The specified instrument name is used to register to instrument field in database.
2. 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.
3. 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.

In the "Select Database" dialog box, click “example(normal).mdb” to specify the


destination database to be used, and click the [OK] button.

2-5
2 Getting Started

4) 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.

2-6
2 Getting Started

2.2.4 Making an Analysis


1) Set up GCMSsolution for analysis. Refer to the GCMSsolution instruction manual.

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 of data obtained from the GCMSsolution system.

4) After analysis is complete, the "Status" pane displays the status of compressed files, copied
files and database registration.
- The "Status" pane -

5) Check the database using Agent Manager.


[NOTE] After this program is started, changes are made to the GCMSsolution registry. For
this reason, this program must be started before using GCMSsolution.
The GCMSsolution registry should be backed up as necessary.

2-7
2 Getting Started

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

Select a destination database.

Retrieve a GCMSsolution analysis file.

Select and store analysis data.

Check stored data in Agent Manager.

2.3.1 Starting the Manual Agent Program


1. Before using the program
Before storing GCMSsolution analysis data manually, create a user account and database
using Agent Manager. To use the Manual Agent Program, specify a user ID and password at
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
[GCMSsolution 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 [GCMSsolution Manual Agent].

Double-click here.

2.3.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.3.3 Specifying a Destination Database


Specify a destination database where the GCMSsolution analysis data is to be stored. The
following procedure shows an example in which analysis data obtained from the
GCMS-QP5000 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.

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

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

The status bar indicates


a database name.

2-11
2 Getting Started

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

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-12
Chapter 3 Automatic Agent
3.1 Introduction .............................................................................................3-1
3.2 Main Screen .............................................................................................3-2
3.3 Command Buttons ...................................................................................3-3
3.4 Status Bar.................................................................................................3-7
3.5 Using the Menu List ................................................................................3-8
3.5.1 Viewing the Status ................................................................................................. 3-9
3.5.2 Configuration Settings ......................................................................................... 3-10
3.5.3 System Configuration Settings............................................................................. 3-12
3.5.4 Database Assignment Settings ............................................................................. 3-16
3.5.5 Compressed File Settings ..................................................................................... 3-19
3.5.6 Executing an Application ..................................................................................... 3-20
3.5.7 Select Chromatograms To Be Saved.................................................................... 3-23
3.5.8 Sample Information.............................................................................................. 3-24
3 Automatic Agent

3.1 Introduction
The Automatic Agent program is used to register analysis results obtained from GCMSsolution
analysis programs to a database specified for each system. This program reads specified analysis
results after analysis is completed, and registers the analysis results to a database. The registered
analysis data can be viewed, edited or printed at any time using Agent Manager.

This program executes additional data processing at the same time as analysis data is registered
to a database. This program compresses files automatically, such as data files, method files,
batch files, report format files and ANDI files.
Compressed files can be extracted using Agent Manager. They can be re-registered to a database
using the Manual Agent program, after recalculation by the analysis program.
In GCMSsolution, a data file is compressed and saved with its filename and folder name during
an analysis process. If a compressed data file is decompressed and saved to a different folder,
recalculation may be prevented.

3-1
3 Automatic Agent

3.2 Main Screen


The following shows the Automatic Agent window, the main screen used to perform various
functions.
- The main screen -
Menu Toolbar

Status bar Detail Information pane

3-2
3 Automatic Agent

3.3 Command Buttons


Functions (Toolbar)
(1) The [Taskbar] button

This button minimizes the main screen to a taskbar icon. To redisplay the main screen,
double-click or right-click the taskbar icon for GCMSsolution Automatic Agent.

The resident program icon in the taskbar.

Double-click or right-click the icon for GCMSsolution


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.

[NOTE] In the ER/ES (Electric Record/Electric Signature) mode, double- or right-clicking


the GCMSsolution icon displays the user check dialog box. The window is
redisplayed only when the correct password is entered.

(2) The [Login] button

The GCMSsolution 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.

3-3
3 Automatic Agent

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

- The "Login" dialog box -

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 user who has entered the
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.

About User Permissions


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) Properties/Option permission
“ON” A user can make changes to all settings. Whether a user is allowed to create or
delete a database is determined by a setting as described in “3) Database
Management permission.”
“OFF” A user cannot make a change to all settings. A user is allowed to open only the
"Status" pane.

3-4
3 Automatic Agent

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.
[NOTE] For procedures for creating a user account and granting user permissions, see the
CLASS-Agent Manager Software Instruction Manual.

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

Procedure
1) Click the [Logout] button in the toolbar in the main screen. The "Logout" message box is
displayed.

2) Click the [OK] button to logout. Clicking the [Cancel] button aborts a logout attempt.

[NOTE] In the ER/ES mode, the "Logout check" dialog is displayed. The correct password
must be entered to log out.

3-5
3 Automatic Agent

(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-6
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 GCMSsolution data output.
Green

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


registering GCMSsolution data output to a database.
Yellow

The “OFF” status means that the program is logged out. Even if
GCMSsolution 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 cannot 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-7
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 8 setting options.


• "Status"
• "Configuration"
• "Assign database per instrument"
• "Select database by keyword priority"
• "Select compression files"
• "Execute application"
• "Select saving chromatogram"
• "Sample Information"

- The main screen -

Menu List pane Menu Display pane

3-8
3 Automatic Agent

3.5.1 Viewing the Status


The "Status" pane shows the status of database registration, login and logout attempts.

- The "Status" pane -

Procedure
1) Click "Status" in the "Menu" pane of the main screen. The "Status" pane is displayed in the
right-hand pane of the main screen. The "Status" pane displays information on events that
occurred after a login.

2) The contents of the "Status" pane is updated with additional events.

3) When another menu item is selected, the "Status" pane is closed.

3-9
3 Automatic Agent

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 -

Option items
1) Login Mode
The Login Mode section is used to specify a login method. For the login procedure, see “3.3
Command Buttons.”
a) The "Normal login" radio button.
If this radio button is on, no auto login attempt is made at a boot-up. The "Login" dialog
box displays the login ID entered at the last login.
b) The "Automatic login" radio button
If this radio button is on, an automatic login attempt is made at a boot-up. The login ID
entered must match the one defined as described in the following step.

2) The "Login ID" and "Password" text boxes


In these text boxes, specify a login ID and password to set the login mode to "Auto login."
The login ID and password entered must match the ones registered to Agent Manager.

3) The "Register this program to Windows Startup" check box


This check box is used to specify whether the Automatic Agent Program is activated
automatically after Windows starts.
“ON” GCMSsolution Automatic Agent starts running automatically.
“OFF” GCMSsolution Automatic Agent does not run automatically.

3-10
3 Automatic Agent

4) The "Registering data automatically by post-run analysis" check box.


This option specifies whether to register data automatically when executing GCMSsolution
post-run analysis.
“ON” Data is automatically registered when post-run analysis has been processed. Batch
file data is registered when each line of batch file has been processed. Single
analysis data is registered each time of data file is saved. The file types for file
compression include calculated data files, method files, batch files, report format
files, and ANDI files.
“OFF” No data is automatically registered even when the post-run analysis is executed.
[NOTE] When exiting from this program, some changes are made to the contents of the
GCMSsolution registry. If any changes have been made to these initialization
settings, reboot and restart GCMSsolution.

5) Make an ANDI file (*.CDF) at the time of the data registration.


This option specifies whether an ANDI file is created when data is registered in the database.
“ON” Make an ANDI file (*.CDF) when the data is registered. An ANDI file is stored in
the link file row of Agent Manager. When checked, a check box on whether to
include an ANDI file is indicated in the "Select compression files" pane.
“OFF” An ANDI file is not made.
[NOTE] It may take several minutes when data is registered because the preparation of the
ANDI file takes time for large files.

Procedure
1) Click "Configuration" in the "Menu" pane of the main screen. The "Configuration" pane is
displayed in the right-hand pane of the main screen.

2) Select the desired options. Settings are updated after changes are made.

3) When another menu item is selected, the "Configuration" pane is closed.

3-11
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 -

Option Items
1. "Instrument name" This column shows instrument names.
2. "Data registration" This column shows whether to collect data.
3. "Database file" This column shows the names of databases where data is stored.
4. "User name" This column shows the names of operators who created the
databases.

Functions
1) The "Assign database per instrument" pane
This pane displays the setting status of each instrument.

2) The [Edit] button


This button opens the "Assign database per instrument" dialog box.
For detailed information, see “3.5.3.1 Assigning Databases to Each System."

Procedure
1) 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.

2) The "Assign database per instrument" pane displays the setting status of each instrument for
database registration. Select the desired instrument, and click the [Edit] button to open the
"Configuration System" dialog box. For detailed information, see “3.5.3.1 Assigning
Databases to Each System."

3) When another menu item is selected, the "Assign database per instrument" pane is closed.

3-12
3 Automatic Agent

Priorities for Database Assignment


Databases are assigned in the order as described in “ 3.5.3.1 Assigning Databases to Each
System” and “3.5.4 Database Assignment Settings”. If there are two settings available for
database assignment, a higher priority is given in the following order.
Database assignment settings > System configuration settings

3.5.3.1 Assigning Databases to Each System


The use of this feature is restricted to users having the Properties/Option permission. The
title “Assign database per instrument” is used for convenience only to maintain
compatibility with other analytical instruments. Since only one analytical instrument can
be connected to the GCMSsolution, a setting can be made for only one analytical
instrument (system).

- The "Assign database per instrument" dialog box -

Option Items
1) The "Instrument Name" section
"Read from Data File" check box is used to get instrument name from
GCMSsolution's data file. If unchecked, the instrument name can be input in the
"Name" text box. The specified instrument name is used for the instrument field in
the database.

2) The "Register data" check box


This check box is used to specify data collection.
“ON” Data is collected.
“OFF” Data is not collected.

3) The "Destination database" text box


This text box is used to specify a database where data is stored. Clicking the [Browse]
button just to the right of this test box opens the "Select Database" dialog box. For
detailed information, see “3.5.1.2 Selecting a Database."

4) The "User Name" list box


This list box is used to specify an operator name that is registered to a database. This
list box provides the following three options.
a) Login user name
b) GCMSsolution¢s user name
c) Specific user name registered in a user table.
3-13
3 Automatic Agent

Functions
1) The [Browse...] button
This button opens the "Select Database" dialog box, where a database can be
selected. For detailed information, see “3.5.3.2 Selecting a Database.”

2) The [Help] button


This button opens the help file.

3) The [OK] button


This button updates the settings and closes the "Assign database per instrument"
dialog box.

4) The [Cancel] button


This button aborts changes made and closes the "Assign database per instrument"
dialog box.

Procedure
1) In the "Assign database per instrument" pane, select the instrument for which settings
are to be entered, and click the [Edit] button. The "Assign database per instrument"
dialog box is displayed.

2) Select the desired options.

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

4) The "Assign database per instrument" dialog box closes, returning to the "Assign
database per instrument" pane.

3.5.3.2 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 use of all features provided in the "Select Database" dialog box, including the [Add
to list] and [Delete from list] buttons, requires the Properties/Option permission.
- The "Select Database" dialog box -

3-14
3 Automatic 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.
Input an Agent database file name that you want to add. If connection test is normal,
the selected database is registered.
For detailed information, see “4.5 Selecting a Database."
2) The [Delete from list] button
This button deletes the selected database from a list. This button opens the "Delete"
dialog box. Clicking the [Cancel] button aborts the deletion.

3) The [OK] button


This button selects the database to be used, and closes the "Select Database" dialog
box.

4) The [Cancel] button


This button closes the "Select Database" dialog box without saving settings made in
the dialog box.

5) The [Help] button


This button opens the help file.

3-15
3 Automatic Agent

Procedure
1) In the "Assign database per instrument" dialog box, click the [Browse...] button just
to the right of the "Save database" text box. The "Select Database" dialog box is
displayed.

2) Select the database to use.

3) Click the [OK] button to obtain information on the selected database and close the
"Select Database" dialog box.

4) The "Select Database" dialog box closes, returning to the "Assign database per
instrument" screen.

3.5.4 Database Assignment Settings


Databases can be assigned by a keyword that is included in sample information. Database
assignment settings supersede system configuration settings described in “3.5.3.1 Assigning
Databases to Each System."
The use of this feature is restricted to users having the Properties/Option permission.

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

Functions
1) The "Select database by keyword priority" pane
This pane displays current settings. If analysis data corresponds to several setting items, the
highest priority is given to a setting item displayed in the upper row.

2) The [Add] button


This button opens the "Select database by keyword priority" dialog box, assignment items
can be added. Up to 20 settings for database assignment by keyword may be made.

3) The [Edit] button


This button opens the "Select database by keyword priority" dialog box, where selected
settings can be edited. For detailed information, see “3.5.4.1 Assigning Databases by
Keyword."

3-16
3 Automatic Agent

4) The [Delete] button


This button deletes selected items for database assignment.
During the deletion, the [Delete] message box is displayed.
Click the [Yes] button to delete the selected allocation items.
Clicking the [No] button aborts the deletion.

Procedure
1) Click "Select database by keyword priority" in the "Menu" pane of the main screen. The
"Select database by keyword priority" pane is displayed in the right-hand pane of the main
screen.

2) The "Select database by keyword priority" pane displays the currently selected settings for
database assignment by keyword. Click the [Add] button, or select the row to edit and click
the [Edit] button. The "Select Database by keyword priority" dialog box is displayed. For
detailed information, see “3.5.4.1 Assigning Databases by Keyword."
To delete a row, select the row and click the [Delete] button.

3) When another menu item is selected, the "Select database by keyword priority" pane is
closed.
[NOTE] Keywords are case sensitive.

Priorities for Database Assignment


Databases are assigned in the order as described in “3.5.4 Database Assignment Settings” and
“3.5.3.1 Assigning Databases to Each System”. If there are two settings available for database
assignment, a higher priority is given to settings in the following order.

Database assignment settings > System configuration settings

A higher priority is given to keywords in the following order.

Keyword displayed in an upper row > Keyword displayed in a lower row

3-17
3 Automatic Agent

3.5.4.1 Assigning Databases by Keyword


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

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

Option Items
1) The "Key item" list box
From the list box, select an item in sample information to be searched for. The
following items are selectable.
a) Sample name
b) Sample ID
c) User name.
d) Acquired Month

2) The "Keyword" text box


If the item in sample information specified in the "Key item" list box contains the
keyword defined here; databases are sorted by the keyword.

3) The "Destination database" text box


In this text box, specify the database where data is to be saved. If the keyword defined
in the "Keyword" text box is found in the item of analysis result data specified in the
"Keyword" list box, the data is registered to the database specified.

4) The "User name" list box


This list box is used to specify an operator name that is registered to a database. This
list box provides the following three options.
a) Login user name
b) GCMSsolution’s user name
c) Specific user name registered in a user table.

3-18
3 Automatic Agent

Functions
1) The [Browse] button
This button opens the "Select Database" dialog box.
For detailed information, see “3.5.3.2 Selecting a Database."

2) The [Help] button


This button opens the help file.

Procedure
1) In the "Select database by keyword priority" pane, click the [Add] button, or select
the row to edit and click the [Edit] button. The "Select database by keyword priority"
dialog box is displayed.

2) Select the desired options.

3) Click the [OK] button to update the settings. Clicking the [Cancel] button aborts
changes made.

4) The "Select database by keyword priority" dialog box closes, returning to the "Select
database by keyword priority" pane.

3.5.5 Compressed File Settings


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

Option Items
1) The "Select compression files" section
This section specifies the type of files to be compressed.
“Data file”, “Method file”, “Batch file”, “Report Format file”, “ANDI file”
[NOTE] The ANDI file check box is shown when ANDI file creation is selected in the
configuration window.

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.

3-19
3 Automatic Agent

Procedure
1) Click "Data file collection" in the "Menu" pane of the main screen. The "Select compression
files" pane is displayed in the right-hand pane of the main screen.

2) Select the desired options. Settings are updated after changes are made.

3) When another menu item is selected, the "Select compression files" pane is closed.

3.5.6 Executing an Application


Settings can be made for automatically executing an external application after registering data to
a database. The use of this feature is restricted to users having the Properties/Option permission.

Option 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 start automatically. If checked, specify the name of the
application to start, the name of the output folder where the sample information file
(an analysis result text file prepared for the application) will be stored, and make
the setting in the "Add a sample information file name in the command line at the
time of execute" check box as described in Step 2)-4).
“OFF” An application will not start automatically.

3-20
3 Automatic Agent

2) The "Program file name" text box


In this text box, specify the full path name of the application to start automatically. Clicking
the [Browse] button just to the right of text box displays the application selection dialog box.
Select an application name and click the [Open] button. The selected application name is
registered. Clicking the [Cancel] button aborts the selection.

- The "Application Selection" dialog box -

3) The "Sample information export folder" text box


In this 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) is to be stored. Clicking
the [Browse] button just to the right of the text box displays the "Folder Select" dialog box,
where a destination folder can be selected. For detailed information, see “3.5.6.1 Selecting a
Folder."

4) The "Add a sample information file name in the command line" check box
A sample information filename is used in a command line when starting an external
application.
“ON” A sample information filename is added to a command line.
“OFF” A sample information filename is not added to a command line.

Procedure
1) Click "Execute application" in the "Menu" pane of the main screen. The "Execute
application" pane is displayed in the right-hand pane of the main screen.

2) Select the desired options. Settings are updated after changes are made.

3) When another menu item is selected, the "Execute application" pane is closed.

3-21
3 Automatic Agent

3.5.6.1 Selecting a Folder


Select a folder that contains imported files.

Functions
1) The [OK] button
This button selects a path name for the selected folder and closes the "Browse for
Folder" dialog box.

2) The [Cancel] button


This button aborts the folder selection.

Procedure
1) In the "Execute application" pane, click the [Browse] button just to the right of the
"Sample information export folder" text box. The "Browse for Folder" dialog box is
displayed.

2) Specify the name of the folder in which imported files are stored.

3) Click the [OK] button to select the path name for the selected folder. Clicking the
[Cancel] button aborts the folder selection.

4) The "Browse for Folder" dialog box closes, returning to the "Execute application"
pane.

3-22
3 Automatic Agent

3.5.7 Select Chromatograms to Be Saved


Select the type of chromatograms to be stored in data information areas of a database.

Option Items
1) Total Ion Chromatogram (TIC)
This check box shows whether the TIC data is saved.
“ON” Saved.
“OFF” Not saved.

2) Mixed Ion Chromatogram (MIC)


This check box shows whether the MIC data is saved.
“ON” Saved.
“OFF” Not saved.

3) Fixed Quantity Chromatogram


This check box shows whether the Fixed Quantity Chromatogram data is saved.
“ON” Saved.
“OFF” Not saved.
[NOTE] At least one kind of Chromatogram must be selected.

Procedure
1) Click "Select saving chromatogram" in the "Menu" pane of the main screen. The " Select
saving chromatogram" pane is displayed in the right-hand pane of the main screen.

2) Select the desired options. Settings are updated after changes are made.

3) When another menu item is selected, the "Select saving chromatogram" pane is closed.

3-23
3 Automatic Agent

3.5.8 Sample Information


Settings can be made for registering sample information options (1-5) at the time of the data base
registration when the batch file option of GCMSsolution is used.

Option Items
Option1
Choose the sample information field to be registered for Option 1with right combo-box.

In the same manner, select the fields to be registered for each remaining option from the
combo boxes. The default setting assigns sample information 1-5 to option 1-5 respectively.

Procedure
1) Click "Sample Information" in the "Menu" pane of the main screen. The " Sample
Information" pane is displayed in the right-hand pane of the main screen.

2) Select registration fields for option 1 to 5. Settings are updated after changes are made.

3) When another menu item is selected, the "Sample Information pane is closed.

3-24
Chapter 4 Manual Agent
4.1 Introduction .............................................................................................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 a Database ......................................................................4-15
4.9 Registration Using the Wizard ..............................................................4-17
4.10 Adding or Deleting Compression Files .................................................4-20
4.10.1 Adding Files ......................................................................................................... 4-21
4.10.2 Deleting Files ....................................................................................................... 4-21
4.11 Toolbar and Status Bar ..........................................................................4-22
4.12 Details Information................................................................................4-23
4.13 Reentry List ...........................................................................................4-24
4.14 Options...................................................................................................4-25
4.14.1 Selecting a Font.................................................................................................... 4-26
4.15 Update Information................................................................................4-27
4.16 Configuration Settings...........................................................................4-28
4.16.1 Configuration Settings ......................................................................................... 4-29
4.16.2 Compressed File Settings ..................................................................................... 4-30
4.16.3 Executing an Application ..................................................................................... 4-31
4.16.4 Instrument name................................................................................................... 4-33
4.16.5 Operator ............................................................................................................... 4-34
4.16.6 Selecting a Chromatogram ................................................................................... 4-35
4.16.7 Sample Information.............................................................................................. 4-36
4.17 Editing a Reentry List............................................................................4-37
4.18 Help .......................................................................................................4-38
4 Manual Agent

4.1 Introduction
The Manual Agent Program is used to manually register analysis results obtained from
GCMSsolution analysis programs to a specified database. This program reads specified analysis
results and registers them to a database. The registered analysis data can be viewed, edited or
printed at any time using Agent Manager.

This program executes additional data processing when analysis data is registered to a database.
This program compresses files automatically, such as data files, method files, batch files, report
format files and ANDI files.
Compressed files can be extracted using Agent Manager. They can be reregistered to a database
using the Manual Agent Program, after recalculation by the analysis program.
In GCMSsolution, a data file is compressed and saved with its filename and folder name during
an analysis process. If a compressed data file is decompressed and saved to a different folder,
recalculation may be prevented.

4-1
4 Manual Agent

4.2 Main Screen


The following shows the GCMSsolution Manual Agent window, used to perform various
functions.
- The main screen -
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] A login is used to identify a user.
[Logout] A logout is to exit a log-in state.
[Select Database] Select a database, add it to a list, or delete it form to the list.
[Properties] View information on a currently selected database, a
currently selected file or a user who is logging in.
[Exit] Exit the Manual Agent program.

2) [Entry] menu
[Entry...] Register an analysis file to a database as a newly created data.
[Reentry...] Register an analysis file decompressed in Agent Manager to a
database again.
[Wizard...] Use the wizard to store analysis data in a database after
selecting an analysis data file in the File List pane.
[Add Compression Files...] Specify the files to be compressed, other than those specified
in “ Compressed File Settings."

4-2
4 Manual Agent

3) [View] menu
[Toolbar] Show or hide the toolbar.
[Status Bar] Show or hide the status bar.
[Details Information] Display detail information on the file selected in the upper-half
pane of the main screen.
[Reentry List...] Displays a listing of analysis data decompressed in Agent
Manager.
[Options...] Specify font or messages.
[Update] Show the latest folder contents.

4) [Tools] menu
[Configuration...] Specify the configuration settings of Manual Agent.
[Edit Reentry List...] Delete unwanted items from a Reentry List.

5) [Help] menu commands


[Help Topics...] Manual Agent help file opens.
[About Manual Agent...] Show the "About Manual Agent" message box.

Functions (Toolbar)
The toolbar buttons are available as follows.
1) [Login] A login is used to identify a user.
2) [Logout] A logout is used to exit a log-in state without exiting the
program.
3) [Select] Select a database, add it to a list, or delete it form to the list.
4) [Entry] Register an analysis file to a database as a newly created data.
5) [Reentry] Register an analysis file decompressed in Agent Manager to a
database again.
6) [Wizard] Use the wizard to store analysis data in a database after
selecting an analysis data file in the File List pane.
7) [Details] Display detail information on the file selected in the upper-half
pane of the main screen.

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.10
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 Since only one analytical instrument can be connected to the
GCMSsolution, any systems other than the currently displayed
system are not selectable.

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) Select optional files and register them manually.

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 (Gateway) 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.

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.

The below function and operation are vary with the kind of the database.
Clicking the [Cancel] button aborts the execution of the [Add to list] command.

4-7
4 Manual Agent

Linking a New Database


(about MDB database)

1. Select the [MDB] option button in “Setting of database connection.”

MDB file
selection button

2. Click the MDB file selection button. Select the desired MDB file and click [Open].

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

4-8
4 Manual Agent

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

5. If there the connection settings are normal, the [Finish] button is enabled. Click the
[Finish] button.

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

(About SQL Server/Oracle database)


1. Choose [SQL Server/MSDE] or [Oracle] from the option buttons of “Setting of
database connection” dialog box.
Enter the database name in the “DataBase” input box. (The database name is the
same as the name of the SQL server database when it was created.)

4-9
4 Manual Agent

2. Enter the machine name of the server where the SQL server database is stored. Click
the [Next] button.

3. For an SQL server / MSDE database, the following screen is displayed. For an Oracle
database, continue at step 4 of this procedure.

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

4. Log in to the SQL Server, based on the setting made in the previous steps. Define a
login ID and password. The login ID and password should be defined when making
the SQL Server settings. For any questions, contact the system administrator.
Enter an ID and a password, then click the [Check the connection] button.

4-10
4 Manual Agent

5. If the connection is normal, the [Finish] button is enabled. Click the [Finish] button.

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

2) The [Delete from list] button


This button deletes the selected database from a list. This button opens the "Delete" dialog
box. Clicking the [Cancel] button aborts the deletion.

3) The [OK] button


This button selects the database to be used, and closes the "Select Database" dialog box.

4) The [Cancel] button


This button closes the "Select Database" dialog box without saving settings made in the
dialog box.

5) The [Help] button


This button opens a help file.

4-11
4 Manual Agent

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 be used.

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

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
Choose [File] ® [Exit] to exit the Manual Agent Program.

4-14
4 Manual Agent

4.8 Registering to a Database


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

Functions
1) [[Entry...]
This command is used to register an analysis file to a database as a newly created data.

2) [Reentry...]
This command is used to register an analysis file decompressed in Agent Manager to a
database. The original data contained in a database remains intact, and the analysis data is
registered as updated data in the database.
[NOTE] • When updating a database, select the database that contains the original data.
• Pressing the ESC key when making an entry to a database will abort the
registration to the database.

Procedure (Entry)
1) Select the database where analysis data will be stored. For the procedure for selecting a
database, see “4.5 Selecting a Database."

2) Select the analysis data to be registered. For the procedure for selecting a file, see “4.2 Main
Screen."

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

4) If the "Confirm database at registration" check box is ON, the "Database upload
confirmation" message box is displayed on the screen. Click the [Yes] button to make an
entry, or click the [No] button to abort an entry. If the "Confirm database at registration"
check box is OFF, the "Confirm database at registration" message box does not appear on the
screen. An entry is automatically made. For the procedure for making the setting in the
"Confirm database at registration" check box, see “4.14 Options."

Procedure (Reentry)
1) Select the database where analysis data will be stored. For the procedure for selecting a
database, see “4.5 Selecting a Database."

2) Select the analysis data to be registered. For the procedure for selecting a file, see “4.2 Main
Screen."

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

4-15
4 Manual Agent

4) Ensure that information on the data file is shown in the " Reentry List" dialog box, and click
the [OK] button to update the database. Clicking the [Cancel] button aborts the update.
Clicking the [Help] button opens a help file.

- The "Reentry List" dialog box -

5) If the "Confirm database at registration" check box is ON, the database upload confirmation
message box is displayed on the screen. Click the [Yes] button to display the "Reentry List"
dialog box, or click the [No] button to abort.

- The Database upload confirmation message box -

If the "Confirm database at registration" check box is OFF, the "Reentry List" dialog box is
displayed immediately. For the procedure to make the setting in the "Confirm database at
registration" check box, see “4.14 Options."

4-16
4 Manual Agent

4.9 Registration Using the Wizard


This section describes using the wizard to store analysis data in a database after selecting an
analysis data file in the File List pane.

Functions
For details about the database registration functions, see “4.8 Registering to a Database."

Procedure
1) Select a destination database.
For a procedure to select a database, see “4.5 Selecting a Database."

2) Select a data file to be registered.


For a procedure for selecting a data file, see “4.2 Main Screen."
[NOTE] If multiple files are selected, the Entry Wizard in database registration cannot be
used.

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

4) Select the method of registering analysis data in the database.


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

4-17
4 Manual Agent

5) Select additional files to compress.


For selection of additional files, see “4.10.1 Adding Files."

After selecting additional files, click the [Next] button.

6) Select a chromatogram to store in data information areas.


For selection of chromatograms, see “4.16.6 Selecting Chromatogram."

After selecting the chromatogram, click the [Next] button.

4-18
4 Manual Agent

7) Ensure that all the selected files are correct.

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

4-19
4 Manual Agent

4.10 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 Files" dialog box.

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

2) The [Delete] button


This button deletes selected files from an archive file list.

3) The "Database entry after clear compression list" 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 Files]. The "Add Compression Files" dialog box is
displayed.

2) Specify files to be 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 the help file.

4-20
4 Manual Agent

4.10.1 Adding Files


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

Procedure
1) Click the [Add] button in the "Add Compression Files" 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.10.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-21
4 Manual Agent

4.11 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-22
4 Manual Agent

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

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.
[NOTE] A maximum of 256 characters can be used for the comment that is displayed in the
detail information field.

4-23
4 Manual Agent

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

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-24
4 Manual Agent

4.14 Options
The [Options] command is used to select option items.

Option Items
1) The "Font" section
This section is used to select a font. See “4.14.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 on the main screen.
OFF The "Folder List" pane dose not is displayed on the main screen.

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 and updating.
ON The database upload confirmation message box is displayed on the screen.
OFF The database upload confirmation message box does not appear on the screen.

5) The "Change folder list when file type is selected" check box
When "Type" in the upper right of the main screen is changed, sets whether the folder list is
changed to the GCMSsolution's folder settings automatically, corresponding to the file type.

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

2) The [Help] button


This button is used to open the help file.

4-25
4 Manual Agent

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.14.1 Selecting a Font


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

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 "Options" 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 "Options" dialog box.

4-26
4 Manual Agent

4.15 Update Information


This updates on-screen display to show the latest folder contents.

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

4-27
4 Manual Agent

4.16 Configuration Settings


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

Menu

Option items
1) "Configuration " Set system configuration and login methods.
2) "Select compression files" Specify the type of compressed files that are created
when data is registered.
3) "Execute application" Specify applications, so that they can automatically start
after data is stored in a database.
4) "Instrument name" Specify the device name.
5) "Operator" Specify whether the login user or the operator is used
when registering a data file
6) "Saving Chromatogram" Select the type of chromatograms to be stored in data
information areas of a database
7) "Sample Information" Set GCMSsolution sample information options

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 effect the settings. Clicking the [Cancel] button aborts the settings.
4) The "Configuration" dialog box closes, returning to the main screen.

4-28
4 Manual Agent

4.16.1 Configuration Settings


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

Configuration: Option items


1) The "Use add compression files" check box
This check box specifies whether to allow addition of compressed files as described in “4.10
Adding or Deleting Archive Files." For details about setting options, see “4.10 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) Make an ANDI file (*.CDF) at the time of the data registration.


This option specifies whether an ANDI file is created when data is registered in the database.
ON Make an ANDI file (*.CDF) at the same time as the data registration. An ANDI file is
stored in the link file row of Agent Manager. When checked, a check box to include
an ANDI file is indicated in the "Select compression files" pane.
OFF An ANDI file is not made.
[NOTE] It may take several minutes for data to be registered because the preparation of large
ANDI files takes time.

3) The "Login" section


The "Login" section is used to specify a login method. For the login procedure, see “4.3
Logging In."
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.

4-29
4 Manual Agent

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 setting options. The "Configuration" dialog
box closes. Clicking the [Cancel] button aborts all the changes made and closes the
[Configuration] dialog box.

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

Option items
1) The "Select compression files" pane
This section specifies the type of files to be compressed.
“Data files” “Method files”
“Batch Schedule” “Report Format files”

[NOTE] The ANDI file check box is only shown when ANDI file creation is selected in the
configuration window.

2) The "Show compression progress bar" check box


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

Purpose
Making settings for compressed files is necessary for the following reasons:
a) To ensure that only the necessary (quantitative results) are entered in the database.

b) To ensure that the raw data files are compressed only if the file size is large.

4-30
4 Manual Agent

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 options. The "Configuration" dialog box
closes. Clicking the [Cancel] button aborts all the changes made and closes the
[Configuration] dialog box.

4.16.3 Executing an Application


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

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-31
4 Manual Agent

Functions
1) The Program file 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-32
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 "Configuration" dialog
box closes. Clicking the [Cancel] button aborts all the changes made and closes the
[Configuration] dialog box.

4.16.4 Instrument name


The "Instrument name" pane is used to specify the device name.

Option Items
1) The "Reference to GCMSsolution settings" check box
This check box determines whether the instrument name of the GCMSsolution's data file is
used.
ON Use the default device name of the GCMSsolution's data file automatically. The
instrument name cannot be input in the "Name" text box.
OFF Use specific name designated by the “Name” text box.

2) The "Name" section


This section specifies the device name designated for this system, when the "Reference to
GCMSsolution settings" check box is OFF.

Procedure
1) Click "Instrument name" in the left-hand pane of the "Configuration" dialog box. The
"Instrument name" 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-33
4 Manual Agent

4.16.5 Operator
This pane is used to specify whether the currently logged in user or the operator specified in the
data file is used when data is registered to the database.

Options items
• Login User
The name of the user that is currently logged in is used when data is registered to a database.

• Operator in data file


The name of the operator specified in the data file is used when data is registered to a
database.

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

2) Select the name to register to the database.

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-34
4 Manual Agent

4.16.6 Selecting a Chromatogram


Select the type of chromatograms to be stored in data information areas of the database. Once
chromatograms are stored, you can view peak area, peak height, retention time and constituent
names at any time using Agent Manager.

Option Items
1) Total Ion Chromatogram (TIC)
This check box shows whether the TIC data is saved.
ON Saved.
OFF Not saved.

2) Mixed Ion Chromatogram (MIC)


This check box shows whether the MIC data is saved.
ON Saved.
OFF Not saved.

3) Fixed Quantity Chromatogram


This check box shows whether the Fixed Quantity Chromatogram data is saved.
ON Saved.
OFF Not saved.
[NOTE] A least one kind of Chromatogram must be selected.

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

2) Check the check box if chromatograms are to be stored.

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

4-35
4 Manual Agent

4.16.7 Sample Information


Settings can be made for registering the options (1-5) in specified fields of the sample
information table at the time of the data base registration when the batch file option of
GCMSsolution is set up.

Option Items
Option1
Choose the field that option 1 of GCMSsolution is registered in from the sample information
tables (1-10) with right combo-box.

In the same way, select fields for options 2-5. The initial setting is that option 1-5 are assigned to
sample information 1-5 fields, respectively.

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

2) Select a registration location for option 1 to 5 respectively.

3) Click the [OK] button to apply 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-36
4 Manual Agent

4.17 Editing a Reentry List


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

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-37
4 Manual Agent

4.18 Help
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.

Procedure (Help Topics)


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-38
Appendix A Supplementary Information
A.1 Compressed 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


When running GCMSsolution Automatic/Manual Agent Program, analysis data is stored in a
database, and files are compressed and saved in LHA format. The files created include data files
(*.QGD), method files (*.QGM), batch files (*.QGB), report format files (*.QGR) and ANDI
files (*.CDF). They are stored in the same folder. Their filenames are changed to the same
filenames assigned to compressed files, but they have different extensions. 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 MDB format database, a folder having the database name (without its extension) is
created in the same folder as the database. Compressed files are stored in this folder.

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

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

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 The number 1.
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 relationaly linked. If a single item of sample information is selected in Agent
Manager, multiple lines of data 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
Analysis/Post run Integer ManageFlag6
Vial No. Integer ManageFlag8
Operator Text Operator
Date acquired Date Time OperateDate
LZH file's folder name Text LzhDirectory
LZH file's name Text LzhFile
Data file name Text FileInfo1
ACQ mode (Scan or SIM) Text FileInfo2
Method file name Text FileInfo3
Batch file name Text FileInfo4
Report format 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
TIC/MIC/Quantity Text Property1
Peak number Single Property3
ID number Long LongData1
Peak height Long LongData2
Leading peak height Long LongData3
Tailing peak height Long LongData4
IS. Group number Long LongData5
Reference Height Long LongData6
Relative Intensity Long LongData7
Retention time Double DoubleData1
Concentration Double DoubleData2
Peak starting time Double DoubleData3
Peak ending time Double DoubleData4
Mass number Double DoubleData10
Area/Height Double DoubleData11
Standard retention time Double DoubleData12
Factor1 Double DoubleData13
Factor2 Double DoubleData14
Area Double DoubleData16
Reference Area Double DoubleData17
Factor3 Double DoubleData18
Factor4 Double DoubleData19
Constituent name Text StringData1
Peak type Text StringData2

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
for some reason. Its filename is TEMP_DT2.MDB, a Microsoft Access 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 GCMSsolution 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 “inf2” folder where an application is installed.
Filename GCMSsol.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.

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 makes it 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 [Ref] 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 after database registration" check box.

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

(3) In the "Sample information export folder" text box, specify an output folder.

(4) Turn on the "Add a sample information file name in the command line" 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 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 may occur.

(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 after database registration" check box.

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

(3) In the "Sample information export folder" text box, specify an output folder.

(4) Turn on the "Add a sample information file name in the command line" 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

You might also like