Version 7.4.2

VSE/ESA Installation

This section describes the preparation for and installation of Adabas Fastpath on VSE/ESA systems.


The Installation Tape

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

Dataset Contents
AFPvrs.INPL SYSAFP objects
AFPvrs.LIBR AFP installation objects
AFPvrs.ERRN SYSAFP error messages

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

Top of page

Installation Checklist for VSE/ESA

The Adabas System Coordinator must be installed prior to the installation of Adabas Fastpath. See the Adabas System Coordinator documentation for detailed information.

Once the required System Coordinator components have been installed, you can proceed to install Adabas Fastpath. The following checklist identifies the steps necessary to complete the installation:

Step Description
1 Restore the Fastpath libraries from the installation tape
2 Prepare SYSAFP
3 Enable the client process
4 Enable the Adabas server process
5 Prepare the asynchronous buffer manager
6 Verify the installation

Top of page

Systems Programming Considerations

Buffer storage is allocated from the 31-bit extended SVA GETVIS area, if enough is available. To avoid impacting the 24-bit SVA area, ensure that your configuration accommodates the desired buffer size.

The CICS GETVIS parameter should be large enough to accommodate the Adabas Fastpath nucleus modules when loaded. If in doubt, increase GETVIS by 200K.

Top of page

Installation Procedure

Following is the general Adabas Fastpath 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 particularly intended for your system. If that information differs from the information in this section, use the release package information or contact your Software AG technical support representative for assistance.

Step 1. Restore the Fastpath libraries

Use the following sample JCS to restore the Adabas Fastpath library. Modify the following variables to reflect the standards at your site:

Variable Is the ...
cuu tape unit number
vrs version, revision, and system maintenance level
tttttt volume serial number of the installation tape
xx file spacing information; see the Report of Tape Creation
* $$ JOB JNM=LIBREST,CLASS=O,DISP=D
* $$ LST CLASS=A,DISP=H
// JOB LIBREST
// ASSGN SYS006,cuu,VOL=tttttt
// ASSGN SYS005,IGN
// MTC REW,SYS006
// MTC FSF,SYS006,xx
// EXEC LIBR
  RESTORE S=SAGLIB.AFPvrs:SAGLIB.AFPvrs                  -
        TAPE=SYS006 TL=tttttt LIST=Y
/*
// MTC REW,SYS006
/&
* $$ EOJ

Step 2. Prepare SYSAFP

The Adabas Fastpath Online Services (SYSAFP) objects are delivered on the Adabas Fastpath installation tape.

  1. Install the INPL objects as standard. If an I001 dataset is supplied, install this as well.

  2. Define SYSAFP and SYSMWvrs to Natural Security, with a start-up program named MENU. Restrict the application to authorized personnel.

  3. Use the following parameter to define the Natural session where SYSAFP is to be used:

    LFILE=(152,dbid,fnr<,passw><,ciph>)

    where dbid and fnr indicate the location of the Adabas System Coordinator configuration file.

    Alternatively, assemble the Natural parameter module can be assembled with

    NTFILE,ID=152,DBID=nnn,FNR=nnn

For more information, refer to the Adabas System Coordinator documentation.

Step 3. Enable the client process

To enable the Adabas Fastpath client process

  1. for the Adabas System Coordinator:

  2. for Adabas Fastpath:

Step 4. Enable the database process

To enable the Adabas Fastpath database process

  1. for the Adabas System Coordinator:

  2. for Adabas Fastpath:

Note:
An unmodified ADALNK must be available to the database in preference to the ADALNK created during the installation of the System Coordinator.

Step 5. Prepare the asynchronous buffer manager

The asynchronous buffer manager (ABM) runs as an optional service within the Adabas System Coordinator daemon.

To enable the ABM for the System Coordinator daemon:

For more information, refer to the Adabas System Coordinator documentation.

Step 6. Verify the installation

Use the procedure described in section Verifying the Installation to ensure that the installation has been successful.

Top of page