This README file covers Inmagic® DB/TextWorks® and Inmagic® DB/Text® WebPublisher PRO. You only need to read about those products that you purchased.
About the Products
What's New in this Version?
Converting Annotations for Use in DB/TextWorks 9.00
Backward Compatibility Issues
Contacting Inmagic, Inc. and Communicating with Others
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.
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.
Version 9.00 addressed the following issues for DB/TextWorks and WebPublisher PRO. The applicable Inmagic tracking number follows each item listed, when available.
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.
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.
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.
This section contains the following topics:
Error message: "Cannot create directory '<directory>'."
Solution: Verify that:
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'
Error message: Directory does not exist. Create it?
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:
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:
Solution: Wait until the other person finishes using the textbase. If this message appears frequently, you may want to do the following:
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.
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.
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.
|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.|
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.
|200 Unicorn Park Drive|
|Woburn, MA 01801 U.S.A.|
|Tel: 781-938-4444 or 800-229-8398|
|firstname.lastname@example.org||- technical support questions|
|CustomerSvc@inmagic.com||- general company, product, and services questions|
|email@example.com||- sales, product pricing, and custom solution questions|
|firstname.lastname@example.org||- 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.
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.