511 lines
14 KiB
Plaintext
511 lines
14 KiB
Plaintext
<!-- $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— these errors can occur during the
|
|
<Command>dtinfogen build</Command>,
|
|
<Command>dtinfogen tocgen</Command>, and
|
|
<Command>dtinfogen update</Command> processes.
|
|
</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>
|
|
Style Sheet Errors— these errors can occur during the
|
|
<Command>dtinfogen build</Command> or the
|
|
<Command>dtinfogen update</Command> processes.
|
|
</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>
|
|
Library Administration Errors— these errors occur
|
|
during the <Command>dtinfogen admin</Command> process.
|
|
</Para>
|
|
</ListItem>
|
|
</ItemizedList>
|
|
|
|
<Para>
|
|
For more information, see <filename>dtinfogen(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>dtinfogen build</Command>,
|
|
<Command>dtinfogen tocgen</Command>, or
|
|
<Command>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>
|
|
|
|
|
|
|
|
|
|
|