2 Preparing for Installation

This chapter describes the VM Client installation package and its pre-installation requirements. It includes the following topics:

IBM VMSES/E

VM Client is installed using IBM's VMSES/E (Virtual Machine Serviceability Enhancements Staged/Enhanced), included as part of IBM VM/ESA.

Refer to the IBM publication VMSES/E Introduction and Reference for information about VMSES/E operation.

VM Client Installation Package

The VM Client installation package includes a VM Client installation ZIP file or CD-ROM (SERVLINK envelope) containing VM Client software.

As part of the installation, you must obtain and install the latest VM Client cumulative maintenance (PTFs and HOLDDATA).

Note:

PTFs and HOLDDATA may not exist at ELS release launch but will follow in time and are released monthly to MOS.

Download cumulative maintenance from the My Oracle Support (MOS) site:

http://www.myoraclesupport.com

Visit this site frequently for HOLDDATA and PTF updates and install cumulative maintenance updates on a regular schedule. PTFs are released monthly to MOS.

See Chapter 4, "Installing VM Client Maintenance" for information about installing ELS cumulative maintenance.

VM Client Installation Contents

Table 2-1 lists the files or SERVLINK groups included in the VM Client installation ZIP file or CD-ROM:

Table 2-1 VM Client Installation Media Contents

CD-ROM SERVLINK Group	Description
1	Header
2	Header
3	`VSMC730A` (Product Identifier File)
4	`VSMC730A MEMO` (Memo to Users)
5	Service Apply Lists (`AXLIST`)
6	`PARTLIST`s
7	Service (`DELTA`)
8	Service (`APPLY`)
9	Base Code (`BASE`)
10	Help Files (`HELP`)

Software and Hardware Requirements

VM Client software and hardware requirements are as follows:

Software Requirements

Operating System: Any IBM supported version of IBM z/VM

Independent Software Vendor Products (optional):

ACF/VTAM
CA-DYNAM/TLMS for z/VM
DFSORT
EPIC VSE
Multi-Image Manager (MIM)
SYNCSORT
VM:Tape (see "Application Program Interface Verification" below)
IBM Tape Manager for z/VM

Hardware Requirements

VM Client requires an IBM or compatible processor capable of running IBM z/VM (any IBM supported version).

MVS Requirements

VM Client communicates with a StorageTek TapePlex server executing on MVS. This server is managed by Oracle's StorageTek ELS software including SMC, HSC, and optionally, VTCS.

VM Client requires that all ELS software be at release 7.1 or later.

Refer to the publication Installing ELS for information about ELS hardware and software requirements.

Application Program Interface Verification

If you use VM:Tape as your tape management system, ensure that VM:Tape release 1.8 or later is installed.

Additionally, you must use the VM Client AUTHorize command to add VM:Tape to the VM Client authorized operators list. See "AUTHorize".

If any other tape management system is currently installed, you may need to write special routines to communicate with the VM Client. See Chapter 9, "VM Client Tape Management Interface" for more information about the interface to tape management systems, including recommended allocation and message processing, commands and responses, data areas, and interrupt handling required to communicate with the TapePlex.

DASD Storage and User ID Requirements

VM Client requires you to add both the VM Client installation user ID and VM Client service machine user ID to your VM directory. The requirements of these user IDs are further defined during the VM Client installation process.

The default VM Client installation user ID is VSMC730A. It is recommended that you use this default user ID to install and service VM Client.

If you choose to change the name of the VM Client installation user ID, you must create a Product Parameter Override (PPF). See "Creating a PPF Override File" for more information.

Table 2-2 describes the VSMC730A minidisk layout:

Table 2-2 VSMC730A Minidisk Layout

Owner (User ID)	Default Address	Size (3390 Cyl)	Disk Name and Description
`VSMC30A`	2B2	20	`BASE` Contains all VM Client base code
`VSMC30A`	2C2	5	`LOCALSAM` Contains customization files.
`VSMC30A`	2D2	20	`DELTA` Contains services files.
`VSMC30A`	2A6	10	`APPLY TEST` Contains AUX files and software inventory tables that represent the test service level of VM Client.
`VSMC30A`	2A2	10	`APPLY PRODUCTION` Contains AUX files and software inventory tables that represent the production service level of VM Client.
`VSMC30A`	29D	10	`BUILD4` Contains HELP files.
`VSMC30A`	201	20	`BUILD1` Test build disk for VM Client. Contains load libraries and modules.
`VSMC30A`	202	20	`BUILD2` Production build disk for VM Client. Contains load libraries and modules.
`VSMC30A`	191	10	`INST191` Installation user ID 191 minidisk
`VSMC30A`	191	10	`VMSMC191` VM Client Service Machine 191 minidisk
`VSMC30A`	200	20	`VMSMCRUN` VM Client Service Machine RUN disk