Step 1: Prepare to install HLASM Toolkit Feature

Edit online
Carry out the following preparatory tasks:
  1. Log on as the HLASM Toolkit Feature installer planner, typically the MAINT user ID. IBM® recommends that you use P696234K as the product installation user ID.

    Normally, the MAINT user ID is used for the planning and setup for HLASM Toolkit Feature, then the P696234K user ID is used to install the product.

    However, you can log on as any user ID that has read access to MAINT's 5E5 minidisk and write access to the MAINT 51D minidisk.

  2. Make the installation media available.

    If you are installing from tape, attach the tape to the user ID at virtual address 181. Using virtual address 181 is required by the VMFINS EXEC.

    If you have received HLASM Toolkit Feature as an Envelope file, ensure the Envelope file exists on the A-disk, or any disk accessed as C.

  3. Establish read access to VMSES/E, using the following command:
  4. Establish write access to the software inventory disk.

    If another user already has the software inventory disk linked in write mode (R/W), you are not allowed to link to that disk in write mode. The other user must relink to the software inventory disk in read-only mode, then you can try the above procedure again.

    The VMSES/E system-level software inventory and other dependent files reside on the MAINT 51D disk.

    You cannot proceed with the installation procedure until you have write access to the software inventory disk.

  5. Load the HLASM Toolkit Feature product control files onto the software inventory disk.

    If you are installing from tape:

    If you are installing from an Envelope file:

    This command will:
    • Load the Memo-to-Users file
    • Load the product control files including the Product Parameter File (PPF) and the PRODPART files
    • Create VMFINS PRODLIST on your A-disk. The VMFINS PRODLIST contains a list of products on the installation tape.
    Options:
    filename
    The name of your Envelope file, for example, P696234K.
    nomemo
    Loads the memo but does not issue a prompt to send it to the system printer. Specify the memo option if you want to be prompted to print the memo.
  6. Obtain the resource planning information.

    If you are installing from tape:

    If you are installing from an Envelope file:

    Note: This command does not load HLASM Toolkit Feature.

    Options:

    filename
    The name of your Envelope file, for example, P696234K.
    nomemo
    Loads the memo but does not issue a prompt to send it to the system printer. Specify the memo option if you want to be prompted to print the memo.
    plan
    VMFINS performs requisite checking, plans system resources, and provides an opportunity to override the defaults in the product parameter file.
    HLASM|HLASMSFS
    This command creates the P696234K PLANINFO file on your A disk.
    • Use HLASM if HLASM Toolkit Feature is to be installed on a minidisk.
    • Use HLASMSFS if HLASM Toolkit Feature is to be installed in SFS.

    You are prompted to change the installation defaults with message VMFINS2601R. You can override:

    • You can override:
      • The name of the product parameter file
      • The default user IDs
      • Minidisk⁄directory definitions
    • If you change the PPF name, a default user ID, or other parameters via a PPF override, you must use your changed values instead of those indicated (when appropriate), throughout the rest of the installation instructions, as well as the instructions for servicing HLASM Toolkit Feature. For example, you must specify your PPF override file name instead of P696234K for certain VMSES/E commands.
    • If you are not familiar with creating PPF overrides using VMFINS, refer to z/VM: VMSES/E Introduction and Reference before you continue. Also see Create Product Parameter File (PPF) override (z/VM).
  7. Review the install message log file

    Review the install message log ($VMFINS $MSGLOG). If necessary, correct any problems before going on. For information about specific error messages, see z/VM: Other Components Messages and Codes.