Installing Adabas on a z/OS system follows a number of procedures, involves several components, and has certain requirements. The following section provides an overview.
The following is an overview of the steps for installing Adabas on a z/OS system.
Important
Be sure that you apply all supplied Adabas 8 maintenance and concatenate Adabas 8
patch-level libraries (L00n), as they are delivered to you.
This will ensure that your Adabas 8 code remains up-to-date, supporting all Adabas 8
features as they are enhanced and maintained.
| Step | Description | Additional Information |
|---|---|---|
|
Basic Installation Steps
|
||
| 1 | Allocate DASD space for the Adabas libraries. |
The libraries are restored from the installation tape. Refer to the section Disk Space Requirements for Libraries. |
| 2 | Allocate DASD space for the Adabas database. |
For better performance, distribute the database files over multiple devices and channels. Refer to the section Disk Space Requirements for the Database. |
| 3 | Specify the address space for running the Adabas nucleus. |
Refer to the section Adabas Nucleus Address Space Requirements. |
| 4 | Restore the Adabas libraries from the installation tape. |
Use the tape positioning information that accompanies the tape. Refer to the section Installing the Release Tape. |
| 5 | Install the Adabas SVC temporarily or permanently. |
Refer to the section Initializing the Adabas Communication Environment. |
|
Database Installation Steps
|
Steps 6-15 require changes to the setup definitions as described in section Installing Base Adabas Manually. | |
| 6 | Allocate and format the Adabas database with the ADAFRM utility job. | |
| 7 | Define the global database characteristics with the ADADEF utility job. | |
| 8 | Load the demonstration files with the ADALODE, ADALODV, ADALODM, and ADALODP jobs. | |
| 9 | Prepare and install the product license file. | |
| 10 | Customize and start the Adabas nucleus and test the Adabas communications with the appropriate ADANUC job. | |
| 11 | If appropriate, test Adabas address space communications by running ADAREP in MULTI mode with the CPEXLIST parameter. | |
| 12 | If appropriate, load the Adabas Online System (AOS) add-on product into a Natural system
file by running the ADAINPL job. Alternatively, install the AOS demo version (see
section Installing the AOS Demo
Version).
Note |
|
| 13 | Terminate the Adabas nucleus with an ADAEND operator command using the OS Modify command F. | |
| 14 | Back up the database by running the ADASAV utility job. | |
| 15 | Insert the ADARUN defaults by running the DEFAULTS job. | |
|
TP Monitor Installation
|
||
| 16 | Install the required TP link routines for Adabas. | See section Installing Adabas With TP Monitors. |
The following table describes most of the libraries included on the release tape. Once you have unloaded the libraries from the tape, you can change these names as required by your site, but the following lists the names that are delivered when you purchase Adabas for z/OS environments.
| Library Name | Description |
|---|---|
| ACIvrs.JOBS | The sample job library for the Adabas CICS link routine. The vrs in the library name represents the version of the Adabas CICS link routine. |
| ACIvrs.LOAD | The load library for the Adabas CICS link routine. The vrs in the library name represents the version of the Adabas CICS link routine. |
| ACIvrs.SRCE | The source library for the Adabas CICS link routine. The vrs in the library name represents the version of the Adabas CICS link routine. |
| ADAvrs.EMPL | The Employees demo file, containing dummy employee data you can use for testing Adabas. The vrs in the library name represents the version of Adabas. |
| ADAvrs.ERRN | Error messages for the Adabas Triggers and Stored Procedures Facility. These messages can be viewed using the Natural SYSERR utility. The vrs in the library name represents the version of Adabas. |
| ADAvrs.INPL | The code for Adabas Online System, Adabas Caching Facility, Triggers and Stored Procedures Facility, and various add-on demo products. The vrs in the library name represents the version of Adabas. |
| ADAvrs.JOBS | The sample job library for Adabas. The vrs in the library name represents the version of Adabas. |
| ADAvrs.LOAD | The load library for Adabas. The vrs in the library name represents the version of Adabas. |
| ADAvrs.MISC | The Miscellaneous demo file, containing dummy miscellaneous data you can use for testing Adabas. The vrs in the library name represents the version of Adabas. |
| ADAvrs.PERC | The Personnel demo file, containing uncompressed dummy
personnel data you can use for testing Adabas. This demo file includes fields that
make use of the extended and expanded features of Adabas 8, include large object
(LOB) fields. The vrs in the library name represents
the version of Adabas.
Note |
| ADAvrs.SRCE | The source library for Adabas. The
vrs in the library name represents the version of
Adabas.
For a complete list of the time zones supported by Adabas in any given release, refer to the TZINFO member in this Adabas library. |
| ADAvrs.TZ00 | The time zone library for Adabas. The
vrs in the library name represents the version of
Adabas. Adabas bases its time zone library on the time zones defined in the public
domain tz
database, also known as the zoneinfo or Olson
database.
For a complete list of the time zones supported by Adabas in any given release, refer to the TZINFO member in the Adabas source library (ADAvrs.SRCE). |
| ADAvrs.VEHI | The Vehicles demo file, containing dummy vehicle data you can use for testing Adabas. The vrs in the library name represents the version of Adabas. |
| AIIvrs.LOAD | The load library for the Adabas IMS link routine. The vrs in the library name represents the version of Adabas. |
| AIIvrs.SRCE | The source library for the Adabas IMS link routine. The vrs in the library name represents the version of Adabas. |
| MLCvrs.JOBS | The sample job library for Software GmbH's common mainframe license check software. The vrs in the library name represents the version of the license check software, which is not necessarily the same as the version of Adabas. |
| MLCvrs.LOAD | The load library for Software GmbH's common mainframe license check software. The vrs in the library name represents the version of the license check software, which is not necessarily the same as the version of Adabas. |
| WALvrs.JOBS | The sample job library for Adabas components shared by Adabas and other Software GmbH products, such as Entire Net-Work. The vrs in the library name represents the version of Adabas. |
| WALvrs.LOAD | The load library for Adabas components shared by Adabas and other Software GmbH products, such as Entire Net-Work. The vrs in the library name represents the version of Adabas. |
| WALvrs.SRCE | The source library for Adabas components shared by Adabas and other Software GmbH products, such as Entire Net-Work. The vrs in the library name represents the version of Adabas. |
| WCAvrs.LOAD | The z/OS load library for Entire Net-Work Administration, used by some of the Adabas add-on products. The vrs in the library name represents the version of Entire Net-Work Administration. |
| WCAvrs.SRCE | The z/OS source library for Entire Net-Work Administration, used by some of the Adabas add-on products. The vrs in the library name represents the version of Entire Net-Work Administration. |
The following add-on products that were previously distributed on separate libraries are now included in the ADAvrs.LOAD library:
| Component | Old library | New library | Modules |
|---|---|---|---|
| Adabas Caching Facility (ACF) | ACFvrs.LOAD | ADAvrs.LOAD |
ADACSH |
| Adabas Cluster Services (ALS) | ALSvrs.LOAD | ADAvrs.LOAD |
ADAXCF |
| Adabas Delta Save Facility (ADE) | ADEvrs.LOAD | ADAvrs.LOAD |
ADADSFN |
| Adabas Online System (AOS) | AOSvrs.LOAD | ADAvrs.LOAD |
ADAAOS |
| Adabas Parallel Services (ASM) | ASMvrs.LOAD | ADAvrs.LOAD |
ADASMC |
Modules in components ACF, ALS, ADE, AOS and ASM are now included in the ADAvrs library. This means that, when applying zaps to components ACF, ALS, ADE, AOS or ASM on z/OS, the SYSLIB DD in the IMASPZAP job must point to the ADAvrs load library. Note that the zap identifiers are unchanged (AHvrsnnn for ACF, APvrsnnn for ALS, ALvrsnnn for ADE, ASvrsnnn for ASM).
For users installing via System Maintenance Aid (SMA), the SMA copy jobs have been updated to take account of the streamlined product delivery. Users installing products via SMA should refer to the System Maintenance Aid documentation.
To use the various sub-products which are now delivered with ADAvrs, it is necessary for users to install a valid product license for the component. For information on installing product licenses, please refer to Adabas and Add-on Licenses and the description given in Installing Base Adabas Manually.
Use the ADACNV utility to migrate existing databases to new releases of Adabas (SMA job number I021). See Adabas Utilities for more information.
Copy the data sets from the supplied installation medium to your disk before you perform the individual installation procedure for each component to be installed.
The way you copy the data sets depends on the installation method and the medium used:
If you use System Maintenance Aid (SMA), refer to the copy job instructions provided in the System Maintenance Aid documentation.
If you are not using SMA and want to copy the data sets from CD-ROM, refer to the README.TXT file on the CD-ROM.
If you are not using SMA and want to copy the data sets from tape, follow the instructions in this section.
To copy all data sets from tape to disk
COPY.JOB from Tape to Disk
Modify the following sample job according to your requirements:
//SAGTAPE JOB SAG,CLASS=1,MSGCLASS=X
//* ---------------------------------
//COPY EXEC PGM=IEBGENER
//SYSUT1 DD DSN=COPY.JOB,
// DISP=(OLD,PASS),
// UNIT=(CASS,,DEFER),
// VOL=(,RETAIN,SER=tape-volser),
// LABEL=(2,SL)
//SYSUT2 DD DSN=hilev.COPY.JOB,
// DISP=(NEW,CATLG,DELETE),
// UNIT=3390,VOL=SER=disk-volser,
// SPACE=(TRK,(1,1),RLSE),
// DCB=*.SYSUT1
//SYSPRINT DD SYSOUT=*
//SYSIN DD DUMMY
//
where:
tape-volser is the VOLSER of the
tape, for example: T12345,
hilev is a valid high-level
qualifier, and
disk-volser is the VOLSER of the
disk.
Execute the job to copy the data set COPY.JOB to your disk.
hilev.COPY.JOB on Your
Disk
Modify hilev.COPY.JOB according to your
requirements:
Set EXPDT to a valid expiration date, for example,
99365.
Set HILEV to a valid high-level qualifier, for example,
USERLIB.
Set LOCATION to a storage location, for example,
STORCLAS=ABC or UNIT=3390,VOL=SER=USR123.
COPY.JOBExecute hilev.COPY.JOB to copy single,
multiple, or all data sets to your disk.
Beginning with Version 8.5.1, the Adabas installation package includes a set of sub-products or add-ons. In order to be able to use the sub-products they must be licensed and the corresponding product license file must be provided with the nucleus or utility execution. The following table describes for a product the member name of the license load module created with LICUTIL and the DD/link name for the license file:
| Product | Product Code | Load Module | DD/Link Name |
|---|---|---|---|
| Adabas | ADA | ADALIC | DDLIC |
| Adabas for zIIP | AZPAD | AZPADLIC | DDLAZPAD |
| Adabas Replication for ZIIP | AZPRP | AZPRPLIC | DDLAZPRP |
| Adabas Caching Facility | ACF | ACFLIC | DDLACF |
| Adabas Delta Save | ADE | ADELIC | DDLADE |
| Adabas Encryption | AEZ | AEZLIC | DDLAEZ |
| Adabas Auditing | ALA | ALALIC | DDLALA |
| Adabas Cluster Services | ALS | ALSLIC | DDLALS |
| Adabas Parallel Services | ASM | ASMLIC | DDLASM |
| Adabas Online Services | AOS | AOSLIC | DDLAOS |
| Adabas Replication Facility | ARF | ARFLIC | DDLARF |
The minimum 3390 disk space requirements for the Adabas libraries are as follows:
| Library | 3390 Cylinders | 3390 Tracks | Directory Blocks |
|---|---|---|---|
| Load | 20 | 300 | 30 |
| Source | 4 | 60 | 20 |
| JCL | 1 | 15 | 20 |
Note
You can isolate user programs from the Adabas load library by creating a separate
load library that contains only those modules needed to execute user programs in
multi-user mode and linked with ADAUSER. For this Adabas version, the modules required
by user programs are ADAIOR, ADAIOS, ADALNK, ADAMLF, ADAPRF, ADARUN.
The ICU for Adabas & Natural (ICS) library is required if you intend to enable a database for universal encoding service (UES) support. This library is delivered separately from the product libraries.
For UES support, the following library must be loaded and included in the STEPLIB concatenation, where nnn is the load library level and vrs is the number of the latest version of that code delivered on the tape:
ICSvrs.Lnnn
For information about setting up connections to UES-enabled databases, see section Enabling Universal Encoding Support (UES) for Your Adabas Nucleus.
The minimum disk space requirements on a 3390 disk for the internal product libraries delivered with this version of Adabas are as follows (where vrs is the latest version of the code delivered on the tape):
| Library | 3390 Cylinders | 3390 Tracks | Directory Blocks |
|---|---|---|---|
| ICSvrs.Lnnn | 100 | 1500 | 500 |
The actual database space needed by Adabas depends on user requirements. The minimum 3390 disk space requirements for the database are as follows:
| Database Component | 3390 Cylinders | 3390 Tracks |
|---|---|---|
| ASSOR1 (Associator) | 20 | 300 |
| DATAR1 (Data Storage) | 60 | 900 |
| WORKR1 (Work space) | 15 | 225 |
| TEMPR1 (temporary work space) | 15 | 225 |
| SORTR1 (sort work space) | 15 | 225 |
The typical Adabas nucleus requires at least 800-1024 kilobytes to operate. The size of the nucleus address space may need to be larger, depending on the ADARUN parameter settings. Parameter settings are determined by the user.
This section describes the installation of the Adabas router (ADASVC). The router uses cross-memory services for communication between the Adabas nucleus and the Adabas users.
The Adabas z/OS cross-memory communications service comprises two modules:
the Adabas router (ADASVC); and
the Adabas subsystem initialization routine (ADASIR).
ADASIR, executed either during IPL or by the Adabas SVC installation program (ADASIP), initializes the router’s operating environment, particularly the ID table.
ADASVC installation can be either temporary or permanent:
The Adabas SVC can be installed temporarily by executing ADASIP. The SVC is then available only until the next IPL.
Note
Once installed, the Adabas SVC can be re-installed temporarily using the ADASIP
REPLACE option. However, no Adabas nucleus can be active during this procedure.
Note
It is necessary to cycle CICS after executing ADASIP to initialize the SVC.
The Adabas SVC is installed permanently using regular operating systems procedures. The SVC then requires an IPL to become active.
Typically, the Adabas SVC is first installed temporarily using ADASIP. This makes Adabas available immediately without the need to wait for an IPL. Meanwhile, preparations are usually made for permanent installation at the next IPL.
Adabas 8 includes a new Adabas SVC. This SVC is fully backward compatible.
However, you cannot use the Adabas SVC from previous Adabas releases with Adabas 8 databases. If you attempt to do this, the Adabas 8 database will not initialize successfully.
Adabas levels are known by their VRS specifications: Version, Release, and SM level. SM level is not a factor in determining compatibility.
With Adabas 8.2 and later versions, the SVC includes performance improvements and improved error recovery routines. Note that the new SVC uses more efficient operating system interfaces, in particular when posting the user at command completion. This shifts work from SRB-mode routines to TCB-mode routines and also between the user's program and the Adabas nucleus. Take this into account when analyzing Adabas 8 SVC performance. With the new SVC, SRB-mode overhead is largely eliminated and TCB-mode overhead is somewhat increased, but the net result is an overall improvement in SVC performance.
The Adabas 8.2 (and later) SVC requires that the Adabas nucleus, as well as other MPM servers (such as Entire Net-Work and the Natural Global Buffer Pool), be authorized to prevent inappropriate use of critical ADASVC functions. This APF authorization prevents unauthorized use of the ADASVC 0-callWe recommend strongly that you run APF-authorized because of the security risks you can incur if you do not. However, upon request, Software GmbH does have a zap you can apply that eliminates this requirement. To determine what this zap number is, review the ZAPOPT member in the Adabas source library for a zap entitled "Remove requirement for APF authorization". If you choose not to have Adabas in an APF-authorized library, modules ADASIP, ADASIR and ADASVC must be copied to an APF-authorized library. Member JCLAPF in the MVSJOBS dataset has sample JCL that invokes z/OS utility IEBCOPY to copy them.
Note
Some add-on products require APF authorization to use restricted z/OS services. APF
authorization is still required in these cases.
There are two authorization mechanisms: System Authorization Facility (SAF) and APF authorization. SAF is the z/OS standard interface to security products such as RACF, ACF2, and Top Secret. APF is the z/OS facility that allows programs from designated libraries to access restricted z/OS functions.
The SAF authorization check occurs first. It requests read access to an entity in the
FACILITY class or an alternative class specified via ADASIP or
ADASIR parameters when installing the SVC. Refer to the
discussion of ADASIP and ADASIR parameters.
ADABAS.SVCsss.IDddddd
The sss is the Adabas SVC number and ddddd is the DBID with leading zeros.
If the nucleus is using Adabas Cluster Services or Adabas Parallel Services, the entity has an additional level:
ADABAS.SVCsss.IDddddd.Nucnnnnn
The nnnnn is the value assigned by the ADARUN NUCID parameter with leading zeros.
The SAF security administrator can assign permissions to entities of this form with a wide range of specificity using a flexible array of patterning and wildcard characters. In general, it should not be necessary to enumerate each possible combination of SVC, DBID, and NUCID.
There are three possible outcomes to the SAF check: permission is explicitly granted, permission is explicitly denied, or the entity may be unknown to SAF. When the entity is unknown, APF authorization is required.
| APF Authorization Status | SAF Allow | SAF Deny | Unknown to SAF |
|---|---|---|---|
| APF authorized | Allow | ABEND U494 | Allow |
| Not APF authorized | Allow | ABEND U494 | ABEND U494 |
Message ADAS33 is issued before any ABEND U494.
APF authorization is still required if your Adabas nucleus configuration needs to use restricted z/OS services. For example, the EXCPVR option and some add-on products such as Adabas Cluster Services and Adabas SAF Security (ADASAF) cannot run without APF authorization. In these cases, ADASVC SAF may be used only to deny permission to initialize.
The ADASAF add-on product can also restrict access to a DBID/SVC combination (but not an Adabas Cluster Services or Adabas Parallel Services nucleus ID). ADASAF uses a different resource class and arranges the subfields in resource entities differently. You may choose to use either SAF mechanism, both, or neither. To maintain their existing behavior, current ADASAF users should not create ADABAS.SVC* resource profiles in the FACILITY class and need not change anything in their existing ADASAV configuration.
APF authorization requires that all libraries in the JOBLIB and STEPLIB concatenations have entries in the z/OS APF list. Systems programming staff typically administer the APF list.
Regardless of the installation procedure selected, an available SVC table entry must be allocated to the Adabas router (ADASVC). SVC table entries are defined in the member IEASVCxx of SYS1.PARMLIB.
The SVC table entry in the operating system for an ADASVC must contain the following information:
| Offset | Label | Description |
|---|---|---|
| 0 | SVCEP | SVC entry point address. |
| 4 | SVCATTR1 |
Must indicate type 2 SVC (flag bit SVCTP2 set—X’80’) or type 3 or 4 SVC (flag bits SVCTP34 set—X’C0’): ADASIR changes a type 1, 5, or 6 SVC to type 2. May indicate that APF-authorization is needed for this SVC (flag bit SVCAPF set—X’08’): if set, all targets and users must be APF-authorized. |
| 6 | SVCLOCKS | Must contain all zeros. ADASIR sets SVCLOCKS to zeros. |
The subsystem name contained in the four-character field SUBSYS at ADASVC offset X’28’ (the default is “ADAB”) must be the same as that specified in the IEFSSNxx member of SYS1.PARMLIB. If the name is not the same, ADASIR ends with an ADAS12 message and condition code 2, and Adabas is not usable.
If the Adabas SVC is to reside in the fixed LPA, add an entry to an IEAFIXxx member of SYS1.PARMLIB.
The Adabas SVC should be initialized with ADASIP/ADASIR in order to guarantee full functioning of all Adabas nuclei.
Note
The ADASIR routine is prepared for concurrent executions and makes use of PLO
(perform locked operation) and CS (compare and swap) instructions when updating shared
control blocks. Thus, the BEGINPARALLEL setting is supported
(IEFSSNxx).
Sample jobs may be found in the MVSJOBS dataset from the Adabas installation tape.
to perform temporary router installation:
If the Adabas load library is not APF-authorized, customize sample job JCL APF to copy ADASIP, ADASIR and ADASVC into an APF-authorized library as authorized modules.
Execute ADASIP to install the SVC.
Customize and run the job ADASIP to dynamically add the Adabas SVC without an IPL.
Sample jobs may be found in the MVSJOBS dataset from the Adabas installation tape.
to perform permanent router installation:
If the Adabas library is not APF-authorized, customize sample job JCLAPF to copy ADASIP to an APF-authorized library.
Customize job JCLSVC step COPY to copy ADASVC to SYS1.LPALIB (or another library concatenated with it by SYS1.PARMLIB member LPALSTxx). Standard practice is to rename it according to z/OS SVC naming rules. For example, type 3/4 SVCs are named IGC00nnn, where nnn is the SVC number expressed as signed decimal digits. A signed decimal is a number ends in either of the following ways:
When the last digit of the SVC routine's load module name is a number from 1 - 9, specify a name that ends with the EBCDIC character (A-I) that corresponds with the last digit. For example, the name for type 3/4 SVC 249 is IGC0024I.
When the last digit of the SVC routine's load module name is zero, specify for the last character of the name the display representation of hexadecimal C0; in EBCDIC this is the left brace ({) character.
z/OS allows the type 3/4 naming convention to be overridden by the entry in SYS1.PARMLIB member IEASVCxx. The load module name specified in the IEASVCxx entry takes precedence. For example, if you have only one instance of ADASVC in the LPA libraries you may specify that name in IEASVCxx and leave the actual load module name unchanged.
If you wish to associate a subsystem name other than the default ADAB with ADASVC, customize sample job JCLSVC step SUBSYS to invoke IBM utility IMASPZAP to set the desired 4-character subsystem name.
Add a subsystem entry to SYS1.PARMLIB member IEFSSNxx for the subsystem name associated with the SVC. Customize and run the job JCLUPDT to add a new subsystem definition entry in the correct format.
Or:
Make the update with an on-line editor.
Customize sample job JCLSIR to copy ADASIR to SYS1.LINKLIB or a library concatenated with it by SYS1.PARMLIB member LKNLSTxx.
Note
ADASIR is not reentrant, and therefore should not be linked into SYS1.LPALIB
or a library concatenated with it by SYS1.PARMLIB member
LKNLSTxx.
IPL z/OS with the CLPA option to install and initialize the Adabas communication environment.
ADASIP performs the following functions:
acquires memory in the specified CSA subpool for the Adabas SVC and a subsystem communication vector table (SSCT)
loads the Adabas SVC into the acquired CSA space
modifies the subsystem name at ADASVC offset +x’28’
modifies the SVC table entry as required by the Adabas SVC
optionally deletes an SSCT for the same subsystem name from the SSCT chain
adds the new SSCT to the SSCT chain
invokes the ADASIR program
releases CSA acquired by a previously installed SVC
If any error is detected, ADASIP backs out all completed activities and terminates operation with a user abend specifying the error.
When reinstalling an instance of ADASVC using an SVC number that is currently being used by ADASVC, the subsystem name must be the same as the one currently being used. This helps avoid a configuration that may not function correctly. For more information, read SVC Integrity Validation.
A Version 8 ADASIP/ADASIR can be used to install a Version 7 Adabas SVC, but the Version 8 SVC requires the Version 8 ADASIP/ADASIR. we recommend using Version 8 to install all supported releases of the SVC. If an earlier version of ADASIP/ADASIR is used to replace an SVC installed with a later version, some areas of common storage may not be released.
If you choose not to have Adabas in an APF-authorized library, modules ADASIP, ADASIR and ADASVC must be copied to an APF-authorized library. Member JCLAPF in the MVSJOBS dataset has sample JCL that invokes IEBCOPY to copy them.
ADASIP parameters have the following syntax:
CONSNAME=c,IDTSPL=i,LEAVE=l,NRIDTES=n,REPLACE=r,SUBSYS=su, SVCNR=svcn,SVCSPL=svcs,RCLASS=class,FORCE=force
—where
| c | is the console name to which operator messages are written. If omitted, messages are issued using ROUTCDE=2, Master Console Information. |
| i | is the ID table subpool: see the ADASIR IDTSPL parameter for details. |
| l | indicates whether ADASIR should display message ADAS11 or ADAS12 on the operator console: see the ADASIR LEAVE parameter for details. |
| n | is the number of ID table entries: see the ADASIR NRIDTES parameter for details. |
| r | indicates whether or not an existing SSCT for the same subsystem name is to be replaced. Y for yes or N for no (N is the default). Use this option to replace any type of Adabas SVC (for example, when installing a new SVC version). |
| su | is the subsystem name. This parameter is required. . Each instance of the Adabas SVC must have a unique subsystem name. |
| svcn | is the Adabas SVC number: see the ADASIR SVCNR parameter for details. |
| svcs | is the Adabas SVC and SSCT subpool: 228 for fixed CSA or 241 for pageable CSA (default: 241). |
| class | is the System Authorizatin Facility (SAF) class name used to test authorization to start a target (default FACILITY). |
| force | allows certain possible errors to be detected while
validating parameters to be overridden. Use Y for overriding or
N for no overriding (N is the default).
|
The following are valid ADASIP parameter abbreviations:
| Parameter | Abbreviation |
|---|---|
| CONSNAME= | C= |
| IDTSPL= | I= |
| LEAVE= | L= |
| NRIDTES= | N= |
| REPLACE= | R= |
| SUBSYS= | SU= |
| SVCNR= | SVCN= |
| SVCSPL= | SVCS= |
| RCLASS= | RC= |
| FORCE= | F= |
All parameters are optional except SUBSYS and SVCNR. If specified, the parameters IDTSPL,LEAVE, NRIDTES, SUBSYS, SVCNR, and RCLASS
are passed to ADASIR without being verified.
JCL similar to the following should be used to execute ADASIP:
// EXEC PGM=ADASIP,PARM=parameters //STEPLIB DD ... //SVCLIB DD ... //SIRLIB DD ...
There is a sample job in member JCLSIP of the MVSJOBS dataset.
The data set defined by the STEPLIB DD statement must be an APF-authorized library containing the APF-authorized program ADASIP. Since ADASIP is neither reentrant nor refreshable, the data set cannot be SYS1.LPALIB.
The data set defined by the SVCLIB DD statement must be an APF-authorized library containing the Adabas SVC with either the name or alias ADASVC.
The data set defined by the SIRLIB DD statement must contain the ADASIR program. Since ADASIR is neither reentrant nor refreshable, the data set may not be SYS1.LPALIB.
ADASIP terminates with a U0481 abend if the parameter input is incorrectly specified.
The ADASIP parameters may not fit on a single JCL statement and may be broken up into segments using continuation JCL statements. The IBM job control convention for continuing the PARM parameter is:
// EXEC PGM=ADASIP,PARM=(’parameters ....’, // ’parameters’)
Note these restrictions:
Enclose the entire PARM string in parentheses.
Place each segment of the PARM string in single quotes.
Break the PARM string before a comma that follows a parameter.
A comma is required after the end-quote on a line that is to be continued.
Start the continuation line within columns 4-16.
A comma is not permitted between the last parameter and the end-quote on the line to be continued because JCL automatically inserts a comma between parameters when concatenating continuation strings:
// ...PARM=(’CONSID=3’, // ’SUBSYS=ADAB’, // ’SVCNR=249’)
—results in an equivalent line of
CONSID=3,SUBSYS=ADAB,SVCNR=249
The ADASIR program is invoked
by the ADASIP program to install the Adabas SVC temporarily, or
by z/OS to install the Adabas SVC permanently.
ADASIR receives control during either master scheduler initialization or ADASIP execution. The operator is prompted for any value that has been incorrectly zapped or assembled (refer to the Adabas Messages and Codes for specific message descriptions). If an error is found during the processing of parameters specified in the IEFSSNxx member or passed by ADASIP, the operator is prompted for all of the values.
If the SVC table entry is incorrect, ADASIR prompts the operator for permission to change the entry (if SVCTAB=P, the default, is specified). If any errors are detected, they must be corrected and either another IPL must be done or ADASIP must be rerun before the Adabas SVC can be used.
ADASIR parameters have the following syntax:
IDTSPL=i,LEAVE=l,NRIDTES=n,SVCNR=svcn,SVCTAB=svct,RCLASS=class
| Variable | Description |
|---|---|
| i | The ID table subpool: 228 for fixed CSA or 241 (the default) for pageable CSA. |
| l | Indicates whether message ADAS11 or ADAS12 is to be displayed on the operator console: Y for yes or N (the default) for no. |
| n | The ID table entry count, which can range from 1 to a maximum specified at offset X’146’ in the CSECT IEAVESVT of the z/OS nucleus (see section Requirements for Cross-Memory Services). |
| svcn | The Adabas SVC number (200-255). |
| svct | Indicates whether or not the operator should be prompted for permission to update the SVC table entry. Enter P (the default) to receive a prompt, or N for no prompt. P is recommended if a possibility exists that the SVC table entry will not be what ADASIR expects. |
| class | is the System Authorizatin Facility (SAF) class name used to test authorization to start a target (default FACILITY). |
The following are valid abbreviations for ADASIR parameters:
| Parameter | Abbreviation |
|---|---|
| IDTSPL= | I= |
| LEAVE= | L= |
| NRIDTES= | N= |
| SVCNR= | SVCN= |
| SVCTAB= | SVCT= |
| RCLASS= | RC= |
Customize sample job JCLSIR to copy ADASIR to SYS1.LINKLIB or a library concatenated with it by SYS1.PARMLIB member LKNLSTxx.
Note
ADASIR is not reentrant, and therefore should not be placed into SYS1.LPALIB or a
library concatenated with it by SYS1.PARMLIB member
LKNLSTxx.
To prepare for permanent SVC installation, an entry must be made in either a new or existing member having the name IEFSSNxx in SYS1.PARMLIB. This entry is an 80-character record with the following format:
SUBSYS SUBNAME(cccc) CONSNAME(consname) INITRTN(ADASIR) INITPARM(’parameters’) comments
—where
| cccc | The 1- to 4-character subsystem name. This name and the name specified in the Adabas SVC at offset X’28’ must be the same. The name provided in the SVC is ADAB; any other name must first be zapped into the SVC before being specified for cccc. |
| consname | The name of the console to which ADASIR will direct any messages. If omitted messages will be issued with ROUTCDE=2, Master Console Information. |
| ’parameters’ | ADASIR parameters. If there is more than one parameter, values must be enclosed in single quotation marks and a comma placed between the parameters. |
| comments | Comments are optional and must be preceded by at least one space. |
If the subsystem name does not match, ADASIR abends with an ADAS12 message and condition code 2; the Adabas z/OS communication environment is not initialized. Re-IPL z/OS, specifying SSN=xx if necessary. If this is the first IPL with a type 3 or 4 Adabas SVC, specify CLPA as one of the SET parameters.
If an error is encountered while processing any of the parameters obtained from the IEFSSNxx member or passed from ADASIP (message ADAS05), the operator is prompted to reenter all of the parameters. If the SVC table entry is not correct (message ADAS09) then, depending on the value of the SVCTAB parameter, either the operator is prompted (message ADAS10) for permission to change the SVCTAB parameter, or it is simply changed (message ADAS15).
A Version 8 ADASIR can be used to install a Version 7 Adabas SVC, but the Version 8 SVC requires the Version 8 ADASIR. We recommend using Version 8 to install all supported releases of the SVC.
In the past, the presence of multiple SVCs with the same subsystem ID has resulted in a single ID table being used by different SVCs. This has caused problems, some of them , such as abnormal nucleus termination or corruption of the database.
To eliminate this exposure, ADASVC checks to ensure that the SVC accessing the ID table is the same as the one that was used by ADASIP/ADASIR to initialize the table. If the SVCs are not the same, the IDT is not accessed.
The lack of a usable IDT may occur during Adabas initialization, during the first Adabas call from a user program, or when the ID table is queried by another server such as Entire Net-Work.
ADASIP has been enhanced to prevent this from arising. If you attempt to install an instance of ADASVC using an SVC number that is presently associated with another subsystem name, message ADAS16 is issued and ADASIP terminates with user abend 435.
When installing or reinstalling ADASVC, ADASIP will also detect if there is an Adabas SVC
already installed as the specified SVC number that specifies a different subsystem than
specified by the SUBSYS parameter. This causes message ADAS16 to be issued and ADASIP terminates
with user abend 436. This abend can be overridden by specifying the FORCE=Y parameter.
If the specified SVC exists and has an IDT where there are active targets (as indicated
by an active IDTE), message ADAS17
is issued for each such target and ADASIP terminates with user abend 437. This abend can
be overridden by specifying the FORCE=Y parameter but doing so may cause the
targets to abend when they try to access the IDT. Using the FORCE=Y
parameter should only be necessary in rare conditions when a target failed in such a way
that the IDT could not be cleaned up.
Due to the implementation of cross-memory services in z/OS, the following points should be noted when running an Adabas nucleus in MULTI mode:
a maximum of one step of a job can establish the cross-memory environment. This means that a job can include at most one step that is a target (for example, an Adabas nucleus).
cross-memory accesses may not be made to a swapped-out address space. Therefore, the address space of an Adabas nucleus is set to “nonswappable” for the duration of the nucleus session. This can increase the installation’s real storage requirements. This behavior is documented in the IBM manual Extended Addressability Guide, chapter Synchronous Cross-Memory Communication.
when a nucleus with an active cross-memory environment terminates either normally or abnormally, the entire address space including any initiator is also terminated.
The address space ID (ASID) representing this address space is not reassigned until the next IPL. Therefore, you should choose a sufficiently high value for the MAXUSERS parameter in the active IEASYSxx member of SYS1.PARMLIB or—if your system supports it—the RSVNONR parameter in the same member can be adjusted accordingly. Also, the Adabas nucleus should not be stopped and started without good reason. This is described in the manuals referred to in the topics Recovery Considerations and Resource Management. Additional information can be found in IBM APARs OZ61154, OZ61741, and OZ67637.
To reduce the possibility that the system will run out of ASIDs for assignment to new address spaces, start ADABAS with REUSASID=YES:
/S ADAxxxx,REUSASID=YES
This is described in the z/OS V1R12.0 MVS Programming Extended Addressability Guide SA22-7614-07.
To make its services available to all address spaces in the system, the Adabas nucleus must obtain a system linkage index (LX) from z/OS. The LX is a reserved slot in the linkage space of all address spaces, and permits system-wide linkage to all address spaces.
If your hardware supports the Address Space and LX Reuse Facility (ALRF), the version 8 ADASVC will make use of reusable system LXs. Otherwise, a non-reusable system LX will be used as in previous releases. Reusable system LXs resolve the constraints imposed by non-reusable LXs. The remainder of this section discusses these constraints.
The number of non-reusable LXs set aside by z/OS for system use is rather small (usually 165 out of a possible 2048).
Because of the way z/OS use cross-memory services, non-reusable system LXs obtained by Adabas cannot be returned to z/OS until the next IPL. However, the system that owns the LXs can reuse them, even for a different address space. Adabas makes use of this feature by identifying used LXs in a table in CSA, where they are available to future nuclei.
The number of non-reusable system LXs can be specified in the member IEASYSxx contained in SYS1.PARMLIB, using the NSYSLX parameter. If you change this value, you must perform an IPL to make the change effective.
To determine an appropriate NSYSLX value, consider the following points:
some LXs are probably already being used by other system functions. Therefore, the chances of creating an LX shortage for other users is small.
Adabas requires one system LX for each Adabas nucleus (or any other target) that will be active concurrently. A value of decimal 64 would allow concurrent execution of up to 64 Adabas nuclei or other targets with little chance of restricting other components using LXs.
Entire Net-Work Version 5 uses only one LX and one ID table entry, regardless of how many remote databases it must represent. This is unlike the pseudo-MPM concept of earlier Entire Net-Work versions.
whenever ADASIP is executed with the REPLACE option, all LXs saved in the current ID table are lost until the next IPL.
Likewise, if a session ends either normally with the FORCE operator command or abnormally during ESTAE processing (for example, by an S222 operator cancel or by a S722 spool limit exceeded abend during a snap dump), the LX also cannot be recovered until the next IPL.
Any commands sent to these targets receive an S0D6 abend. Any attempt to restart the nucleus results in an ADAM98 message DUP ID (LOCAL), followed by an abend. To resolve both of these problems, restart the nucleus with the ADARUN FORCE=YES and IGNDIB=YES parameters.
The first target that tries to obtain a system LX when none is available ends with an S053 abend code and reason code 0112. No additional targets can be started until the next IPL.
This section provides information on device and system file topics.
Adabas container data sets (ASSO, DATA, WORK, TEMP, SORT, PLOG, CLOG, RLOG, ALOG, or DSIM) consist of fixed-length records (RECFM=F), with a data set organization which is compatible with sequential data sets (DSORG=PS).
Both basic format and large format data sets are supported for Adabas containers.
Extended format data sets (also known as striped data sets) are not supported for Adabas containers. If an attempt is made to open an Adabas container using an extended format data set, an error message will be issued and the job will be terminated.
Adabas files can be managed by DFSMS, and placed on disk devices belonging to a DFSMS Storage Group. This allows Adabas to take advantage of the storage management features of DFSMS, for example allowing DFSMS to administer the space requirements of data sets when they are allocated or extended.
The procedure for extending Adabas files differs according to whether the file is DFSMS-managed or not. See DBA Tasks > Database Space Management > Increasing Associator and Data Storage Space for more details. See also the descriptions of ADABAS INCREASE and ADADBS ONLINCREASE in the Utilities manual.
If Adabas container files are encrypted using the add-on Adabas Encryption product (product code AEZ), DFSMS management is mandatory. Otherwise, it is optional.
Adabas supports large format files, a feature introduced with IBM z/OS 1.7.
Prior to large format file support, the extents of an Adabas container (ASSO, DATA, WORK, TEMP, SORT, PLOG, CLOG, RLOG, ALOG, or DSIM data sets) were only able to occupy 65,535 tracks per volume. With large format file support, the data set extents can now occupy an entire volume.
As before, each data set can have up to 16 extents on a volume and can span up to 59 volumes. For ASSO and DATA, up to 99 separate data sets are supported.
In addition to supporting large format files for container data sets, Adabas sequential data sets (typically those read or written by the Adabas utilities) can also take advantage of IBM large format file features.
When allocating a new Adabas data set (container or sequential) where the space on any single volume can exceed 65,535 tracks, the DSNTYPE=LARGE parameter needs to be specified in the JCL. If the data set is eligible to use the cylinder-managed space on an EAV disk device, EATTR=OPT needs to be specified in the JCL, in addition to DSNTYPE=LARGE. Once a large format file is allocated, the DSNTYPE=LARGE and EATTR=OPT paramaters are no longer necessary in JCL for the file.
For further information about the DSNTYPE JCL parameter, as well as for details about the IBM PARMLIB parameter BLOCKTOKENSIZE(REQUIRE) in member IGDSMSxx, refer to the IBM z/OS documentation provided in section Processing Large Format Data Sets in the DFSMS: Using Data Sets guide.
The standard characteristics of the device types supported via the ADARUN DEVICE parameter in z/OS environments are summarized in the following table. Adabas block sizes and blocks per track are provided for each Adabas component for each device type.
| Device | Trks/Cyl | ASSO | DATA | WORK | PLOG/RLOG | CLOG/ALOG | TEMP/SORT/DSIM | Notes |
|---|---|---|---|---|---|---|---|---|
| 3390 | 15 | 2544:18 | 5064:10 | 5724:9 | 5724:9 | 5064:10 | 8904:6 | 1 |
| 8390 | 15 | 3440:14 | 6518:8 | 10706:5 | 10706:5 | 8904:6 | 8904:6 | 1 |
| 8391 | 15 | 4136:12 | 10796:5 | 13682:4 | 13682:4 | 8904:6 | 18452:3 | 1 |
| 8392 | 15 | 4092:12 | 12796:4 | 18452:3 | 18452:3 | 18452:3 | 18452:3 | 1 |
| 8393 | 15 | 4092:12 | 27644:2 | 27990:2 | 27990:2 | 27990:2 | 27990:2 | 1 |
| 3380 | 15 | 2004:19 | 4820:9 | 5492:8 | 5492:8 | 4820:9 | 7476:6 | 2 |
| 8380 | 15 | 3476:12 | 6356:7 | 9076:5 | 9076:5 | 9076:5 | 9076:5 | 2 |
| 8381 | 15 | 3476:12 | 9076:5 | 11476:4 | 11476:4 | 9076:5 | 9076:5 | 2 |
| 8385 | 15 | 4092:10 | 23292:2 | 23468:2 | 23468:2 | 23468:2 | 23468:2 | 2 |
Notes:
Any users requiring to add a new Adabas device type, or else update an existing Adabas device type, should contact their our support representative for assistance.
Adabas exploits IBM’s large block (more than 32,760 bytes) support for sequential access methods BSAM and QSAM under z/OS version 2 release 10 and above. ADAIOR supports tape drives with a block size of up to 256K for 3590 devices and 64K for 3490/3490E devices.
This support can provide performance benefits for any utility writing to tape (for example, ADASAV).
 |
Warning: If you choose to write tape files with large block sizes (for example, for database backups), these files will not be transportable to systems where support for large blocks is not available. This might include a site being used as a backup facility for disaster recovery. |
Adabas uses Global Resource Serialization (GRS) to synchronize the execution of Adabas nuclei and utilities at certain points in their processing. It is vital that GRS be set up correctly in the system so that GRS requests by Adabas will be effective.
When setting up GRS, consider the following:
Adabas uses the GRS macros ENQ and DEQ with systems-wide scope (SCOPE=SYSTEMS) and major name ‘ADABAS’ (QNAME).
if the database resides on disks that are shared between multiple images of the operating system (multiple LPARs or machines) and Adabas nuclei or utilities may be run against the database from several of these images, make sure that GRS is installed in a way that systems-wide ENQ requests are effective on all of these system images.
Adabas performance and system throughput are improved when you use EXCPVR rather than EXCP, due to a reduction in channel program translation overhead.
For Adabas to invoke EXCPVR, the nucleus must be running with APF authorization. All Adabas modules must be in APF-authorized libraries, and all libraries in the JOBLIB or STEPLIB concatenations must be APF-authorized.
Running the Adabas nucleus and utilities APF-authorized is now a standard. For more information, read APF Authorization Requirement.
Prior versions of Adabas tied the use of EXCP or EXCPVR for database I/Os to the APF-authorization of the load library. EXCP was always used when running non-APF-authorized; EXCPVR was always used when running APF-authorized. If you wanted to use EXCP when running APF-authorized, you were required to apply special A$- or AY- zaps.
Adabas 8 introduces a new ADARUN parameter, EXCPVR, available in z/OS environments. Using this parameter, you can specify whether EXCP or EXCPVR is used when running APF-authorized. If the EXCPVR parameter is set to "YES", EXCPVR is used; if it is set to "NO", EXCP is used. If the EXCPVR parameter is set to "YES" when running from a non-APF-authorized load library, the EXCPVR parameter is ignored. For complete information on the use of this parameter, read EXCPVR : Control EXCP or EXCPVR Use.
In addition to the EXCPVR parameter, another ADARUN parameter, PGFIX, affects EXCPVR use. When EXCPVR is used on z/OS systems, the PGFIX parameter controls whether pages containing I/O control blocks are released after I/O processing is completed or after the job has ended. This parameter is valid only for z/OS users of EXCPVR. When the PGFIX parameter is set to NO, pages containing the I/O control blocks are fixed only for the duration of the I/O processing; when it is set to YES, pages containing the I/O control blocks are fixed for the duration of the job. For complete information on the use of this parameter, read PGFIX: EXCPVR Page Fixing Control.
The ADARUN module delivered in the Adabas load library is not reusable. If you need a shareable ADARUN, you will need to relink it with the REUS=YES link-edit attribute.
Linking ADARUN with the reusable option permits several programs running in the same address space to share the same ADARUN and ultimately, the same copy of ADALNK. This is important when it is necessary to have only one Adabas user ID for the different programs, and is also needed if single copies of ADALNK user exits are required.
To create a shareable ADARUN, use the sample job JCLLINRR in the JOBS library to relink it with the REUS attribute.
If both nonreusable and reusable versions of ADARUN are required, they must be located in different load libraries since both must be loadable using the name ADARUN.
Adabas can acquire a number of its required areas, including buffer space, above the 16-MB addressing limit, allowing Adabas to increase the buffer pool size.
To reverse the space allocation to be below the 16-MB limit, set the AMODE value in the MODE statement in the example below to AMODE(24):
//LINKRUN EXEC PGM=IEWL,PARM=’REUS’ //SYSPRINT DD SYSOUT=* //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) //ADALIB DD DSN=user.loadlib,DISP=SHR //SYSLMOD DD DSN=user.loadlib,DISP=SHR <=APF-authorized library //SYSLIN DD * MODE AMODE(24),RMODE(24) SETCODE AC(1) INCLUDE ADALIB(ADARUN) NAME ADARUN(R)
In addition, Adabas must be run with a sufficient REGION specification, either on the JOB or EXEC statement or as an installation default. For example:
//BIG JOB ...,REGION=30M,...
Adabas can exploit storage occupying real pages above the 2-gigabyte line. This capability allows Adabas I/Os to use 64-bit real addresses.
Support for 64-bit real storage is available whether you are running APF-authorized (using EXCPVR) or not (using EXCP). The run mode is indicated in the ADAI65 message:
ADAI65 EXCPVR IS {BEING | NOT BEING} USED FOR THIS RUN IN ESA64 MODE
Support for 64-bit real storage requires either
z/OS R10 in ARCHLEVEL=2 (that is, z/architecture mode); or
z/OS 1.2 or above
on a processor of the IBM 2064 family with an LPAR greater than 2 gigabytes for real storage allocation.
IBM supports 64-bit virtual storage only for z/OS 1.2 or above.
Software GmbH provides support for IBM’s 64-bit virtual storage in Adabas. The ADARUN V64BIT parameter allows you to indicate whether the Adabas nucleus should use virtual storage above the 2 gigabyte bar. If your z/OS operating system supports 64-bit virtual storage, you can request that the Adabas nucleus use it also. In addition, the ADARUN LARGEPAGE parameter allows you to indicate whether the Adabas nucleus should use large pages (1 MB pages of real storage above the 2 gigabyte bar). If your z/OS operating system supports 64-bit virtual storage and large pages, you can request that the Adabas nucleus use large pages.
we also provides support for 64-bit virtual storage in the product Adabas Caching Facility (ACF). contact your nearest representative for more information.
A demo of Adabas Caching Facility is delivered in the ADAvrs.ALLINPL file (where vrs is the number of the latest Adabas version delivered on the tape).
Adabas for Mainframes supports pageable large pages.
Pageable large page support allows storage to be backed by 1M large pages without the configuration restrictions of fixed large page support (e.g. by reserving space via the LFAREA parameter in SYS1.PARMLIB member IEASYSxx).
To check the availability of pageable large pages, refer to the IBM documentation for z/OS and for the features supported by your CPU model.
Additional options to the ADARUN LARGEPAGE parameter are defined, allowing you to indicate whether your Adabas nucleus should attempt to make use of pageable large pages. For more information, see LARGEPAGE : Large Page Support Option.
Note that the implementation of pageable large page support by IBM indicates a preference for the storage to be backed by pageable large pages. If no pageable large pages are available, or if certain operations (e.g. page-fixing) are performed against storage backed by pageable large page, storage backed by 1M large page can get demoted to being backed by pageable 4K pages during the run time of the job. Once storage has been demoted to being backed by 4K pages, it will continue to be backed by 4K pages for the remaining duration of the job. The success or otherwise of the request to allocate storage backed by large pages is indicated via the ADAI39 and ADAI44 messages described in the Messages manual. If an area of storage initially backed by large pages is later demoted to 4K pages, there is no indication of this within the Adabas job.
An attempt to allocate storage using pageable large pages will occur in the following situations:
In an Adabas nucleus running with LARGEPAGE=P64 and V64BIT=YES, an attempt to allocate storage below the 2G bar backed by pageable large pages will be made for the large buffer area associated with various ADARUN parameters, including LBP, LFP, and LWP. The flush I/O pool (ADARUN parameter LFIOP) will be allocated above the 2G bar in storage backed by 4K pages. No attempt is made to allocate flush I/O pool storage above the 2G bar using 1M pageable large pages, as this area is used for I/O and will therefore get demoted to being backed by 4K pages.
In an Adabas nucleus running with LARGEPAGE=P64 and V64BIT=NO, an attempt to allocate storage below the 2G bar backed by pageable large pages will be made for the large buffer area associated with various ADARUN parameters, including LBP, LFP, LWP, and LFIOP. Users should note that potentially large parts of this buffer area (those used for I/O) are subject to being demoted to being backed by 4K pages. For these areas, any potential performance benefit in using 1M pageable large pages will be lost for the duration of the job.
In an Adabas Parallel Services environment, specifying CLUCACHETYPE=P64 will attempt to allocate storage above the 2G bar backed by pageable large pages for the global cache area (ADARUN parameter CLUCACHESIZE).
In an Adabas Parallel Services environment, specifying LARGEPAGE=P64 and V64BIT=YES will attempt to allocate storage above the 2G bar backed by pageable large pages for the cast-out directory buffer (size derived internally and not associated with any single ADARUN parameter).
With Event Replicator V4.1 SP1 or later, in an Event Replication Server, specifying LARGEPAGE=P64 and V64BIT=YES will attempt to allocate storage above the 2G bar backed by pageable large pages for the replication pool (ADARUN parameter LRPL).
With versions of Event Replicator prior to V4.1 SP1, in an Event Replication Server, specifying LARGEPAGE=P64 and V64BIT=YES will attempt to allocate storage below the 2G bar backed by pageable large pages for the replication pool (ADARUN parameter LRPL).
For all supported versions of Event Replicator, in an Event Replication Server, specifying LARGEPAGE=P64 and V64BIT=NO will attempt to allocate storage below the 2G bar backed by pageable large pages for the replication pool (ADARUN parameter LRPL).
For all supported versions of Event Replicator, an Adabas nucleus running with REPLICATION=YES, specifying LARGEPAGE=P64 and V64BIT=YES will attempt to allocate storage above the 2G bar backed by pageable large pages for the replication pool (ADARUN parameter LRPL).
For all supported versions of Event Replicator, an Adabas nucleus running with REPLICATION=YES, specifying LARGEPAGE=P64 and V64BIT=NO will attempt to allocate storage below the 2G bar backed by pageable large pages for the replication pool (ADARUN parameter LRPL).
In an Adabas nucleus running with AUDITING=YES or in an Auditing Server, specifying LARGEPAGE=P64 and V64BIT=YES will attempt to allocate storage above the 2G bar backed by pageable large pages for the auditing pool (ADARUN parameter LAP, described in the Adabas Auditing documentation).
In an Adabas nucleus running with AUDITING=YES or in an Auditing Server, specifying LARGEPAGE=P64 and V64BIT=NO will attempt to allocate storage below the 2G bar backed by pageable large pages for the auditing pool (ADARUN parameter LAP, described in the Adabas Auditing documentation).
In an Adabas nucleus running with the Adabas Caching Facility active, allocation of the various storage areas using pageable large pages will be attempted according to extensions to the associated Adabas Caching Facility parameters. These parameters are described in the ADARUN parameters section of the Operations manual.
Use the z/OS AMASPZAP utility to apply zaps in the respective operating system; this method verifies (VER) and replaces (REP) data. The following sample JCL executes AMASPZAP:
//ADAZAP JOB //STEP1 EXEC PGM=AMASPZAP //SYSPRINT DD SYSOUT=X //SYSLIB DD DSN=ADABAS.ADAvrs.LOAD,DISP=SHR //SYSIN DD * (zap control statements) /* //
—where the following are examples of zap control statements:
NAME membername csectname VER displacement data REP displacement data IDRDATA (up to eight bytes of user data) * (comment)
Note
In VER and REP statements, spaces must be used to separate command, displacement, and
data. Commas are acceptable data separators; however, commas with spaces or spaces alone
are not, and may cause errors.