580 lines
17 KiB
Plaintext
580 lines
17 KiB
Plaintext
<!-- $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>
|
|
|