Manual IRsolution Agent
Manual IRsolution Agent
IRsolution Agent
Instruction Manual
Read this manual carefully before operating the software, and retain it for
future reference.
SHIMADZU CORPORATION
ANALYTICAL INSTRUMENTS DIVISION
KYOTO, JAPAN
Before Using CLASS-Agent Software
Thank you for purchasing CLASS-Agent Software. To get the most out of this software, read this manual
carefully before use.
This instruction manual describes how to use and operate CLASS-Agent Software. It assumes that the
user has a basic familiarity with Windows® 2000 and experience using a personal computer.
The basic terminology used in Windows® 2000 is used in this instruction manual to explain procedures for
using CLASS-Agent Software. For definitions of unfamiliar words, please refer to the Windows® 2000
manual or help file.
A first-time user of Windows® 2000 should first obtain a basic level of understanding of the operating
system before reading this manual.
Software Restrictions
1. This Software is the proprietary property of the Shimadzu Corporation. Shimadzu Corporation retains
all rights to this Software.
2. No part of this Software may be copied or reproduced in any form or by any means, except for
installation and routine backup. No part of this Software may be leased, assigned, transferred,
recompiled or altered in any form or by any means.
3. Shimadzu Corporation shall not be liable to the purchaser or any other person for any loss or damage
arising out of the use or operation of this Software.
Contents
Preface
About CLASS-Agent Software
About the Instruction Manual
Important Information
Chapter 1 Introduction
1.1 Features .........................................................................................................1-1
1.1.1 Features of the IRsolution Automatic Agent Program..................................................... 1-2
1.1.2 Features of the IRsolution Manual Agent Program.......................................................... 1-2
1.1.3 Features of Agent Manager.................................................................................................. 1-3
1.2 Handling Precautions.......................................................................................1-4
1.2.1 Before Using CLASS-Agent Software................................................................................. 1-4
1.2.2 About the Automatic Agent Program................................................................................. 1-6
1.2.3 About the Manual Agent Program...................................................................................... 1-7
1.2.4 About the Agent Manager Program.................................................................................... 1-8
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.
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.
IRsolution Agent is software designed to make entries of measurement results obtained from an
IRsolution system to a database shared by all types of CLASS-Agent Software. This software consists of
two programs:
• The Automatic Agent program that registers measurement data imported from calculated data files
or their related files created by the IRsolution to a database without user intervention
• The Manual Agent program that registers stored measurement files to a database manually
The Agent Manager software that comes with IRsolution Agent makes it much easier to view, print or
approve stored data, add sample information, copy data to other applications and restore measurement
files.
IRsolution Agent software supports GLP/GMP-compliant security capabilities and log capabilities,
making it easier to audit the operations performed by users.
1.1 Features
This program provides the following.
1-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
4. Creating a Database
In the "New MDB Database" dialog box in CLASS-Agent Manager, create an
MDB database to store analysis data. The creation of a database is limited to users
having the Administrator permission. To create an MS SQL Server formatted
database or MSDE (Microsoft Data Engine) formatted database, use the
CLASS-Agent Manager accessory program for creating an SQL database.
1-8
1 Introduction
6. Screen Saver
When this software is started after installation in the ER/ES mode, the system is
set so that the screen saver dedicated to the Agent system is automatically
activated. After this software is closed, the system returns to the original setting.
For Windows NT, the screen lock is valid. If a password is required, set a
password for the screen lock in the OS.
The default value of the time until the screen saver starts is 5 minutes. To change
this value, change “common.inf2” in "Environment Setting" of the Agent
Manager. For example, to set to 10 minutes the waiting time until the screen saver
starts, add the following two lines.
[GLP]
ScreenLock=10
7. Log Types
Log information is separated into the data log for data operations and the system
log (Log2.mdb) where logs related to the system are saved.
When the contents of the database storing the data acquired from the analysis
instrument are changed, the history of such changes is stored in the data log.
When the contents of options not directly related to the data are changed, the
history of such changes is stored in the system log.
Click the log on the database tree to display the log information on the sample
information table.
1-9
Chapter 2 Getting Started
2.1 IRsolution Setup ......................................................................................2-1
2.2 Automatically Storing Measurement Data in a Database........................2-2
2.2.1 Starting the Automatic Agent Program...........................................................................2-2
2.2.2 Logging In to the System...................................................................................................2-3
2.2.3 Specifying a Database for Each Instrument....................................................................2-4
2.2.4 Making a Measurement......................................................................................................2-7
2.3 Manually Storing Measurement Data in a Database ..............................2-8
2.3.1 Starting the Manual Agent Program ...............................................................................2-8
2.3.2 Logging in to the System ..................................................................................................2-9
2.3.3 Specifying a Destination Database.................................................................................2-11
2.3.4 Selecting and Storing Measurement Data ...................................................................2-12
2 Getting Started
2-1
2 Getting Started
Flowchart of Operations
Start measurement.
Click here.
2-2
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-3
2 Getting Started
Click the [OK] button. The login ID and password are checked against the ones recorded for the
user account. If they match the stored entries, the main screen is displayed under login status.
Clicking the [Cancel] button aborts a login attempt, but the main screen is displayed. To gain
access to the system, follow the login procedure from the main screen.
- The main screen -
1) Click the "Assign database per instrument" menu item in the "Menu List" pane, The "Assign
database per instrument" worksheet is displayed in the right-hand pane.
2-4
2 Getting Started
2) Double-click on the first row of the "Assign database per instrument" pane, or click on the
first row and click the [Edit] button. The "Assign database per instrument" dialog box is
displayed.
1. Instrument Name
"Read from Data File" check box is used to get the instrument name from IRsolution's
data file. If unchecked, the instrument name in the "Name" text box. The specified
instrument name is used to register to instrument field in database.
2. Register data
Click the "Register data" check box so that it is turned on, as shown in the figure. If this
check box is off, data is not stored in a database.
3. Destination database
In the "Destination database" list box, specify a database in which to store data. Clicking
the [Browse] button opens the "Select Database" dialog box.
In the "Select Database" dialog box, click “IRTest.mdb” to specify the destination
database to be used, and click the [OK] button.
2-5
2 Getting Started
4) In the "User Name" list box, specify a user name that accompanies data information
stored in the selected database. If the "Login user name" option is selected, the name of a
user who is currently logged in will be recorded with data information in the selected
database.
Click the [OK] button in the "Assign database per instrument" dialog box to finish the
setting. The contents of the "Assign database per instrument" pane is updated, as shown
below.
2-6
2 Getting Started
2) 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) After measurement is complete, the "Status" pane displays the status of compressed files,
copied files and database registration.
- The "Status" pane -
2-7
2 Getting Started
Flowchart of Operations
Click here.
2-8
2 Getting Started
Double-click here.
Double-click here.
Type a valid login ID and password in the text boxes. Regardless of the characters you type, only
asterisks (*) appear in the "Password" text box. The password must be correctly entered.
Passwords are case-sensitive.
2-9
2 Getting Started
Click the [OK] button. The login ID and password are checked against the ones recorded for the
user account. If they match the stored entries, the main screen is displayed under login status.
Clicking the [Cancel] button aborts a login attempt, but the main screen is displayed. To gain
access to the system, follow the login procedure from the main screen.
- The main screen -
2-10
2 Getting Started
1) Click the "Select Database..." menu item in the "File Menu" pane.
Clicking the [Browse] button opens the "Select Database" dialog box.
In the "Select Database" dialog box, click “IRTest.mdb” to specify the destination database
to use, and click the [OK] button.
2-11
2 Getting Started
2) From the "File List" pane, select a file (calculated data file) to be stored in the database. To
select several files, use the Shift and Ctrl keys, as in Windows Explorer.
4) The selected data is stored in the selected database and a result is displayed in the lower right
pane.
2-12
Chapter 3 Automatic Agent
3.1 Introduction .............................................................................................3-1
3.2 Main Screen.............................................................................................3-2
3.3 Command Buttons ...................................................................................3-3
3.4 Status Bar.................................................................................................3-7
3.5 Using the Menu List ................................................................................3-8
3.5.1 Viewing the Status..............................................................................................................3-9
3.5.2 Configuration Settings......................................................................................................3-10
3.5.3 System Configuration Settings .......................................................................................3-12
3.5.4 Database Assignment Settings........................................................................................3-16
3.5.5 Compressed File Settings.................................................................................................3-19
3.5.6 Executing an Application.................................................................................................3-20
3 Automatic Agent
3.1 Introduction
The Automatic Agent program is used to register measurement results obtained from IRsolution
programs to a database specified for each system. This program reads specified measurement
results after measurement is completed, and registers the measurement results to a database. The
registered measurement data can be viewed, edited or printed at any time using Agent Manager.
Compressed files can be extracted using Agent Manager. They can be re-registered to a database
using the Manual Agent program, after recalculation by the measurement program.
In IRsolution, a data file is compressed and saved with its filename and folder name during a
measurement process. If a compressed data file is decompressed and saved to a different folder,
recalculation may be prevented.
3-1
3 Automatic Agent
Menu Toolbar
3-2
3 Automatic Agent
This button minimizes the main screen to a taskbar icon. To redisplay the main screen,
double-click or right-click the taskbar icon for IRsolution Automatic Agent.
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 IRsolution Automatic Agent program provides security protection that restricts system
use to previously defined authorized users, and grants permissions to restrict the operations
that users may perform. The login procedure restricts access and system use to authorized
users. User’s activities are recorded in a log database. A log database can be viewed using
Agent Manager.
3-3
3 Automatic Agent
The [Login] button opens the "Login" dialog box, as shown below.
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.
2) Properties/Option permission
“ON” A user can make changes to all settings. Whether a user is allowed to create or
delete a database is determined by a setting as described in “3) Database Man-
agement permission.”
“OFF” A user cannot make a change to all settings. A user is allowed to open only the
"Status" pane.
3-4
3 Automatic Agent
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.
Procedure
1) Click the [Logout] button in the toolbar in the main screen. The "Logout" message box is
displayed.
2) Click the [OK] button to logout. Clicking the [Cancel] button aborts a logout attempt.
[NOTE] In the ER/ES mode, the "Logout check" dialog is displayed. The correct password
must be entered to log out.
3-5
3 Automatic Agent
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-6
3 Automatic Agent
The “Ready” status means that the program is on standby after a login,
monitoring IRsolution data output.
Green
The “OFF” status means that the program is logged out. Even if
IRsolution data is output, it will not be processed or registered to a
Gray database.
3-7
3 Automatic Agent
3-8
3 Automatic Agent
Procedure
1) Click "Status" in the "Menu" pane of the main screen. The "Status" pane is displayed in the
right-hand pane of the main screen. The "Status" pane displays information on events that
occurred after a login.
3-9
3 Automatic Agent
Option items
1) Login Mode
The Login Mode section is used to specify a login method. For the login procedure, see “3.3
Command Buttons.”
a) The "Normal login" radio button.
If this radio button is on, no auto login attempt is made at a boot-up. The "Login" dialog
box displays the login ID entered at the last login.
b) The "Automatic login" radio button
If this radio button is on, an automatic login attempt is made at a boot-up. The login ID
entered must match the one defined as described in the following step.
3-10
3 Automatic Agent
Procedure
1) Click "Configuration" in the "Menu" pane of the main screen. The "Configuration" pane is
displayed in the right-hand pane of the main screen.
2) Select the desired options. Settings are updated after changes are made.
3-11
3 Automatic Agent
Option Items
1. "Instrument name" This column shows instrument names.
2. "Data registration" This column shows whether to collect data.
3. "Database file" This column shows the names of databases where data is stored.
4. "User name" This column shows the names of operators who created the data-
bases.
Functions
1) The "Assign database per instrument" pane
This pane displays the setting status of each instrument.
Procedure
1) The settings for each analytical instrument may be viewed and edited. The use of this feature
is restricted to users having the Property/Option permission.
2) The "Assign database per instrument" pane displays the setting status of each instrument for
database registration. Select the desired instrument, and click the [Edit] button to open the
"Configuration System" dialog box. For detailed information, see “3.5.3.1 Assigning
Databases to Each System."
3) When another menu item is selected, the "Assign database per instrument" pane is closed.
3-12
3 Automatic Agent
Option Items
1) The "Instrument Name" section
"Read from Data File" check box is used to get instrument name from IRsolution's
data file. If unchecked, the instrument name can be input in the "Name" text box. The
specified instrument name is used for the instrument field in the database.
3-13
3 Automatic Agent
Functions
1) The [Browse...] button
This button opens the "Select Database" dialog box, where a database can be
selected. For detailed information, see “3.5.3.2 Selecting a Database.”
Procedure
1) In the "Assign database per instrument" pane, select the instrument for which settings
are to be entered, and click the [Edit] button. The "Assign database per instrument"
dialog box is displayed.
3) Click the [OK] button to update the settings. Clicking the [Cancel] button aborts the
changes.
4) The "Assign database per instrument" dialog box closes, returning to the "Assign
database per instrument" pane.
3-14
3 Automatic Agent
Functions
1) The [Add to list] button
This button adds the selected database to a list. This button opens the "Setting of
database connection" dialog box.
Input an Agent database file name that you want to add. If connection test is normal,
the selected database is registered.
For detailed information, see “4.5 Selecting a Database."
2) The [Delete from list] button
This button deletes the selected database from a list. This button opens the "Delete"
dialog box. Clicking the [Cancel] button aborts the deletion.
Procedure
1) In the "Assign database per instrument" dialog box, click the [Browse...] button just
to the right of the "Save database" text box. The "Select Database" dialog box is
displayed.
3) Click the [OK] button to obtain information on the selected database and close the
"Select Database" dialog box.
4) The "Select Database" dialog box closes, returning to the "Assign database per
instrument" screen.
3-15
3 Automatic Agent
Functions
1) The "Select database by keyword priority" pane
This pane displays current settings. If measurement data corresponds to several setting
items, the highest priority is given to a setting item displayed in the upper row.
3-16
3 Automatic Agent
Procedure
1) Click "Select database by keyword priority" in the "Menu" pane of the main screen. The
"Select database by keyword priority" pane is displayed in the right-hand pane of the main
screen.
2) The "Select database by keyword priority" pane displays the currently selected settings for
database assignment by keyword. Click the [Add] button, or select the row to edit and click
the [Edit] button. The "Select Database by keyword priority" dialog box is displayed. For
detailed information, see “3.5.4.1 Assigning Databases by Keyword."
To delete a row, select the row and click the [Delete] button.
3) When another menu item is selected, the "Select database by keyword priority" pane is
closed.
[NOTE] Keywords are case sensitive.
3-17
3 Automatic Agent
Option Items
1) The "Key item" list box
From the list box, select an item in sample information to be searched for. The
following items are selectable.
a) User name
b) Acquired Month
3-18
3 Automatic Agent
Functions
1) The [Browse] button
This button opens the "Select Database" dialog box.
For detailed information, see “3.5.3.2 Selecting a Database."
Procedure
1) In the "Select database by keyword priority" pane, click the [Add] button, or select
the row to edit and click the [Edit] button. The "Select database by keyword priority"
dialog box is displayed.
3) Click the [OK] button to update the settings. Clicking the [Cancel] button aborts
changes made.
4) The "Select database by keyword priority" dialog box closes, returning to the "Select
database by keyword priority" pane.
Option Items
1) The "Select compression files" section
This section specifies the type of files to be compressed.
“Data file”
3-19
3 Automatic Agent
Procedure
1) Click "Data file collection" in the "Menu" pane of the main screen. The "Select compression
files" pane is displayed in the right-hand pane of the main screen.
2) Select the desired options. Settings are updated after changes are made.
3) When another menu item is selected, the "Select compression files" pane is closed.
Option Items
1) The "Execute after database registration" check box
This check box specifies whether to start an application automatically after storing data in a
database (to send e-mail, or print operation results, etc.).
“ON” An application will start automatically. If checked, specify the name of the appli-
cation to start, the name of the output folder where the sample information file (a
measurement result text file prepared for the application) will be stored, and make
the setting in the "Add a sample information file name in the command line at the
time of execute" check box as described in Step 2)-4).
“OFF” An application will not start automatically.
3-20
3 Automatic Agent
4) The "Add a sample information file name in the command line" check box
A sample information filename is used in a command line when starting an external
application.
“ON” A sample information filename is added to a command line.
“OFF” A sample information filename is not added to a command line.
Procedure
1) Click "Execute application" in the "Menu" pane of the main screen. The "Execute
application" pane is displayed in the right-hand pane of the main screen.
2) Select the desired options. Settings are updated after changes are made.
3) When another menu item is selected, the "Execute application" pane is closed.
3-21
3 Automatic Agent
Functions
1) The [OK] button
This button selects a path name for the selected folder and closes the "Browse for
Folder" dialog box.
Procedure
1) In the "Execute application" pane, click the [Browse] button just to the right of the
"Sample information export folder" text box. The "Browse for Folder" dialog box is
displayed.
2) Specify the name of the folder in which imported files are stored.
3) Click the [OK] button to select the path name for the selected folder. Clicking the
[Cancel] button aborts the folder selection.
4) The "Browse for Folder" dialog box closes, returning to the "Execute application"
pane.
3-22
Chapter 4 Manual Agent
4.1 Introduction .............................................................................................4-1
4.2 Main Screen.............................................................................................4-2
4.3 Logging In...............................................................................................4-5
4.4 Logging Out .............................................................................................4-6
4.5 Selecting a Database ................................................................................4-7
4.6 Viewing Properties ................................................................................4-13
4.7 Exiting a Program..................................................................................4-14
4.8 Registering to a Database ......................................................................4-15
4.9 Registration Using the Wizard ..............................................................4-17
4.10 Adding or Deleting Compression Files .................................................4-19
4.10.1 Adding Files .......................................................................................................................4-20
4.10.2 Deleting Files .....................................................................................................................4-20
4.11 Toolbar and Status Bar ..........................................................................4-21
4.12 Details Information................................................................................4-22
4.13 Reentry List ...........................................................................................4-23
4.14 Options ..................................................................................................4-24
4.14.1 Selecting a Font.................................................................................................................4-25
4.15 Update Information ...............................................................................4-26
4.16 Environment Settings ............................................................................4-27
4.16.1 Configuration Settings......................................................................................................4-28
4.16.2 Compressed File Settings.................................................................................................4-29
4.16.3 Executing an Application.................................................................................................4-30
4.16.4 Instrument name ................................................................................................................4-32
4.16.5 Operator..............................................................................................................................4-33
4.17 Editing a Reentry List............................................................................4-34
4.18 Help .......................................................................................................4-35
4 Manual Agent
4.1 Introduction
The Manual Agent Program is used to manually register measurement results obtained from
IRsolution programs to a specified database. This program reads specified measurement results
and registers them to a database. The registered measurement data can be viewed, edited or
printed at any time using Agent Manager.
This program executes additional data processing when measurement data is registered to a
database. This program compresses files automatically, such as data files.
Compressed files can be extracted using Agent Manager. They can be reregistered to a database
using the Manual Agent Program, after recalculation by the IRsolution program.
In IRsolution, a data file is compressed and saved with its filename and folder name during a
measurement process. If a compressed data file is decompressed and saved to a different folder,
recalculation may be prevented.
4-1
4 Manual Agent
2) [Entry] menu
[Entry...] Register a measurement file to a database as a newly created
data.
[Reentry...] Register a measurement file decompressed in Agent Manager
to a database again.
[Wizard...] Use the wizard to store measurement data in a database after
selecting a measurement data file in the File List pane.
[Add Compression Files...] Specify the files to be compressed, other than those specified
in “ Compressed File Settings."
4-2
4 Manual Agent
3) [View] menu
[Toolbar] Show or hide the toolbar.
[Status Bar] Show or hide the status bar.
[Details Information] Display detail information on the file selected in the upper-half
pane of the main screen.
[Reentry List...] Displays a listing of measurement data decompressed in Agent
Manager.
[Options...] Specify font or messages.
[Update] Show the latest folder contents.
4) [Tools] menu
[Configuration...] Specify the configuration settings of Manual Agent.
[Edit Reentry List...] Delete unwanted items from a Reentry List.
Functions (Toolbar)
The toolbar buttons are available as follows.
1) [Login] A login is used to identify a user.
2) [Logout] A logout is used to exit a log-in state without exiting the program.
3) [Select] Select a database, add it to a list, or delete it form to the list.
4) [Entry] Register a measurement file to a database as a newly created data.
5) [Reentry] Register a measurement file decompressed in Agent Manager to a
database again.
6) [Wizard] Use the wizard to store measurement data in a database after se-
lecting a measurement data file in the File List pane.
7) [Details] Display detail information on the file selected in the upper-half pane
of the main screen.
4-3
4 Manual Agent
2) The "Folder List" pane Double-click the folder to show data files in the "File List" pane.
3) The "File List" pane Displays a list of files specified in the "Drive" list box 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
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) Type a login ID and password.
3) Click the [OK] button.
A user can log in to the system if the login ID and password entered meet the following two
conditions.
a) The login ID and password entered match the ones registered to Agent Manager.
b) The Run Agent/GW (Gateway) permission has been granted to the user.
If these conditions are not met, another login attempt should be made from the beginning.
Clicking the [Cancel] button aborts a login attempt.
[NOTE] Since the database chosen as data registration is memorized for every user, the user who
logs-in for the first time cannot do registration of data, and a registration menu does not
become effective, unless newly choosing a database.
4-5
4 Manual Agent
Procedure
Click the [Logout] button in the toolbar, or click the [Logout] menu command in the menu bar.
4-6
4 Manual Agent
Functions
1) The [Add to list] button
This button adds the selected database to a list. This button opens the "Setting of database
connection" dialog box.
The below function and operation are vary with the kind of the database.
Clicking the [Cancel] button aborts the execution of the [Add to list] command.
4-7
4 Manual Agent
MDB file
selection button
2. Click the MDB file selection button. Select the desired MDB file and click [Open].
3. The [Next] button is enabled when and MDB file is selected. Click the [Next] button
to continue.
4-8
4 Manual Agent
5. If there the connection settings are normal, the [Finish] button is enabled. Click the
[Finish] button.
6. A dialog box prompting for a comment is displayed. Type a comment, if any, and
click the [OK] button.
SQL Server/MSDE
Enter the database name in the “DataBase” input box. (The database name is the
same as the name of the SQL server database when it was created.)
Oracle
Input the service name set up in the client PC.
4-9
4 Manual Agent
2. Enter the machine name or IP address of the server where the SQL server database is
stored. Click the [Next] button.
3. For an SQL server / MSDE database, the following screen is displayed. For an Oracle
database, continue at step 4 of this procedure.
Choose and set a protocol for the SQL server. Click the [Next] button.
4. Log in to the SQL Server, based on the setting made in the previous steps. Define a
login ID and password. The login ID and password should be defined when making
the SQL Server settings. For any questions, contact the system administrator.
Enter an ID and a password, then click the [Check the connection] button.
4-10
4 Manual Agent
5. If the connection is normal, the [Finish] button is enabled. Click the [Finish] button.
6. A dialog box prompting for a comment is displayed. Type a comment, if any, and
click the [OK] button.
4-11
4 Manual Agent
Procedure
1) Choose [File] → [Select Database], or click the [Select] button in the toolbar. The "Select
Database" dialog box is displayed.
3) Click the [OK] button. The selected database is identified as a destination database. Clicking
the [Cancel] button clears the selection.
4) The "Select Database" dialog box closes, returning to the main screen.
4-12
4 Manual Agent
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-13
4 Manual Agent
Procedure
Choose [File] → [Exit] to exit the Manual Agent Program.
4-14
4 Manual Agent
Functions
1) [Entry...]
This command is used to register a measurement file to a database as a newly created data.
2) [Reentry...]
This command is used to register a measurement file decompressed in Agent Manager to a
database. The original data contained in a database remains intact, and the measurement data
is registered as updated data in the database.
[NOTE] • When updating a database, select the database that contains the original data.
• Pressing the ESC key when making an entry to a database will abort the
registration to the database.
Procedure (Entry)
1) Select the database where measurement data will be stored.
3) Choose [Entry] → [Entry...] in the menu bar, or click the [Entry] button in the toolbar.
4) If the "Confirm database at registration" check box is ON, the "Database upload
confirmation" message box is displayed on the screen. Click the [Yes] button to make an
entry, or click the [No] button to abort an entry. If the "Confirm database at registration"
check box is OFF, the "Confirm database at registration" message box does not appear on the
screen. An entry is automatically made.
Procedure (Reentry)
1) Select the database where measurement data will be stored.
3) Choose [Entry] → [Reentry...] in the menu bar, or click the [Reentry] button in the toolbar.
4-15
4 Manual Agent
4) Ensure that information on the data file is shown in the " Reentry List" dialog box, and click
the [OK] button to update the database. Clicking the [Cancel] button aborts the update.
Clicking the [Help] button opens a help file.
5) If the "Confirm database at registration" check box is ON, the database upload confirmation
message box is displayed on the screen. Click the [Yes] button to display the "Reentry List"
dialog box, or click the [No] button to abort.
If the "Confirm database at registration" check box is OFF, the "Reentry List" dialog box is
displayed immediately. For the procedure to make the setting in the "Confirm database at
registration" check box, see “4.14 Options."
4-16
4 Manual Agent
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."
3) Click [Wizard] in the [Entry] menu, or click the [Wizard] button in the toolbar.
4-17
4 Manual Agent
4-18
4 Manual Agent
Functions
1) The [Add] button
This button adds selected files to an archive file list. The selected files are displayed in the
"Add compression file s list" section.
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 and returns to the main screen.
Clicking the [Cancel] button aborts the addition or deletion. Clicking the [Help] button
opens the help file.
4-19
4 Manual Agent
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 measurement data
is stored in a database.
4-20
4 Manual Agent
Functions
1) Toolbar
Choose [View] and click [Toolbar] to show or hide the toolbar.
2) Status Bar
Choose [View] and click [Status Bar] to show or hide the status bar.
4-21
4 Manual Agent
Procedure
1) Select the file to view its detail information from the "File List" pane of the main screen.
2) Choose [View] → [Details Information]. The detail information on the selected file is
displayed in the "Details Information" pane of the main screen.
[NOTE] A maximum of 256 characters can be used for the comment that is displayed in the
detail information field.
4-22
4 Manual Agent
Procedure
1) Choose [View] → [Reentry List]. The "Reentry List" dialog box is displayed.
2) Check a listing of measurement data decompressed in Agent Manager. Clicking the [Help]
button opens a help file.
3) Click the [Close] button to close the "Reentry List" dialog box.
4-23
4 Manual Agent
4.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."
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.
Functions
1) The [Change] button
This button is used to select a font.
Procedure
1) Choose [View] → [Options]. The "Options" dialog box is displayed.
3) Click the [OK] button to apply the selection. Clicking the [Cancel] button aborts the
selection.
4-24
4 Manual Agent
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-25
4 Manual Agent
Procedure
Choose [Vie w] → [Update]. The content of the file list is updated in the "File List" pane of the
main screen, showing the latest information.
4-26
4 Manual Agent
Menu
Option items
1) "Configuration " Set system configuration and login methods.
2) "Select compression files" Specify the type of compressed files that are created
when data is registered.
3) "Execute application" Specify applications, so that they can automatically start
after data is stored in a database.
4) "Instrument name" Specify the device name.
5) "Operator" Specify whether the login user or the operator is used
when registering a data file
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 affect the settings. Clicking the [Cancel] button aborts the settings.
4) The "Configuration" dialog box closes, returning to the main screen.
4-27
4 Manual Agent
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 setting options. The "Configuration" dialog
box closes. Clicking the [Cancel] button aborts all the changes made and closes the
[Configuration] dialog box.
4-28
4 Manual Agent
Option items
1) The "Select compression files" pane
This section specifies the type of files to be compressed.
“Data file s”
Purpose
Making settings for compressed files is necessary for the following reasons:
a) To ensure that only the necessary (quantitative results) are entered in the database.
b) To ensure that the raw data files are compressed only if the file size is large.
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 options. The "Configuration" dialog box
closes. Clicking the [Cancel] button aborts all the changes made and closes the
[Configuration] dialog box.
4-29
4 Manual Agent
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-30
4 Manual Agent
Functions
1) The Program file name text box
In this text box, specify the full path name of the application to start automatically. Clicking
the [Browse] button displays the Application Selection dialog box. Select an application
name and click the [OK] button. The selected application name is registered. Clicking the
[Cancel] button aborts the selection.
4-31
4 Manual Agent
Procedure
1) Click "Execute application" in the left-hand pane of the "Configuration" dialog box. The
"Execute application" section is displayed in the right-hand pane.
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.
Option Items
1) The "Reference to IRsolution settings " check box
This check box determines whether the instrument name of the IRsolution's data file is used.
ON Use the default device name of the IRsolution's data file automatically. The
instrument name cannot be input in the "Name" text box.
OFF Use specific name designated by the “Name” text box.
Procedure
1) Click "Instrument name" in the left-hand pane of the "Configuration" dialog box. The
"Instrument name" section is displayed in the right-hand pane.
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-32
4 Manual Agent
4.16.5 Operator
This pane is used to specify whether the currently logged in user or the operator specified in the
data file is used when data is registered to the database.
Options items
• Login User
The name of the user that is currently logged in is used when data is registered to a database.
Procedure
1) Click "Operator " in the left-hand pane of the "Configuration" dialog box. The "Operator"
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-33
4 Manual Agent
Functions
The [Delete from list] button : Deletes selected items from a list.
The [Help] button : Opens a help file.
Procedure
1) Choose [Tools] → [Reentry List]. The "Reentry List" dialog box is displayed.
3) Click the [Delete from list] button. The selected items are deleted from the Reentry List.
4) Click the [Close] button to close the "Reentry List" dialog box.
4-34
4 Manual Agent
4.18 Help
The [Help] menu command is used to open the help file.
Functions
1) [Help Topics] command
This command displays the Find tab. Typing a search word will display all related topics.
Click the topic to open it immediately. All of the checked topics are displayed.
2) To close the "About Manual Agent" message box, click the [OK] button.
4-35
Appendix A Supplementary Information
A.1 Compressed Files....................................................................................A-1
A.2 Contents of a Database ...........................................................................A-2
A.3 Temporary Database...............................................................................A-3
A.4 Log Database ..........................................................................................A-4
A.5 User Permissions ....................................................................................A-5
A.6 Instrument Configuration File ................................................................A-6
A.7 Contents of a Sample Information Table Created
When an Application is Activated..........................................................A-7
Appendix A Supplementary Information
Storage Folder
For an MDB format database, a folder having the database name (without its extension) is
created in the same folder as the database. Compressed files and Link files are stored in this
folder, not stored in the binary image field of a database.
Filename = Computer name + Instrument number + Storage date + Serial number + “.LZH”
Computer name The name determined in the Properties settings on a network computer.
Instrument number The number 1.
Storage date YYMMDD, 6 characters, the date on which the file is registered on a database.
Serial number 4 numeric characters from 0000 to 9999 used for all Agent programs. The
number is incremented by 1 each time a file is registered on a database.
[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-1
Appendix A Supplementary Information
Appendix A-2
Appendix A Supplementary Information
Appendix A-3
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-4
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-5
Appendix A Supplementary Information
File Structure
Folder Location “inf2” folder where an application is installed.
Filename IR.inf2
[DATATBL] section
This section contains settings for column headings of a data information table in Agent Manager,
such as “Area” and “Height.”
[Option] section
This section is used to make option settings for the IRsolution Agent Program.
Appendix A-6
Appendix A Supplementary Information
Appendix A-7
Appendix B Additional Software
B.1 The Agent Automatic Print Program...................................................... B-1
B.1.1 Initial Settings .....................................................................................B-1
B.1.2 Test Print ............................................................................................B-2
B.1.3 Using an External Application to Print ..................................................B-3
B.2 The Agent Mail Carrier Program ........................................................... B-4
B.2.1 Initial Settings .....................................................................................B-4
B.2.2 Checking the Connection to Mail Server and the Test E-Mail .................B-7
B.2.3 Using an External Application to Send E-Mail.......................................B-8
B.3 IRView Utility...................................................................................... B-10
B.3.1 Introduction ......................................................................................B-10
B.3.2 Screen...............................................................................................B-10
B.3.3 Operation ..........................................................................................B-11
B.3.4 Customizing Screen...........................................................................B-20
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
(2) In the "Program file name" text box, type the full path to the Agent Automatic Print program
“Agent_pr2.exe”
(3) In the "Sample information export folder" text box, specify an output folder.
(4) Turn on the "Add a sample information file name in the command line" check box.
In this example, the Agent Automatic Print program will start each time automatic or manual
entries are made, and will print registered information. The exported sample information file is
automatically deleted after a print job is successfully completed.
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. Click the [Connect] and [Send] buttons to check
whether an error may occur.
Appendix B-7
Appendix B Additional Software
(2) In the "Program file name" text box, type the full path to the Agent Mail Carrier program
“Agent_ml2.exe."
(3) In the "Sample information export folder" text box, specify an output folder.
(4) Turn on the "Add a sample information file name in the command line " check box.
In this example, t he 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 memo ry. No workspace is available.
Appendix B-9
Appendix B Additional Software
Features:
• A spectrum can be enlarged by dragging it with the mouse button.
• A spectrum can be saved to a Windows META file.
• A spectrum image can be copie d to the Clipboard so that they can be pasted to a word
processing or spreadsheet application.
B.3.2 Screen
The IRView Utility Window is displayed as shown below.
Client area
Scroll bar
Status bar
Appendix B-10
Appendix B Additional Software
B.3.3 Operation
B.3.3.1 Opening a Data File
This section describes how to open a spectrum file. If a data file is open, the on-screen
contents will be cleared. After a spectrum file is opened, a spectrum is displayed in the
client area. The size of a spectrum image is adjusted to the largest peak of the spectrum.
The horizontal axis is fixed.
Procedure
1) Choose [File] → [Open].
Click the Open button ( ) in the toolbar or press the Ctrl + O key as a keyboard
shortcut.
2) A dialog box opens, prompting for a filename. Select a spectrum file and click the
[Open] button.
Appendix B-11
Appendix B Additional Software
[NOTE] To save a spectrum, adjust the image size and font size. This step is de-
scribed later in another section: Setting the spectrum display.
B.3.3.3 Printing
Spectra displayed in the client area can be printed.
Procedure
1) Choose [File] → [Print].
Click the Print button ( ) in the toolbar or press the Ctrl + P key as a
keyboard shortcut.
2) The "Print" dialog box opens. Select a printer and click the [OK] button. The
printer starts a print job.
Appendix B-12
Appendix B Additional Software
Appendix B-13
Appendix B Additional Software
Procedure
1) Display a spectrum in the client area.
2) Place the mouse pointer at a point from which to start the zoom-in, and drag it to a
desired size.
3) Release the mouse button at a destination. The area defined by the mouse pointer is
enlarged.
Appendix B-14
Appendix B Additional Software
Procedure
1) Choose [Edit] → [Copy to clipboard].
Click the Copy button ( ) in the toolbar or press the Ctrl + C key as a
keyboard shortcut.
Procedure
1) Choose [Edit] → [Init Spectrum].
Click the Initialize button ( ) in the toolbar or press the Ctrl + I key as a keyboard
shortcut.
2) The spectrum returns to its initial state. A maximized or minimized spectrum returns
in its original status.
Appendix B-15
Appendix B Additional Software
Procedure
Choose [Edit] → [Adjust].
Click the Adjust button ( ) in the toolbar or press the Ctrl + J key as a keyboard
shortcut.
Procedure
1) Choose [Edit] → [Undo].
Click the Undo button ( ) in the toolbar or press the Ctrl + Z key as a keyboard
shortcut.
Appendix B-16
Appendix B Additional Software
2) Select the desired options and click the [OK] button. To cancel the selections, click
the [Cancel] button.
Appendix B-17
Appendix B Additional Software
In the "Font" dialog box, select a font style and font size to use for a comment,
and click the [OK] button.
Display of grids and scales along the vertical and horizontal axes can be selected
when drawing a spectrum.
Appendix B-18
Appendix B Additional Software
Appendix B-19
Appendix B Additional Software
Specify an image size that is applicable to the creation of a META file. Adjust the
image size to the screen size if displaying a META file. Adjust the image size to the
resolution and number of pixels per inch of the printer to produce a printout.
Specifying a larger value in the text box stores the image in greater detail. This may
cause an image to be larger than the screen size when the image is copied to another
word processing or spreadsheet application. The larger the value entered, the more
memory required. There is a possibility that memory will be low when other ap-
plications are running.
Appendix B-20