IBM: z/VM SDO Enabling Aid

z/VM SDO Enabling Aid (Optional)

Please review this section before installing the Enabling Aid to determine whether it is required. Although, the files provided with the Enabling Aid may be useful to system programmers, they are not required in order to install the other Products. However, if installed, the Enabling Aid (5741-A06), should be installed before installing the Licensed Products.

The Enabling Aid consists of two z/VM SDO configuration files which contain sample VM Directory entries and Saved Segment definitions for the SDO Optional Products. Information on the two Enabling Aid files follows.

SDOZVM54 SAMPDIR

This file is generally placed on the MAINT 2C2 (Samples & Install Tools Disk). The file contains a prologue section describing the file's contents. This prologue includes the following information:

The organization of the directory (directory entries are broken down by products in VM for the SDO option).
Sample user directory, with a brief description of each directory entry.
Minidisks required to install the products.
Minidisk sizes
How to edit the file for your own use.
How to use XEDIT to determine total minidisk size required, based on individual product minidisk size information.

The SDOZVM54 SAMPDIR file can be seen here .

SDOZVM54 PRODPART

This file is generally placed on the MAINT 2C2 (Samples & Install Tools Disk). The file contains the saved segment definitions for the z/VM SDO Licensed Products.

The VMSES/E SEGDATA file may be updated with the Saved Segment (DCSS) definitions for all the z/VM SDO Licensed Products at the same time by following the instructions in Appendix D.1, "Using the SDOZVM54 PRODPART File to Create Saved Segment Definitions" on page 213 in the V5R4.0 z/VM SDO Program Directory.

After the VMSES/E SEGDATA file has been updated, the VMSES/E VMFBLD command may be utilized to define and create the Saved Segments for VMSES/E Format Licensed Products.

The Saved Segments for z/VM SDO Semi-VMSES/E Licensed Products must be defined and created by following the instructions in the Technical Notes provided for each z/VM SDO Semi-VMSES/E Licensed Products.

Installation Steps for the Enabling Aid

The Enabling Aid files are provided in VMARC Archive format. The following are the general steps required to transfer the VMARC Archive file to a z/VM System and to unpack the Enabling Aid files from the VMARC Archive file.

Before you download z/VM SDO Enabling Aid Archive file you must read the license agreement.
Download z/VM SDO Enabling Aid.
- This will download the VMARC Archive file with the Enabling Aid files to your PC.
- If you are using Microsoft Internet Explorer, click on the link and save the archive file to your PC.
- If you are using Mozilla Firefox, right click on the link and select "Save link as..." to save the archive file to your PC.
Upload the VMARC Archive file with the Enabling Aid files from your PC to your z/VM System.
- The VMARC Archive file must be uploaded in binary.
On the z/VM System, perform the following steps to unpack the VMARC Archive file.
1. Reblock the VMARC Archive file to fixed length 80 character records
2. Unpack the reblocked VMARC Archive file with the 'VMARC UNPK' command.

The following sections contain procedures that may be utilized to upload the VMARC Archive file from your PC to a z/VM System; and to unpack the VMARC Archive file on the z/VM System.

Additional information on the download of VMARC Archive Files, the VMARC Command and the download of the VMARC Command software may be found at following IBM Website.

http://www.vm.ibm.com/download/

Sample Upload Procedure

The following are the steps required to transfer the VMARC Archive file from your PC to a z/VM System utilizing FTP (TCP/IP's File Transfer Protocol). The steps require that FTP be enabled on both the PC and the z/VM System.

From a DOS window, enter the following-
 
   FTP  url_of_zVM_System         ===> Where 'url_of_zVM_System'
                                       is the IP address (url)
                                       of the z/VM System
 
   User: Userid_on_zVM System     ===> In response to the prompt
                                       'User:' enter the name of
                                       the ID on the z/VM System
                                       that will be utilized
                                       for the FTP (e.g. MAINT)
 
   Password: Password_for_Userid  ===> In response to the prompt
                                       'Password:' enter the
                                       password for the ID on
                                       the z/VM System.
 
   ftp> CD mini_disk_SFS_dir      ===> In response to the prompt
                                       'ftp>' enter the minidisk
                                       or the SFS Directory that
                                       will be utilized to store
                                       the Enabling Aid files.
                                          - The minidisk must be
                                            specified as
                                            'userid.minidisk'
                                            (e.g. MAINT.2C2)
                                          - The SFS Directory
                                            must be specified as
                                            a standard z/VM SFS
                                            Directory name (e.g.
                                            SYSPOOL:MAINT.2C2.)
 
   ftp> BINARY                    ===> In response to the prompt
                                       'ftp>' specify 'binary'
                                       transmission mode
 
   ftp> PUT pc_file zvm_file      ===> In response to the prompt
                                       'ftp>' enter the name of
                                       the PC file (pc_file) and
                                       the name of the z/VM file
                                       (zvm_file).  The z/VM
                                       file must be in the format
                                       'file_name.file_type'
                                       (e.g. ENABLE.VMARC)
 
   ftp> QUIT                      ===> In response to the prompt
                                       'ftp>' enter 'quit' to
                                       exit FTP.

In order for the above procedure to work, the minidisk or SFS Directory specified to contain the VMARC Archive file cannot be accessed in 'write' mode by any ID on the z/VM System.

VMARC File Unpack Procedure

The following commands may be utilized as indicated to unpack the Enabling Aid files from the VMARC Archive file and place them either on a minidisk or in an SFS Directory. On the z/VM System, perform the following steps to unpack the VMARC Archive file.

Reblock the VMARC Archive file to fixed length 80 character records
```
 PIPE < fn1 ft1 fm1 | FBLOCK 80 00 | > fn2 ft2 fm2 F 80
 
```

Unpack the reblocked VMARC Archive file with the 'VMARC UNPK' command.

 VMARC UNPK fn2 ft2 fm2

Where:

  fn1 ft1 fm1    ===> The file name (fn1), file
                      type (ft1) and file mode
                      (fm1) of the VMARC Archive
                      file that was uploaded from
                      your PC
 
  fn2 ft2 fm2    ===> The file name (fn2), file
                      type (ft2) and file mode
                      (fm2) of the reblocked
                      VMARC Archive file.

An example of the above commands follows:

  PIPE < ENA VMARC A | FBLOCK 80 00 | > ENAUNB VMARC A F 80
 
  VMARC UNPK ENAUNB VMARC A
 
     Note:
        The VMARC command in the above format will place
        the Enabling Aid files on the same disk as the
        reblocked VMARC Archive file (i.e. For the above,
        on the 'A' disk.)