The ADD function adds a new dataset to the Associator or Data Storage.
This document covers the following topics:
For the Associator or for Data Storage, the dataset to be added may be on the same device type as that currently being used or on a different one. A maximum of five datasets each may be assigned to the Associator and Data Storage.
Note:
The Associator and Data Storage dataset sizes must be added
separately. It is not possible to add both with a single
operation.
After an ADD operation is completed for an Associator or Data Storage dataset, the ADD function automatically ends the current nucleus session. This allows for the necessary Associator or Data Storage formatting with ADAFRM before a new session is started. A message tells you that the nucleus has been stopped.
To add an additional dataset to the Associator or Data Storage
Execute the ADD function.
Allocate the dataset with the operating system, then format the additional space using the ADAFRM utility.
Add necessary JCL/JCS to all Adabas nucleus and Adabas utility execution procedures.
The device type to be used for the new dataset. These parameters are required only if a different device type from the device type specified by the ADARUN DEVICE parameter is to be used.
For VSAM datasets, use dynamic device types; that is, DDxxxxR1=9999, DDxxxxR2=8888, ... DDxxxxR5=5555. For example, if DDDATAR3 is added, DATADEV=7777.
The number of cylinders to be contained in the new dataset.
When an error is encountered while the function is running, the utility prints an error message and terminates with user abend 34 (with a dump) or user abend 35 (without a dump).
If NOUSERABEND is specified, the utility will not abend after printing the error message. Instead, the message "utility TERMINATED DUE TO ERROR CONDITION" is displayed and the utility terminates with condition code 20.
The TEST parameter tests the operation syntax without actually performing the operation. Note that the validity of values and variables cannot be tested: only the syntax of the specified parameters can be tested. See Syntax Checking with the TEST Parameter for more information about using the TEST parameter in ADADBS functions.
A new dataset containing 800 cylinders on 3350 disks is to be added to Data Storage.
ADADBS ADD DATASIZE=800, DATADEV=3350
A new dataset containing 100 cylinders is to be added to the Associator on the Associator's existing device type.
ADADBS ADD ASSOSIZE=100
