The MODFCB function modifies various parameters for a non-system Adabas file.
This document covers the following topics:
FILE is the number of the Adabas file to be modified. An Adabas system file cannot be specified.
ASSOPFAC/DATAPFAC specify the padding factor (1-90) to be in effect for Associator and Data Storage, respectively. Existing blocks retain their original padding factor (see the ADAORD utility).
The maximum number of blocks per secondary extent allocation for the Data Storage (MAXDS), the normal index (MAXNI), and the upper index (MAXUI).
The value specified must specify blocks, be followed by "B" (for example, MAXDS=8000B), and cannot be more than 65535B.
If one of the parameters is either not specified or specifies "0B", the maximum secondary extent allocation for that component has no limit.
In all cases, however, Adabas enforces minimum secondary allocations for these parameters:
MAXDS=6B MAXNI=6B MAXUI=15B
If you specify a value lower than these minimum allocations, the minimum value is used.
The maximum compressed record length permitted for the file. The value specified should not be less than the current maximum record size in the specified file.
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.
This parameter is required if the file is password-protected.
The PGMREFRESH option determines whether a user program is allowed to perform a file refresh operation by issuing a special E1 command. If the parameter is not specified, the option remains in its current status: either on (YES) or off (NO).
The TEST parameter tests the operation syntax without actually performing the operation. Only the syntax of the specified parameters can be tested; not the validity of values and variables. See Syntax Checking with the TEST Parameter for more information on using the TEST parameter in ADADBS functions.
The following modifications are to be made for file 203: the Associator padding factor is set to 5, the Data Storage padding factor to 5, and the maximum Data Storage secondary extent allocation to 100 blocks.
ADADBS MODFCB FILE=203,ASSOPFAC=5,DATAPFAC=5,MAXDS=100B
