Reconfigure Library Server information centers
Description
Starting with z/OS V2R1, the Library Server element requires the Location value (ICPATH=) value of InfoCenters to be configured differently than it was in the past. Thus, for any existing information center configurations migrated from the previous version, you must delete, configure, and process the configured information centers.
Table 1 provides more details about this migration action. Use this information to plan your changes to the system.
| Element or feature: | Library Server |
|---|---|
| When change was introduced: | z/OS V2R1. |
| Applies to migration from: | z/OS V1R13. |
| Timing: | After the first IPL of z/OS V2R2. |
| Is the migration action required? | Yes, if you intend to preserve configured information centers from the previous version |
| 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
Follow these steps:
- Migrate your current customized booksrv.80 as described in Description.
- Configure and start you HTTP server as required for Library Server as described in the z/OS Program Directory.
- Using the Library Server Administrative Interface, delete any existing information center configuration entries.
- Using the Library Server Administrative Interface, configure (that is, create new) each deleted information center, using for its Locationfield the fully qualified root plugin directory name, or jar file name, of the information center. (Note that the root plugin is a child of the information center parent directory and is typically distinguishable as the plug-in that contains the plugin_customization.ini file for the information center.)
- Using the Library Server Administrative Interface for managing information centers, for each configured information center, use the Prepare InfoCenter Plugins function to prepare its plug-ins for subsequent creation of the information center search index.
- Using the Library Server Administrative Interface for managing information centers, for each configured information center, use the Receive InfoCenter Plugins function to copy/catalog all the prepared information center plug-in objects (for example, TOC files and plug-in card files) into the Library.
- Using the Library Server Administrative Interface for managing information centers, for each configured information center, use the Create InfoCenter Search Index function to create the search index which enables searching across all the plug-ins for the information center.
Reference information
For a description of each parameter of the Library Server configuration files, see z/OS Program Directory at z/OS installation related information.