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.
-
Reblock the VMARC Archive file to fixed length 80 character records
-
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.
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.)
