<!-- $XConsortium: ch06.sgm /main/4 1996/10/11 09:24:03 cdedoc $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<Chapter id="infoapg.div.6">
<Title id="n0W3SgFBd02698oL">Troubleshooting</Title>
<IndexTerm><Primary>troubleshooting</Primary></IndexTerm>
<Para>
This section describes problems that may occur with the
Information Manager tools as a result of:
</Para>
<ItemizedList>
<ListItem>
<Para>
Build Errors&mdash; these errors can occur during the
<Command>dtdocbook2infolib build</Command>,
<Command>dtdocbook2infolib tocgen</Command>, and
<Command>dtdocbook2infolib update</Command> processes.
</Para>
</ListItem>
<ListItem>
<Para>
Style Sheet Errors&mdash; these errors can occur during the
<Command>dtdocbook2infolib build</Command> or the
<Command>dtdocbook2infolib update</Command> processes.
</Para>
</ListItem>
<ListItem>
<Para>
Library Administration Errors&mdash; these errors occur
during the <Command>dtdocbook2infolib admin</Command> process.
</Para>
</ListItem>
</ItemizedList>

<Para>
For more information, see <filename>dtdocbook2infolib(1)</filename>.
</Para>

<!--))))))))))))))))))))))))))))))))))))))))))))))))))))))-->

<sect1>
<Title id="DW3SgFBd02698oL">Build Errors</Title>
<Para>
The following error messages are generally associated with the
build process and are generated by either the
<Command>dtdocbook2infolib build</Command>,
<Command>dtdocbook2infolib tocgen</Command>, or
<Command>dtdocbook2infolib update</Command> programs.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>(ERROR) An undeclared style sheet name NAME was
found in the bookcase specification.
</computeroutput>
</literallayout>
<para>
means that style sheet <Replaceable>NAME</Replaceable> is specified in the bookcase
specification but has not been declared anywhere.
</Para>
<Para>
You must include the style sheet explicitly. One way of
including a style sheet is through the use of an entity
reference.
</Para>
<para>The following error message:</para>
<literallayout>
<computeroutput>(ERROR) An illegal ToC was found.
</computeroutput>
</literallayout>
<para>means that
the Information Manager found more than one TOC within the same
book.
</Para>
<Para>
Only one TOC is allowed for each book.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>(ERROR) Memory exhausted.
</computeroutput>
</literallayout>
<para>
means that insufficient memory was available to complete the build.
</Para>
<Para>
You must increase the memory available for the build
process. See
<Link Linkend="jI.RgFBe.1698oL">Build Considerations</Link> for more information
about allocating memory for the build process.
</Para>
<para>
The following error message:</para>
<literallayout>
<computeroutput>(ERROR) ToC validation failed.
</computeroutput>
</literallayout>
<para>
means that TOC validation failed.
</Para>
<Para>
Check the log of the build for details on where to find the error.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) IDREF = <Replaceable>LINK</Replaceable>
   "	  of ToC file = <Replaceable>FILE</Replaceable>
   "	  at line = <Replaceable>LINE</Replaceable>
   "      is pointing to an unavailable section.
</computeroutput>
</literallayout>
<para>
means that a hypertext link <Replaceable>LINK</Replaceable> at line
<Replaceable>LINE</Replaceable> in the TOC file
<Replaceable>FILE</Replaceable>
does not have a destination section.
</Para>
<Para>
Supply a unique ID for the destination section.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Section ID = <Replaceable>ID</Replaceable>
   "       of file = <Replaceable>FILE</Replaceable>
   "       at line = <Replaceable>LINE</Replaceable>
   "       does not have a corresponding link with
   "       the value = <Replaceable>ID</Replaceable>
   "       from the
   "       TOC file = <Replaceable>TOCFILE</Replaceable>.
</computeroutput>
</literallayout>
<para>
means that no link exists from the TOC file <Replaceable>TOCFILE</Replaceable>
to the section <Replaceable>ID</Replaceable> for
<Replaceable>FILE</Replaceable>.
</Para>
<Para>
Check the TOC file <Replaceable>TOCFILE</Replaceable>
and add a link with the value
<Replaceable>ID</Replaceable> to the TOC.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Duplicate ID = <Replaceable>ID</Replaceable>
   "       found in file = <Replaceable>FILENAME1</Replaceable>
   "       at line = <Replaceable>LINE1</Replaceable>
   "       is in conflict with
   "       ID = <Replaceable>ID</Replaceable>
   "       found in file = <Replaceable>FILE2</Replaceable>
   "       at line = <Replaceable>LINE2</Replaceable>.
</computeroutput>
</literallayout>
<para>
means that the Information Manager found the duplicate ID value
<Replaceable>ID</Replaceable> in both
<Replaceable>FILE1</Replaceable> and <Replaceable>FILE2</Replaceable>.
</Para>
<Para>
Each ID value must be unique. Change the appropriate
ID value to make it unique. Be sure to update the TOC
file with the new value.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Duplicate section ID = <Replaceable>ID</Replaceable>
   "       found in the file = <Replaceable>FILE1</Replaceable>
   "       at line = <Replaceable>LINE1</Replaceable>
   "       is in conflict with section ID = <Replaceable>ID</Replaceable>
   "       in file = <Replaceable>FILE2</Replaceable>
   "       at line= <Replaceable>LINE2</Replaceable>.
</computeroutput>
</literallayout>
<para>
means that the Information Manager found the duplicate section ID value
<Replaceable>ID</Replaceable> in both
<Replaceable>FILE1</Replaceable> and <Replaceable>FILE2</Replaceable>.
</Para>
<Para>
Each section ID value must be unique. Change the
appropriate section ID value to make it unique. Be sure
to update the TOC file with the new value.
</Para>

<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Tab ID = <Replaceable>TabId</Replaceable>
   "       of book = <Replaceable>bookName</Replaceable>
   "       specified in file = <Replaceable>FILE1</Replaceable>
   "       at line = <Replaceable>LINE</Replaceable>
   "       is not pointing to any
   "       section ID found in the book.
</computeroutput>
</literallayout>
<para>
means that the tab ID value <Replaceable>TabId</Replaceable> listed in
<Replaceable>bookName</Replaceable> was not
found in the files that comprise <Replaceable>bookName</Replaceable>.
</Para>
<Para>
All tabs must point to a valid section in the book. Make
sure the tab ID is pointing to a valid section.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Style sheet validation failed.
</computeroutput>
</literallayout>
<para>
means that a syntax error was found in the style sheet.
</Para>
<Para>Correct the syntax error in the style sheet.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) An ID could not be found for the graphical
object.
</computeroutput>
</literallayout>
<para>
means that the graphical object did not have an ID.
Supply a non-empty ID value for the graphical object.
</Para>

<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Terms file does not exist.
</computeroutput>
</literallayout>
<para>
means that there is insufficient disk space
to contain a temporary file for searchable terms information.
</Para>
<Para>
Verify that you have enough disk space to perform the build.
</Para>
</sect1>

<!--))))))))))))))))))))))))))))))))))))))))))))))))))))-->

<sect1>
<Title id="n7eNaekBIaXwA0YK">Style Sheet Errors</Title>
<Para>
The following error messages are associated with style sheets.
For information about creating and using style sheets, see
<Link Linkend="tgmdnkb6vm9x3cs">Understanding Information Manager Style Sheets</link>
and <Link Linkend="btcmaab0ang24ak">Creating a Style Sheet</link>.
</para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Autonumber: missing ID attribute.
</computeroutput>
</literallayout>
<para>
means that the ID attribute for autonumbering could not be found.
Specify the ID attribute for autonumbering.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Autonumber: missing Type attribute.
</computeroutput>
</literallayout>
<para>
means that the Type attribute for autonumbering could not be found.
Specify the Type attribute for autonumbering.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Autonumber: missing Initial attribute.
</computeroutput>
</literallayout>
<para>
means that the Initial attribute for autonumbering could not be found.
Specify the Initial attribute for autonumbering.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Autonumber: missing Delta attribute.
</computeroutput>
</literallayout>
<para>
means that the Delta attribute for autonumbering could not be found.
Specify the Delta attribute for autonumbering.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Autonumber: missing Reset attribute.
</computeroutput>
</literallayout>
<para>
means that the Reset attribute for autonumbering could not be found.
Specify the Reset attribute for autonumbering.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Autonumber: missing Counter attribute.
</computeroutput>
</literallayout>
<para>
means that the Counter for autonumbering could not be found.
Specify the Counter attribute for autonumbering.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) No name given for the style sheet.
</computeroutput>
</literallayout>
<para>
means that the style sheet name was missing.
Specify the style sheet name.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Syntax error in <Replaceable>EXPR</Replaceable>.
</computeroutput>
</literallayout>
<para>
means that a syntax error was found in the expression
<Replaceable>EXPR</Replaceable>
specified for an Information Manager architectural form.
</Para>
<Para>
Search for the expression
<Replaceable>EXPR</Replaceable> in the DTD and correct
the syntax for the Information Manager architectural form.
</Para>
</sect1>

<!--))))))))))))))))))))))))))))))))))))))))))))))))-->

<sect1>
<Title id="L4E7gLBYimg24aK">Library Administration Messages</Title>

<Para>
The following error messages are associated with the
<Command>dtdocbook2infolib admin</Command> command.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) <Replaceable>InfoLibPath</Replaceable> is not a valid information library.
</computeroutput>
</literallayout>
<para>
means that the <Replaceable>InfoLibPath</Replaceable> you specified may
be an invalid path, or the information library itself may be invalid.
Enter the correct path name, or check to see if there is a file named
<Filename>*.oli</Filename> under the
<Replaceable>InfoLibPath</Replaceable> you chose.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) No copying is performed because of errors found in validation.
</computeroutput>
</literallayout>
<para>
means that 
<Command>dtdocbook2infolib admin</Command>
found a problem in the validation phase
and did not copy the bookcase into the destination
library. The problem may be version mismatch or
duplicate IDs.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Data version mismatch
   "    <Replaceable>checkBase</Replaceable> version = #
   "    <Replaceable>installBase</Replaceable> version = #
</computeroutput>
</literallayout>
<para>
means that
<Command>dtdocbook2infolib admin</command>
found a database version mismatch in the
bookcase you are copying (<Replaceable>checkbase</Replaceable>) and the bookcase
that exists in the information library (installed base).
Rebuild the bookcases with the same version of the build
tools.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Duplicate ID value [<Replaceable>ID</Replaceable>] found in <Replaceable>BookCaseName</Replaceable>
</computeroutput>
</literallayout>
<para>
means that
<Command>dtdocbook2infolib admin</Command>
found <Replaceable>ID</Replaceable> in the bookcase you are copying and in
<Replaceable>BookCaseName</Replaceable>, the bookcase into which you are
copying. All IDs must be unique. Change the ID value of
one of the sections in the SGML document and rebuild
the bookcases.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) The position you chose is not valid. Please
specify a valid position for the bookcase.
</computeroutput>
</literallayout>
<para>
means that the position you specified for a particular bookcase is out
of range. Please specify a valid position for the bookcase.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) Unable to remove <Replaceable>BookCaseName</Replaceable> from
<Replaceable>InfoLibPath</Replaceable>
</computeroutput>
</literallayout>
<para>
means that
<Command>dtdocbook2infolib admin</Command> was unable to remove bookcase
<Replaceable>BookCaseName</Replaceable> from the information library
<Replaceable>InfoLibPath</Replaceable>. Verify that you have the correct
permissions for changing this bookcase. It may be that this bookcase
does not exist in the information library, or the bookcase
path is not valid.
</Para>
<para>
The following error message:
</para>
<literallayout>
<computeroutput>
(ERROR) You have chosen an invalid number. Please specify a number 1-6.
</computeroutput>
</literallayout>
<para>
means that
you have chosen a number that is out of range.
</Para>
</sect1>
</Chapter>





