EPHWP00 (BookManager topic extraction)

To use man pages on z/OS® UNIX, you must have a SEPHTAB data set cataloged in your system. (See z/OS UNIX System Services Planning for information about cataloging the SEPHTAB data set.)

You must make the SEPHTAB data set name available to the BookRead service called by the "man" command. You do this with one of the following methods:

  1. Use the default data set EPH.SEPHTAB.
  2. Specify a non-default prefix of the SEPHTAB data set, right-justified on line one of the EPHWP00 member in SYS1.PARMLIB.
  3. Specify a non-default prefix of the SEPHTAB data set, right-justified on line one of the default HFS configuration file: /etc/booksrv/bookread.conf
  4. Specify a non-default prefix of the SEPHTAB data set, right-justified on line one of a NON-default HFS configuration file. Specify the non-default HFS configuration file by setting the EPHBookReadConfig environment variable to the HFS file name and path.
  5. Specify a data set containing the members of SEPHTAB but not ending in SEPHTAB by entering "DSN=MY.FB4096.DATA.SET" right-justified without the double quotation marks on line one of 'SYS1.PARMLIB(EPHWP00)'.
  6. Specify a data set containing the members of SEPHTAB but not ending in SEPHTAB by entering "DSN=MY.FB4096.DATA.SET" right-justified without the double quotation marks on line one of the default HFS configuration file: /etc/booksrv/bookread.conf
  7. Specify a data set containing the members of SEPHTAB but not ending in SEPHTAB by entering "DSN=MY.FB4096.DATA.SET" right-justified without the double quotation marks on line one of a non-default HFS configuration file. Specify the NON-default HFS configuration file by setting the EPHBookReadConfig environment variable.

To use man pages on z/OS UNIX, you must have a SEPHTAB data set cataloged in your system and an EPHWP00 member in SYS1.PARMLIB. The SEPHTAB data set contains translation tables used to translate data from the internal BookManager® softcopy format to the code page BookManager is being asked to display. (See z/OS UNIX System Services Planning for information about cataloging the SEPHTAB data set.)

A sample EPHWP00 parmlib member is provided in SEPHSAMP. To use man pages, you must copy that sample from SEPHSAMP into SYS1.PARMLIB.

A sample EPHWP00 parmlib member is provided in SEPHSAMP. To override the default EPH.SEPHTAB data set name, you must copy that sample from SEPHSAMP into the configuration file /etc/booksrv/bookread.conf or into SYS1.PARMLIB.

The sample EPHWP00 parmlib member contains a left-justified statement of "EPH". This is the IBM-supplied prefix for the SEPHTAB data set. If you change the prefix of the SEPHTAB data set, you must manually change this left-justified statement to match the prefix of the SEPHTAB data set. For example, if you used a prefix of ABC in the SEPHTAB data set, you must change the EPHWP00 parmlib member from "EPH" to "ABC".

If you do not change the prefix of the SEPHTAB data set, no changes are required to /etc/booksrv/bookread.conf or to the EPHWP00 parmlib member.