Version 7.4.2

OS/390, z/OS, and z/OS.e Systems Installation


The Installation Tape

Review the Report of Tape Creation that accompanies the release package before restoring the release data to disk. Information in this report supersedes the information in this documentation.

The installation tape contains the following datasets in the sequence indicated in the report:

Dataset Contents
AVIvrs.LOAD AVI load modules
AVIvrs.SRCE AVI source modules
AVIvrs.INPL SYSAVI objects
AVIvrs.ERRN SYSAVI error messages

where vrs in dataset names represents the version, revision, and system maintenance level of the product.

Top of page

Installation Checklist

The configuration file, configuration module, and client component of the Adabas System Coordinator 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

The installation of these components is described in detail in the Adabas System Coordinator documentation.

Once the required Adabas System Coordinator 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 Restore the Adabas Vista libraries and other items from the installation tape
2 Prepare SYSAVI
3 Enable the client process
4 Enable the database process
5 Enable the Adabas System Coordinator daemon process

Top of page

Installation Procedure

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.

Step 1. Restore the Adabas Vista libraries

Use IEBCOPY to unload the libraries. Modify the following variables to reflect the standards at your site:

Variable Is the...
vrs version, revision, and system maintenance level
tttttt volume serial number of the installation tape
vvvvvv volume serial number for the target disk
//AVILOAD  JOB  (site-dependent data)
//* ----------------------------------------------------------
//*---COPY THE LOAD LIBRARY
//* ----------------------------------------------------------
//LOADLIB EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=*
//IN     DD DSN=AVIvrs.LOAD,DISP=OLD,
//       VOL=(,RETAIN,SER=tttttt),UNIT=TAPE,LABEL=(3,SL)
//OUT    DD DSN=SAG.AVIvrs.LOAD,DISP=(,CATLG,DELETE),
//       UNIT=SYSDA,VOL=SER=vvvvvv,SPACE=(CYL,(5,1,15),RLSE)
//SYSIN DD *
 COPY INDD=IN,OUTDD=OUT
/*

Step 2. Prepare SYSAVI

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 distribution tape enable full functionality.

  1. 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 installation tape, you must re-apply the Adabas Vista INPL and any subsequent Adabas Vista INPL updates.

  2. In a Natural Security environment, define the libraries SYSAVI (using MENU as the startup program name) and SYSMVvrs. Restrict the application to authorized personnel.

  3. 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 System Coordinator configuration file.

    Alternatively, assemble the Natural parameter module with

    NTFILE,ID=152,DBID=dbid,FNR=fnr

  4. Run the supplied Natural program U1JPARM

  5. Ensure that the supplied Natural program AVIMIG74 has been run. This runs automatically when you first enter SYSAVI version 7.4. This will

Step 3. Enable the client process

Start of instruction setTo enable the Adabas Vista client process

  1. for the Adabas System Coordinator:

  2. for Adabas Vista:

Step 4. Enable the database process

Start of instruction setTo enable the Adabas Vista database process

  1. for the Adabas System Coordinator:

  2. for Adabas Vista:

Step 5. Enable the Adabas System Coordinator daemon process

Note:
This step is required only if you intend to run clustered applications with dynamic transaction routing across multiple operating system images in an IBM sysplex environment.

Start of instruction setTo enable the Adabas Vista System Coordinator daemon process

  1. Add the control statement PRODUCT=AVI to the DDCARD input of the startup procedures for the Adabas System Coordinator daemon.

  2. Make the Adabas Vista load library available to the Adabas System Coordinator daemon (STEPLIB).

Top of page