Professional Documents
Culture Documents
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
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.
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.
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.
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-1
1 Introduction
1-2
1 Introduction
1-3
1 Introduction
1-4
1 Introduction
ElementA ElementB
1-5
1 Introduction
1-6
1 Introduction
1-7
1 Introduction
1-8
1 Introduction
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.
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.
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
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
• 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
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
Flowchart of Operations
Set up CLASS-VP.
Click here.
2-5
2 Getting Started
Double-click here.
Double-click here.
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.
Command button
Menu list
Status bar
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-8
2 Getting Started
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.
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.
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
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) 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.
4) The "Status" pane displays the status of compressed files, copied files and registered
databases.
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
Double-click here.
Double-click.
Agent Manager
This program is used for creating user
accounts, storing data in a database,
viewing or editing stored data.
3-1
3 Automatic Agent Program
3-2
3 Automatic Agent Program
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.
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.
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.
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.
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.
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.
Clicking the [OK] button to log out. Clicking the [Cancel] button aborts a logout attempt.
3-4
3 Automatic Agent Program
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.
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
The “Ready” status means that the program is on standby after a login,
monitoring CLASS-VP data output.
Green
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.
3-6
3 Automatic Agent Program
3-7
3 Automatic Agent Program
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-8
3 Automatic Agent Program
3-9
3 Automatic Agent Program
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
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.
3-11
3 Automatic Agent Program
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.”
[NOTE] In Ver. 5.03, this setting is not required. This is set under "Configuration".
3-12
3 Automatic Agent Program
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.”
3-13
3 Automatic Agent Program
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.
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 "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
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
• 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
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-21
3 Automatic Agent Program
3-22
3 Automatic Agent Program
• 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
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.
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.
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.
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
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.”
Functions (Toolbar)
The toolbar buttons are available as follows.
1) [Login] See “4.3 Logging In.”
4-3
4 Manual Agent Program
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.
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.
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) 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.
[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
Procedure
Click the [Logout] button in the toolbar, or click the [Logout] menu command in the menu bar.
4-6
4 Manual Agent Program
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.
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
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) 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.
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.
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
Functions
1) The "Database" tab
This sheet displays information on the destination database selected in the "Select Database"
dialog box.
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
Procedure
Chose [File] → [Exit] to exit the Manual Agent Program.
4-13
4 Manual Agent Program
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.
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.
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.”
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.
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.”
4-16
4 Manual Agent Program
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.
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.
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
Procedure
1) Click the [Add] button in the "Add Compression Files" dialog box. The "Add File" dialog
box is displayed.
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.
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
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.
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.
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.
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.
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.
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.
4-22
4 Manual Agent Program
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
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
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.
Option Items
1) The "Font" section
This section is used to select a font. See “4.14.1 Selecting a Font."
Functions
1) The [Change] button
This button is used to select a font. See “4.14.1 Selecting a Font.”
Procedure
1) Choose [View] → [Options]. The "Options" dialog box is displayed.
3) Click the [OK] button to effect the selection. Clicking the [Cancel] button aborts the
selection.
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.
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
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
Menu
Option items
1) "Configuration" See “4.16.1 Configuration Settings.”
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.
Procedure
1) Choose [Tools] → [Configuration]. The "Configuration" dialog box is displayed.
3) Click the [OK] button to apply the settings. Clicking the [Cancel] button aborts the settings.
4-29
4 Manual Agent Program
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.
Procedure
1) Click "Configuration" in the left-hand pane of the "Configuration" dialog box. The
"Configuration" section is displayed in the right-hand pane.
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
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”
Purpose
Settings for compressed files must be made to ensure the following.
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.
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
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.
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.
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.
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.
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.
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.
Options
1) [Do not register method]
If this option button is on, a method file is not registered for file compression.
[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
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.
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
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.
Procedure
1) Choose [Help] and click the [Help Topics] command. A help file opens.
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
Filename = Computer name + Instrument number + Storage date + Serial number + “.LZH”
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
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
Appendix A-3
Appendix A Supplementary Information
[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
Appendix A-5
Appendix A Supplementary Information
Appendix A-6
Appendix A Supplementary Information
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.”
Appendix A-7
Appendix A Supplementary Information
• 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.
Appendix A-8
Appendix A Supplementary Information
• 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
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.”
Appendix A-10
Appendix A Supplementary Information
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
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.
Appendix B-1
Appendix B Additional Software
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.
Appendix B-2
Appendix B Additional Software
(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.
Appendix B-3
Appendix B Additional Software
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
(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
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.
Appendix B-7
Appendix B Additional Software
(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.
Appendix B-8
Appendix B Additional Software
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