Installing IBM z/OS Extraction Utilities

To extract z/OS data or disks for usage in the Wazi Image Builder, you need to install the IBM z/OS Extraction Utilities (referred to as the Utilities in this page) on the source z/OS systems. The z/OS system programmer is responsible for this task.

For instructions or more information about source environment types, see section Adding source environments.

The Utilities bundled with this product, are to be installed on one or more z/OS source environments to extract z/OS® resources.

Install and configure the Utilities by following these steps:
  1. Get the host component from Passport Advantage.
  2. After downloading the host installation package, unzip the downloaded package.
  3. Send ./HALMF10/HALMF10.pax.Z (in binary mode) and ./HALMF10/HALMF10.readme.txt (in text mode) to a USS folder of your source z/OS.
  4. Tailor and submit the HALMF10.readme.txt.
  5. Follow the installation instructions in the program directory (./HALMF10/HALMF10.htm or ./HALMF10/HALMF10.pdf available in the downloaded package) for the Utilities, starting from step 6.1.8 Create SMP/E environment.
  6. After installation, configure the Utilities by following these steps:
    1. The SFEUAUTH library must be marked APF-authorized.
    2. It is advised to enable automatic ASCII-EBCDIC conversion for your users. For example, by updating /etc/profile with
      export _BPXK_AUTOCVT=ON
export _CEE_RUNOPTS='FILETAG(AUTOCVT,AUTOTAG) POSIX(ON)'
    3. Share the following information with the Linux administrator that sets up Wazi Image Builder:
      • z/OS host name
      • SSH port number (default 22)
      • Installation directory of the Utilities (default /usr/lpp/IBM/odtz)
    Note: To use z/OS Extraction Utilities from ZD&T or ODTz 1.0.0.x, you need to make the following changes to the source z/OS system, by modifying the script feuc under /usr/lpp/IBM/odtz to point to the specific installation directory of z/OS Extraction Utilities and authorized LoadLib.

    For example: STEPLIB=FEU02.SFEUAUTH /usr/lpp/IBM/odtz/feucli "$@".

Note:
  • Ensure that you have write access to the /tmp directory in the source z/OS UNIX System Services, because the Utilities will write a lot of logs into it. According to best practices, clean this folder periodically.