You are on page 1of 120

223-10063 D

CLASS-VP Agent Version 2


Instruction Manual

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

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

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

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

A first-time user of Windows® XP/2000/NT 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 CLASS-VP Automatic Agent Program ............................................ 1-2
1.1.2 Features of the CLASS-VP Manual Agent Program................................................. 1-2
1.1.3 Features of Agent Manager ....................................................................................... 1-2
1.2 Handling Precautions............................................................................................. 1-3
1.2.1 Before Using CLASS-Agent Software ..................................................................... 1-3
1.2.2 About the Automatic Agent Program........................................................................ 1-5
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 CLASS-VP Setup ................................................................................................. 2-1
2.2 Automatically Storing Analysis Data in a Database.............................................. 2-5
2.2.1 Starting the Automatic Agent Program ..................................................................... 2-5
2.2.2 Logging In to the System .......................................................................................... 2-6
2.2.3 Set up a configuration in the Automatic Agent......................................................... 2-7
2.2.4 Specifying a Database for Each Instrument .............................................................. 2-9
2.2.5 Making an Analysis................................................................................................. 2-13

Chapter 3 Automatic Agent


3.1 Starting the Program.............................................................................................. 3-1
3.2 Main Screen........................................................................................................... 3-2
3.3 Command Buttons ................................................................................................. 3-3
3.4 Status Bar............................................................................................................... 3-6
3.5 Using the Menu List .............................................................................................. 3-7
3.5.1 Viewing the Status .................................................................................................... 3-8
3.5.2 Configuration Settings .............................................................................................. 3-8
3.5.3 System Configuration Settings................................................................................ 3-10
3.5.4 Database Assignment Settings ................................................................................ 3-14
3.5.5 Data Registration Options ....................................................................................... 3-18
3.5.6 Sample information ................................................................................................. 3-20
3.5.7 Compressed File Settings ........................................................................................ 3-21
3.5.8 Running an Application .......................................................................................... 3-22
3.5.9 Linking a Database.................................................................................................. 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-12
4.7 Exiting a Program................................................................................................ 4-13
4.8 Registering to a Database .................................................................................... 4-14
4.9 Adding or Deleting Compression Files ............................................................... 4-17
4.9.1 Adding Files ............................................................................................................ 4-18
4.9.2 Deleting Files .......................................................................................................... 4-18
4.10 Using the Wizard in Database Registration......................................................... 4-19
4.11 Toolbar and Status Bar ........................................................................................ 4-23
4.12 Details Information.............................................................................................. 4-24
4.13 Reentry List ......................................................................................................... 4-25
4.14 Options ................................................................................................................ 4-26
4.14.1 Selecting a Font....................................................................................................... 4-27
4.15 Update Information ............................................................................................. 4-28
4.16 Environment Settings .......................................................................................... 4-29
4.16.1 Configuration Settings ............................................................................................ 4-30
4.16.2 Compressed File Settings ........................................................................................ 4-31
4.16.3 Executing an Application ........................................................................................ 4-32
4.16.4 Selecting the CLASS-VP Parameters...................................................................... 4-34
4.16.5 Setting the Data Registration Option Selection....................................................... 4-36
4.17 Editing a Reentry List.......................................................................................... 4-37
4.18 Help Topics ......................................................................................................... 4-38

Appendix A Supplementary Information


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

Appendix B Additional Software


B.1 The Agent Automatic Print Program.....................................................................B-1
B.1.1 Making Initial Settings ..............................................................................................B-1
B.1.2 Test Print ...................................................................................................................B-2
B.1.3 Using an External Application to Print .....................................................................B-3
B.2 The Agent Mail Carrier Program...........................................................................B-4
B.2.1 Making Initial Settings ..............................................................................................B-4
B.2.2 Checking the Connection to Mail Server and the Test E-Mail .................................B-7
B.2.3 Using an External Application to Send E-Mail.........................................................B-8
Preface
About CLASS-Agent Software
This 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 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 product (HPLC, GC, LC/MS, GC/MS, UV-VIS, FTIR and AA
spectrophotometers, TOC analyzers, Thermal analyzers, electronic balances) and other analytical
instruments.

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
application software such 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 CLASS-VP Automatic Agent Program ......................................... 1-2
1.1.2 Features of the CLASS-VP Manual Agent Program.............................................. 1-2
1.1.3 Features of Agent Manager .................................................................................... 1-2
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-8
1.2.4 About the Agent Manager Program ....................................................................... 1-9
1 Introduction

CLASS-VP Agent is software designed for making automatic entries of analysis results collected by the
CLASS-VP system to databases shared by all types of CLASS-Agent Software. When chromatographic
data is analyzed and exported on a standard report with the export and method settings of CLASS-VP
Agent, a collection of chromatogram data such as analyzed result, analysis file, and AIA-format file are
automatically added and registered to databases specified by the CLASS-VP Auto Entry program.
The Agent Manager software that comes with CLASS-VP Agent makes it easier to view, print or
approve stored data, add sample information, copy data to other applications and restore analysis files.
CLASS-VP Agent software supports GLP/GMP-compliant security capabilities and log capabilities,
making it easier to audit the operations performed by users.

1.1 Features
CLASS-VP Agent supports CLASS-VP Software Version 5.02 or higher, except that analysis
data obtained from a PDA detector cannot be saved to AIA-format file.
This program provides the following features.

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.
4. Provides security management for analysis data. See Note 1.
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.
11. Sends notice of analysis completion or analysis data by e-mail. See Note 2.
12. Uploads approved data to the host. See Note 3.

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 CLASS-VP Automatic Agent Program


The CLASS-VP Automatic Agent Program (VP60_TT2.EXE) allows automatic entry of
analysis data obtained from a CLASS-VP instrument to a database.

A user can do the following:


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

1.1.2 Features of the CLASS-VP Manual Agent Program


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

A user can do the following:


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

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 (AIA files). More than one chromatogram can be displayed.
7. Copy displayed data or object data (chromatograph data) to the Clipboard.
8. Set an approval flag to data according to the approval flowchart.
9. Add sample tag information (lot number, sampling place, etc.) up to 10 items.
10. View or print a log of stored data.
11. Send analysis data by e-mail.
12. Create user accounts and user groups (for security protection).
13. Create new databases in MDB format (SQL format requires the use of optional programs).

1-2
1 Introduction

14. Make backups of databases.


15. Register additional system logs.
16. Shift from a LAN environment to a local environment.
17. Link objects with filename extensions.

1-3
1 Introduction

1.2 Handling Precautions


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

1.2.1 Before Using CLASS-Agent Software


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

2. About Archive Files and Object Link Files


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

3. About Database Name and Subdirectories


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 the PC that meets the minimum system requirements.

6. About Database Size


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

1-4
1 Introduction

7. Restriction in Character Codes Available in a Database


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

ElementA ElementB

8. About Setting the Date


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

9. Changing the Password Using the Database Software


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

1-5
1 Introduction

1.2.2 About the 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. 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 the same application are open at the same time, operations
can be made each window.
4. An application displays no more messages than necessary.

1-6
1 Introduction

6. About Automatic/Manual Registration


• The following setting should not be made when using automatic registration
with CLASS-VP.
On the “Network Storage” setting screen (displayed by choosing [Method] →
[Advanced]), do not enable the “Copy file after acquisition” checkbox.
• Observe the following if several analysis instruments are connected to
CLASS-VP.
When several analysis instruments are connected to CLASS-VP, a longer period
may be needed for processing to occur. This is dependent on the specifications
of the PC running CLASS-VP. An error log may be generated if the processing
speed of the PC is low.
If this occurs, set longer time in the "Time interval about import folder" in the
configuration of CLASS-VP Agent automatic registration.

1-7
1 Introduction

1.2.3 About the Manual Agent Program


1. Program Operation
This program will only operate with CLASS-VP versions greater than Version
5.03. Use the agent program only after upgrading to a version of CLASS-VP
greater than 5.03.
Registration of an ANDI format file is only performed when an ANDI format file
containing the desired data already exists on the disk. Note that automatic ANDI
file preparation is not done in this program.

2. Starting the program for the first time


Settings for instrument names and database assignment are not factory set for the
Manual Agent Program. Before using the Manual Agent Program, a user who has
administrative permissions must log in, define a Login ID and create a database.

3. Security protection against automatic login attempts


If an Automatic login option is selected in the configuration settings, a login
attempt can be made under any login ID. 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.

4. Running an external application


External applications to be run automatically by the Agent software must meet the
conditions described below. If these conditions are not observed, multiple
instances of a particular application may remain open. This will cause error
messages to appear and make 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 the same application are open at the same time, operations
can be made each window.
3. An application should display no more messages than necessary.

5. Correspondence version of the Manual Agent Program


The manual registration program becomes correspondence only of CLASS-
VP Ver6.xx.
It doesn't correspond to CLASS-VP Ver5.xx and CLASS-VP Ver7.xx.

1-8
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 automatically 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 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-9
1 Introduction

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

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

[GLP]
ScreenLock=10

7. Log Types
Log information is separated into the data log for data operations and the system
log (Log2.mdb) where logs related to the system are saved.
When the contents of the database storing the data acquired from the analysis
instrument are changed, the history of such changes is stored in the data log.
When the contents of options not directly related to the data are changed, the
history of such changes is stored in the system log.
Click the log on the database tree to display the log information on the sample
information table.

8. Precautions for Multiple Users in Windows NT


• The common network settings offered by choosing [Tool] → [Configuration] on
the Agent Manager menu should be executed by a user having the NT “Power
Users” or “Administrators” permission.
• In multi-user mode of NT, all other settings should be executed for each user ID.
The Agent system administrator should login using each NT user ID, and
perform the required settings.

1-10
Chapter 2 Getting Started
2.1 CLASS-VP Setup ...................................................................................2-1
2.2 Automatically Storing Analysis Data in a Database ...............................2-5
2.2.1 Starting the Automatic Agent Program .................................................................. 2-5
2.2.2 Logging In to the System ....................................................................................... 2-6
2.2.3 Set up a configuration in the Automatic Agent. ..................................................... 2-7
2.2.4 Specifying a Database for Each Instrument ........................................................... 2-9
2.2.5 Making an Analysis.............................................................................................. 2-13
2 Getting Started

2.1 CLASS-VP Setup


Before using CLASS-VP Agent, make the Method settings for automatic entries. The Automatic
Agent program does not run properly if Method settings are not made. For CLASS-VP Software
operation, see the CLASS-VP Software Instruction Manual.
Procedure
1) Choose [Method] → [Advanced]. Advanced settings are specific to each channel and must
be made for each channel. The number of instruments connected times the number of
channels is the number of settings required.

2) The "Advanced Settings" dialog box is displayed.


• Turn on the "Export Enabled" check box. This check box must be checked to register data
to a database. If this check box is off, no file is exported; and the Automatic Agent program
does not detect exported data.
• In the "Export options" section, set the "Field separator" list box to "Tab."
• Next, specify the path for file export as follows.

For CLASS-VP Ver. 7.xx


Set up export parameters as shown in the figure below. Check the "Export Enabled" box
and select [Standard Report] from the "Parameters to export" drop down box. Select
"Sample Information Report" and all “* Report” click the right (green) arrow button to
move it into the "Export these parameters" box.
Moreover, please set it in the value that wants to use the unit of Decimals. (It is necessary
to do this setting by each Report.)

2-1
2 Getting Started

• Select "Chromatogram" from the list box, and move “AIA (*.CDF)” to the "Export these
parameters" pane.

• After the setting for channels required is complete, save the Method settings to a file.
Moreover, Save as Default the Method settings to a file.

2-2
2 Getting Started

For CLASS-VP Ver. 5.03 from Ver.6.xx


Set up export parameters as shown in the figure below. Check the "Export Enabled" box
and select [Miscellaneous] from the "Parameters to export" drop down box. Select
"Sample Information" and click the right (green) arrow button to move it into the "Export
these parameters" box.

Check this check box. Click on this button to select.

Specify the same folder name


as the import folder specified in
the System Configuration
settings for Automatic Agent.

• Select "Chromatogram" from the list box, and move “AIA (*.CDF)” to the "Export these
parameters" pane. If CLASS-VP Agent Version 5.02 is being used, AIA-formatted files
that contain three-dimensional chromatograms cannot be exported.

3) After the setting for channels required is complete, save the Method settings to a file.

2-3
2 Getting Started

For CLASS-VP Ver. 5.02 and Lower


Export specifies all the reports of the standard report.

Check this check box Click on this button to select.

Specify the same folder name as the import folder in the


System Configuration settings for Automatic Agent.

If several systems are to be used, type the desired folder name for each system in the "Path
for export files" text box. Specify the same folder name as the import folder specified in the
"Configuration System" pane for the Automatic Agent program. See “3.5.3 System
Configuration Settings.”

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

Set up CLASS-VP.

Collect data in CLASS-VP.

Check stored data in Agent Manager.

2.2.1 Starting the Automatic Agent Program


1. Before using the program
Before using the CLASS-VP Automatic Agent program, create a user account and database
using the Agent Manager program. In Automatic Agent, specify a user ID and password at a
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
[CLASS-VP Automatic Agent].

Click here.

2-5
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 [CLASS-VP 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-6
2 Getting Started

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

- The main screen -

Command button

Menu list

Status bar

2.2.3 Set up a configuration in Automatic Agent.


Set up a configuration menu in accordance with the version of CLASS-VP.

1) When CLASS-VP is Ver. 7.xx


Select the “CLASS-VP7.xx” list-box.

The database register to instrument 1 becomes the database of default for CLASS-VP7.
Please distribute instrument name by “Select database by keyword priority” when you
register since instrument 2 in another database.

2-7
2 Getting Started

2) When CLASS-VP is from Ver. 5.03 to Ver.6.xx:


Selected the “CLASS-VP5.03 form Ver. 5.03 to Ver.6.xx:” list-box. In addition, check the
“Data after the re-analysis are collected” check box when analysis data is to be collected
automatically during reanalysis in CLASS-VP.

3) When CLASS-VP is Ver. 5.02 before:


Select the “CLASS-VP5.02 before” list-box.

2-8
2 Getting Started

2.2.4 Specifying a Database for Each Instrument


Assign a destination database to each instrument in CLASS-VP. 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 the 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. CLASS-VP can be
connected to a maximum of 4 HPLC systems(Max 8). In the right-hand pane, a database is
assigned to each instrument.
- The "Assign database per instrument" pane. -

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

- The "Assign database per instrument" dialog box -

2-9
2 Getting Started

1) Instrument Name
By default, a system name is Instrument 1. A system name may be specified at any time. Do
not leave the "Instrument Name" text box blank.

2) Use VP instrument name


The instrument name is set to the name used in CLASS-VP.
This is valid for CLASS-VP Ver. 5.03 or later.

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

4) Destination database
In the "Destination database" text box, specify a database in which to store data. Clicking the
[Browse] button opens the "Select Database" dialog box.
- The "Select Database" dialog box -

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

2-10
2 Getting Started

5) Import folder(VP Ver 5.02 before)


For CLASS-VP Instrument 1, specify the same folder name as the one specified in the "Path
for export files" text box in the "Advanced Settings" dialog box of the [Method] menu.
Clicking the [Browse] button opens the "Browse for Folder" dialog box, where an import
folder name can be selected from a listing.

The importing folder is set since CLASS-VP Ver5.03 on the following screens.

2-11
2 Getting Started

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

2-12
2 Getting Started

2.2.5 Making an Analysis


1) Set up CLASS-VP.
See “Setting CLASS-VP” in this chapter.

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

3) Perform an analysis operation or reanalyze existing data using CLASS-VP.

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

- The "Status" pane -

5) Check the database using Agent Manager.

2-13
Chapter 3 Automatic Agent
3.1 Starting the Program................................................................................3-1
3.2 Main Screen.............................................................................................3-2
3.3 Command Buttons ...................................................................................3-3
3.4 Status Bar.................................................................................................3-6
3.5 Using the Menu List ................................................................................3-7
3.5.1 Viewing the Status ................................................................................................. 3-8
3.5.2 Configuration Settings ........................................................................................... 3-8
3.5.3 System Configuration Settings............................................................................. 3-10
3.5.4 Database Assignment Settings ............................................................................. 3-14
3.5.5 Data Registration Options .................................................................................... 3-18
3.5.6 Sample information.............................................................................................. 3-20
3.5.7 Compressed File Settings..................................................................................... 3-21
3.5.8 Running an Application ....................................................................................... 3-22
3.5.9 Linking a Database............................................................................................... 3-24
3 Automatic Agent Program

3.1 Starting the Program


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

Double-click here.

2) Double-click the CLASS-VP Automatic Agent icon.

This icon opens a file in Notepad,


showing information on precautions and
upgrade.

Double-click.

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

3) Follow the login procedure after staring the program.

- The "Login" dialog box -

3-1
3 Automatic Agent Program

3.2 Main Screen


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

- The main screen -


Command button
Clicking this button
executes a command.

Menu pane Status bar


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

3-2
3 Automatic Agent Program

3.3 Command Buttons


(1) The [Taskbar] button

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

The resident program icon in the taskbar.

Double-click or right-click the icon for CLASS-VP


Automatic Agent to reopen a closed 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.

To re-display the window


Double- or right-click the CLASS-VP task tray icon.

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


the CLASS-VP icon displays the user check dialog. The correct password must be
entered to re-display the window.

(2) The [Login] button

The CLASS-VP 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 Program

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.

(3) The [Logout] button

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

- The "Logout" message box -

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

3-4
3 Automatic Agent Program

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


the CLASS-VP icon displays the user confirmation dialog. The correct password
must be entered to re-display window.

(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-5
3 Automatic Agent Program

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 CLASS-VP data output.
Green

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


registering CLASS-VP data output to a database.
Yellow

The “OFF” status means that the program is logged out. Even if
CLASS-VP 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-6
3 Automatic Agent Program

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"
• "Data registration opetions"
• "Sample Information"
• "Select compression files"
• "Execute application"

- The main screen -

Menu List pane Menu Display pane

3-7
3 Automatic Agent Program

3.5.1 Viewing the Status


- The "Status" pane -

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

3.5.2 Configuration Settings


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

- The "Configuration" pane -

3-8
3 Automatic Agent Program

• The "Normal login" check box


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

• The "Auto login" check box


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

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


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

• The CLASS-VP Version list box


Please select the setting to the version of CLASS-VP used version.

• The "Import folder" list box


The CLASS-VP Automatic Agent program imports a text-formatted file that is exported to a
folder by CLASS-VP Software, and registers imported data to a database. This list box is used
to specify time intervals at which the availability of files to be imported should be monitored.
A time interval can be set to any duration between 5 seconds and 60 seconds (in 5 second
steps).

• The "Delete import files at login" check box


This check box is used to specify whether to delete files contained in the import folder at login.
If a file exported by CLASS VP Software is available in the import folder before using the
Automatic Agent program, imported data is registered to a database. For routine operations,
turn on this check box.

3-9
3 Automatic Agent Program

3.5.3 System Configuration Settings


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

- The "Assign database per instrument" pane -

System configuration status list To widen or narrow the


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

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

3-10
3 Automatic Agent Program

Assigning Databases to Each System


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

- The "Assign database per instrument" dialog box -

This dialog box is used to assign databases to each CLASS-VP system.


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

The database register to instrument 1 becomes the database of default for CLASS-VP7. Please
distribute instrument name by “Select database by keyword priority” when you register since
instrument 2 in another database.

• The "Instrument name" text box


CLASS-VP Software can be connected to a maximum of 4 HPLC systems(max:8 include
postrun). In this text box, specify the name of the system to be used when registering data to a
database.

• The "Use VP instrument name" check box


This setting is available when the "CLASS-VP 5.03 form" use in "Configuration". The
instrument name is received from the output CLASS-VP data and registered in a database.
When this check box is set to OFF, the instrument name entered here is registered in a
database.

• The "Register data" check box


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

3-11
3 Automatic Agent Program

• The "Destination database" text box


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

- The "Select Database" dialog box -

Database list To widen or narrow the columns, drag


the column line to the left or right.

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

• The "Import folder" text box(VP ver.5.02 before)


In this text box, specify the name of the folder to which data is exported from CLASS-VP.
Files created in this folder are automatically imported and registered to a database. Type a
folder name directly in this text box, or click the [Browse] button to open the "Select Folder"
dialog box, where a folder name can be selected from a listing.

[NOTE] In Ver. 5.03, this setting is not required. This is set under "Configuration".

3-12
3 Automatic Agent Program

- The "Browse for Folder" dialog box -


Click on the desired folder icon.

Click on the [+] icon to open


its folder.

Click on the [-] icon to close


its folder.

A folder name must be specified for each system. It must be identical with the one specified in
the setting as described in “Setting CLASS-VP.”

Example: Set the import folder name for Instrument 1 to C:\CLASS-VP\EXPORT1.


Set the import folder name for Instrument 2 to C:\CLASS-VP\EXPORT2.

Click the [OK] button to specify a selected folder as an import folder.


Clicking the [Cancel] button aborts changes and closes the dialog box.

• The "User name" list box


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

1. "Login user name"


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

2. CLASS-VP’s user name


The name of a user who is logged into the CLASS-VP program is registered to the
database.

3-13
3 Automatic Agent Program

3 "Register any user name"


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

- The "Password" dialog box -

3.5.4 Database Assignment Settings


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

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

Keyword setting status list To widen or narrow the


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

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

3-14
3 Automatic Agent Program

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

- The "Caution" message box -

• The "Key item" column


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

• The "Keyword" column


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

• The "Database name" column


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

• The "User name" column


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

Assigning Databases by Keyword


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

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

3-15
3 Automatic Agent Program

If particular keywords that represent sample information, such as sample IDs and user names,
Filename, Instrument Number , Instrument Name, are included in output data from CLASS-VP,
a destination database can be automatically changed to another database.

• The "Key item" list box


In the list box, select data to search for a keyword. Clicking the pull-down button selects either
a sample ID or user name.

• The "Keyword" text box


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

• The "Destination database" text box


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

- The "Select Database" dialog box -

Database list To widen or narrow the columns, drag


the column line to the left or right.

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

3-16
3 Automatic Agent Program

• The "User name" list box


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

1. "Login user name"


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

2. "CLASS-VP’s user name"


The name of the user who is logged in to the CLASS-VP program is registered to a
database.

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

3-17
3 Automatic Agent Program

3.5.5 Data Registration Options


Set options for the data registration method.
The use of this feature is restricted to users having the Property/Option permission.
- The "Data registration opetions" pane -

• The "Register data file after reprocessing" check box


The setting of this check box can he changed only when "CLASS-VP 5.03 form" is set to ON
in "Configuration". When this check box is set to ON, both the analysis data and the reanalysis
data of the CLASS-VP are registered in a database. If it is set to OFF, only the analysis result is
registered.

• The "Exclude ‘Spectrum Max Plot’ data" check box


In analysis (or reanalysis) of three-dimensional data, if the maximum plot channel of the
spectrum does not have to be registered in a database, set this check box to ON.

• The "Exclude 'Spectrum Current Plot' data" check box


In analysis (or reanalysis) of three-dimensional data, if the current plot channel of the spectrum
does not have to be registered in a database, set this check box to ON and Select detector name.

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


Set this check box to ON to register a PDF document file, output from the CLASS-VP, to a
database. The PDF document file is registered as an object file in the Link File 10 in the sample
information table. Click the [Browse] button to display the folder selection screen, then select
a folder to which the PDF file is output from CLASS-VP.
Enter the delay time required until CLASS-VP outputs a PDF file after it has finished analysis
or reanalysis to the "Wait time to monitor PDF report output" list box.

• The "Register VP data file (*.DAT) to LinkFile 9 field" check box


Set this check box ON to register a CLASS-VP data file to the database.
The CLASS-VP data file is registered as an object file in the Link File 9 in the sample
information table.

• The "Register the latest system check report after acquisition(VP ver.6.xx only)
When this check box is checked, the report of the system check executed immediately before
the real analysis is registered in link file 8 of the Agent data base.
[NOTE] When the system check is not done beforehand, it doesn't register in link file 8.

3-18
3 Automatic Agent Program

The system check report file is registered in the data base by the HTM L form type. When the
cell of the data registered in "Link file 8" is double-clicked with CLASS-Agent Manger, details
of the data can be displayed.

Double Click

Microsoft Internet Explorer starts when the cell of the data registered in "Link file 8" is
double-clicked with CLASS-Agent Manger, and the system check report of the HTM L form
type can be referred to.

3-19
3 Automatic Agent Program

3.5.6 Sample information


Specify how to register to databases three data items, “SPL.WT," “IS.WT” and “DFACT" output
from CLASS-VP.
The use of this feature is restricted to users having the Property/Option permission.

- The " Sample information" pane -

For each of “SPL.WT (sample weight)”, “IS.WT (internal standard sample weight)” and
“DFACT (dilution factor)”, specify which field in the sample information table of a database
each item is to be registered. Click the [ ] button to display the pull-down menu.

no regist
Sample info.1
Sample info. 2
Sample info. 3
...

Sample info.10

If an item does not have to be registered in a database, select "NO." If an item has to be
registered, select from “Sample info.1 - 10.” Ensure that the setting here does not overlap the
setting for other data.

3-20
3 Automatic Agent Program

3.5.7 Compressed File Settings


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

- The "Select compression files" pane -

All checked files are compressed.

• The "Show compression progress bar" check box


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

• The "Delete import files after data registration" check box


When checked, import files (“*.CDF” and “*.PDF”) are deleted after registration of data to a
database is completed. Data files (“*.DAT”), method files (“*.MET”) and schedule files
(“*.SEQ”) are not deleted.

3-21
3 Automatic Agent Program

3.5.8 Running an Application


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

• The "Execute after database registration" check box


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

3-22
3 Automatic Agent Program

• The "Program file name" text box


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

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

• The "Sample information export folder" text box


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

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

3-23
3 Automatic Agent Program

3.5.9 Linking a Database


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

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

MDB file
selection button

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

3-24
3 Automatic Agent Program

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

Click the [Check the connection] button.


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

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

3-25
3 Automatic Agent Program

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

Procedure (SQL /Oracle database)


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

2) Click the [Add to list] button.

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


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

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

3-26
3 Automatic Agent Program

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

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

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

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

3-27
3 Automatic Agent Program

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

Removing a Linked Database


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

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

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

3-28
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-12
4.7 Exiting a Program..................................................................................4-13
4.8 Registering to a Database ......................................................................4-14
4.9 Adding or Deleting Compression Files .................................................4-17
4.9.1 Adding Files......................................................................................................... 4-18
4.9.2 Deleting Files ....................................................................................................... 4-18
4.10 Using the Wizard in Database Registration...........................................4-19
4.11 Toolbar and Status Bar ..........................................................................4-23
4.12 Details Information................................................................................4-24
4.13 Reentry List ...........................................................................................4-25
4.14 Options...................................................................................................4-26
4.14.1 Selecting a Font.................................................................................................... 4-27
4.15 Update Information................................................................................4-28
4.16 Configuration Settings...........................................................................4-29
4.16.1 Configuration Settings ......................................................................................... 4-30
4.16.2 Compressed File Settings..................................................................................... 4-31
4.16.3 Executing an Application ..................................................................................... 4-32
4.16.4 Selecting the CLASS-VP Parameters................................................................... 4-34
4.16.5 Setting the Data Registration Option Selection.................................................... 4-36
4.17 Editing a Reentry List............................................................................4-37
4.18 Help Topics............................................................................................4-38
4 Manual Agent Program

4.1 Introduction
The Manual Agent Program is used to manually register analysis results obtained from
CLASS-VP 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 does the following:
a) Compresses files automatically, such as data files, method files, sample schedule, and AIA
files.
b) Creates an object link to AIA files.

Compressed files can be extracted using Agent Manager. They can be reregistered to a database
using this Manual Agent Program, after recalculation. In addition, the AIA file that an object
was linked to can be opened with Agent Manager.

[NOTE] Only CLASS-VP Ver6.xx corresponds to the CLASS-VP Agent manual registration.

4-1
4 Manual Agent Program

4.2 Main Screen


The following shows the CLASS-VP Manual Agent window, a main screen, used to perform
various program functions.

- CLASS-VP Manual Agent Window -


Menu bar Toolbar File List pane

Status bar Detail Information pane

Functions (Menu bar)


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

2) [Entry] menu
[Entry...] See “4.8 Registering to a Database.”
[Reentry...] See “4.8 Registering to a Database.”
[Wizard...] See “4.10 Using the Wizard in Database Registration.”
[Add Compression Files...] See “4.9 Adding or Deleting Compression Files.”

4-2
4 Manual Agent Program

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

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

5) [Help] menu commands


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

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

2) [Logout] See “4.4 Logging Out.”

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

4) [Entry] See “4.8 Registering a Database.”

5) [Reentry] See “4.8 Registering a Database.”

6) [Wizard] See “4.10 Using the Wizard in Database Registration.”

7) [Details] See “4.12 Details Information.”

Functions (Status Bar)


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

2) Login user name indicator


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

3) Additional file number indicator


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

4) Database name indicator


This indicates the name of a currently selected database.

4-3
4 Manual Agent Program

Functions (File List pane)


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

- The "File List" pane -


System list box File List pane File Type list box

Folder List pane

File List pane


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

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

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

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

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

2) Perform data processing.

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

4-4
4 Manual Agent Program

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

- The "Login" dialog box -

Procedure
1) Click the [Login] button in the toolbar, or click the [Logout] menu command in the menu
bar. The "Login" dialog box is displayed.

2) Type a login ID and password.

3) Click the [OK] button.


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

About User Permissions


The user permissions are assigned to each login ID in Agent Manager. The operations that a user
may perform depend on degrees of user permissions. The user permissions include the
following.
1) Run Agent/GW permission
“ON” A user can log in.
“OFF” A user cannot log in.

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

3) Database Management permission


“ON” A user can use the [Add to list] and [Delete from list] buttons in the "Select
Database" dialog box.
“OFF” A user cannot use the [Add to list] and [Delete from list] buttons in the "Select
Database" dialog box.

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

4-5
4 Manual Agent Program

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 Program

4.5 Selecting a Database


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

- The "Select Database" dialog box -

Functions
(1) Linking a Database
Procedure (MDB database)
1) Choose [Tools] → [Link Database].
2) Click the [Add to list] button.
3) Select the [MDB] option button of “Selection of the database.”

MDB file
selection button

Click the MDB file selection button and select the MDB file.

4-7
4 Manual Agent Program

When the MDB file is selected, the [Next] button is enabled. Click the [Next] button.

Click the [Check the connection] button.


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

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

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

4-8
4 Manual Agent Program

Procedure (SQL /Oracle database)


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

2) Click the [Add to list] button.

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


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

4) Enter a machine name of the server in which the SQL server database is stored.

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

4-9
4 Manual Agent Program

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

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

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

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

4-10
4 Manual Agent Program

(2) Removing a Linked Database


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

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

- The "Delete" dialog box -

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

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-11
4 Manual Agent Program

4.6 Viewing Properties


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

- The "Properties" dialog box -

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

2) The "User" tab


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

3) The "File" tab


This sheet displays information on a currently selected file.

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

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

4-12
4 Manual Agent Program

4.7 Exiting a Program


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

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

4-13
4 Manual Agent Program

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...]
Analysis data in a file is stored as “new” data in a database.

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

[NOTE] • For a database update, select a database that contains original data.
• Pressing the [ESC] key during a database registration will abort the database
registration.

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

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

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

4) Select a sequence file to be compressed. Click the button to the left of a filename to select the
file and click the [Next] button. A single file can be selected.

- The Select File dialog box -

4-14
4 Manual Agent Program

5) If the "Select a method file manually" option button in the "Configuration" dialog box is
checked, select a method file to be compressed. Click the button to the left of a filename to
select the file and click the [Next] button. A single file can be selected.

- The Select Method dialog box -

6) If the "Confirm database at registration" option is [ON], the "Confirmation" dialog box is
displayed. Click the [Yes] button to register all the selected files. Click the [No] button to
abort the current selections.
If the "Confirm database at registration" option is [OFF], the "Confirmation" dialog box is
not displayed, thus continuing the registration. For the "Confirm database at registration"
setting, see “4.14 Options.”

- The Confirmation dialog box -

Procedure (Reentry...)
1) Select the database where analysis data is to 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 Program

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

- The "Reentry List" dialog box -

5) Select a sequence file to be compressed. For a procedure for selecting files, see “Procedure
(Entry...)” on the preceding page.

6) If the "Select a method file manually" option button in the "Configuration" dialog box is
checked, select a method file to be compressed. For a procedure for selecting files, see
“Procedure (Entry...)” on the preceding page.

7) If the "Confirm database at registration" option is [ON], the "Confirmation" dialog box is
displayed. Click the [Yes] button to register all the selected files. Click the [No] button to
abort the current selections.
If the "Show or hide a confirmation message at database registration" option is [OFF], the
"Confirmation" dialog box is not displayed and the selected files are registered. For the
"Confirm database at registration" setting, see “4.14 Options.”

- The Confirmation dialog box -

4-16
4 Manual Agent Program

4.9 Adding or Deleting Compression Files


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

- 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 "Clear this list after database entry " check box
ON A listing of selected files, displayed in the "Add compression files list" section, will
be cleared each time analysis data is stored in a database.
OFF A listing of selected files, displayed in the "Add compression files list" section, will
not be cleared each time analysis data is stored in a database.

Procedure
1) Choose [Entry] → [Add Compression 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, returning to the main screen.
Clicking the [Cancel] button aborts the addition or deletion. Clicking the [Help] button
opens a help file.

4-17
4 Manual Agent Program

4.9.1 Adding Files


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

- The "Add File" dialog box -

Procedure
1) Click the [Add] button in the "Add Compression 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.9.2 Deleting Files


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

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

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

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

4-18
4 Manual Agent Program

4.10 Using the Wizard in Database Registration


This section describes how to use the wizard to store analysis data in a database after selecting an
analysis data file in the "Select File" dialog box.

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 to select a data file, see “4.2 Main Screen.”

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. Click the Option button to
open the [Entry Wizard]. Select the [Entry] or [Reentry] option button and click the [Next]
button.

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

- Entry Wizard - Select Entry -

4-19
4 Manual Agent Program

5) Select a sequence file to be compressed. Click the button to the left of a filename to select the
file and click the [Next] button. A single file can be selected.

- Entry Wizard- Select Sequence File -

6) If the "Select a method file manually" option button in the "Configuration" dialog box is
checked, select a method file to be compressed. Click the button to the left of a filename to
select the file and click the [Next] button. A single file can be selected.

- Entry Wizard - Select Method File -

4-20
4 Manual Agent Program

7) Select an ANDI file to be compressed. Click the button to the left of a filename to select the
file and click the [Next] button. Multiple files can be selected.

- Entry Wizard - Select ANDI File -

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

- Entry Wizard - Add Compression Files -

4-21
4 Manual Agent Program

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

- The Entry Wizard - Confirmation -

4-22
4 Manual Agent Program

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-23
4 Manual Agent Program

4.12 Details Information


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

- The "Details Information" pane -

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

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

4-24
4 Manual Agent Program

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

- The "Reentry List" dialog box -

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

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

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

4-25
4 Manual Agent Program

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

- The "Options" dialog box -

Option Items
1) The "Font" section
This section is used to select a font. See “4.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 is not 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, updating or replacing.
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 "Specify peak information using Details button" check box.


ON Detail peak information is displayed on the screen.
OFF Detail peak information is not displayed on the screen.

6) "Specify concentration format using Details button" combo box.


Choose the form of concentration (ESTD / ISTD / NTST) to indicate when detail button is
clicked..

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-26
4 Manual Agent Program

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

2) Select the desired option items.

3) Click the [OK] button to effect 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 for the main screen.

- The "Font" dialog box -

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

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

Procedure
1) Click the [Change] button in the "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-27
4 Manual Agent Program

4.15 Update Information


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

- The "File List" pane -

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

4-28
4 Manual Agent Program

4.16 Configuration Settings


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

- The "Configuration" dialog box -

Menu

Option items
1) "Configuration" See “4.16.1 Configuration Settings.”

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

3) "Execute application" See “4.16.3 Executing an Application.”

4) "CLASS-VP Parameters" See “4.16.4 Selecting the CLASS-VP Parameters.”

5) "Data registration options" See “4.16.5 Setting the Data Registration Option Selection.”

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

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

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

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

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

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

4-29
4 Manual Agent Program

4.16.1 Configuration Settings


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

- The "Configuration" pane -

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

2) The "Login" section


The "Login" section is used to specify a login method. 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 you check this radio
button, you need to specify a login ID and password. The login ID and password must
match the ones registered to Agent Manager.

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

2) Select the desired setting options.

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

4-30
4 Manual Agent Program

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.

- The "Select compression files" pane -

Option items
1) The "Select compression files" section
This section specifies the type of files to be compressed.
“Data file” “Andi file”
“Method file” “Acrobat file”
“Sequence file”

2) The "Show compression progress bar" check box


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

Purpose
Settings for compressed files must be made to ensure the following.

1) Only the desired quantitative results are archived.

2) Chromatogram files are compressed only if the file size is large.

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

2) Select the desired setting options.

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

4-31
4 Manual Agent Program

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.

- The "Execute application" pane -

Options items
1) The "Execute after database registration" check box
This check box specifies whether to start an application automatically after storing data in a
database (to send e-mail, or print operation results, etc.).
ON An application will automatically start. If checked, specify the name of the applica-
tion 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-32
4 Manual Agent Program

Functions
1) The Program file name text box
In this text box, specify the full path name of the application to be started 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-33
4 Manual Agent Program

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 Selecting the CLASS-VP Parameters


This section describes how to specify the operating parameter for CLASS-VP.

- "CLASS-VP Parameters" Pane -

Options
1) [Instrument]
CLASS-VP software supports a maximum of 4 HPLC systems. This field is used to specify
an instrument name that will be used when registering each system's data in a database. For
routine operation, select the same instrument name used for CLASS-VP.

2) [Data File]
This field is used to specify a destination folder where data files registered for each system
are stored. For routine operation, select the same folder name specified for CLASS-VP.

3) [Sequence File]
This field is used to specify a destination folder where sequence files registered for each
system are stored. For routine operation, select the same folder name specified for
CLASS-VP.

4) [Method File]
This field is used to specify a destination folder where method files registered for each
system are stored. For routine operation, select the same folder name specified for
CLASS-VP.
5) [Export]
This field is used to specify a destination folder where ANDI files registered for each system
are stored. For routine operation, select the same folder name specified for CLASS-VP.

4-34
4 Manual Agent Program

Functions
1) [Instrument]
This field is used to specify an instrument name for database registration.

2) [Data File]
Clicking the [...] button to the right of the text box will open the "Folder Select" dialog box.
Click the [OK] button in the dialog box to register the selected folder. The [Cancel] button is
used to abort the selection.

3) [Sequence File]
Clicking the [...] button to the right of the text box will open the "Folder Select" dialog box.
Click the [OK] button in the dialog box to register the selected folder. The [Cancel] button is
used to abort the selection.

4) [Method File]
Clicking the [...] button to the right of the text box will open the "Folder Select" dialog box.
Click the [OK] button in the dialog box to register the selected folder. The [Cancel] button is
used to abort the selection.

5) [Export]
Clicking the [...] button to the right of the text box will open the "Folder Select" dialog box.
Click the [OK] button in the dialog box to register the selected folder. The [Cancel] button is
used to abort the selection.

- The "Browse for Folder " dialog box -

4-35
4 Manual Agent Program

Procedure
1) Click [CLASS-VP Parameters] in the left pane of the "Configuration" dialog box. The
"CLASS-VP Parameters" sheet is displayed in the right pane.

2) Make the appropriate setting in each text box.

3) Click the [OK] button. All settings made in the "Configuration" dialog box take effect and
the "Configuration" dialog box closes. Click the [Cancel] button to cancel the changes made
and to close the "Configuration" dialog box.

4.16.5 Setting the Data Registration Option Selection


Set options for the data registration method.
The use of this feature is restricted to users having the Property/Option permission.

"Data registration options" - Pane

Options
1) [Do not register method]
If this option button is on, a method file is not registered for file compression.

2) [Select a method file manually]


If this option button is on, select a method file from a listing to specify the method file to be
compressed.

3) [Register the method file used in analysis]


If this option button is on, the latest method file is registered at the time of data registration.

[NOTE] By default, the [Do not register method] option button is on.

Procedure
1) Click [Data registration options] in the left pane of the "Configuration" dialog box. The
"Data registration options" is displayed in the right pane.

2) Click the desired option to specify whether to use a method file at the time of database
registration.

3) Click the [OK] button. All the settings made in the "Configuration" dialog box take effect
and the "Configuration" dialog box closes. Click the [Cancel] button to cancel the changes
made and to close the "Configuration" dialog box.

4-36
4 Manual Agent Program

• The "Exclude ‘Spectrum Max Plot’ data" check box


In analysis (or reanalysis) of three-dimensional data, if the maximum plot channel of the
spectrum does not have to be registered in a database, set this check box to ON.

• The "Exclude 'Spectrum Current Plot' data" check box


In analysis (or reanalysis) of three-dimensional data, if the current plot channel of the spectrum
does not have to be registered in a database, set this check box to ON and Select detector name.

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


Set this check box to ON to register a PDF document file, output from the CLASS-VP, to a
database. The PDF document file is registered as an object file in the Link File 10 in the sample
information table. Click the [Browse] button to display the folder selection screen, then select
a folder to which the PDF file is output from CLASS-VP.
Enter the delay time required until CLASS-VP outputs a PDF file after it has finished analysis
or reanalysis to the "Wait time to monitor PDF report output" list box.

• The "Register VP data file (*.DAT) to LinkFile 9 field" check box


Set this check box ON to register a CLASS-VP data file to the database.
The CLASS-VP data file is registered as an object file in the Link File 9 in the sample
information table.

4.17 Editing a Reentry List


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

- The "Reentry List" dialog box -

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

Procedure
1) Choose [Tools] → [Edit 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 Program

4.18 Help Topics


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

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

2) [About Manual Agent] command


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

- The "About Manual Agent" message box -

Procedure
1) Choose [Help] and click the [Help Topics] command. A 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 and Object Link Files............................................... A-1
A.2 Contents of a Database ......................................................................... A-3
A.3 Temporary Database............................................................................. A-6
A.4 Log Database ........................................................................................ A-7
A.5 User Permissions ................................................................................... A-8
A.6 AIA-format Data (Andi-format Data) ................................................... A-9
A.7 Instrument Configuration File ............................................................. A-10
A.8 Contents of a Sample Information Table Created When an Application is
Activated.............................................................................................. A-11
Appendix A Supplementary Information

A.1 Compressed Files and Object Link Files


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

Storage Folder - For an SQL or Oracle database


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

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

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

Storage Folder - For an MDB database


For an MDB-format database, the data is stored as a file rather than a binary image field.
A folder having the database name (minus the extension) is created in the same folder as the
database. Compressed files are stored in this folder.

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

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


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

Compressed File Name (*.LZH)


A filename is automatically defined under the following conditions.

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

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

Appendix A-1
Appendix A Supplementary Information

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


A filename is automatically defined under the following conditions.

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

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

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

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

Appendix A-2
Appendix A Supplementary Information

A.2 Contents of a Database


There are five database tables: the sample information table, data information table, data log
information table, file information table and environment setting table. For single analysis data,
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
relationally 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 date Date Time RegistDate
Work station name Text WsName
Instrument name Text InstrumentName
Data process type Text InstrumentKind
Sample name Text SampleName
Sample ID Text SampleID
Sample type Text SampleType
Entry method Integer ManageFlag5
Operator Text Operator
Operation date Date Time OperateDate
LZH file's folder name Text LzhDirectory
LZH file's name Text LzhFile
AIA file (ch.1) name Text File1
AIA file (ch.2) name Text File2
AIA file (ch.3) name Text File3
GCD file name Text File9
PDF file name Text File10
Data file name Text FileInfo1
Batch schedule name Text FileInfo2
Method file name Text FileInfo3
Report file name Text FileInfo4
Background file name Text FileInfo5
Sample information 1-10 Text Tag1 - Tag10

Appendix A-3
Appendix A Supplementary Information

Data Information Table (DATATBL)


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

File Information Table (FILETBL)


Data Name Data Type Field Name
Registration date Date Time RegistDate
Work station name Text WsName
Instrument name Text InstrumentName
Archive registration date Date Time IniLzhFileDate
Link file registration date (1 to 10) Date Time IniFileDate1-10
Archive registration last date Date Time UpLzhFileDate
Link file registration last date (1 to 10) Date Time UpFileDate1-10
Archive file image Binary LzhFileImg
Link file image (1 to 10) Binary FileImg1-10

[NOTE] Compressed file images/Link File 1 to 10 images are used only when the database
format is “SQL Server (MSDE)” or “Oracle."

Appendix A-4
Appendix A Supplementary Information

Data Log Information Table (DATALOGTBL)


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

Appendix A-5
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 97 type database. It is
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 by Agent Manager. For data restoration, see the Agent Manager
Instruction Manual.

Appendix A-6
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 item per record.
The data log storing processes related to data is contained in the database storing the sample
information. The table structure is similar to that shown below.

Contents of a Log Information Table


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

Appendix A-7
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] and [Delete] buttons in the "Select Database"
dialog box are disabled, preventing the addition or deletion of a database.

Appendix A-8
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.

• When a CLASS-VP-format data file is converted to an AIA-format file, the data converted
may become less precise due to the differences in data type. If other application's data is
analyzed using CLASS-VP, small differences in results may arise due to a lack of data
precision and the differences between the methods of processing waveforms. If
CLASS-VP-format data is converted to AIA format then back to CLASS-VP format, the
results do not completely match because the converted data is less precise.

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

A.7 Instrument Configuration File


The instrument configuration file is used by Agent Manager and the CLASS-VP Automatic
Agent Program. It contains information on the maximum number of analysis devices connected,
and column headings of an information table. The contents of this file can be edited using the
Agent Manager Text Editor. Editing this file incorrectly will prevent the programs from running
properly. Do not make any change to the settings other than the ones described below.

File Structure
Folder Location folder where an application is installed.
Filename VP60.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-10
Appendix A Supplementary Information

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


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

Section Name Keyword Description


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

Appendix A-11
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 much easier to
perform print jobs.
This program is an external application designed for printing registered information on a default
printer when data is registered to a database using the automatic entry or manual entry features
provided by the CLASS-Agent software. This program can run on a personal computer that
supports the Automatic Agent/Manual Agent programs of CLASS-Agent software. This
program cannot be used on a client PC used for other management/analysis.

B.1.1 Making Initial Settings


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

- The "Agent Automatic Print" dialog box -

Print items

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

2) To finish the setting:


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

Appendix B-1
Appendix B Additional Software

B.1.2 Test Print


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

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

Click the [Browse] button to select

Click the [Print] button to print

Appendix B-2
Appendix B Additional Software

B.1.3 Using an External Application to Print


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

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

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

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

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

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

- The "Execute application" pane -

Appendix B-3
Appendix B Additional Software

B.2 The Agent Mail Carrier Program


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

B.2.1 Making Initial Settings


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

- The "Agent Mail Carrier" dialog box -

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

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

Appendix B-4
Appendix B Additional Software

Setting Option Information


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

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

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

Appendix B-5
Appendix B Additional Software

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

a) The "Export information append" check box


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

Appendix B-6
Appendix B Additional Software

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

(1) To check the connection to mail server:


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

Click the [Connect]


button to check
status.

(2) To check the test e-mail:


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

Click the [Send]


button to check
status.

Appendix B-7
Appendix B Additional Software

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


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

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

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

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

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

- The "Execute application" pane -

Appendix B-8
Appendix B Additional Software

E-Mail Error Code List

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

Appendix B-9

You might also like