 |
ShopzSeries: CD-ROM and e-delivery |
In addition to shipment on tape cardridges, VSE is available on CD-ROM and for download from the Internet through ShopzSeries. ShopzSeries is available for customers in certain countries. An overview of ShopzSeries can be found in this flyer (PDF, 57KB).
With ShopzSeries the following can be ordered:
-
VSE/ESA and z/VSE base tapes
-
VSE optional products
-
VSE preventive service (Hiper/PE)
-
VSE corrective service (PTFs, APARs)
When ordering the VSE base tapes or optional products, you get a CD-ROM or download a file containing a tape image in AWSTAPE format. The VSE operating system consists of 3 files (VSE base, VSE extended base, DB2 Help Texts), for the optional products you will have only one file available. In case of multiple optional products ordered you will find all these optional products in this one file in VSE stacked format. In addition, a ReadMe file is provided, which points to the sources of installation instructions as listed below.
When ordering VSE service (APARs, PTFs) you get a binary job stream that contains the PTFs. Please follow the PTF installation instructions in order to install the service. For ordering Hiper/PE service, you must first provide a 'Installed Software Report' that contains information about installed products and PTFs.
You are encouraged to use the new electronoc delivery method.
|
Installations instructions |
Depending on the VSE level you are currently running, some preparations need to be done for FSU or Initial Installation:
- If you already are on VSE/ESA 2.7 or higher, you may run the FSU using the Virtual Tape.
- In case your system is VSE/ESA 2.6 or in case you want to perform an initial installation, you must copy the AWS Base Tape to a real tape.
- If you plan to install VSE/ESA 2.7.2 on a system that is able to read tape images in AWS tape image (e.g. MP3000 or FLEX/ES system), you can directly continue with the initial installation or FSU.
Detailed instructions how to install the VSE system from PC files can be found in the manuals z/VSE Installation, and z/VSE System Upgrade and Service.
|
Apply PTFs from the internet |
This section describes the preparation required if you received PTFs over the Internet. The shipment you received consists of several files, a readme file, the PTF coverletter file and the PTF file itself. The readme and coverletter files are plain text and can be read without being transferred to the VSE system. The PTF file includes all the PTFs ordered and has to be transferred to the VSE system as a binary file. The PTF file might be compressed using the ZIP facility. Before you transfer it to VSE, please UNZIP it first.
Transfer to the VSE system can be done in several ways. It is recommended to transfer to a VSAM file called IJSYSPF (PTF.FILE) which is defined on the VSE system and used by the PTF application dialog (VSE/ESA 2.4.0 or later), or to use VSE Virtual Tape Support. For older VSE systems, a tape is required as the application medium. In this case, a VSE library is needed as intermediate storage. Following is a detailed description of the various methods to transfer the PTF file to the VSE system, in order of ease of use and effectiveness:
|
How PTF Application should not be done |
PTF files should not be transferred directly to the VSE system (POWER reader), because
- PRE- and CO-requirements may not be fulfilled due to wrong order of PTFs, CO-requirements will not work at all.
- POWER JECL included in the data part of the PTFs will be processed while running the job. This leads to modified contents of the PTF and also might cause the code to be incomplete.
- Missing POWER JECL in the PTF file causes POWER to extract VSE JOB cards, this also leads to modified contents of the PTF and may also be incomplete due to job termination.
- No indirect application possible.
|
Using TCP/IP FTP |
- Transfer the PTF file directly to disk into the VSAM file IJSYSPF. The file needs to be defined in TCP/IP:
DEFINE FILE,TYPE=ESDS,DLBL=IJSYSPF,PUBLIC='IJSYSPF'
Alternatively you can define the whole filesystem using:
DEFINE FILESYS,LOCATION=SYSTEM,TYPE=PERM
In that case the file IJSYSPF would be called PTF.FILE per default. You would use the name PTF.FILE instead of IJSYSPF when doing FTP PUT (see below).
The transfer has to be done with the parameter 'binary' and logical record length 80 (quote site lrecl 80), record format fixed (quote site recfm f). Following is a sample protocol of such a transfer:
C:\Temp>ftp 9.164.170.30
Connected to 9.164.170.30
220-TCP/IP for VSE Internal FTPDAEMN 01.05 E 20050303 15.52
Copyright (c) 1995,2004 Connectivity Systems Incorporated
Service ready for new user.
User (9.164.155.2:(none)): SYSA
331 User name okay, need password.
Password: *******
230 User logged in, proceed.
ftp> quote site unix off
200 Command okay.
ftp> bin
200 Command okay.
ftp> quote site lrecl 80
200 Command okay.
ftp> quote site recfm f
200 Command okay.
ftp> put ptffile.bin IJSYSPF
- Apply service using the dialog, service medium is disk.
|
Using VSE Virtual Tape Support |
In this case a VSE Virtual Tape is used to apply the PTFs. The VSE Virtual Tape Support will simulate a PTF tape with the binary PTF file. This is only possible when the binary PTF file is on a remote system.
This method is recommended in case of a PTF mass application (fast path 1423). If a backup of affected libraries is intended to be done with the PTF application job stream, the backup step writes to the specified tape address, preferable a real tape. The binary PTF file is simulated as a read only tape for VSE.
To install a PTF via Virtual Tape Support follow these steps:
- Download and install the VSE Virtual Tape Server on a PC or workstation.
- Rename the binary PTF file to '.PTF', e.g: rename ptffile.bin to ptffile.ptf
- Before you submit the PTF apply job, enter the following command from a PAUSE job (assuming tape address used for PTF application is 181):
VTAPE START,UNIT=181,LOC=<ip>,FILE='ptffile.ptf',READ
- Apply service using the dialog, service medium is tape (181).
- At the end after the PTF application job stream has finished, enter the following command from a PAUSE job (assuming tape address used for PTF application is 181):
VTAPE STOP,UNIT=181
|
Using IND$FILE filetransfer (if TCP/IP is not available) |
In this case, an intermediate medium is required, this can be a VSE library member or the Host Transfer File (HTF).
- Transfer the PTF file to a library member or into the HTF (IUI fast path: 386) using IND$FILE transfer. Following send commands will transfer to the PRIMARY library (one line per command):
SEND PTFFILE.BIN A:PTFFILE Z (FILE=LIB L=PRIMARY
S=SUF LRECL=80 BINARY
or to the HTF (IUI fast path: 386):
SEND PTFFILE.BIN A:PTFFILE Z (FILE=HTF
LRECL=80 BINARY
From the intermediate medium, the PTF file can be transferred to disk. This is done using following DITTO job in case the intermediate medium is the VSE library:
* $$ JOB JNM=COPYPTF,CLASS=0,DISP=D
// JOB COPYPTF
* PTF MEMBER IS COPIED (AND REBLOCKED)
* TO VSAM FILE IJSYSPF
// LIBDEF *,SEARCH=(PRIMARY.SUF)
// UPSI 1
// EXEC DITTO
$$DITTO LV LIBIN=PRIMARY.SUF,
$$DITTO MEMBERIN=PTFFILE.Z,
$$DITTO FILEOUT=IJSYSPF,
$$DITTO REUSE=YES
/*
/&
* $$ EOJ
Or in case the intermediate medium is the HTF, the Move Utility (IUI fast path: 383) to move from HTF to VSAM can be used. It is required that the IJSYSPF file is defined to CICS. After the move to VSAM, IJSYSPF needs to be closed (CEMT SET FILE(IJSYSPF) CLOSE).
- Apply service using the dialog, service medium is disk.
|
Transfer PTF file to tape |
In this case, an intermediate medium is also required, which must be a library member.
- Transfer the PTF file to a library member as above (IUI fast path: 386). Following send command will transfer to the PRIMARY library:
SEND PTFFILE.BIN A:PTFFILE Z (FILE=LIB L=PRIMARY
S=SUF LRECL=80 BINARY
-
From the library, following DITTO job will put the PTF file onto tape at address 181:
* $$ JOB JNM=COPYPTF,CLASS=0,DISP=D
// JOB COPYPTF
* PTF FILE MUST BE COPIED TO SUBLIB PRIMARY.SUF
* AS MEMBER PTFFILE.Z, FILE TRANSFER MUST BE
* BINARY LRECL 80
// UPSI 1
// PAUSE - PLEASE MOUNT SCRATCH TAPE ON 181
// EXEC DITTO
$$DITTO REW OUTPUT=181
$$DITTO WTM OUTPUT=181,NTMKS=5
$$DITTO LT LIBIN=PRIMARY.SUF,
$$DITTO MEMBERIN=PTFFILE.Z,OUTPUT=181,
$$DITTO RECFMOUT=FB,
$$DITTO BLKSIZE=10320
$$DITTO WTM OUTPUT=181,NTMKS=2
$$DITTO RUN OUTPUT=181
/*
/&
* $$ EOJ
- Apply service using the dialog, service medium is tape.
|
|
|
 |
Easy ways to get the answers you need. |
|
|
|
|
|
