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.
| Element or feature: |
Library Server |
| When change was introduced: |
z/OS V2R1. |
| Applies to migration from: |
z/OS V1R13 and z/OS V1R12. |
| Timing: |
After the first IPL of z/OS V2R1. |
| 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:
- 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 "Prepare
InfoCenter Plugins" 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 "Receive
InfoCenter Plugins" 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 "Create
InfoCenter Search Index" to create the search index which enables
searching across all the plug-ins for the information center.
Reference information: For a complete description of each
parameter of the Library Server configuration files, see z/OS
Program Directory at z/OS installation related information.