<!-- $XConsortium: ch05.sgm /main/4 1996/10/11 09:23:56 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.5">
<Title id="B7XKbKBcgmg24aK">Administering Bookcases</title>
<IndexTerm><Primary>information libraries</Primary>
<Secondary>bookcase administration</Secondary></IndexTerm>
<Para>
After building bookcases into an information library, you can
perform several administrative functions on the bookcases that
make up the library without having to rebuild them. Specifically,
you can:
</Para>
<ItemizedList>
<ListItem>
<Para><Link Linkend="K7XKbKBcgmg24aK">Copy bookcases from another library</Link></Para>
</ListItem>
<ListItem>
<Para><Link Linkend="B8XKbKBcgmg24aK">Remove bookcases from a library</Link></Para>
</ListItem>
<ListItem>
<Para><Link Linkend="M8XKbKBcgmg24aK">List the bookcases in a library</Link></Para>
</ListItem>
<ListItem>
<Para><Link Linkend="n0cWdbKB-zmg24aK">Rename bookcases in a library</Link></Para>
</ListItem>
<ListItem>
<Para><Link Linkend="vbWdbKB-zmg24aK">Rearrange bookcases in a library</Link></Para>
</ListItem>
</ItemizedList>
<Para>
See also
<Link Linkend="n7Ktl2IBUXmBt8oL">Adding a Bookcase to an Existing Library</Link>.
</Para>
<!--(((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<Title id="n01cq1dBePI9X3cS">Running dtdocbook2infolib admin</Title>
<IndexTerm><Primary>Information Manager Toolkit</Primary><Secondary>commands</Secondary>
<Tertiary>dtdocbook2infolib admin</Tertiary></IndexTerm>
<Para>
<command>dtdocbook2infolib admin</command>
is an interactive program that displays a menu
from which you select the administrative operation you want to
perform. To run the <Command>dtdocbook2infolib admin</Command> command,
on the command line type:
</Para>
<ProgramListing>
<UserInput>dtdocbook2infolib admin</UserInput>
</ProgramListing>
<Para>
When you press enter, the following menu appears.</Para>
<LiteralLayout>
1) Copy a bookcase from another library
2) Remove a bookcase
3) List bookcases in a library
4) Rename a bookcase
5) Rearrange bookcases in a library
6) Exit
Please enter your choice [1-6]
</LiteralLayout>
</sect1>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<Title id="K7XKbKBcgmg24aK">Copying Bookcases from Another Library</Title>
<IndexTerm><Primary>information libraries</Primary><Secondary>copying bookcases between</Secondary></IndexTerm>
<IndexTerm><Primary>bookcases</Primary><Secondary>copying from another library</Secondary></IndexTerm>
<Para>
When you copy a bookcase from another library,
<command>dtdocbook2infolib admin</command>
validates the bookcase you are copying against the bookcases in
the destination library. This ensures that no section IDs are
duplicated within the library, and that the database versions are
compatible with each other.
</Para>
<Para>
If the bookcase you want to copy already exists in the destination
library, <Command>dtdocbook2infolib admin</Command> asks whether you wish to replace the
bookcase.
</Para>
<Para>
To copy a bookcase from another library:
</Para>
<OrderedList>
<ListItem>
<Para>At a command line, enter <UserInput>dtdocbook2infolib admin</UserInput>.
</Para>
<Para>
The following menu appears:
</Para>
<LiteralLayout>
1) Copy a bookcase from another library
2) Remove a bookcase
3) List bookcases in a library
4) Rename a bookcase
5) Rearrange bookcases in a library
6) Exit
Please enter your choice [1-6]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>On the command line, enter <UserInput>1</UserInput>.
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
Enter the path for the library from which you want to copy a bookcase.
This can be a relative or absolute path.
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
Enter the path to the information library from which you
want to copy a bookcase. For example: <UserInput>/lit/wolfe</UserInput>
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays the bookcases available in the
library you specified. For example:
</Para>
<LiteralLayout>
The bookcases available in /lit/wolfe are:

 1) Life [Life Works]
 2) Essays [Essays from Life]
 3) Poems [Collections of Poems]

Enter the number associated with the bookcase you want to copy.
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
At the prompt, enter the number corresponding to the
bookcase you want to copy. <command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
You specified <Replaceable>[Life]</Replaceable>. Do you really want to copy this bookcase?
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
To copy the bookcase you specified, enter
<UserInput>Y</UserInput> (you can use
an uppercase or lowercase character).
</Para>
</ListItem>
<ListItem>
<Para>
Enter the path to the information library to which you
want to copy the bookcase. For example:
<UserInput>/lit/destiny</UserInput>
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays the bookcases available in the
library you specified:
</Para>
<LiteralLayout>
The bookcases available in /lit/destiny are:

 1) Child [School Days]
 2) Reports [Reports from School]

Bookcases appear in the browser Book List in the order listed here.
Enter the number corresponding to the position you want bookcase to occupy [1-2].
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
Enter the number corresponding to the position you want
the bookcase to occupy.
</Para>
<Para>
If another bookcase already occupies the position you
choose, the bookcase you are copying takes its place, and
the original bookcase moves down one place in the list.
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays the new order of the bookcases in
the library. For example:
</Para>
<LiteralLayout>
You specified this order for the bookcases:

 1) Child [School Days]
 2) Reports [Reports from School]
 3) Life [Life Works]

Is this correct? [ynq]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
To copy the bookcase into this position, enter
<UserInput>Y</UserInput>. <command>dtdocbook2infolib admin</command> saves the addition to the library and returns
to the main menu.
</Para>
</ListItem>
</OrderedList>
</sect1>

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

<sect1>
<Title id="B8XKbKBcgmg24aK">Removing Bookcases from a Library</Title>
<IndexTerm><Primary>information libraries</Primary><Secondary>removing bookcases from</Secondary></IndexTerm>
<IndexTerm><Primary>bookcases</Primary><Secondary>removing from a library</Secondary></IndexTerm>
<Para>
The procedure for removing a bookcase with <command>dtdocbook2infolib
admin</command> is similar to the procedure for copying a bookcase into
a library. When you remove a bookcase from a library, its database is
deleted from the information library.
</Para>
<Para>
When you specify the library to work with, <Command>dtdocbook2infolib
admin</Command> lists the bookcases found in that library. You simply
specify the bookcase to remove. If the information you supply is valid,
<Command>dtdocbook2infolib admin</Command> prompts you for confirmation before
removing the bookcase you specified.
</Para>
<Para>
To remove a bookcase from a library:
</Para>
<OrderedList>
<ListItem>
<Para>
At a command line, enter <UserInput>dtdocbook2infolib admin</UserInput>.
</Para>
<Para>
The following menu appears.
</Para>
<LiteralLayout>
1) Copy a bookcase from another library
2) Remove a bookcase
3) List bookcases in a library
4) Rename a bookcase
5) Rearrange bookcases in a library
6) Exit
Please enter your choice [1-6]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>To remove a bookcase, enter <UserInput>2</UserInput>.
</Para>
<Para>
<Command>dtdocbook2infolib admin</Command> displays:
</Para>
<LiteralLayout>
Enter the path for the library from which you want to remove a bookcase.
This can be a relative or absolute path.
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
Enter the path to the information library from which you
want to remove the bookcase. For example: <UserInput>/lit/wolfe</UserInput>.
</Para>
<Para>
<Command>dtdocbook2infolib admin</Command> displays the bookcases available in the
library you specified:
</Para>
<LiteralLayout>
The bookcases available in /lit/wolfe are:

1) Life [Life Works]
2) Essays [Essays from Life]
3) Poems [Collections of Poems]

Enter the number corresponding to the bookcase to remove.
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
At the prompt, enter the number corresponding to the
bookcase you want to remove.
<Command>dtdocbook2infolib admin</Command> displays:
</Para>
<LiteralLayout>
You specified <Replaceable>[Essays]</Replaceable>. Do you really want to remove this bookcase?
</LiteralLayout>
</ListItem>
<ListItem>
<Para>To remove the bookcase you specified, enter <UserInput>Y</UserInput>.
<Command>dtdocbook2infolib admin</Command> removes the bookcase and returns to the
main menu.
</Para>
</ListItem>
</OrderedList>
</sect1>
<!--((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((-->
<sect1>
<Title id="M8XKbKBcgmg24aK">Listing the Bookcases in a Library</Title>
<IndexTerm><Primary>information libraries</Primary><Secondary>listing bookcases in</Secondary></IndexTerm>
<IndexTerm><Primary>bookcases</Primary><Secondary>listing for a library</Secondary></IndexTerm>
<Para>
In trying to identify the library to work with, you may want to
list the bookcases in a library.
</Para>
<Para>
To list bookcases in a library:
</Para>
<OrderedList>
<ListItem>
<Para>At a command line, enter
<UserInput>dtdocbook2infolib admin</UserInput>.
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays:</Para>
<LiteralLayout>
1) Copy a bookcase from another library
2) Remove a bookcase
3) List bookcases in a library
4) Rename a bookcase
5) Rearrange bookcases in a library
6) Exit
Please enter your choice [1-6]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
To list a bookcase, enter <UserInput>3</UserInput>.
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays:</Para>
<LiteralLayout>
Enter the path for the library for which you want to list bookcases.
This can be a relative or absolute path.
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
Enter the path to the information library for which you
want to list bookcases. For example: <UserInput>/lit/wolfe</UserInput>.
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays the bookcases available in the
library you specified. For example:
</Para>
<LiteralLayout>
The bookcases available in /lit/wolfe are:

 1) Life [Life Works]
 2) Essays [Essays from Life]
 3) Poems [Collections of Poems]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
After listing the bookcases in the information library, <command>dtdocbook2infolib admin</command>
returns you to the main menu.
</Para>
</ListItem>
</OrderedList>
</sect1>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))))))-->

<sect1>
<Title id="n0cWdbKB-zmg24aK">Renaming Bookcases in a Library</Title>
<IndexTerm><Primary>information libraries</Primary><Secondary>renaming bookcases in</Secondary></IndexTerm>
<IndexTerm><Primary>bookcases</Primary><Secondary>renaming in a library</Secondary></IndexTerm>
<Para>
You can change the bookcase names that the browser displays in
the Information Manager Book List. To rename a bookcase:
</Para>
<OrderedList>
<ListItem>
<Para>
At a command line, enter <UserInput>dtdocbook2infolib admin</UserInput>.
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
1) Copy a bookcase from another library
2) Remove a bookcase
3) List bookcases in a library
4) Rename a bookcase
5) Rearrange bookcases in a library
6) Exit
Please enter your choice [1-6]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
To rename a bookcase, enter <UserInput>4</UserInput>.
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
Enter the path for the library containing the bookcase you want to rename.
This can be a relative or absolute path.
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
Enter the path to the information library you want to
rename. For example: <UserInput>/lit/wolfe</UserInput>.
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays the bookcases available in the
library you specified:
</Para>
<LiteralLayout>
The bookcases available in /lit/wolfe are:

 1) Life [Life Works]
 2) Essays [Essays from Life]
 3) Poems [Collections of Poems]

Enter the number corresponding to the bookcase you want to rename.
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
At the prompt, enter the number corresponding to the
bookcase you want to rename. <command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
You specified <Replaceable>[Poems]</Replaceable>. Do you really want to rename the bookcase?
</LiteralLayout>
</ListItem>
<ListItem>
<Para>To rename the bookcase you specified, enter <UserInput>Y</UserInput>.
<command>dtdocbook2infolib admin</command> asks you to enter the new title for the
bookcase:
</Para>
<LiteralLayout>
Enter the new title for <Replaceable>[Poems]</Replaceable>.
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
Enter the new title for the bookcase.
<command>dtdocbook2infolib admin</command> displays the new title:
</Para>
<LiteralLayout>You entered <Replaceable>[Old Poems]</Replaceable>. Is this title correct?
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
To accept the new title, enter <UserInput>Y</UserInput>.
<command>dtdocbook2infolib admin</command> saves the
new title and returns to the main menu.
</Para>
</ListItem>
</OrderedList>
</sect1>
<!--)))))))))))))))))))))))))))))))))))))))))))))))))))))))))))-->
<sect1>
<Title id="vbWdbKB-zmg24aK">Rearranging Bookcases in a Library</Title>
<IndexTerm><Primary>information libraries</Primary><Secondary>rearranging bookcases in</Secondary></IndexTerm>
<IndexTerm><Primary>bookcases</Primary><Secondary>rearranging in a library</Secondary></IndexTerm>
<Para>
After you have built a library, you may find that you want to
display the bookcases in a different order in the Information Manager Book List.
Or, you may have added a bookcase using
<Command>dtdocbook2infolib build</Command>, and
want to move it to a different position. You can use
<Command>dtdocbook2infolib admin</Command> to
change the order of bookcases in a library.
</Para>
<Para>
To rearrange bookcases within a library:
</Para>
<OrderedList>
<ListItem>
<Para>
At a command line, enter <UserInput>dtdocbook2infolib admin</UserInput>.
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
1) Copy a bookcase from another library
2) Remove a bookcase
3) List bookcases in a library
4) Rename a bookcase
5) Rearrange bookcases in a library
6) Exit
Please enter your choice [1-6]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
To rearrange bookcases within a library, enter <UserInput>5</UserInput>.
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
Enter the path for the library you want to rearrange.
This can be a relative or absolute path.
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
Enter the path to the information library you want to
rearrange. For example: <UserInput>/lit/wolfe</UserInput>.
</Para>
<Para>
<command>dtdocbook2infolib admin</command> displays the bookcases available in the
library you specified:
</Para>
<LiteralLayout>
The bookcases available in /lit/wolfe are:

1) Life [Life Works]
2) Essays [Essays from Life]
3) Poems [Collections of Poems]

Enter the number corresponding to the bookcase you want to move.
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
At the prompt, enter the number corresponding to the
bookcase you want to move. <command>dtdocbook2infolib admin</command> displays:
</Para>
<LiteralLayout>
You specified <Replaceable>[Poems]</Replaceable>. Do you really want to move this bookcase?
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
To move the bookcase you specified to a different position
in the library, enter <UserInput>Y</UserInput>.
<command>dtdocbook2infolib admin</command> displays the current
order of the library without the bookcase you selected to
move. For example:
</Para>
<LiteralLayout>
The order of the bookcase without [Poems] is:

1) Life [Life Works]
2) Essays [Essays from Life]

Bookcases appear in the browser Book List in the order listed here.
Enter the number corresponding to the position you want bookcase to occupy.
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
Enter the number corresponding to the position you want
the bookcase to occupy.
</Para>
<Para>
If another bookcase already occupies the position you
choose, the bookcase you are moving takes its place, and
the original bookcase moves one place down in the list.
</Para>
<Para>
<Command>dtdocbook2infolib admin</Command> displays the new order of the bookcases in
the library. For example:
</Para>
<LiteralLayout>
You specified this order for the bookcases:

 1) Poems [Collections of Poems]
 2) Life [Life Works]
 3) Essays [Essays from Life]

Is this correct? [ynq]
</LiteralLayout>
</ListItem>
<ListItem>
<Para>
To accept the rearranged order, enter <UserInput>Y</UserInput>.
<Command>dtdocbook2infolib admin</Command> saves
the new order and returns to the main menu.
</Para>
</ListItem>
</OrderedList>
</sect1>
</Chapter>

