This section describes the various installation tapes. It contains the following topics:
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. |
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.
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
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.
Submit COPY.JOB to unload all other data sets from the tape to your disk.
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. |
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.
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
Modify COPYTAPE.JOB to conform with your local naming conventions and set the disk space parameters before submitting this job.
Submit COPYTAPE.JOB to unload all other data sets from the tape to your disk.
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. |
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.).
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.
Ask the system operator to attach a tape drive to your virtual machine at address X'181' and mount the Con-form installation tape.
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.
Load the Con-form under CMS installation material by issuing the CMS command:
TAPE LOAD * * A
Keep the tape drive attached to your virtual machine, because the tape is still needed during the installation procedure.
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. |
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:
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)
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.
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'.