CHANGE CAPACITY [ DBChange Plus User's Guide ] MPE/iX 5.0 Documentation
DBChange Plus User's Guide
CHANGE CAPACITY
Changes the capacity of a data set.
Syntax
CHA[NGE] CA[PACITY] DataSetName NewCapacity
Parameters
DataSetName is the name of the data set whose capacity is to be
changed.
NewCapacity is the new capacity of the data set. It must be less
than 231 -1 (2,147,483,647), but cannot be less than
the current number of entries in the data set.
Description
Use this command to change the capacity of a data set. For performance
reasons, it is recommended that you do not use a number that is a power
of two for the capacity of a master data set. The capacity must be a
number that can be evenly divided by the blocking factor. If you change
the capacity to a number that cannot be evenly divided by the blocking
factor, DBChange Plus adjusts the specified capacity to the nearest
multiple of the blocking factor.
NOTE If a data set capacity is lowered below the greatest number of
entries the data set has ever contained (the high-water mark),
DBChange Plus displays a recommendation to use the REPACK SET
command.
Example
>change capacity inventory 503
In this example, the capacity of the data set INVENTORY is changed from
450 to 503. However, because 503 cannot be evenly divided by the
blocking factor of 15, the capacity is automatically adjusted to the
nearest multiple of the blocking factor, which is 510.
Before the change, the INVENTORY data set entry in the schema looks like
this:
NAME: INVENTORY ,D(12/13,14,18);
ENTRY: STOCK# ( PRODUCT ),
ONHANDQTY ,
SUPPLIER (!SUP-MASTER ),
UNIT-COST ,
LASTSHIPDATE ( DATE-MASTER ),
BINNUM ;
CAPACITY: 450(15); <---- capacity to be changed
After the change, the INVENTORY data set entry in the schema looks like
this:
NAME: INVENTORY ,D(12/13,14,18);
ENTRY: STOCK# ( PRODUCT ),
ONHANDQTY ,
SUPPLIER (!SUP-MASTER ),
UNIT-COST ,
LASTSHIPDATE ( DATE-MASTER ),
BINNUM ;
CAPACITY: 510(15); <---- capacity changed
MPE/iX 5.0 Documentation