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

  • DB/TextWorks now supports GIF files as a standard image type. You can view and manipulate GIF images just like any other image format supported by DB/TextWorks.
     
  • The DB/TextWorks Images window now supports PDF files. You have the option of viewing PDF files in the Images window rather than Adobe Reader.
     
  • You can now browse and select files while editing. With your mouse pointer in an edit box, choose Edit>Browse Files to open the Open dialog box. This capability is similar to how you browse and select a file by using Microsoft Windows Explorer.
     
  • The full path can now appear for secondary textbases on the Edit Textbase Structure dialog box. To see the full path of a secondary textbase, position your mouse pointer over the secondary textbase name on the Link Definition tab. The full path displays in the pop-up balloon text.
     
  • Batch Modify has been enhanced. Batch Modify now supports special characters such as line breaks and entry delimiters. You can also now add text to the beginning or the end of an entry.
     
  • You can now do the following through the General tab of the Options dialog box (choose Tools>Options).
     
    • Change the User File path. See the "User options" section on the tab.
       
    • Save forms as Public by default. See the "Options" section on the tab, which has a new Save new forms, etc. in Textbase File (Public) by default check box.
       
  • The "Finish" button replaces the "Close" button on the Edit Fields dialog box.
     
  • The DBTLabel.INI file now includes a label form to print spine labels only. The label form is equivalent to DemCo product code P142-1802 and Gaylord LSL01.
     
  • The product version number now appears in the title bar. When applicable, the service pack number appears also.
     
  • You can now use SMS to do Setup Workstation. See the Installation and Upgrade Notes document.
     
  • The Installation and Upgrade Notes document has been reformatted. This document now prints in full-page portrait orientation with document identification in the footer. A listing of the major sections in the document is now provided on the first page.

WebPublisher PRO

  • The XML tutorial has been updated. See Knowledgebase article 2772.
     
  • You can now change the label text for the "Browse Choices" button. In the Inmagic.INI file, see the [WebPublisher] section and the BrowseChoicesText parameter. This Inmagic.INI file is located your user file path.
     
  • You can now configure the InmagicBrowse application. In the <appSettings> section of the Web.CONFIG file, which is located in the InmagicBrowse subfolder within the main WebPublisher PRO installation folder, to configure:
     
    • The "leading article" character (Alt+0160), edit the value for the SpaceSubst element.
       
    • The number of keys displayed in the InmagicBrowse list, edit the value for the NumKeys element.
       
    • Whether InmagicBrowse wraps long terms or not, edit the value for the WrapKeys element.
       
  • The following is now available for XML input.
     
    • You can now return information from secondary fields using the <KeyField> element in a query.
       
    • You can now specify that a query set be sorted by a secondary field using the <SortField> element.
       
    • Batch Modify is now available through the XML API. For more information, see the XML tutorial.
       
    • The textbase name is now emitted with the XML schema.
       
  • You can now browse the associated field for Link fields while editing.
     
  • Browsing long validation lists is now much faster. There is added support for paging the validation list (as we offer when browsing the index during searching).
     
  • The product now supports exploded sorts. Add or edit the WebAllowExplode parameter in the [WebPublisher] section of the DBTWPUB.INI file, which is located in the WebPublisher PRO installation folder on the Web server. Note that you must restart IIS (the World Wide Web Publishing Service) any time you make any changes to this parameter in the DBTWPUB.INI file. You can use the Services option through the Windows Computer Management window to restart IIS.
     
  • The "Add" button replaces the "Select" button on the Inmagic Choices Browser pop-up window. A Replace All button also appears when browsing terms from a validation list.
     
  • The Installation and Upgrade Notes document has been reformatted. This document now prints in full-page portrait orientation with document identification in the footer. A listing of the major sections in the document is now provided on the first page.

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

  • Right justification on labels now works as expected. Previously, report, display, edit, and query screens were ignoring right justification on labels. [621]
     
  • Switching to a form with a relevance-ranked sort now uses Unsorted Order if the search criteria does not use the Word index. Previous versions used the sort from the previously selected form. Note that Relevance-Ranked Order only applies to searches using the Word index. [675]
     
  • Validation list links no longer appear for read-only boxes added to an edit form to display the contents of secondary fields. [992]
     
  • "Next page" problem with InmagicBrowse fixed. [1415]
     
  • AC=INDEX_BY_KEY no longer ignores Default-DisableXML-Setting=1. [1777]
     
  • Using https in IIS now works as expected. The "XML Document must have a top level element." message now does not appear when you try to edit over the Web from an https address. [2878]
     
  • TB_SCHEMA_QUERY and RF_SCHEMA_QUERY now force XML output as expected. [2887]
     
  • The "Updating record..." pop-up window now shows the correct product name. [3131]

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).

  • Can be used with DB/TextWorks 9.00 if:
    • The textbase structure is not modified.
       
    • The public textbase elements (query screens, forms, and record skeletons) or textbase default elements are not changed. Note that public saved sets can be changed (for example, refreshed, or created) without affecting backward compatibility.
  • Cannot be used with DB/TextWorks 9.00 if:
    • The textbase was created using DB/TextWorks 8.00 or later.
       
    • The textbase structure was modified using DB/TextWorks 8.00 or later.
       
    • Any public textbase element (query screen, form, or record skeleton) or the textbase default elements were modified using DB/TextWorks 8.00 or later.

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.

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

  Home page | Inmagic software | Crew-Noble services | Training Dates  
  About Crew-Noble | What's new? | Contact us  

Crew-Noble Information Services
323 El Pintado Heights Drive, Danville, CA 94526-1412
Phone: (925) 837-1399   Fax: (925) 820-9114