This document covers the following topics:
Projects are essential parts of the Eclipse environment. In Eclipse, the resources (folders and files) in the workspace are always organized in projects.
When you have chosen to work in local mode, you have to deal with Natural projects which are shown in the Navigator view and/or in the Natural Navigator view.
The Navigator view is a standard Eclipse view which always shows a project as it is physically stored in the file system. The Natural Navigator view, however, allows you to manage, view and/or filter your Natural projects in several Natural-specific ways; see Using the Natural Navigator View for further information.
The following example shows how the projects that are shown in the Navigator view can be shown in the Natural Navigator view. According to the settings of the toggle buttons, the Natural Navigator view shows only Natural projects, the root folder is hidden and the objects are logically grouped by type.
A Natural project contains the contents of one or more Natural
libraries, and also other folders and files which are added by other components
of NaturalONE such as Ajax Developer. A Natural project is indicated by the
following icon:
.
By default, the environment to which a Natural project pertains is shown next to the project name. The number in parentheses which is also shown next to the project name indicates the number of Natural libraries in this project. This is part of the so-called label decoration.
Important information for this environment (such as the Natural parser settings or whether the environment is protected by Natural Security) is stored in the properties of the project. See Changing the Project Properties.
Caution:
Each Natural project includes standard project information which
is required by Eclipse (.settings folder and
.project file) and by Natural
(.natural file). You must not change these items manually
since this may result in damaging your project.
Important:
With the current version of NaturalONE, the Natural
Navigator view is provided as a preview version. There will be no
support for this preview version. Any feedback from our customers on this new
view is greatly appreciated. Since the Natural Navigator
view is still under development, a later version of NaturalONE may include
substantial changes for this view. Currently, only a small subset of the
possible commands is available. More commands will be available with a later
version.
The Natural Navigator view is not shown by default when you open the NaturalONE perspective. For information on how to display it, see Showing a View of the NaturalONE Perspective.
Whereas the Navigator view, which is a standard Eclipse view, always shows your projects as they are physically stored in the file system, the Natural Navigator view, which is provided by Software AG, can be configured to show your projects in a logical way. It allows you to switch on and off different Natural-specific options for displaying your Natural projects in the tree. In addition, it provides enhanced support, for example, for copying and pasting Natural objects (for detailed information, see Copying and Pasting Objects and Libraries).
When none of the toggle buttons described below is selected in the local toolbar of the Natural Navigator view, the Natural Navigator shows the same information as the standard Eclipse Navigator view.
The local toolbar of the Natural Navigator view provides the following toggle buttons:
| Toggle Button | Description |
|---|---|
| N |
Show Natural Projects Only
When selected, only the Natural projects are shown. When not selected, all projects in your Eclipse workspace (including, for example, your Java projects) are shown. |
| R |
Hide Root Folders
When selected, the root folders are not shown. When not selected, all root folders (for example, "Natural-Libraries") are shown in the Natural projects. |
| L |
Library View
When selected, all objects in a Natural library are shown as they would be stored on the server. The special folders SRC, ERR and RES are not shown. When library folders have been defined, they are not shown. When not selected, the Natural libraries and all objects in a library are shown as they are physically stored in your Eclipse workspace in the file system. In addition, if library folders have been defined, their names are shown (if more than one library folder has been defined for a single library, more than one node is shown for the same library). This is similar to the representation in the Navigator view. |
| G |
Group Objects by Type
When selected, all objects in a Natural library are logically grouped into different nodes, according to their object types. This is similar to the Natural Server view. For example, your programs are grouped into a Programs node and your subprograms are grouped into a Subprograms node. The special folders SRC, ERR and RES are not shown. When not selected, all objects in a library are shown as they are physically stored in your Eclipse workspace in the file system. However, whether the special folders SRC, ERR and RES are shown depends on the setting of the L toggle button. Note: |
| U |
Show Objects with Update Flags Only
When selected, only the modified Natural objects which still need to be updated in the Natural environment are shown for a Natural project. These are the objects which contain specific flags in the label decoration. For further information, see Flags in a Label Decoration. When not selected, all objects of a Natural project are shown. |
| F |
Hide File Extension
When selected, the file extensions of the Natural objects are not shown. When not selected, the file extensions of the Natural objects are shown (for example, ".NSP" for a Natural program). |
When the Natural Navigator view shows the objects in a logical way (that is, when they are not shown as they are physically stored in the file system), the icons for the libraries and group folders and are shown with a grey color.
Using the command in the view menu of the Natural Navigator view, you can also filter items that you do not want to see in the Natural Navigator view. When you choose this command, the following dialog box appears.
You can define the following filters, in addition to the standard Eclipse filters which are also shown in this dialog box:
When selected, all Natural objects are hidden which do not have update flags. Only the modified objects which still need to be updated in the Natural environment are shown. This corresponds to the U toggle button in the local toolbar.
When selected, non-Natural projects (for example, Java projects) are hidden and only the Natural projects are shown. This corresponds to the N toggle button in the local toolbar.
There are different types of Natural projects with different characteristics:
Regular Natural Project
This is the standard project type that is used to develop Natural
applications. In the properties of each project, you can define other projects
as project references (this is standard Eclipse functionality). If you do this,
it is important that you also define the corresponding libraries in the
referenced project as steplibs in the regular
project.
Referenced Natural Project
A referenced Natural project is designed to hold common Natural
objects for use in the regular project. For example, common data structures or
copycodes can be defined once in a referenced project in order to have these
objects available for other projects. In the properties of the regular project,
the referenced project must be defined as a project reference; the builder of
the regular project then gets the information from the referenced project.
Example: You are using application programming interfaces (APIs) in
your projects, but you have not downloaded the corresponding objects into your
workspace. Since the APIs that are referenced in your programs are not
available to your projects, the Dependencies view marks
them as "Unknown". To avoid this, you can download
all APIs once (that is, the contents of the system library SYSEXT)
into a dedicated project in your Eclipse workspace. Let us call this project
"ExternalObjects". In all other regular projects
that make use of SYSEXT, you can then define the project
"ExternalObjects" as a referenced project (in the
project properties). In addition, you have to define SYSEXT as a
steplib in all projects which make use of the referenced project. When this has
been done, the Dependencies view no longer shows an API as
"Unknown". It now shows the name of the referenced
project.
The name of a Natural project must meet the Eclipse naming conventions.
You can create a Natural project in different ways:
You can download entire libraries from a Natural server. A library is either placed in a newly created project or in an existing project, depending on the command that you use.
It is also possible to download only single objects of a library. These objects are then downloaded into a library which has the same name as the library on the Natural server (into a new or existing project, depending on the command that you use).
Only the sources are downloaded from the Natural server. Since a Natural application can only be executed (and debugged) directly in the Natural server environment, the generated programs (which are also called "GPs" or "cataloged Natural objects") remain on the server.
When you download into a new project, a number of required Natural profile parameter settings is also downloaded to the project. These settings are stored as the default settings in the .natural file. See also Changing the Project Properties.
Notes:
To download a library or object
In the Natural Server view, map the required Natural server as described in the section Mapping a Natural Environment.
Expand the node for the mapped Natural server.
Expand the node for the required system file (for example, User Libraries).
Select one or more of the following: a library, a node for an object type (for example, Program) or a single object.
Tip:
Type the first letters of the library name to select the first
library that starts with these letters. When you type all letters of a name
quickly, without a pause, you can immediately select the corresponding
library.
If you want to download several single objects at a time, open the library node(s), then open the node(s) for the object type(s), and then select the object(s).
If you want to download, for example, all subprograms of a library, select the corresponding node for this object type.
Notes:
SYSMAIN
utility profile of Natural Security in order to download objects. See also
Protecting the Natural Development Environment in Eclipse in
the Natural Security documentation, which is part of the
Natural documentation.
Invoke the context menu and choose either Add to New Project or Add to Existing Project.
Notes:
When you have chosen to download to a new project, a dialog box appears and you can specify a project name. The name of the (first) selected node is offered as the default name. When a project with this name already exists in your workspace, the dialog box informs you and you have to specify a project name that is not yet used.
If you want to create the "Natural-Libraries" root folder in the new project, make sure that the option Create the library root folder is selected. This option is only shown when root folder support has been enabled in the Natural preferences. For further information, see Natural > Project in Setting the Preferences.
If you want to group the downloaded Natural objects into separate folders within the new project, according to their object types, make sure that the option Group new objects by object type is selected. For further information, see Group Folders.
Or:
When you have chosen to download into an existing project, a dialog
box appears in which you have to select the project.
Choose the button to continue.
A dialog box is shown indicating the download progress. When you download a small number of objects, this dialog box is only briefly shown. However, when you download a large number of objects, you can choose to download the objects in the background so that you are able to continue working. A progress indicator is shown at the right bottom of the Eclipse window.
The downloaded libraries or objects are shown in the Navigator view and in the Natural Navigator view.
To download a library or object to an existing project using
drag-and-drop
In the Natural Server view, select one or more libraries or objects as described above.
Drag the selected nodes onto an existing project node in the Navigator view or in the Natural Navigator view.
Instead of downloading a library as a project from a Natural server, you can also create a Natural project manually.
You only have to provide a project name. The project wizard creates a Natural project structure that contains the .natural file with the default settings of the project properties. All other project information may be entered at a later point in time. See also Changing the Project Properties.
To create a project using a wizard
From the menu, choose .
Or:
In the Navigator view or in the
Natural Navigator view, invoke the context menu and choose
.
The following dialog box appears.
Specify the following information:
| Option | Description |
|---|---|
| Project | A unique name for the new project. |
| Create the library root folder | If you want to create the "Natural-Libraries" root folder in the new project, make sure that this option is selected. This option is only shown when root folder support has been enabled in the Natural preferences. For further information, see Natural > Project in Setting the Preferences. |
| Group new objects by object type | If you want to group the Natural objects in this project into separate folders, according to their object types, make sure that this option is selected. For further information, see Group Folders. |
Optional. Choose the button repeatedly if you want to change the default settings.
On the next pages of the dialog box, you can then specify the following information:
Settings for the connection to a Natural server. By default, the local Natural runtime will be used. This enables you to upload projects without having to define any connection settings.
The advantage of using a local Natural runtime is that you can immediately test and debug your Natural applications which are located in the Navigator view or in the Natural Navigator view, without the need of having Natural Development Server (NDV) installed. To deploy your applications, however, remote Natural server access via Natural Development Server (NDV) is required; this is also required if you want to test or debug applications which read or write data from/to Adabas.
If you want to create a project which applies to a Natural server, you have to specify all required mapping information. See also Mapping a Natural Environment. When you are working in a new workspace and create a project, the user ID in the project wizard is initially set to the user ID that you have used to log on to your operating system. Each time you enter a different user ID in the project wizard, this user ID is persistently stored in Eclipse and will be provided as the default value the next time you create a new project.
Environment settings (steplibs).
Project encoding and character assignments.
Parser limits and parser report parameters.
Parser options.
See Changing the Project Properties for further information.
Note:
Many default settings (such as the parser settings, project
encoding and character assignments) are defined in the Natural preferences. For
further information, see Setting the
Preferences.
Choose the button.
You use the standard Eclipse functionality to import a Natural project from a version control system.
You use the standard Eclipse functionality to import a Natural project from a different workspace into the current workspace.
When you import a Natural project into your workspace or check it out from the repository of a version control system, the user ID on the Runtime page of the project properties may differ from your current user ID. On import or checkout, the user ID is always set to the default user ID and the password is set to blank. The default user ID is either the ID that you have used to log on to your operating system or - if already entered in the project wizard - the user ID that is persistently stored in Eclipse. It is your responsibility to enter the appropriate user ID and password for the defined server connection.
The Natural project properties are made up of information and profile parameters that are important for the development of a Natural application.
When a project is created using the wizard, the project properties are preset and can be changed in the wizard. The properties are then written as the default settings into the .natural file. For some properties, default values can be defined in the Natural preferences.
When a project is created by downloading a library or object from a Natural server into a new project, the properties from the server are written as the default settings into the .natural file.
The settings stored in the .natural file are the so-called "default settings". They are important when you work with a version control system. When you change any settings in the project properties and just choose the or button, these changes are stored persistently under the control of Eclipse, but they are not automatically written to the .natural file. The content of the .natural file is only changed when you do this explicitly by also choosing the button (see below).
When you change the settings for a project, your changes are uploaded to the appropriate Natural environment the next time you update the Natural environment with an object in this project. The uploaded changes include the default settings in the .natural file, plus your user settings which are stored persistently under the control of Eclipse. In this case, the user settings always superimpose the default settings.
To change the project properties
Select the project in the Navigator view or in the Natural Navigator view.
Invoke the context menu and choose .
In the tree of the resulting dialog box, expand the Natural node.
Different pages are provided for setting different types of properties.
Note:
The Steplibs node is only available when the
project pertains to a server environment which is not protected by Natural
Security.
Select one of the property pages in the tree and set the required options as described in the topics below.
Choose the button to save your changes and to close the dialog box.
The following property pages are available for Natural projects:
This property page is shown when you select the Natural node.
One of the following messages can be shown next to Security:
| Message | Meaning |
|---|---|
| Environment is secured | This environment is protected by Natural Security. |
| No secured environment | This environment is not protected by Natural Security. |
Note:
The type of environment is defined on the
Runtime
page.
You can modify the following settings:
If you want to group the Natural objects in this project into separate folders, according to their object types, make sure that this option is selected. For further information, see Group Folders.
This option applies to the internal format of data areas in a Natural for Windows, UNIX and OpenVMS environment.
With Natural Version 6.1 for Windows and UNIX and Natural Version 6.3 for OpenVMS, a new internal format was introduced for data areas which supports, for example, dynamic and large variables.
When data areas are uploaded to the Natural environment, the new internal data area format is used by default. It is strongly recommended that you keep this default (that is, do not select this check box).
Data areas with the new format are not downward-compatible. Therefore, it is not possible to use them with Version 5.1 and below. Select this check box only, if you require data areas in the old format that are to be used with Natural Version 5.1 or below.
Note:
The default setting for this option can be changed in the
Natural preferences. See Natural >
Options in Setting the Preferences.
When selected, all error messages are deleted in the appropriate library on the server before the error messages from the project are uploaded.
When not selected (default), all error messages are uploaded to the server. Any error messages which are no longer available in the project are not deleted on the server. This may cause inconsistencies.
See also Creating Application-Specific Messages.
Note:
The default setting for this option can be changed in the
Natural preferences. See Natural >
Options in Setting the Preferences.
The .natural file contains the default settings of the Natural project properties. The following command buttons are available:
If you choose this command button, the current user settings of
the project properties are stored as the new default values in the
.natural file. A dialog appears in which you have to
confirm the action.
When you commit the new version of the .natural file to the repository of your version control system, the new default values are available to all developers involved in the project.
If you choose this command button, the current user settings of
the project properties are discarded. They are overwritten with the default
values that are stored in the .natural file. A dialog
appears in which you have to confirm the action.
Since the .natural file can be versioned, any newly defined project settings can thus be used consistently by all developers involved in the project.
This property page (and its corresponding link in the tree) is only shown when a debug attach server has been enabled in the Natural preferences. See Debug Attach Settings in Setting the Preferences.
The debug attach server uses a client ID to manage its attach records. A new unique client ID is generated for each project each time you start NaturalONE. This client ID is shown on this property page.
It is recommended that you do not change the generation type. You should leave it with unique.
However, if you want to debug an external Natural application or, if necessary, for testing purposes, you can define a custom client ID. You should only do this if you want to start a particular Natural runtime server manually. In this case, select custom from the drop-down list box and specify a client ID in the text box.
This property page allows you to write the history of the Natural builder to a log file.
When this check box is enabled, all other options on this page are also enabled and information is written to a log file each time you change, delete or add a source. The log file is created as soon as the first action occurs which requires an update in the server environment. These are the actions for which flags will be shown in the label decorations when your projects are not automatically built (see also Flags in a Label Decoration).
New history information is appended to the log file. As long as you do not enable or disable the option Store only one log entry for each Natural object (see below), the content of the log file is not deleted.
The following is an example of a log file:
[2012/03/29][10:25:14.817],MYLIB-A,COPY1,C,SAVE [2012/03/29][10:25:14.817],MYLIB-A,PROG1,P,CAT [2012/03/29][10:25:27.330],MYLIB-B,LDA1,L,STOW [2012/03/29][10:25:27.330],MYLIB-A,PROG1,P,CAT [2012/03/29][10:25:27.330],MYLIB-A,PROG3,P,CAT [2012/03/29][10:25:35.641],MYLIB-A,PROG1,P,STOW [2012/03/29][10:25:40.072],MYLIB-B,HLPRT2,H,STOW [2012/03/29][10:25:40.072],MYLIB-A,PROG3,P,STOW [2012/03/29][10:25:46.945],MYLIB-B,SUBP1,N,SCRATCH
For each operation, the log file provides the following information, separated by commas:
timestamp in the format [yyyy/mm/dd][hh:mm:ss.SSS]
library name
object name
one-letter abbreviation for the object type (for example,
P for a program)
type of operation (SAVE, CAT,
STOW or SCRATCH)
Using the following option buttons, you can define where the log file is to be stored:
Natural log folder
When enabled (default), the log file is stored in your Eclipse
workspace. When you look at your workspace in the file system, you can find it
in the .naturalone/log folder. The name of the log file is
<project-name>_builderHistory.log.
Project
When enabled, the log file is stored in the root of the current
Natural project. You can find it in the Navigator view or
in the Natural Navigator view. The name of
the log file is builderHistory.log.
When a log file exists at the selected location (either in the Natural log folder or in the project), the button is enabled. You can use this button to delete the log file at the selected location. When you choose this button, a dialog appears, asking whether you want to delete the log file. It is not possible to undo the deletion.
Caution:
When you change the setting of this option and if a log file
exists at the selected location, a dialog box appears, informing you that the
current contents of the log file will be deleted. You are asked whether you
want to continue.
When enabled, each Natural object is listed only once in the log
file. The log file is written in the same format as described above. However,
its sort sequence is different. The entries are no longer sorted according to
the timestamp (that is, new information is not always appended at the end of
the file). Instead, the following sort sequence is used: library name, object
type, object name. This is similar to the sort sequence which is used by
CATALL.
The following is an example of such a log file:
[2012/04/05][10:26:52.633],MY_LIB1,SUBPGM2,N,STOW [2012/04/05][10:27:03.345],MY_LIB1,PGM1,P,STOW [2012/04/05][10:26:56.954],MY_LIB1,PGM2,P,STOW [2012/04/05][10:26:48.930],MY_LIB2,PGM2,P,STOW [2012/04/05][10:26:58.954],MY_STEP1,CPYCDE1,C,SAVE [2012/04/05][10:26:50.930],MY_STEP1,LDA1,L,STOW [2012/04/05][10:27:07.126],MY_STEP1,SUBROUT1,S,STOW [2012/04/05][10:27:03.345],MY_STEP2,CPYCDE2,C,SAVE
The content of the log file can be seen as a compilation of all actions which are needed to deploy updates. Each time an action is performed on an object, either a new entry is created in the log file or the stored entry is updated.
For example, when the log file already contains a
SAVE entry for an object and a CAT entry is later
added for the same object, both log entries are automatically combined into a
single STOW entry (which logically contains the SAVE
and CAT operations).
Or, when a STOW operation occurs several times for the
same object, only the latest STOW operation (with the
corresponding timestamp) is shown in the log file.
This property page provides the following tabs:
Note:
If Natural Security is active, the parser settings can also be
defined in the properties of a library. In this case, the library properties
override the project properties. See
Changing the Library
Properties.
On this tab, you can modify the following Natural profile parameters:
| Option | Corresponding Natural Profile Parameter |
|---|---|
| Interpretation of database field short names | DBSHORT |
| Length/format specification | FS |
| Keyword checking | KCHECK |
| Parameter checking for CALLNAT statements | PCHECK |
| Structured mode | SM |
For detailed information on these profile parameters, see the Natural documentation for the appropriate platform.
The Parser mode drop-down list box, which is also provided on this tab, allows you to define the platform for which the Natural language syntax is to be checked. You can select one of the following options:
Mainframe compatible
Natural sources are checked according to the Natural syntax for
mainframe platforms.
Open systems compatible
Natural sources are checked according to the Natural syntax for
Windows, UNIX and OpenVMS platforms.
Error tolerant
This is the default setting. When the Natural sources are checked,
all valid Natural syntax is accepted, no matter for which platform you are
currently developing. An error will occur only if invalid Natural syntax is
found which does not apply to any of the supported platforms.
For example, if you are developing for UNIX platforms and your code contains special syntax which is only valid for mainframe platforms (such as the SQL extended set for DB2 databases), the parser will not consider this as an error.
Platform compatible
When the Natural sources are checked, not all Natural syntax is
accepted. The parser only accepts syntax which can be used on all
supported platforms. An error will occur if platform-specific syntax is found
(even if this is the correct syntax for a specific platform).
For example, if your code contains special syntax which is only valid for mainframe platforms (such as the SQL extended set for DB2 databases), the parser will consider this as an error.
On this tab, you can modify the following Natural profile parameters:
| Option | Corresponding Natural Profile Parameter |
|---|---|
| Line size | LS |
| Page size | PS |
| Spacing factor | SF |
| Maximum year | MAXYEAR |
For detailed information on these profile parameters, see the Natural documentation for the appropriate platform.
This property page provides the following tabs:
On this tab, you can modify the following Natural profile parameters:
| Option | Corresponding Natural Profile Parameter |
|---|---|
| Set terminal command character | CF |
| Terminal command character | |
| Decimal character | DC |
| Input assign character | IA |
| Input delimiter character | ID |
| Dynamic thousands separator | THSEP |
| Thousands separator character | THSEPCH |
For detailed information on these profile parameters, see the Natural documentation for the appropriate platform.
On this tab, you can modify the following Natural profile parameters:
| Option | Corresponding Natural Profile Parameter |
|---|---|
| Date representation | DTFORM |
| User language | ULANG |
For detailed information on these profile parameters, see the Natural documentation for the appropriate platform.
The Project encoding drop-down list box, which is also provided on this tab, provides for selection all code pages that are valid for the Natural environment (Natural server or local Natural runtime) which is currently defined on the Runtime page of the project properties. When set to blank, a code page is not defined for the project. When the Natural environment is updated, the default code page defined in this environment will be used. New sources will be created using the code page that is defined for the project.
This property page shows the mapping information for the Natural environment (Natural server or local Natural runtime) to which this project belongs. This information is used, for example, when you execute an object.
For information on the Natural server connection and startup options on this property page, see Mapping a Natural Environment.
The Use local Natural runtime option button is only visible when the local Natural runtime has been installed. When the local Natural runtime is selected, host name and port number are automatically provided and the corresponding text boxes appear gray.
If you want, you can assign your project to a different Natural environment. If you do so, it is likely that the security status of the project no longer matches the security status of the new Natural environment. Therefore, a dialog box appears which allows you to change or keep the current security status:
When you change the Natural environment from a secure environment (protected by Natural Security) to an unsecure environment or vice versa, a dialog box appears, asking whether you want to change the security status of the project (for example, from secure to unsecure). In addition, when you decide to change the security status, you can adapt the properties for all libraries so that they match the properties of the new environment:
When you change to an unsecure environment, you can specify that the existing security properties are to be removed from all Natural libraries.
When you change to a secure environment, you can specify that properties are to be added to all Natural libraries with the security settings from the secure environment.
When you change from a secure environment to a different secure environment, a dialog box appears asking whether you want to update the properties of all Natural libraries with the security settings from the new environment.
You can modify the following Natural profile parameter on this page:
| Option | Corresponding Natural Profile Parameter |
|---|---|
| Processing loop limit number | LT |
For detailed information on this profile parameter, see the Natural documentation for the appropriate platform.
Note:
If Natural Security is active, this profile parameter can also be
set in the properties of a library. In this case, the library properties
override the project properties. See
Changing the Library
Properties.
This page is only available when the project pertains to a server environment which is not protected by Natural Security. If the server environment is protected by Natural Security, you can only define steplibs for a library; see Changing the Library Properties.
On this property page, you can define steplibs and the development mode in which the build is to be performed on the Natural server.
When the Natural server is updated (see Updating the Objects in the Natural Environment), all new and changed sources of a project are uploaded to the server and are stowed there. The development mode that you define determines the target libraries on the server. Two modes are available:
Shared Mode
This is the default mode. The sources are uploaded to libraries
which have the same names as in the Eclipse workspace and are stowed in these
libraries.
Shared mode has the disadvantage that unpredictable results may occur if two users update the same sources on the same server at about the same time. In the best case, the update initiated by the second user overwrites the updates made by the first user, and the subsequent stow process thus considers only the changes made by the second user.
When your original sources are stored on the Natural server (and not in the repository of a version control system), shared mode must be active for production.
Private Mode
When several users work with the same libraries, it is
recommended that you use private mode for development and testing. With this
mode, private-mode libraries are automatically created on the Natural server.
They remain there persistently. For more information, see
Private-mode
Libraries in NaturalONE in a
Nutshell.
The name of each private-mode library has a prefix which is defined in the Natural preferences (see Natural > Options in Setting the Preferences). In the Natural preferences, it is also possible to define a label decoration for a library in the workspace which displays the name of the associated private-mode library (see Label Decorations in Setting the Preferences).
The sources are uploaded to private-mode user libraries which belong only to one user; they are not shared by other users. The resulting cataloged objects are also stored in these private-mode user libraries. This has the advantage that each user can develop and test an application without affecting the sources of other users.
Exception: DDMs can only be uploaded to private-mode user
libraries if they are stored in libraries in the server environment. This is
the case in UNIX, OpenVMS and Windows environments when the
FDDM parameter has not been set. DDMs which are not
stored in libraries in the server environment are always uploaded to their
original locations. It is not possible to upload them to private-mode user
libraries. These are the DDMs which are stored in the FDIC system
file (mainframe) and in the FDDM system file (UNIX, OpenVMS and
Windows when the FDDM parameter has been set).
In addition to the private-mode user libraries, a private-mode steplib can be created for each steplib which exists in the current project. The search sequence is changed in such a way that each private-mode steplib is searched before the corresponding original steplib is searched.
You can define your own names for the private-mode steplibs or you can create the names automatically. See below.
After a successful test, the changes can either be stored on the server (in shared mode) or they can be committed to the repository of a version control system, depending on the location where your original sources are stored.
Notes:
A steplib is a Natural user library or system library that is
concatenated with the current user or system library. This avoids redundant
storage of identical objects and helps organize applications. Natural searches
in a steplib when an object is not found in the current library. The standard
steplibs are the libraries SYSTEM in the system files
FUSER and FNAT. The additional steplibs that you
define on this property page are searched for an object before the standard
steplibs.
*STEPLIB
This option corresponds to the Natural profile parameter
STEPLIB which specifies the initial setting for the
system Natural variable *STEPLIB. You can specify
any valid library name.
Steplib Table
You can define up to eight steplibs in the steplib table. The
steplib number is shown in the first column and cannot be changed. The search
sequence is determined by the steplib number (number 1 is searched first).
When you add or modify a steplib, you specify the following information:
| Option | Description |
|---|---|
| Library name | The name of an existing library. |
| Private-mode name | Only available in private mode. Optional.
The name of the private-mode steplib that is used in addition to the existing
steplib.
Private-mode names can only be generated for libraries which exist in the current project. When you add or modify a steplib and the library name you specify cannot be found in the current project, the text box is dimmed and it is thus not possible to enter a private-mode name. On the other hand, when you modify a steplib and if a private-mode name has already been generated, the generated name is shown in a dimmed text box. |
| DBID | The database ID of the system file in which the library is located. |
| FNR | The file number of the system file in which the library is located. |
The following command buttons are available:
| Command Button | Description |
|---|---|
| Add a new steplib. Alternative: double-click any empty line. A new steplib is always added in the next empty line. It is not possible to add more than 8 steplibs. | |
| Modify the library name, private-mode name, DBID and/or FNR for the selected steplib. Alternative: double-click a defined steplib. | |
| Delete the selected steplib. Any defined steplibs after the deleted steplib are automatically moved up in the table and thus receive a different steplib number. | |
| Move the selected steplib to a higher steplib number (in this case, the steplib is moved down in the table). | |
| Move the selected steplib to a lower steplib number (in this case, the steplib is moved up in the table). | |
| Delete all steplib entries. | |
| Only available in private mode. Generates a private-mode name for each steplib for which a private-mode name has not yet been defined. The generated name includes the prefix which is defined in the Natural preferences; see Natural > Options in Setting the Preferences. |
You can use any kind of project (for example, a Java project) with NaturalONE. However, you have to enable it first.
Natural projects which have been created with Natural for Eclipse
cannot be used immediately with NaturalONE. If you have imported such a project
into NaturalONE or if you have checked it out from your version control system,
you first have to enable it for NaturalONE. A Natural project which has not yet
been enabled for NaturalONE is indicated by the following icon:
.
To enable a project for NaturalONE
In the Navigator view, select the project that you want to enable.
Invoke the context menu and choose .
Note:
This command is only visible when you select a project which has
not been created with NaturalONE.