The Con-nect Installation Tapes

This document contains the following topics:


The z/OS Installation Tape

The following topics are covered below:

The Datasets

The z/OS 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
CNTnnn.JOBS Example installation jobs.
CNTnnn.INPL INPL dataset containing language-independent components of the Con-nect processor and transport service.
CNTnnn.LOAD Contains the CTMOD module which must be linked to the Natural nucleus. This dataset is specifically for the transport service.
CNTnnn.SRCE Source library for the transport service. This dataset is specifically for the transport service.
CNTnnn.SYS2 An unloaded copy of an empty Con-nect help system file. This file has the internal identification LFILE number 222.
CNTnnn.SYS3 An unloaded copy of an empty Con-nect spool file. This file is used for the external mailing facility, e.g., Con-nect multi-node. It has the internal identification LFILE number 223.
CNTnnn.SYS4 An unloaded copy of an empty central directory file for the directory synchronization. It has the internal identification LFILE number 160.
CNTnnn.SYS5 An unloaded copy of an empty Con-nect system file in the format used by the Cabinet Transfer utilities. The internal identification LFILE number for this dataset is 224.
CNTnnn.SYS6 An unloaded copy of an empty Con-nect Text Retrieval document file. The internal identification LFILE number for this dataset is 233.
CNTnnn.SYS7 An unloaded copy of an empty Con-nect Text Retrieval vocabulary file. The internal identification LFILE number for this dataset is 231.
CSxnnn.INPL INPL dataset containing components for the language-dependent parts of Con-nect.
CSxnnn.ERRN Con-nect internal error text (language-dependent).
CSxnnn.HLPS Con-nect help screens (language-dependent).

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 COPYTAPE.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 following topics are covered below:

Datasets

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
CNTnnn.INPL INPL dataset containing language-independent components of the Con-nect processor and transport service.
CNTnnn.LIBR Contains the CTMOD module which must be linked to the Natural nucleus and the source library for the transport service. This dataset is specifically for the transport service.
CNTnnn.LIBJ Example installation jobs.
CNTnnn.SYS2 An unloaded copy of an empty Con-nect help system file. This file has the internal identification LFILE number 222.
CNTnnn.SYS3 An unloaded copy of an empty Con-nect spool file. This file is used for the external mailing facility, e.g., Con-nect multi-node. It has the internal identification LFILE number 223.
CNTnnn.SYS4 An unloaded copy of an empty central directory file for the directory synchronization. It has the internal identification LFILE number 160.
CNTnnn.SYS5 An unloaded copy of an empty Con-nect system file in the format used by the Cabinet Transfer utilities. The internal identification LFILE number for this data set is 224.
CNTnnn.SYS6 An unloaded copy of an empty Con-nect Text Retrieval document file. The internal identification LFILE number for this dataset is 233.
CNTnnn.SYS7 An unloaded copy of an empty Con-nect Text Retrieval vocabulary file. The internal identification LFILE number for this dataset is 231.
CSxnnn.INPL INPL dataset containing components for the language-dependent parts of Con-nect.
CSxnnn.ERRN Con-nect internal error text (language-dependent).
CSxnnn.HLPS Con-nect help screens (language-dependent).

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 following topics are covered below:

Datasets

The VM/CMS 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
CNTnnn.INPL INPL dataset containing language-independent components of the Con-nect processor and transport service.
CNTnnn.TAPE Contains the CTMOD module which must be linked to the Natural nucleus. This dataset is specifically for the transport service.
CNTnnn.SYS2 An unloaded copy of an empty Con-nect help system file. This file has the internal identification LFILE number 222.
CNTnnn.SYS3 An unloaded copy of an empty Con-nect spool file. This file is used for the external mailing facility, e.g., Con-nect multi-node. It has the internal identification LFILE number 223.
CNTnnn.SYS4 An unloaded copy of an empty central directory file for the directory synchronization. It has the internal identification LFILE number 160.
CNTnnn.SYS5 An unloaded copy of an empty Con-nect system file in the format used by the Cabinet Transfer utilities. The internal identification LFILE number for this data set is 224.
CNTnnn.SYS6 An unloaded copy of an empty Con-nect Text Retrieval document file. The internal identification LFILE number for this dataset is 233.
CNTnnn.SYS7 An unloaded copy of an empty Con-nect Text Retrieval vocabulary file. The internal identification LFILE number for this dataset is 231.
CSxnnn.INPL INPL dataset containing components for the language-dependent parts of Con-nect.
CSxnnn.ERRN Con-nect internal error text (language-dependent).
CSxnnn.HLPS Con-nect help screens (language-dependent).

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 CNTnnn.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-nect 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-nect 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-nect 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 following topics are covered below:

Datasets

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 Content
CNTnnn.JOBS Example installation jobs.
CNTnnn.INPL INPL dataset containing language-independent components of the Con-nect processor and transport service.
CNTnnn.LIB Contains the CTMOD module which must be linked to the Natural nucleus. This dataset is specifically for the transport service.
CNTnnn.SYS2 An unloaded copy of an empty Con-nect help system file. This file has the internal identification LFILE number 222.
CNTnnn.SYS3 An unloaded copy of an empty Con-nect spool file. This file is used for the external mailing facility, e.g., Con-nect multi-node. It has the internal identification LFILE number 223.
CNTnnn.SYS4 An unloaded copy of an empty central directory file for the directory synchronization. It has the internal identification LFILE number 160.
CNTnnn.SYS5 An unloaded copy of an empty Con-nect system file in the format used by the Cabinet Transfer utilities. The internal identification LFILE number for this data set is 224.
CNTnnn.SYS6 An unloaded copy of an empty Con-nect Text Retrieval document file. The internal identification LFILE number for this dataset is 233.
CNTnnn.SYS7 An unloaded copy of an empty Con-nect Text Retrieval vocabulary file. The internal identification LFILE number for this dataset is 231.
CSxnnn.INPL INPL dataset containing components for the language-dependent parts of Con-nect.
CSxnnn.ERRN Con-nect internal error text (language-dependent).
CSxnnn.HLPS Con-nect help screens (language-dependent).

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.LIB 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'.