Copy Library Server configuration files

Description

The Library Server configuration files (bookmgr.80, booksrv.80) contain information about your environment and preferences. The information in bookmgr.80 includes the names of bookshelf lists for bookshelves in z/OS data sets and the names of the file system directories that Library Server reads and writes during execution. The information in booksrv.80 includes the file system directory names of book collections, shelves, and bookcases, as well as product option settings configured via the Library Server Administration Page. There are default values but normally you would customize them. In order to bring the customized values over to your new system, you have to copy them. (Note that port number suffix .80, used in bookmgr.80 and booksrv.80, is an example. Your port number suffix might be different.)

Table 1 provides more details about this migration action. Use this information to plan your changes to the system.

Table 1. Information about this migration action
Element or feature: Library Server.
When change was introduced: General migration action not tied to a specific release.
Applies to migration from: z/OS V2R1 and z/OS V1R13.
Timing: Before the first IPL of z/OS V2R2.
Is the migration action required? Yes, if you intend to preserve your Library Server configuration.
Target system hardware requirements: None.
Target system software requirements: None.
Other system (coexistence or fallback) requirements: None.
Restrictions: None.
System impacts: None.
Related IBM® Health Checker for z/OS® check: None.

Steps to take

Copy your current (customized) configuration files, usually bookmgr.80 and booksrv.80, to your new system and add any configuration parameters that are new since the z/OS release from which you are migrating. Otherwise Library Server will run with default values, not the values you're used to. A suggested (but not required) place for these configuration files is /etc/booksrv. Library Server will also search /etc and the original cgi-bin for them. If you place the files in any other directory, use the EPHConfigPath environment variable to tell Library Server where to find them.

Reference information

For description of each parameter of the Library Server configuration files, see z/OS Program Directory at the z/OS installation related information website.