*------------------------------------------------------------------------------*
* R/390 VSE/ESA Version 2.3.0 CD-ROM                                   12/8/97
*
*  Special Notes for R/390 install under AIX.
*                                                                 Carmine Castaldo
*                                                                PKEDVM9 (CASTALDO)
*                                                           ccastaldo@vnet.ibm.com
*                                                              UBIB5F73 at IBMMAIL
*
* c Copyright International Business Machines Corporation 1996
*   Licenced Material - Program Property of IBM. All rights Reserved.
*------------------------------------------------------------------------------*

Please read the README.VSE that is in the /vse subdirectory on this
CD-ROM.  That file was written mostly from an OS/2 install viewpoint.
Here are some of the differences for an R/390 AIX install:

Subdirectory names
==================

OS/2 subdirectory    AIX name
-----------------    --------
d:\VSE               /vse/vseesa
d:\P390              /usr/bin/r390

Printer LPT1:        /dev/lp0  | Note: The printer output can also be redirected to an
                               |       AIX file (e.g. /tmp/printer.00e). If you want it to
                               |       go to a real device, you must first define one in AIX.

4mm DAT tape         /dev/rmt0


Prerequisites
=============

1. Before running any of the install program on this CD you MUST already
   have installed the R/390 Program code and L.I.C. code.  We urge you to
   install the latest version of this code.

2. You must create and mount a CD-ROM file system. You can use SMIT to
   do this.  As an example, we will assume the mount point is /cdrom

3. You must have sufficient hard disk space (approximately 1 GB) on a
   physical volume (e.g. hdisk2) that is NOT assigned to a volume group.

4. You cannot have a existing volume group or mount point called /vse,
   unless it contains an older version that you wish to overlay.


Running the Install
===================

The OS/2 VSE install is called INSTALL.CMD and is located in the root of
this CD-ROM.  The AIX VSE install is a program called "insvse", is located
in the /aix/ subdirectory on the CD-ROM, and can be executed directly from
the CD as follows:

1. Open an AIXTERM window, stretch it vertically to a maximum size,
   and from the AIX prompt type:
        cd /cdrom/aix
        ./insvse
   Follow the instructions given on the screen.

2. After the VSE install completes, you must set the default DEVMAP.

   The DEVMAP file /aix/devmap.vse was copied from the CD-ROM to your
   AIX system as /vse/vseesa/devmap.vse

   Have your System Administrator update the file /etc/environment as follows:
     - Append the path  :/usr/bin/r390  to the PATH= statement.
     - Add the statement  CONFIG_FILE=/vse/vseesa/devmap.vse

   You must logout and then login for this change to take effect.

3. From an AIXTERM window type:
        cd /usr/bin/r390
        r390 &
   to bring up the R/390 Main Menu.  Then click on the IPL P/390 icon
   to IPL the VSE/ESA operating system that you just installed.


Alternate Installation Method
=============================

The above installation requires that you have an empty volume available
(not assigned to any AIX volume group).  If VM/ESA was already installed
(e.g. from the pre-configured CD) and you want to install VSE/ESA in
addition, this may cause a problem because you may not have empty volumes
or you want to install to the same physical drive(s) as VM/ESA.  In this
case you can not use the VSE/ESA install process from the CD.  However,
you can just unzip the volumes for VSE/ESA (DOSRES & SYSWK1) from CD to
the volume group used by VM/ESA. Type "unzip" for help on this command.