|
SSDOT Log Procedures
for a Pears Database
SSDOT
for Pears generates log files when you perform various update activities
on a Pears database. Log files are database-specific
and are kept in a subdirectory that you can access directly with an editor
or through the Database Creation and Maintenance
menu in SSDOT for Pears. This topic addresses
how to display, print, or delete log files by selecting certain options
from within SSDOT for Pears.
Contents
Viewing
Pears Database Logs
Printing Pears Database Logs
Deleting Pears Database Logs
Viewing
Pears Database Logs
One
option to review logged information about a Pears
database is to display it online. The procedure below provides the
steps for viewing log information on your screen by selection a menu option
from within SSDOT for Pears.
|
1. Start
SSDOT for Pears.
| Result: |
The
following Main Menu appears:
|
Main Menu
1. Database
Registration
2. BER Records
3. Database Creation and Maintenance
4. Database Backup
5. Advanced Options
6. Exit SSDOT
Working Database:
No database selected
Type "l"
To LIST available databases
Type "s" To SET a working database
Type "u" To UNSET the working database
Press [ENTER]
key to return to Main Menu
>
|
|
2. Type
3 and press Enter at the SSDOT command prompt.
| Result: |
The
following menu appears:
|
Database Creation
and Maintenance Menu
1. Update database
2. Validate database
3. Reorganize database
4. Reindex database
5. Delete database files
6. Log Files Menu
7. Convert Newton database to Pears database
8. Exit SSDOT
Working Database:
No database selected
Type "l"
To LIST available databases
Type "s" To SET a working database
Type "u" To UNSET the working database
Press [ENTER]
key to return to Main Menu
>
|
|
3. Type
6 and press Enter.
| Result: |
The
following menu appears:
|
Log Files Menu
1. View log
files
2. Print log files
3. Delete log files
4. Exit SSDOT
Working Database: No database selected
Type "l"
To LIST available databases
Type "s" To SET a working database
Type "u" To UNSET the working database
Press [ENTER]
key to return to the Creation and Maintenance Menu
>
|
|
4. Type 1 and
press Enter.
| Result: |
The
following prompt appears:
|
Name of database
or press [ENTER] key to return to menu:
|
|
5. Type the
name of the database and press Enter.
| Result: |
Information
similar to the following appears:
|
***************************************************************
<WebZ_root>/dbbuilder/dbs/marcus/logs/log.txt
Last Modified:Monday, October 22, 2001 9:51:32 AM EDT
******************************************
Monday, October 22, 2001 9:54:35 AM EDT
**NOTE: File does not exist:<WebZ_root>/ini/dbs/localmarcus.ini
------------------------------------------
******************************************
Monday, October 22, 2001 9:54:36 AM EDT
zbase is not running.
------------------------------------------
******************************************
Monday, October 22, 2001 9:54:36 AM EDT
Database creation started.
Press [ENTER]
key to continue or type "q" to quit:
|
|
6. Do you wish
to view more log information?
- Yes:
Press Enter to continue viewing log information about the database.
- No:
Type "q" and press Enter twice to quit viewing log information
and return to the Log Files Menu.
| Note: |
At the
conclusion of the log information, SSDOT
for Pears returns you automatically and by default back
to the Log Files Menu. Before reaching the end of the information,
if you wish to stop viewing logs at any point, you simply type
"q" and press Enter. |
|
Return
to Contents
Printing
Pears Database Logs
Printing
log files is an alternative to viewing them. The advantage to printing
log files is that you can more comprehensively examine and visually compare
the information within them. Also, printed log files are not restricted
by screen size or on-screen navigation. The procedure below provides the
steps for printing the log files for a Pears
database.
|
1. Start
SSDOT for Pears.
| Result: |
The
following Main Menu appears:
|
Main Menu
1. Database
Registration
2. BER Records
3. Database Creation and Maintenance
4. Database Backup
5. Advanced Options
6. Exit SSDOT
Working Database:
No database selected
Type "l"
To LIST available databases
Type "s" To SET a working database
Type "u" To UNSET the working database
Press [ENTER]
key to return to Main Menu
>
|
|
2. Type
3 and press Enter at the SSDOT command prompt.
| Result: |
The
following menu appears:
|
Database Creation
and Maintenance Menu
1. Update database
2. Validate database
3. Reorganize database
4. Reindex database
5. Delete database files
6. Log Files Menu
7. Convert Newton database to Pears database
8. Exit SSDOT
Working Database:
No database selected
Type "l"
To LIST available databases
Type "s" To SET a working database
Type "u" To UNSET the working database
Press [ENTER]
key to return to Main Menu
>
|
|
3. Type
6 and press Enter.
| Result: |
The
following menu appears:
|
Log Files Menu
1. View log
files
2. Print log files
3. Delete log files
4. Exit SSDOT
Working Database: No database selected
Type "l"
To LIST available databases
Type "s" To SET a working database
Type "u" To UNSET the working database
Press [ENTER]
key to return to the Creation and Maintenance Menu
>
|
|
4. Type 2 and
press Enter.
| Result: |
The
following prompt appears:
|
Name of database
or press [ENTER] key to return to menu:
|
|
5. Type the
name of the database and press Enter.
| Example: |
|
| Name
of database or press [ENTER] key to return to menu: marcus |
| Result: |
The
following prompt appears:
|
File Name to
PRINT to or press [ENTER] key to return to menu:
|
|
6. Type the
name of the text file that is to contain the log information.
| Note: |
By default
SSDOT for Pears saves the text file containing the log information
to your <WebZ_root>/dbbuilder/pearsExes subdirectory.
To put this file in another directory of your choice, you need
to type the entire directory path to it. |
|
7. Print the
file using either a Windows application or operating system command.
|
Return
to Contents
Deleting
Pears Database Logs
In order to create
a fresh log each time you perform an update function on a Pears
database, you need to delete or rename the current log file. You can
delete a log file either by directly deleting it in the logs subdirectory
for a database or by using SSDOT for Pears.
The procedure below instructs you on how to delete old log files using
SSDOT for Pears.
| Note: |
Unless
you regularly delete the existing log.txt file for a database, by
default, SSDOT for Pears continuously
appends log information to the end of the same log.txt file after
each update. The log.txt file is located in the logs subdirectory
for the specified database. An example logs subdirectory for the marcus
database might be <WebZ_root>/dbbuilder/dbs/marcus/logs. |
|
1. Start
SSDOT for Pears.
| Result: |
The
following Main Menu appears:
|
Main Menu
1. Database
Registration
2. BER Records
3. Database Creation and Maintenance
4. Database Backup
5. Advanced Options
6. Exit SSDOT
Working Database:
No database selected
Type "l"
To LIST available databases
Type "s" To SET a working database
Type "u" To UNSET the working database
Press [ENTER]
key to return to Main Menu
>
|
|
2. Type
3 and press Enter at the SSDOT command prompt.
| Result: |
The
following menu appears:
|
Database Creation
and Maintenance Menu
1. Update database
2. Validate database
3. Reorganize database
4. Reindex database
5. Delete database files
6. Log Files Menu
7. Convert Newton database to Pears database
8. Exit SSDOT
Working Database:
No database selected
Type "l"
To LIST available databases
Type "s" To SET a working database
Type "u" To UNSET the working database
Press [ENTER]
key to return to Main Menu
>
|
|
3. Type
6 and press Enter.
| Result: |
The
following menu appears:
|
Log Files Menu
1. View log
files
2. Print log files
3. Delete log files
4. Exit SSDOT
Working Database: No database selected
Type "l"
To LIST available databases
Type "s" To SET a working database
Type "u" To UNSET the working database
Press [ENTER]
key to return to the Creation and Maintenance Menu
>
|
|
4. Type 3 and
press Enter.
| Result: |
The
following prompt appears:
|
Name of database
or press [ENTER] key to return to menu:
|
|
5. Type the
name of the database and press Enter.
| Example: |
|
| Name
of database or press [ENTER] key to return to menu: marcus |
| Result: |
The
following prompt appears:
|
Logs deleted
for database marcus
Press [ENTER]
key to continue:
| Note: |
Deleting
log files for a Pears database
using SSDOT for Pears removes
all the files in the logs subdirectory for that database, regardless
of the file's name or extension. So, if you wish to keep some
of the files currently located in the logs subdirectory, you
need to copy them to another directory before performing the
delete action in SSDOT. |
|
|
6. Press Enter
to return to the Log Files Menu.
|
Return
to Contents
See Also
OCLC
SiteSearch Database Builder - Pears
Pears System Overview
Pears-Newton Comparison
Creating a New Pears Database
|