The Con-form Installation Tapes

This section describes the various installation tapes. It contains the following topics:


The z/OS Installation Tape

The installation tape contains the datasets listed below. The sequence of the datasets is shown in the "Report of Tape Creation" which accompanies the installation tape.

Dataset Name Contents
CMFnnn.JOBS Example installation jobs.
CMFnnn.LOAD Con-form load library.
CMFnnn.SRCE Con-form source library.
CMFnnn.ERRN Con-form internal error texts (language-independent).
CMFnnn.SYS1 An unloaded copy of an empty Con-form system file. This file has the internal identification number 251.

Copying the Tape Contents to Disk

If you are using System Maintenance Aid (SMA), refer to the SMA documentation (included on the current edition of the Natural documentation CD).

If you are not using SMA, follow the instructions below.

The JCL in this data set is then used to copy all data sets from tape to disk.

If the datasets for more than one product are delivered on the tape, the dataset COPY.JOB contains the JCL to unload the datasets for all delivered products from the tape to your disk.

After that, you will have to perform the individual install procedures for each component.

Step 1 - Copy data set COPY.JOB from tape to disk

The data set COPY.JOB (label 2) contains the JCL to unload all other existing data sets from tape to disk. To unload COPY.JOB, use the following sample JCL:

//SAGTAPE JOB SAG,CLASS=1,MSGCLASS=X
//* ---------------------------------
//COPY EXEC PGM=IEBGENER
//SYSUT1 DD DSN=COPY.JOB,
// DISP=(OLD,PASS),
// UNIT=(CASS,,DEFER),
// VOL=(,RETAIN,SER=<Tnnnnn>),
// LABEL=(2,SL)
//SYSUT2 DD DSN=<hilev>.COPY.JOB,
// DISP=(NEW,CATLG,DELETE),
// UNIT=3390,VOL=SER=<vvvvvv>,
// SPACE=(TRK,(1,1),RLSE),
// DCB=*.SYSUT1
//SYSPRINT DD SYSOUT=*
//SYSIN DD DUMMY
//

Where:

<hilev> is a valid high level qualifier

<Tnnnnn> is the tape number

<vvvvvv> is the desired volser

Step 2 - Modify COPY.JOB to conform with your local naming conventions

Modify the COPY.JOB to conform with your local naming conventions and set the disk space parameters before submitting this job:

  • Set HILEV to a valid high level qualifier

  • Set LOCATION to a storage location.

  • Set EXPDT to a valid expiration date.

Step 3 - Submit COPY.JOB

Submit COPY.JOB to unload all other data sets from the tape to your disk.

The z/VSE Installation Tape

The installation tape contains the datasets listed below. The sequence of the datasets is shown in the "Report of Tape Creation" which accompanies the installation tape.

Dataset Name Contents
CMFnnn.LIBR Con-form relocatable and source libraries.
CMFnnn.LIBJ Example installation jobs.
CMFnnn.ERRN Con-form internal error texts (language-independent).
CMFnnn.SYS1 An unloaded copy of an empty Con-form system file. This file has the internal identification number 251.

Copying the Tape Contents to Disk

If you are using System Maintenance Aid (SMA), refer to the SMA documentation (included on the current edition of the Natural documentation CD).

If you are not using SMA, follow the instructions below.

This section explains how to:

  • Copy data set COPYTAPE.JOB from tape to library.

  • Modify this member to conform with your local naming conventions.

    The JCL in this member is then used to copy all data sets from tape to disk.

If the datasets for more than one product are delivered on the tape, the member COPYTAPE.JOB contains the JCL to unload the datasets for all delivered products from the tape to your disk, except the datasets that you can directly install from tape, for example, Con-nect INPL objects.

After that, you will have to perform the individual install procedure for each component.

Step 1 - Copy data set COPYTAPE.JOB from tape to disk

The data set COPYTAPE.JOB (file 5) contains the JCL to unload all other existing data sets from tape to disk. To unload COPYTAPE.JOB, use the following sample JCL:

* $$ JOB JNM=LIBRCAT,CLASS=0,                                                       + 
* $$ DISP=D,LDEST=(*,UID),SYSID=1                                       
* $$ LST CLASS=A,DISP=D                                                  
// JOB LIBRCAT                                                           
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *                              
*     CATALOG COPYTAPE.JOB TO LIBRARY                                    
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *                              
// ASSGN SYS004,NNN  <------  tape address 
// MTC REW,SYS004                                                        
// MTC FSF,SYS004,4                                                      
ASSGN SYSIPT,SYS004                                                      
// TLBL IJSYSIN,'COPYTAPE.JOB'                                           
// EXEC LIBR,PARM='MSHP; ACC S=lib.sublib'  <------- for catalog
/*
// MTC REW,SYS004                                                                       
ASSGN SYSIPT,FEC                                                         
/*                                                                       
/&                                                                      
* $$ EOJ  

Where:

  • NNN is the tape address

  • lib.sublib is the library and sublibrary of the catalog

Step 2 - Modify COPYTAPE.JOB

Modify COPYTAPE.JOB to conform with your local naming conventions and set the disk space parameters before submitting this job.

Step 3 - Submit COPYTAPE.JOB

Submit COPYTAPE.JOB to unload all other data sets from the tape to your disk.

The VM/CMS Installation Tape

The installation tape contains the datasets listed below. The sequence of the datasets is shown in the "Report of Tape Creation" which accompanies the installation tape.

Dataset Name Contents
CMFnnn.TAPE Con-form VM/CMS-specific components in VM/CMS tape dump format.
CMFnnn.ERRN Con-form internal error texts (language-independent).
CMFnnn.SYS1 An unloaded copy of an empty Con-form system file. This file has the internal identification number 251.

Copying the Tape Contents to Disk

  1. To position the tape for the TAPE LOAD command, calculate the number of tape marks as follows:

    If the sequence number of CMFnnn.TAPE, as shown by the Report of Tape Creation, is n, you must position over 3n - 2 tape marks (that is, FSF 1 for the first dataset, FSF 4 for the second, etc.).

  2. Access the disk that is to contain the Con-form installation files as disk "A".

    The size of the disk must be at least 1500 4-KB blocks, for example, 10 cylinders on 3380-type disks or 12000 blocks FB-512.

  3. Ask the system operator to attach a tape drive to your virtual machine at address X'181' and mount the Con-form installation tape.

  4. Position the tape by issuing the CMS command:

    TAPE FSF fsfs
    

    where fsfs is the number of tape marks and is calculated as described above.

  5. Load the Con-form under CMS installation material by issuing the CMS command:

    TAPE LOAD * * A
    
  6. Keep the tape drive attached to your virtual machine, because the tape is still needed during the installation procedure.

The BS2000/OSD Installation Tape

The installation tape contains the files listed below. The sequence of the files is shown in the "Report of Tape Creation" which accompanies the installation tape.

Dataset Name Contents
CMFnnn.JOBS Example installation jobs.
CMFnnn.LIB Con-form load library. This file is used as input data to LMS or LMR, which produces a LMS or LMR library with the name CMFnnn.LIB. It is also contains source elements and assembles language macros.
CMFnnn.ERRN Con-form error texts (language-independent).
CMFnnn.SYS1 An unloaded copy of an empty Con-form system file. This file has the internal identification number 251.

Copying the Tape Contents to Disk

If you are not using SMA, use the procedure described below. In this procedure, the values specified below must be supplied.

To copy the datasets from tape to disk, perform the following steps:

1. Copy the Library SRVnnn.LIB from Tape to Disk

This step is not necessary if you have already copied the library SRVnnn.LIB from another Software AG tape. For more information, refer to the element #READ-ME in this library

The library SRVnnn.LIB is stored on the tape as the sequential file SRVnnn.LIBS containing LMS commands. The current version nnn can be obtained from the Report of Tape Creation. To convert this sequential file into an LMS-library, execute the following commands:

  /IMPORT-FILE  SUPPORT=*TAPE(FILE-NAME=SRVnnn.LIBS, -
  /   VOLUME=<volser>, DEV-TYPE=<tape-device>)
  /ADD-FILE-LINK  LINK-NAME=EDTSAM, FILE-NAME=SRVnnn.LIBS, -
  /   SUPPORT=*TAPE(FILE-SEQ=3), ACC-METH=*BY-CAT, -
  /   BUF-LEN=*BY-CAT, REC-FORM=*BY-CAT, REC-SIZE=*BY-CAT
  /START-EDT 
  @READ  '/'
  @SYSTEM 'REMOVE-FILE-LINK  EDTSAM'
  @SYSTEM 'EXPORT-FILE  FILE-NAME=SRVnnn.LIBS'
  @WRITE  'SRVnnn.LIBS'
  @HALT
  /ASS-SYSDTA  SRVnnn.LIBS
  /MOD-JOB-SW  ON=1
  /START-PROG  $LMS
  /MOD-JOB-SW  OFF=1
  /ASS-SYSDTA  *PRIMARY

Where:

  • <tape-device> is the device-type of the tape, e.g. TAPE-C4

  • <volser> is the VOLSER of the tape (see Report of Tape Creation)

2. Copy the Procedure COPY.PROC from Tape to Disk

To copy the procedure COPY.PROC to disk, call the procedure P.COPYTAPE in the library SRVnnn.LIB:

 /CALL-PROCEDURE  (SRVnnn.LIB,P.COPYTAPE), -
 /   (VSNT=<volser>, DEVT=<tape-device>)

If you use a TAPE-C4 device, you may omit the parameter DEVT.

3. Copy all Product Files from Tape to Disk

To copy all Software AG product files from tape to disk, enter the procedure COPY.PROC:

 /ENTER-PROCEDURE  COPY.PROC, DEVT=<tape-device>

If you use a TAPE-C4 device, you may omit the parameter DEVT. The result of this procedure is written to the file 'L.REPORT.SRV'.