Understanding the Behavior of the Natural Builder

You can customize the NaturalONE environment to your specific needs. You can decide which of the Eclipse-specific build commands you want to use from the Project menu, and you can change the behavior of the Natural builder by changing the settings in the Natural preferences. How the Natural builder handles specific actions and commands depends on the following settings:

The setting of the Build Automatically command in the Project menu of Eclipse (if disabled, the commands Build All and Build Project are enabled in the Project menu).
The option Build Natural projects automatically in the Natural preferences.
The option Scratch server objects in the Natural preferences.

For detailed information on the above-mentioned Natural preferences, see Natural > Builder in Setting the Preferences.

An overview is provided in the table below.

No.	Action	Build Automatically	Build Natural projects automatically	Scratch server objects	Results
1	Add object to workspace or modify existing object in workspace	On / Off	Off	On / Off	If the object is new, it is added to the Natural builder's object management. The object is marked with an upload and stow flag (if appropriate). Depending on the type of the object and the setting of the project's `PCHECK` parameter, other objects that call this object are marked with a catalog flag. The Build Natural Project command of NaturalONE is enabled.
2		Off	On	On / Off	See the result for No. 1.
3		On	On	On / Off	If the object is new, it is added to the Natural builder's object management. The object is uploaded and stowed (if appropriate) in the Natural environment. Depending on the type of the object and the setting of the project's `PCHECK` parameter, other objects that call this object are cataloged in the Natural environment. The Build Natural Project command of NaturalONE is enabled.
4	Delete object from workspace	On / Off	On / Off	Off	The object is removed from the Natural builder's object management. If no other object within the current Natural project has been modified, the Build Natural Project command of NaturalONE is disabled.
5		Off	On / Off	On	See the result for No. 4. Depending on the type of the object and the setting of the project's `PCHECK` parameter, other objects that call this object are marked with a catalog flag. The object waits to be scratched from the Natural environment.
6		On	Off	On	See the result for No. 5.
7		On	On	On	The object is removed from the Natural builder's object management. The object is scratched from the Natural environment. Depending on the type of the object and the setting of the project's `PCHECK` parameter, other objects that call this object are cataloged in the Natural environment.
8	Execute Build Natural Project command of NaturalONE	On / Off	Off	Off	All objects within the current Natural project that have an upload flag are uploaded to the Natural environment. If the upload was successful, the upload flag is removed. All objects within the current Natural project that have a stow flag are stowed in the Natural environment. If stowing was successful, the stow flag is removed. Note: An object is only stowed if the preceding upload was successful. All objects within the current Natural project that have a catalog flag are cataloged in the Natural environment. If cataloging was successful, the catalog flag is removed. Note: A catalog flag is only shown if the object does not need to be uploaded.
9		On / Off	Off	On	See the result for No. 8. The objects waiting to be scratched are scratched from the Natural environment.
10		Off	On	Off	See the result for No. 8.
11		Off	On	On	See the result for No. 9.
12		On	On	On / Off	The Build Natural Project command of NaturalONE is disabled.
13	Execute Build Project command in Project menu of Eclipse	On	On / Off	On / Off	The Build Project command in the Project menu is disabled.
14		Off	Off	On / Off	The Build Project command in the Project menu has no effect on Natural projects.
15		Off	On	Off	See the result for No. 8.
16		Off	On	On	See the result for No. 9.
17	Execute Clean command in Project menu of Eclipse	On / Off	Off	Off	All objects are removed from the Natural builder's object management. All objects are added to the Natural builder's object management. The upload, stow and catalog flags are preserved.
18		On / Off	Off	On	All objects are removed from the Natural builder's object management. All objects are added to the Natural builder's object management. All objects within the current Natural project are marked with a scratch, upload and stow flag (if appropriate).
19		On / Off	On	Off	See the result for No. 17. See the result for No. 8.
20		On / Off	On	On	All objects are removed from the Natural builder's object management. All objects are added to the Natural builder's object management. All objects within the current Natural project are scratched from the Natural environment. All objects within the current Natural project are uploaded to Natural environment. If the upload fails, the upload flag is not removed. All objects within the current Natural project are stowed (if appropriate) in the Natural environment. If stowing fails, the stow flag is not removed. Note: An object is only stowed if the preceding upload was successful.
21	Execute Upload command of NaturalONE	not applicable	not applicable	not applicable	All selected objects are uploaded to the Natural environment. If the upload was successful and if flags where previously shown for the objects, the upload and scratch flags of the uploaded objects are removed.
22	Execute Update command of NaturalONE	not applicable	not applicable	not applicable	All selected objects are uploaded to the Natural environment and stowed (if appropriate) in the Natural environment. Note: An object is only stowed if the preceding upload was successful. If the upload and stowing/cataloging was successful and if the corresponding flags where previously shown for the objects, the upload, stow/catalog and scratch flags of the uploaded objects are removed.