The settings option is used to specify option settings for the unload, load, find or scan function and parameter settings for the unload or load function.
To invoke the Unload/Load/Scan Settings screen
On any of the unload, load or scan screens, enter the following internal command:
SETTINGS
See also Commands for Navigation and Special Functions in the section Direct Commands.
Or:
Activate advanced-user mode, choose a function and choose
ENTER to start the processing procedure.
Or:
On advanced-user screens, choose PF7 (Setti).
Unless selected by default, to activate the options provided on the Unload/Load/Scan Settings screen described below, mark the corresponding input field with any single character.
This section covers the following topics:
The Unload/Load/Scan Settings screen provides the following fields and PF keys:
| Field | PF Key | Explanation |
|---|---|---|
| Transfer format | Only valid if
Use default
options (this is the default) has been selected.
If selected, the data to be processed is written/read in Transfer format to/from the work file. See also Work File Format in Work Files. Unload function: Load and scan functions: |
|
| Unicode work file | Only applies to the unload function and if
Transfer format has been selected.
If this option is selected, all object sources are converted to Unicode/UTF-8 (Universal Transformation Format, 8-bit form) before they are written to the work file. If a Unicode work file is specified, you cannot use the transfer options Use conversion table, Substitute line references and Incorporate free rules. |
|
| Portable work file | Not required for the load and scan functions,
which automatically choose the appropriate work file type and ignore this
option if set.
Portable work file is only valid if the following applies:
|
|
| Work file |
PF11 |
Only valid if
Use default
options (this is the default) has been selected.
The name of the work file to be used for the function. If the name exceeds the space available, choose PF11 (WorkF) and enter a longer name of up to 253 characters. Alternatively, position the cursor at this field and choose PF1 (Help). See also Work Files. |
| Use default options | Default options are used (this is the default). See also Profile Settings and Set Additional Options. | |
| Set additional options | PF4 | Only valid if
Use default
options has been selected.
Invokes the Options screen where you can modify the default settings and enter additional options for the processing sequence. For the options available, see Set Additional Options. |
| Use Option Workplan | A Workplan of the type OPTION is used. See also Workplans. | |
| Name
(next to Use Option Workplan) |
Only valid if Use Option
Workplan has been selected.
The name of a Workplan of the type OPTION to be used. |
|
| List Option Workplan | PF6 | Only valid if Use Option
Workplan has been selected.
Displays the contents of the Workplan specified in the Name field next to Use Option Workplan. |
| Select Option Workplan | PF5 | Only valid if Use Option
Workplan has been selected.
Displays a selection list of available Workplans of the type OPTION (see also List the Available Workplans in the Workplan Library in Administration). |
| Do not use parameters | If selected (default setting), no parameters are set. | |
| Use global parameters | Global parameters are used. See Set Global Parameters. | |
| Set global parameters | PF7 | Only valid if Use global
parameters has been selected.
Invokes the Parameters screen. See Set Global Parameters and parameter-setting (Direct Commands) for descriptions of keywords and valid input values. |
| Use Parameter Workplan | A Workplan of the type PARAMETER is used. See also Workplans. | |
| Name
(next to Use Parameter Workplan) |
Only valid if Use Parameter
Workplan has been selected.
The name of a Workplan of the type PARAMETER to be used. |
|
| List Parameter Workplan | PF9 | Only valid if Use Parameter
Workplan has been selected.
Displays the contents of the Workplan specified in the Name field next to Use Parameter Workplan. |
| Select Parameter Workplan | Only valid if Use Parameter
Workplan has been selected.
Displays a selection list of available Workplans of the type PARAMETER. See also List the Available Workplans in the Workplan Library in Administration. |
The sections contained in the Options screen are described below. Note that not all of the sections may appear on the screen, because they depend on the function used, the settings defined and the products installed.
For descriptions of keywords and valid input values, see also option-setting in the section Direct Commands.
This section covers the following topics:
The options provided for work files and reports are described in the following section.
| Field | Explanation |
|---|---|
| Work file | The work file used for the unload, load or scan function:
enter the complete path name assigned to Work File 1.
If the name exceeds the space available, choose PF4 (WorkF) and enter a longer name of up to 253 characters. Alternatively, position the cursor at this field and choose PF1 (Help). See also Work Files. |
| Write report | Writes a report of the objects processed to
Work File 4.
The Write report option is selected by default. To display the report, enter the internal command |
| Start new report | Only valid if Write report has been
selected.
Deletes the contents of Work File 4 before a new report is written. Otherwise, a new report is appended to the existing one. |
| Report file | Only valid if Write report has been
selected.
The name of the report file: enter the complete path name assigned to Work File 4. If the name exceeds the space available, choose PF5 (RepoF) and enter a longer name of up to 253 characters. Alternatively, position the cursor at this field and choose PF1 (Help). |
| Write restart information | Only applies to the load function.
When this option is set, restart information is provided for the restart load function. For details, see Restart Load in Functions. |
| Restart file | Only applies to the load function and if Write
restart information has been selected.
The name of the work file to be used for the restart data: Work File 6 (default setting) or the restart-file specified. If the name exceeds the space available, choose PF6 (RestF) and enter a longer name of up to 253 characters. Alternatively, position the cursor at this field and choose PF1 (Help). |
| Use FDDM file for processing DDMs | Only applies in environments where the FDDM system file has
been activated in the NATPARM module.
If this option has been selected (this is the default), the FDDM system file is used for processing DDMs with the load, unload or find function. Specify the library If used with the load function, all DDMs are loaded into the FDDM
system file. In this case, the parameter
See also the syntax diagram of the option-clause in Direct Commands. |
XREF options are only available when unloading or loading data in internal format, that is, if the field Transfer format has not been selected. Predict must be installed to process XRef data.
The XREF options provided and the functions to which they apply are described in the following section.
| Field | Explanation | Function |
|---|---|---|
| Yes (unload XRef data)
or Yes (load XRef data) |
Unloads cataloged objects and their cross-reference data, if any. Loads cataloged objects and their cross-reference data if cross-references exist in the work file. |
Unload |
| No (ignore XRef data) | No XRef data is processed. |
Unload |
| Force |
Loads cataloged objects and their cross-reference data only if cross-references exist in the work file and if Predict entries exist for the objects in the FDIC system file. |
Load |
| Doc |
Loads cataloged objects only if Predict entries exist for the objects in the FDIC system file. |
Load |
| Special |
Loads cataloged objects and their cross-reference data (if any). |
Load |
Transfer options are only available when processing data in Transfer format, that is, if the field Transfer format has been selected.
The transfer options provided and the functions to which they apply are described in the following section.
| Option | Explanation | Function | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Substitute line references | Only applies if source-code line numbers are used for
statement references.
If line numbers are used as references in the source code, the line numbers of referenced lines and the line number references are replaced with labels. The sources are not modified in the database. |
Unload | ||||||||||||||||||
| Include line numbers | If you choose this option, the line numbers will be transferred. (By default, line numbers in Natural objects are not transferred.) | Unload | ||||||||||||||||||
| Incorporate free rules | If Predict is installed, Predict rules associated with a map are incorporated into the map source. | Unload | ||||||||||||||||||
| Use conversion table |
Caution:
Unload:
Load: |
Unload |
||||||||||||||||||
| System table | Only valid if
Use conversion
table has been selected.
Unload:
Load: |
Unload |
||||||||||||||||||
| User table | Only valid if
Use conversion
table has been selected.
If the name of a conversion program has been entered in the field, data is converted to EBCDIC or ASCII format by using the conversion program defined. To specify an individual conversion program, the program must be located in the library SYSOBJH or one of its steplibs. See the example subprograms OTNCONAE and OTNCONEA in the library SYSOBJH. If no conversion program is specified, by default, the corresponding conversion table in the Natural file NATCONV.INI is used for the unload ([ISO8859_1->EBCDIC] ) and the load ([EBCDIC->ISO8859_1]) functions. |
Unload |
||||||||||||||||||
| Use load code page | If you choose this option, a window appears where you can
enter the name of the code page to be used for the load function.
If this option is selected, all object sources unloaded into a work file in UTF-8 will be converted with the specified code page when they are loaded into a work file. See also Unicode work file. If you enter If no code page name is specified, the source objects are converted with the code page used when unloading them. If Use load code page is specified, you cannot use the options Use conversion table and Translate to upper case. |
Load | ||||||||||||||||||
| Translate to upper case | Translates any source code to be loaded into upper case. | Load | ||||||||||||||||||
| Data area format |
|
Unload |
||||||||||||||||||
The replace options described below only apply to the load function:
| Do not replace | Does not replace any objects. This is the default. |
| Replace all | Replaces all objects. |
| Replace obsolete | Replaces objects with a date older than the date of the objects in the load file. |
| Replace except newer | Replaces all objects except those with a date newer than the date of the objects in the load file. |
Number to process only applies to the load and scan functions.
In the field Number to process, enter a value with a maximum of 5 digits. If a value greater than 0 is specified, the load or scan function stops after the specified number of objects has been processed.
Note:
If a cataloged Natural object is processed directly after the source
object of the same name, they are considered one object.
FDIC settings only apply if Predict is installed.
They specify the Predict file (FDIC) to be used for processing XRef data:
| DBID | The database ID where the FDIC file is located. |
| FNR | The file number where the FDIC file is located. |
| Password | Optional. The Adabas password of the Adabas file where the FDIC file is located. |
| Cipher | Optional. The cipher code of the Adabas file where the FDIC file is located. |
FSEC settings only apply if Natural Security is installed.
FSEC settings are used to specify the Natural Security data file (FSEC) to be used for security checks:
| DBID | The database ID where the FSEC file is located. |
| FNR | The file number where the FSEC file is located. |
| Password | Optional. The Adabas password of the Adabas file where the FSEC file is located. |
| Cipher | Optional. The cipher code of the Adabas file where the FSEC file is located. |
The fields provided on the Parameters screen can be used to change global parameter settings for the objects to be processed with the load or unload function, and to change the target environment for the load function. For example, you can specify new names (or name ranges) under which the selected objects are unloaded to the work file, or you can specify a different library into which the selected objects are loaded from the work file.
If global parameters are specified during the unload function, the parameter settings affect the objects before they are written to the work file. If they are specified during the load function, the parameter settings affect the objects before they are written to the target environment.
The values that can be specified to change parameter settings, are entered next to the required parameters in the fields Check Value and New Value.
If no value has been entered in Check Value, the value entered in New Value affects all objects to which the specific parameter setting applies. If a value has been entered in Check Value, the value entered in New Value only affects objects to which the specific parameter setting and the value entered in Check Value apply. If a Check Value or New Value is not relevant to the type of object to be processed, any value entered in either field will be ignored. For example: Natural system error messages have no library name. Therefore, when processing Natural system error messages, a value entered in Check Value or New Value for the Library field will be ignored.
Check Value and New Value do not apply to the parameter Error number difference and the parameters contained in the section System files for load of the Parameters screen.
For valid parameter settings, see also parameter-setting in the section Direct Commands.
The following fields are contained in the Parameters screen:
| Field/Section | Explanation | ||
|---|---|---|---|
| Object name | Check Value/New Value:
A single object name or a range of names: see Name in Name, Date and Time Specification and Rules for New Values. Note: |
||
| Library | Check Value/New Value:
A single library name or a range of names: see Name and Rules for New Values. |
||
| Date | Check Value/New Value:
A single date or a range of dates: see Date in Name, Date and Time Specification and Rules for New Values. |
||
| Time | Check Value/New Value:
A time or a range of times: see Time in Name, Date and Time Specification and Rules for New Values. |
||
| User ID | Check Value/New Value:
A single user ID or a range of user IDs: see Name and Rules for New Values. |
||
| Lang. codes | Only applies when processing Natural system error messages or
user-defined error messages.
Check Value/New Value: Up to 8 valid language codes such as code Note: New Value does not apply to the long
texts of Natural system error messages for which English (code |
||
| Error number difference | Only applies when processing Natural system error messages or
user-defined error messages.
A 4-digit positive or negative value (+/-nnnn) to be used as a new number range for error messages. Start and end values must be provided in the Error number from/to fields (see Natural Library Objects) to validate whether the new range can be applied to the selected error messages. Example: If Error number from/to selects message
numbers 1 to 10 and Error number difference is set to
|
||
| FDT DBID/FNR | Check Value/New Value:
A valid database ID (DBID) and/or file number (FNR) for Adabas FDTs. |
||
| Ext. Path | Check Value/New Value:
The name of the path for external objects. If the name exceeds the space available, choose PF6 (CPath) for Check Value or PF7 (NPath) for New Value and enter a longer name of up to 253 characters. Alternatively, position the cursor at either field and choose PF1 (Help). |
||
System files for load: Load FNAT
|
Only applies to the load function.
The database ID (DBID) and file number
(FNR) of the target FNAT system file. This system file is
used for all library objects whose library name starts with |
||
System files for load: Load FUSER
|
Only applies to the load function.
The database ID (DBID) and file number
(FNR) of the target FUSER system file. This system file is
used for all library objects whose library name does not start with
|
||
| System files for load: Load FNAT/FUSER
Select |
Only applies to the load function.
Invokes the Select System File window with a list of all system files available in your Natural environment: see Select System File. |
||
System files for load: Load NCP
|
Only applies to the load function.
The database ID (DBID) and file number (FNR) of the target Adabas file into which the Natural command processor sources are to be loaded. |
This section covers the following topic:
The following applies to New Value for Object name, Library, Date/Time and User ID.
If New Value contains a range with an asterisk (*)
such as ABC*, the number of characters before the asterisk (*)
determines the number of characters to be replaced in Check
Value. This is also valid if Check Value is
shorter than the range specified in New Value (see the
second example in Examples below).
If Object name is ABCDEFG and
New Value is set to ZYX*, the resulting
object name is ZYXDEFG.
If Object name is AB and
New Value is set to ZYX*, the resulting
object name is ZYX.
If Date/Time is 2005-03-26 and
New Value is set to 2006*, the resulting
object date is 2006-03-26.
