version 2004.2 (Modified)
ADD DATA SEGMENT
|This command does not require any parameters|
The ADD DATA SEGMENT command displays the data segment management dialog box shown here:
If the user clicks the OK button to validate the dialog box, the OK variable is set to 1. If the user clicks the Cancel button, OK is set to 0.
NOTE: This command does nothing when used with 4D Server.
When all data segments are full, 4th Dimension or 4D Server automatically creates a new segment if the Create new data segments as needed option is checked in the application Preferences ("Database/Data Management" page). Each automatic segment has a maximum size of 2 GB and is stored next to the last segment created or the data file.
If this option is not checked, the error -9999 is generated. An error message is displayed, stating that the disk is full.
If you are using 4th Dimension, you can use the ON ERR CALL method to catch the error message so you can handle the error procedurally. You can then use ADD DATA SEGMENT to allow the user to add a new data segment on another volume that has available space.
If you are using 4D Server, you can display an alert stating that the Database Administrator must add a new data segment from the server machine.
ON ERR CALL.
System Variables and Sets
OK is set to 1 if the data segment management dialog box is validated.