This section describes the preparation for and installation of Adabas Fastpath on z/VSE systems.
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.
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 |
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.
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.
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
The Adabas Fastpath Online Services (SYSAFP) objects are delivered on the Adabas Fastpath installation medium.
To prepare SYSAFP:
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.
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.
To enable the Adabas Fastpath client process
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.
for Adabas Fastpath:
make the Adabas Fastpath load library available (COMPLIB for Com-plete, STEPLIB for all other client systems).
To enable the Adabas Fastpath database process
for the Adabas System Coordinator:
make the Adabas System Coordinator load library available.
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.
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.
Use the procedure described in section Verifying the Installation to ensure that the installation has been successful.