IBM Shopz: DVD and e-delivery

In addition to shipment on tape cartridges, z/VSE is available on DVD and for download from the Internet through IBM Shopz. IBM Shopz is available for customers in certain countries. An overview of IBM Shopz can be found in the Help section of IBM Shopz.

With IBM Shopz you can order the following:

When ordering the z/VSE base tapes or optional products, you get a DVD or download a file containing a tape image in AWSTAPE format. The z/VSE operating system consists of 3 files (z/VSE base, z/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 z/VSE stacked format. In addition, a ReadMe file is provided, which points to the sources of installation instructions as listed below.

When ordering z/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 electronic delivery method.

 

Installations instructions

Depending on the z/VSE level you are currently running, some preparations need to be done for FSU or Initial Installation:

Initial Installation:

Fast Service Upgrade (FSU):

Detailed instructions how to install or upgrade the z/VSE system from workstation 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 cover letter file and the PTF file itself. The readme and cover letter files are plain text and can be read without being transferred to the z/VSE system. The PTF file includes all the PTFs ordered and has to be transferred to the z/VSE system as a binary file. The PTF file might be compressed using the ZIP facility. Before you transfer it to z/VSE, please UNZIP it first.

Transfer to the z/VSE system can be done in several ways. It is recommended to transfer to a VSE/VSAM file called IJSYSPF (PTF.FILE) which is pre-defined on the z/VSE system and used by the PTF application dialog, or to use z/VSE Virtual Tape support. For older z/VSE or VSE/ESA systems, a tape is required as the application medium. In this case, a z/VSE library is needed as intermediate storage.

Following is a detailed description of the various methods to transfer the PTF file to the z/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 z/VSE system (VSE/POWER reader), because:

 

Using TCP/IP FTP

Please follow these instructions to upload the PTF file into IJSYSPF (PTF.FILE):

  1. Transfer the PTF file directly to disk into the VSE/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 file system 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 record format fixed blocked (quote site recfm fb), logical record length 80 (quote site lrecl 80), block size 10320 (quote site blksize 10320). 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 recfm fb
    200 Command okay.
    ftp> quote site lrecl 80
    200 Command okay.
    ftp> quote site blksize 10320 
    200 Command okay.
    ftp> put ptffile.bin IJSYSPF
    

    Note: The IJSYSPF file was delivered with an incorrect definition on z/VSE V5.2. In order to apply service from disk it is necessary to redefine this file prior to service application. This can be done by changing and then submitting skeleton SKPTFILE in library 59 from:
    RECORDSIZE (80,10320)                  -
    RECORDFORMAT(FIXBLK(10320))            -
    
    to
    RECORDSIZE (80,10320)                  -
    RECORDFORMAT(FIXBLK(80))               -
    
    This skeleton is corrected in PTF UI17100.
  2. Apply service using the dialog, service medium is disk.

 

Using z/VSE Virtual Tape Support

In this case a z/VSE Virtual Tape is used to apply the PTFs. The z/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 z/VSE.

To install a PTF via Virtual Tape Support follow these steps:

  1. Download, install and start the VSE Virtual Tape Server on a PC or workstation.
  2. Rename the binary PTF file to '.PTF', e.g: rename ptffile.bin to ptffile.ptf
  3. Apply service using the dialog.
    • Also specify the full qualified path and file name of the ptffile.ptf file where it resides on your PC or workstation.

 

Using IND$FILE file transfer (if TCP/IP is not available)

In this case, an intermediate medium is required, this can be a z/VSE library member or the Host Transfer File (HTF).

  1. 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:
    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 VSE/VSAM can be used. It is required that the IJSYSPF file is defined to CICS. After the move to VSE/VSAM, IJSYSPF needs to be closed (CEMT SET FILE(IJSYSPF) CLOSE).
  2. 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.

  1. 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
  2. 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
    

  3. Apply service using the dialog, service medium is tape.

 

IBM Mainframe: Make the Extraordinary Possible

  • The mainframe is essential in today's digital world, enabling 90% of Fortune 500 companies.

IBM zEnterprise System

  • zEnterprise

    The IBM zEnterprise System extends modern mainframe capabilities for enterprises of all sizes to help cut costs, improve service, and fuel innovation for business growth.

Rate zEnterprise product