Review the Report of Tape Creation that accompanies the release package before restoring the release data to disk. Information in the report supersedes the information in this documentation.
The installation tape contains the following datasets in the sequence indicated in the report:
Dataset | Contents |
---|---|
AVIvrs.JOBS | AVI installation jobs |
AVIvrs.PAMS | AVI load modules |
AVIvrs.INPL | SYSAVI objects |
where vrs in dataset names represents the version, revision, and system maintenance level of the product.
The configuration file, configuration module, and client component of the System Coordinator for Adabas Options must already be installed as indicated in the following checklist before any attempt is made to install Adabas Vista:
Step | Description |
---|---|
1 | Load the Adabas System Coordinator configuration file |
2 | Build the Adabas System Coordinator configuration module CORCFG |
3 | Build the modified Adabas link module by including the Adabas System Coordinator client component |
4 | Specify the virtual start address of the shared memory pool in the Adabas System Coordinator group definition |
The installation of these components is described in detail in the System Coordinator for Adabas Options documentation.
Once the required components have been installed, you can proceed to install Adabas Vista. The following checklist identifies the steps necessary to successfully complete the installation:
Step | Description |
---|---|
1 | Copy the library SRVnnn.LIB from tape to disk |
2 | Copy the library SRVnnn.LIB from tape to disk |
3 | Copy all product files from tape to disk |
4 | Prepare SYSAVI |
5 | Enable the client process |
6 | Enable the database process |
Following is the general Adabas Vista installation procedure. The actual installation depends on your particular requirements and the specific contents of the release package provided by Software AG for your site. Information in the release package is intended for your system. If that information differs from the information in this section, use the release package information or contact Software AG technical support for assistance.
This step is not necessary if you have already copied the library SRVnnn.LIB from another Software AG installation 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 a 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 <tape-device> = device-type of the tape, e.g. TAPE-C4 <volser> = VOLSER of tape (see Report of Tape Creation)
/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 <tape-device> = device-type of the tape, e.g. TAPE-C4 <volser> = VOLSER of tape (see Report of Tape Creation)
/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 <tape-device> = device-type of the tape, e.g. TAPE-C4 <volser> = VOLSER of tape (see Report of Tape Creation)
Call the procedure P.COPYTAPE in the library SRVnnn.LIB to copy the procedure COPY.PROC to disk:
/CALL-PROCEDURE (SRVnnn.LIB,P.COPYTAPE), - / (VSNT=<volser>, DEVT=<tape-device>)
If you use a TAPE-C4 device, you can omit the parameter
DEVT
.
Enter the procedure COPY.PROC to copy all Software AG product files from tape to disk:
/ENTER-PROCEDURE COPY.PROC, DEVT=<tape-device>
If you use a TAPE-C4 device, you can omit the parameter
DEVT
. The results of this procedure is written to the
file L.REPORT.SRV.
The SYSAVI objects needed to create the Adabas Vista Online Services demo version are delivered as part of the System Coordinator for Adabas Options installation tape.
Additional SYSAVI objects delivered on the Adabas Vista installation tape enable full functionality.
INPL the objects provided on the Adabas Vista installation tape.
Note:
If you install the Adabas version 7.4 INPL again after installing
the Natural INPL supplied on the Adabas Vista distribution tape, you must
re-apply the Adabas Vista INPL and any subsequent Adabas Vista INPL
updates.
In a Natural Security environment, define the libraries SYSAVI (using MENU as the startup program name) and SYSMVvrs. Restrict the application to authorized personnel.
Use the following parameter to define the Natural session where SYSAVI is to be used:
LFILE=(152,dbid,fnr<,passw><,ciph>)
where dbid and fnr define the location of the Adabas System Coordinator configuration file.
Alternatively, assemble the Natural parameter module with
NTFILE,ID=152,DBID=dbid,FNR=fnr
Run the supplied Natural program U1JPARM
to initialize the Adabas Vista configuration file in version 7.3 mode; and also
to convert any existing job parameters.
Ensure that the supplied Natural program AVIMIG74 has been run. This runs automatically when you first enter SYSAVI version 7.4. This will
initialize the Adabas Vista configuration file in version 7.4 mode, and
convert any existing partition definitions and translation rules
To enable the Adabas Vista client process
for the Adabas System Coordinator:
make the modified Adabas link module available (BLSLIBnn);
make the generated configuration module CORCFG available (BLSLIBnn); and
make the Adabas System Coordinator load library available (BLSLIBnn).
for Adabas Vista:
make the Adabas Vista load library available (BLSLIBnn).
To enable the Adabas Vista database process
for the Adabas System Coordinator:
make the Adabas System Coordinator load library available (BLSLIBnn).
for Adabas Vista:
set the Adabas parameter ADARUN
VISTA=YES
.