Inmagic® DB/TextWorks® and
DB/Text® WebPublisher PRO
Version 9.00 README File


Copyright © 1995–2005 Inmagic, Inc. All rights reserved.

This README file covers Inmagic® DB/TextWorks® and Inmagic® DB/Text® WebPublisher PRO. You only need to read about those products that you purchased.

Contents

About the Products

What's New in this Version?

Issues Resolved

Converting Annotations for Use in DB/TextWorks 9.00

Backward Compatibility Issues

Troubleshooting

Documentation Resources

Contacting Inmagic, Inc. and Communicating with Others


About the Products

DB/TextWorks is a content management system—a type of database software that enables you to build networked and standalone textbases to manage text, numbers, dates, and electronic images. DB/TextWorks combines traditional database power, including the ability to manipulate data and perform arithmetic calculations, with the ability to handle large amounts of text. When you want to publish your textbase(s) over the Web, you need to use DB/Text WebPublisher PRO.

DB/TextWorks also provides you with access to Inmagic.net™, which gives you the ability to connect to the Inmagic server from within a DB/TextWorks session to accomplish various tasks related to cataloging, indexing, and disseminating information throughout an organization.

DB/Text WebPublisher PRO is a server version of DB/TextWorks that enables you to publish textbases on the Internet or an intranet, so Web users can search them. WebPublisher PRO accepts queries from standard Web browsers, such as Microsoft Internet Explorer, and accepts XML function calls. The software returns search results in dynamically generated HTML and XML reports, and allows for editing over the Web. WebPublisher PRO, which is a separate product to be purchased, is used together with DB/TextWorks, which is the "buildware" for creating searchable textbases.


What's New in this Version?

This section lists each new and enhanced feature for DB/TextWorks and WebPublisher PRO. For more information on a feature, see the online help, unless otherwise noted.

DB/TextWorks

WebPublisher PRO


Issues Resolved

Version 9.00 addressed the following issues for DB/TextWorks and WebPublisher PRO. The applicable Inmagic tracking number follows each item listed, when available.

DB/TextWorks

WebPublisher PRO


Converting Annotations for Use in DB/TextWorks 9.00

Note: This is necessary only if you are upgrading from DB/TextWorks version 7.01 or earlier.

Run the Inmagic Annotation Converter application (DBTANNCONV.EXE), which was installed with DB/TextWorks version 9.00, for each DB/TextWorks textbase that contains image annotations that you want to use in version 9.00.

To run the conversion program, you must have exclusive access to the textbase.

  1. Start the Inmagic Annotation Converter application (double-click DBTANNCONV.EXE, located in the DB/TextWorks installation folder).
     
  2. Choose Convert Image Annotations>Convert Annotations in Textbase to open the Select Inmagic DB/TextWorks Textbase dialog box.
     
  3. Select the textbase containing the image annotations you want to convert, then click Open. If the textbase has passwords, you are prompted for the Master password.
     
  4. A message appears showing the number of image annotations in the textbase and explains that the old format will be converted to the new format. Click Yes to proceed with the conversion.
     
  5. Another message appears listing the number of annotations converted, skipped, and/or not converted. Click OK to dismiss it.
     
  6. Close the Inmagic Annotation Converter application.

To verify that the annotations have been converted, open the textbase in DB/TextWorks version 9.00 and search for one or more records that you know have image annotations. Display the images and see if the annotations appear.

Note: As of DB/TextWorks version 8.00, the annotation files have the default extension of .ANN. Previously, annotation files had the default extension of .ART.


Backward Compatibility Issues

The following outlines the compatibility requirements for client machines running WebPublisher PRO version 7.01 and earlier, and/or the Run-time version software (which is a standalone, search-only version of DB/TextWorks).

Inmagic® ODBC Driver for DB/Text® version 8.00 is the compatible version for DB/TextWorks version 9.00.


Troubleshooting

This section contains the following topics:

Critical Errors

All DB/TextWorks messages are documented in the DB/TextWorks Messages textbase (DBTMSG) included in the Inmagic Applications group (click the Windows Start button, then click Programs>Inmagic Applications>DBTextWorks>Messages Textbase). However, there are several messages that may prevent you from starting the software or opening any textbase (including the Messages textbase). Each is documented below. Messages are listed in alphabetic order.

Error message: "Cannot create directory '<directory>'."

Reasons:

  • This is the first time you have run DB/TextWorks or your UserFilePath setting has been removed from the Windows Registry.
     
  • You typed a directory that does not already exist in the User File Path dialog box, and responded Yes to the Directory does not exist. Create it? question. However, DB/TextWorks encountered an error when trying to create the directory. When you click OK, you will return to the User File Path dialog box so you can try again.

Solution: Verify that:

  • You typed a path (that is, a drive and directory), not a file name.
     
  • The drive you specified, if any, exists (and if you are on a network, that you are connected to it or logged in).
     
  • You have the necessary rights to create a directory on that drive.
     
  • The directory name is a valid directory name.
     
  • If you typed multiple directory levels, all directories above the specified directory already exist (for example, if you typed C:\User\Temp\DBTEXT, verify that C:\User\Temp already exists).
     
  • No file exists with the directory name you specified.

Try creating the directory manually by choosing File>New>Folder in Windows Explorer.

If all else fails, accept the default that DB/TextWorks supplies (for example, C:\Program Files\Inmagic\).

Error Message: Cannot open license file. Contact system administrator.

Reason/Solution: This message will normally only occur for network installations. The DBTEXT.LIC file does not exist and you do not have the necessary rights to create it. Have someone with Write and Create access to the directory containing the software run DB/TextWorks. The license file will be created automatically.

Error message: Cannot read 'dbtext32.cmx'

Reasons/Solutions:

  • The DBTEXT32.CMX file is missing or damaged. If the DBTEXT32.CMX file is missing or damaged, re-install DB/TextWorks.
     

  • OR
     
  • You pressed OK on the Enable or Upgrade Network dialog box when you do not have Write access to the directory where the DBTEXT32.CMX file is located. To get to this dialog box, you choose Tools>Enable or Upgrade Network. When you press Cancel on the Enable or Upgrade Network dialog box, you will receive an "Error opening file DBTEXT32.CMX: Access denied." message. Log in using a user ID that has Full access to the directory where DB/TextWorks is installed before attempting to increase the number of licensed users. Note that if the DBTEXT32.CMX file is write-protected, you get an error message when you select the Enable or Upgrade Network command and click OK.

Error message: Directory does not exist. Create it?

Reasons/Solutions:

  • This is the first time you have run DB/TextWorks or you have deleted your UserFilePath setting in the Windows Registry or INMAGIC.INI file (for example, by renaming or the file). If this is the first time you have run DB/TextWorks and you want to create the new directory, click Yes.
     

  • OR
     
  • You typed a directory that does not already exist in the User File Path dialog box. If you already have existing user files, or you made a mistake when typing the directory name, click No. You return to the User File Path dialog so you can specify the directory where your user files (extension .TBU) are already located.

Error message: File 'd:\path\tbname.dbs' cannot be read by the software.

Reason/Solution: You attempted to open a version 8.00 or later textbase with an earlier version of DB/TextWorks. Open a version 8.00 textbase with DB/TextWorks version 8.00 or later.

Error message: File '<file name>', and possibly other textbase files, no longer exist. The textbase cannot be opened. Please note that the 'Recover Textbase' operation may help you recover from this problem.

Reasons: You tried to open a textbase using one of the following methods:

  • You clicked on a textbase box in a menu screen.
     
  • You chose one of the "last-used" textbases from the bottom of the File menu.
     
  • You chose File>Open.
     
  • You used one of the options on the Manage Textbases menu.
     
DB/TextWorks cannot find the file name shown in the message.

Solutions:

  • If you used one of the first two methods, the problem may be that you have moved or renamed the textbase or you are not connected to the network drive where the textbase is located. Or, the textbase may have been a temporary textbase that you have deleted because you no longer need it.
     
  • If you used one of the last two methods, the problem is probably more serious. The .TBA file exists, but other files are missing. The Recover Textbase command on the Manage Textbases menu will only be useful if all of the textbase files with the following extensions do still exist: .TBA, .DBS, .DBR, .DBO, and .ACF. If the only file that is missing is the .ACF file, you can copy and rename one from another textbase. Otherwise, your only recourse is to restore the textbase from a healthy backup.
     

Error message: File '<file name>' is missing, and Inmagic DB/TextWorks cannot run. Please reinstall.

Reason/Solution: DB/TextWorks checks for several files on startup, including DBTEXT32.CMX and certain DLL files. The file name shown in the message is missing. Re-install DB/TextWorks from the original disks using the Setup program, and apply all subsequent patches (if appropriate). Or restore the missing file from a healthy backup.

Error message: Software has an invalid serial number. Please reinstall.

Reason/Solution: The serial number is not a valid Inmagic DB/TextWorks serial number. The most likely cause for this is that the DBTEXT32.EXE file has been damaged or the installation process failed prior to completion. Re-install DB/TextWorks from the original disks using the Setup program, and apply all subsequent patches (if appropriate).

Error message: Temporary directory has not been specified or is write protected, please specify a writable directory in the TEMP variable.

Reason/Solution: You are running DB/TextWorks from write-protected media (for example, a write-protected floppy disk or a CD-ROM). DB/TextWorks is trying to create a file in the default directory or the directory specified using the TEMP= environment variable. Shell to DOS and type SET TEMP=C:\ or some other directory to which you have full access.

Error message: The textbase is not available because someone else has exclusive access. Please try again later.

Reason: You tried to open a textbase when someone else has already has the textbase open with exclusive access. This can happen when:

  • The textbase default indexing mode for this textbase is Immediate (exclusive access).
     
  • The other person used File>Change Indexing Mode to switch to Immediate (exclusive access).
     
  • The other person used one of the options on the Manage Textbases menu (for example, Dump Textbase, Load New Textbase, or Check Textbase). All of these options require exclusive access to the textbase.
     
  • Someone else is editing the textbase structure.

Solution: Wait until the other person finishes using the textbase. If this message appears frequently, you may want to do the following:

  • If the textbase default indexing mode is set to Immediate (exclusive access), change it. Choose File>Change Indexing Mode, select the Shared Immediate (multiple users) or Deferred option button, and select the Use as Textbase Default Indexing Mode check box. Note that this option is only available when you are using the Master password.
     
  • If users are switching to Immediate indexing, add or change any passwords in use so that they cannot. Clear the Exclusive (Immediate) Access Permitted check box for each password.
     
  • If "unauthorized" people are using the options on the Manage Textbases menu, add a Master password. You must know the Master password to use any of these options. You can enable a Silent password to provide default permissions to the textbase.

Error message: The user file path '<path>' specified in your user options does not exist.

Reason/Solution: When you open or create a textbase, DB/TextWorks checks your user file directory for a matching user file for that textbase. If no user file exists, DB/TextWorks attempts to create one. However, the user file directory represented by '<path>' in the message does not exist, so DB/TextWorks cannot create a user file until you specify a new user file path. When you click OK on the message, the User File Path dialog will appear, with the user file path specified in your Registry filled in. If you would like to create the user file path shown, click OK. Otherwise, specify a different user file path. For example, your Registry key may have been created by your network administrator and copied to everyone's machine. If you know where your user files are located, specify that directory. User files have the extension .TBU.

Error message: You have reached the maximum number of users licensed (<number>). Please try again later. Contact Inmagic, Inc. to increase the number of users permitted.

Reason/Solution: You tried to run Inmagic DB/TextWorks when the number of users allowed to run the program simultaneously (indicated by the number in parentheses) has already been reached. For example, if you have a 10-node license, you receive this message when the eleventh person tries to start the software. You will be able to use Inmagic DB/TextWorks when someone else stops using it. If this message appears frequently, contact Inmagic Sales to increase the number of simultaneous users permitted.

This message can also appear if a workstation (node) goes down (gets turned off or rebooted, or loses its network connection) while someone is using DB/TextWorks on it. Most networks eventually time out and release the lock. Try logging in from the same workstation to release the connection. If the problem does not clear, contact your system administrator.

Error message: Your workstation setup is out of date, and you must run Setup Workstation again on this machine before you can run Inmagic DB/TextWorks. See the Installation Notes for more information.

Reason/Solution: You attempted to run DB/TextWorks when Setup Workstation has not been run on this machine. Setup Workstation does not simply create shortcuts; it installs files and registry entries necessary for DB/TextWorks to run. Log in as Administrator. Then close down all other applications, including the Microsoft Office taskbar, and run Setup.EXE from the directory where DB/TextWorks is installed. Click the Workstation button and follow the prompts.

Troubleshooting - General

Inmagic recommends using the latest version available to you. Service packs are available on the Service Packs page through the Inmagic Customer Extranet at http://support.inmagic.com/downloads/extranet.html for customers on maintenance.


Documentation Resources

The following table lists the documentation and help resources for DB/TextWorks and WebPublisher PRO. When available, you received electronic copies of the respective documentation set when you installed the applicable product. You will find them in the Documentation subfolder of the main installation folder for each product. In addition, you can access the documentation sets through the Inmagic Customer Extranet at http://support.inmagic.com/downloads/extranet.html.

Resource Explanation
Installation and Upgrade Notes for DB/TextWorks This document explains how to install and upgrade the product. An electronic version of this document is available on the installation CD-ROM or when you download the product.
Installation and Upgrade Notes for WebPublisher PRO This document explains how to install and upgrade the product. An electronic version of this document is available on the installation CD-ROM or when you download the product.
User's Manual for DB/TextWorks A user’s manual that covers DB/TextWorks and is available as a PDF file, which is included with the installation of the DB/TextWorks product.
User's Manual for WebPublisher PRO A user’s manual that covers WebPublisher PRO and is available as a PDF file, which is included with the installation of the WebPublisher PRO product.
Online Help File The help file, which covers DB/TextWorks and WebPublisher PRO, contains the most up-to-date information and includes more details than their user's manuals. To open the help file, start DB/TextWorks and press F1, or choose Help>Help Topics from the DB/TextWorks menu bar.
Web Services Guide This guide describes the Web services - SOAP interface available for use with the DB/Text® product line. It is available as a PDF file, which is also included with the installation of the WebPublisher PRO product.
XML Tutorial You can use this tutorial to help you get started with WebPublisher PRO. Created with Microsoft ASP, this tutorial lets you add records via the Web to the Cars textbase, which is also installed with WebPublisher PRO. See Knowledgebase article 2772.
Inmagic Web Products Schema Documentation This file contains information about each element you can submit in XML to WebPublisher PRO. To access the schema documentation, go to the Inmagic Customer Extranet.
README File for PowerPack Lite PowerPack Lite is bundled with DB/TextWorks, and you install PowerPack Lite from the same method as you installed DB/TextWorks (from an installation CD-ROM or from a download). This README file was installed in the PowerPack Lite installation folder.
Knowledgebase Use the Inmagic Technical Support knowledgebase on the Web to search for solutions to common problems and explanations for error messages. To access the knowledgebase, go to the Inmagic Customer Extranet.
HTML help pages for WebPublisher PRO These files provide help topics for WebPublisher PRO. See the online help for descriptions of WEB_BEGIN.HTM, WEB_ICHOICES.HTM, WEB_MSG.HTM, and WEB_WW.HTM, which are in the HELP subfolder of the WebPublisher PRO installation folder.


Contacting Inmagic and Communicating with Other Users

For help, you can contact Inmagic, Inc. or your local Inmagic dealer. You can also communicate with other Inmagic users.

If you have a maintenance agreement, please have your customer ID ready, and try to be at your computer when you call. If that is not possible, note exactly what you were doing when you encountered the problem, the exact text of any error messages you received, and your software version number and serial number (choose Help>About DB/TextWorks to look it up). If you do not have a maintenance agreement, you can contact Inmagic Customer Service to purchase one.

Inmagic, Inc.
200 Unicorn Park Drive
Fourth Floor
Woburn, MA 01801 U.S.A.
Tel: 781-938-4444 or 800-229-8398
Fax: 781-938-4446
http://www.inmagic.com

support@inmagic.com - technical support questions
CustomerSvc@inmagic.com - general company, product, and services questions
sales@inmagic.com - sales, product pricing, and custom solution questions
wishlist@inmagic.com - feature requests

If your message is intended for a particular person at Inmagic, Inc. (for example, a Technical Support representative who is expecting the message or files), please include the name of that person in the subject and in the message.

Communicating with Other Users

You can participate in user-to-user discussions through an Inmagic forum on the Web. Note that the forums are not an official customer or technical support channel for Inmagic products. To participate in a forum, go to the Inmagic Customer Extranet at http://support.inmagic.com/downloads/extranet.html.

1205