The installation medium contains the data sets listed in the table below. The sequence of the data sets is shown in the Software AG Product Delivery Report that accompanies the installation medium.
| Data Set | Contents |
|---|---|
| AFPvrs.LOAD | AFP load modules |
| AFPvrs.INPL | SYSAFP objects |
| AFPvrs.ERRN | SYSAFP error messages |
where vrs in 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 Adabas 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 acquired from extended CSA (ECSA subpool 241). The operating system parameter CSA in the IEASYSxx member of SYS1.PARMLIB defines the size available. It may need to be increased if a large buffer is required.
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 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.
If you are using System Maintenance Aid (SMA), refer to the SMA documentation (included on the current edition of the Natural documentation CD). If you are not using SMA, perform steps 1a, 1b and 1c as described in this section:
Note:
If the data sets for more than one product are delivered on the
medium, the data set COPY.JOB contains the JCL to unload the data sets for all
delivered products from the medium to your disk. After that, you will have to
perform the individual install procedure for each
component.
The data set COPY.JOB (label 2) contains the JCL to unload all other existing data sets from medium to disk. To unload COPY.JOB, use the following sample JCL:
//SAGmedium JOB SAG,CLASS=1,MSGCLASS=X //* --------------------------------- //COPY EXEC PGM=IEBGENER //SYSUT1 DD DSN=COPY.JOB, // DISP=(OLD,PASS), // UNIT=(CASS,,DEFER), // VOL=(,RETAIN,SER=<Tnnnnn>), // LABEL=(2,SL) //SYSUT2 DD DSN=<hilev>.COPY.JOB, // DISP=(NEW,CATLG,DELETE), // UNIT=3390,VOL=SER=<vvvvvv>, // SPACE=(TRK,(1,1),RLSE), // DCB=*.SYSUT1 //SYSPRINT DD SYSOUT=* //SYSIN DD DUMMY //
where: <hilev> is a valid high level qualifier <Tnnnnn> is the medium number <vvvvvv> is the desired volser
Modify COPY.JOB to conform with your local naming conventions and set the disk space parameters before submitting this job:
set HILEV to a valid high level qualifier
set LOCATION to a storage location
set EXPDT to a valid expiration date
Submit COPY.JOB to unload all other data sets from the medium to your disk.
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
To enable the Adabas Fastpath client process
for the Adabas System Coordinator:
make the modified Adabas link module available (COMPLIB for Com-plete, DFHRPL for CICS, STEPLIB for all other client systems);
make the generated configuration module CORCFG available (COMPLIB for Com-plete, STEPLIB for all other client systems); and
make the Adabas System Coordinator load library available (COMPLIB for Com-plete, STEPLIB for all other client systems).
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 Adabas System
Coordinator.
The asynchronous buffer manager (ABM) runs as an optional service within the Adabas System Coordinator daemon.
To enable the ABM for the Adabas System Coordinator daemon:
make the generated primary and alternate (if used) 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.
Use this procedure to ensure that the installation has been successful.
Several Natural programs are supplied in source form that demonstrate the effect of Adabas Fastpath optimization. These programs refer to the sample EMPLOYEES file distributed with Adabas.
Using Adabas Fastpath Online Services (SYSAFP), define a global buffer. For more information, see Parameter Maintenance.
Using Adabas Fastpath Online Services, define EMPLOYEES as a file to be optimized, and for all command types, set the default for optimization to ON. For more information, see Parameter Maintenance.
Using Adabas Fastpath Online Services, define the Client Runtime controls for the TP system (or batch job) where you wish to implement Adabas Fastpath optimization. See Parameter Maintenance.
Enable the database containing the EMPLOYEES file. See Step 4 of the Adabas Fastpath installation procedure for the operating system you are using. For example, step 4 for z/OS.
Start the asynchronous buffer manager. See Step 5 of the Adabas Fastpath installation procedure for the operating system you are using. For example, step 5 for z/OS.
Enable the client job chosen for Adabas Fastpath optimization. See Step 3 of the Adabas Fastpath installation procedure for the operating system you are using. For example, step 3 for z/OS.
From the Adabas Fastpath administration menu go to the command line and LIST/STOW the Natural programs beginning with EEX* to compile them with your correct EMPLOYEES DDM
The verification program relies on a certain amount of records being present in the EMPLOYEES file. Ensure the file is not empty.
Type VERIFY at the
SYSAFP command line to execute the verification
procedure. Use VERIFY along with the
SYSAFP command 2.1 to show the optimization being
achieved. Initially, only a small percentage of commands are actually
optimized: this grows with the repeated use of
VERIFY as Adabas Fastpath builds the knowledge base
based on previous requests.