CDE/cde/doc/C/guides/infoAPg/ch05.sgm

<!-- $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 dtinfogen admin</Title>
<IndexTerm><Primary>Information Manager Toolkit</Primary><Secondary>commands</Secondary>
<Tertiary>dtinfogen admin</Tertiary></IndexTerm>
<Para>
<command>dtinfogen 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>dtinfogen admin</Command> command,
on the command line type:
</Para>
<ProgramListing>
<UserInput>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen
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>dtinfogen
admin</Command> lists the bookcases found in that library. You simply
specify the bookcase to remove. If the information you supply is valid,
<Command>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen admin</UserInput>.
</Para>
<Para>
<command>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen admin</UserInput>.
</Para>
<Para>
<command>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen build</Command>, and
want to move it to a different position. You can use
<Command>dtinfogen 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>dtinfogen admin</UserInput>.
</Para>
<Para>
<command>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen 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>dtinfogen admin</Command> saves
the new order and returns to the main menu.
</Para>
</ListItem>
</OrderedList>
</sect1>
</Chapter>