z/VSE Installation

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


The Installation medium

The installation medium contains the data sets listed in the table below. The sequence of the datasets is shown in the Software AG Product Delivery Report that accompanies the installation medium.

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

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

Installation Checklist for z/VSE

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 medium
2 Prepare SYSAFP
3 Enable the client process
4 Enable the Adabas server process
5 Prepare the asynchronous buffer manager
6 Verify the installation

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.

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 medium unit number
vrs version, revision, and system maintenance level
tttttt volume serial number of the installation medium
xx file spacing information; see the Software AG Product Delivery Report
* $$ 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                  -
        medium=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 medium.

Start of instruction setTo prepare SYSAFP:

  1. Use your everyday Natural INPL job to load the administration tool (Natural application SYSAFP) and associated message texts into your Natural system. For reference a sample Natural INPL job called CORI061 can be found with the sibling System Coordinator product in the jobs distribution file. The INPL job’s work file 1 must reference the distribution file AFPvrs.INPL and work file 2 must reference AFPvrs.ERRN.

    Note:
    If you use Natural Security in this system, define the libraries SYSAFP and SYSMWvrs (where vrs is the level you are installing, for example 821) and protect as you require. You may define MENU as the startup transaction for SYSAFP. However, you must not define a startup transaction for SYSMWvrs.

  2. 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 define the location of the Adabas System Coordinator configuration file.

    Alternatively, assemble the Natural parameter module with

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

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:

    • make the modified Adabas link module available;

    • make the generated configuration module CORCFG available; and

    • make the Adabas System Coordinator load library available.

  2. for Adabas Fastpath:

    • make the Adabas Fastpath load library available (COMPLIB for Com-plete, STEPLIB for all other client systems).

Step 4. Enable the database process

To enable the Adabas Fastpath database process:

  1. for the Adabas System Coordinator:

    • make the Adabas System Coordinator load library available.

  2. for Adabas Fastpath:

    • set the Adabas parameter ADARUN FASTPATH=YES; and

    • make the Adabas Fastpath load library available.

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:

  • make the generated configuration module CORCFG available;

  • set the daemon service startup parameter PRODUCT=AFP; and

  • make the Adabas Fastpath load library available.

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.