CONTENTS

  Title Page

  Copyright Page

  Preface

  1      Introduction

  1.1     Product Kits
    1.1.1      Files Included in a Product Kit
    1.1.2      Building a Product Kit

  1.2     VMSINSTAL Functional Overview

  1.3     Invoking VMSINSTAL

  1.4     Choosing VMSINSTAL Options
    1.4.1      Installer's Options
    1.4.2      Developer's Options

  1.5     Safety Mode

  1.6     Recovery from System Failure

  2      Guidelines and Conventions

  2.1     Product Identification String

  2.2     Save Set Identification

  2.3     Volume Labeling
    2.3.1      Diskette Kits
    2.3.2      TU58 Cartridge Kits
    2.3.3      Magnetic Tape Kits

  2.4     Logical Names and Global Symbols

  2.5     Error Handling

  2.6     Compatibility Mode

  2.7     Referencing Other Products

  2.8     Changing Global State

  2.9     Verifying Installation

  2.10    Prompting the Installer for Input

  2.11    Internationalization of VMSINSTAL Messages

  2.12    Release Notes

  3      The KITINSTAL Command Procedure

  3.1     Guidelines for Writing a KITINSTAL Command Procedure
    3.1.1      Installation Phase
    3.1.2      IVP Phase

  3.2     Using Callbacks
    3.2.1      Accessing Files
    3.2.2      Moving Files from the Kit's Working Directory
    3.2.3      Updating Files
      3.2.3.1      Updating an Existing File Version
      3.2.3.2      Updating a File by Creating a New Version
    3.2.4      Updating a Library
    3.2.5      Deleting a File
    3.2.6      Creating a Directory

  3.3     Summary of KITINSTAL Design Specifications

  3.4     A Basic KITINSTAL Command Procedure

  4      VMSINSTAL Functional Description

  4.1     Overview

  4.2     Functional Steps
    4.2.1      Step 1
    4.2.2      Step 2
    4.2.3      Step 3
    4.2.4      Step 4
    4.2.5      Step 5
    4.2.6      Step 6
    4.2.7      Step 7
    4.2.8      Step 8
    4.2.9      Step 9
    4.2.10     Step 10
    4.2.11     Step 11
    4.2.12     All Done

  4.3     Special Steps
    4.3.1      Step 12
    4.3.2      Step 13

  5      VMSINSTAL Callbacks

  5.1     ADD_IDENTIFIER Callback

  5.2     ASK Callback

  5.3     CHECK_NETWORK Callback

  5.4     CHECK_NET_UTILIZATION Callback

  5.5     CHECK_PRODUCT_VERSION Callback

  5.6     CHECK_VMS_VERSION Callback

  5.7     COMPARE_IMAGE Callback

  5.8     CONTROL_Y Callback

  5.9     CREATE_ACCOUNT Callback

  5.10    CREATE_DIRECTORY Callback
    5.10.1     Creating a System Directory
    5.10.2     Creating a System-Specific Directory
    5.10.3     Creating a Common Directory
    5.10.4     Creating a User Directory

  5.11    DELETE_FILE Callback

  5.12    FIND_FILE Callback

  5.13    GET_IMAGE_ID Callback

  5.14    GET_PASSWORD Callback

  5.15    GET_SYSTEM_PARAMETER Callback

  5.16    MESSAGE Callback

  5.17    PATCH_IMAGE Callback

  5.18    PRINT_FILE Callback

  5.19    PRODUCT Callback

  5.20    PROVIDE_DCL_COMMAND Callback

  5.21    PROVIDE_DCL_HELP Callback

  5.22    PROVIDE_FILE Callback

  5.23    PROVIDE_IMAGE Callback

  5.24    RENAME_FILE Callback

  5.25    RESTORE_SAVESET Callback

  5.26    RUN_IMAGE Callback

  5.27    SECURE_FILE Callback

  5.28    SET Callback
    5.28.1     SET ACL Option
    5.28.2     SET ASK_CASE Option
    5.28.3     SET IVP Option
    5.28.4     SET POSTINSTALL Option
    5.28.5     SET PURGE Option
    5.28.6     SET REBOOT Option
    5.28.7     SET SAFETY Option
    5.28.8     SET SHUTDOWN Option
    5.28.9     SET STARTUP Option

  5.29    SUMSLP_TEXT Callback

  5.30    TELL_QA Callback

  5.31    UNWIND CALLBACK

  5.32    UPDATE_ACCOUNT Callback

  5.33    UPDATE_FILE Callback

  5.34    UPDATE_IDENTIFIER Callback

  5.35    UPDATE_LIBRARY Callback

  A   Symbols and Logical Names

  B   Sample Installation Procedure

  C   Product-Specific Callback Conventions

  D   How to Use the VMI$VMS_VERSION Symbol

  E   Product Registration

  EXAMPLES

  3-1        A Basic KITINSTAL.COM

  B-1        Sample KITINSTAL.COM

  C-1        Product-Specific Callback Procedure

  D-1        A Template for Using the VMI$VMS_VERSION Symbol