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.
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. |
|
Use PC File |
Only applies if Entire Connection is installed.
If selected, the data to be processed is read from or written to an Entire Connection work file. |
|
PC File | Only applies if Entire Connection is installed.
The complete path name to the Entire Connection work file. If your system environment does not accept a backslash (\) separator, use a slash (/) instead. |
|
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 |
---|---|
Use PC File | Only applies if Entire Connection is installed.
If selected, the data to be processed is read from or written to an Entire Connection work file. |
PC File | Only applies if Entire Connection is installed.
The complete path name assigned to the Entire Connection work file. If your system environment does not accept a backslash (\) separator, use a slash (/) instead. |
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. |
Write report |
Writes a report of the objects processed to the report text
member specified in the Report text member field.
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 the report text member before a new report is written. Otherwise, a new report is appended to the existing one. |
Error report only | Only valid if Write report has been selected.
Write
only error messages to the report. This includes messages from Natural
Security and messages that have incurred during the execution of a LOAD
command, for instance "not replaced". See also |
Change report library | Only valid if Write report has been
selected.
Opens a new screen where you can change the report library. See also Change the Report Library
(Administration) and |
Report text member | Only valid if Write report has been selected.
The name of the text member stored in the Workplan library to which the report is written. |
Select text member | Displays a list of all text members stored in the Workplan library. From this list, you can select a Report text member. |
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 text member | Only applies to the load function and if Write restart
information has been selected.
The name of the text member in the Workplan library to which the restart information is written. If you do not specify a name, the Object Handler generates a name and assigns it to the text member. |
Select text member | Displays a list of all text members stored in the Workplan library. From this list, you can select a Restart text member. |
Delete allowed | Only applies to the load function. Processes delete instructions from work files when loading objects in internal format. |
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 and their cross-reference data (if any) 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 |
All cross-reference (XRef) data stored in the Predict system file can be processed with the Object Handler. The XREF option indicates whether the Object Handler should process XRef data. XRef data is always deleted if the delete or replace function is performed on a cataloged object.
If Predict has not been installed, set the XREF option to N
and thus no
validation of Predict files is performed. If the XREF option is set to Y
and the FDIC file being used is not a valid Predict file, an error message is
returned.
The rules for setting the XREF option are the same as the ones imposed by Natural Security. In a non-security environment there are no restrictions, see the first five cases described below. However, if Natural Security is active, as in the last case, the setting of the XREF option in the Object Handler depends on the value of the XREF option in the utility profiles of Natural Security.
Consider the following settings for XREF:
If the XREF option is set to OFF or No, no XRef data is processed. But in situations where a cataloged object is deleted or replaced, the Object Handler deletes the XRef data. The target Predict system file is determined according to the current settings of the FDIC option. The default is the value assigned to the profile parameter FDIC (see FDIC - Predict System File in the Parameter Reference documentation) at the start of the Natural session.
If the XREF option is set to Yes or Force, the following actions are applied during processing:
Unload
Unloads cataloged objects and their cross-reference data (if any).
Load
Loads cataloged objects and their cross-reference data if cross-references exist
in the work file.
Only applies to LOAD.
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.
If the XREF option is set to Force, the Object Handler additionally checks that the cataloged object has a Predict program entry defined on the Predict system target file. If not, processing of the object is terminated.
Only applies to LOAD.
If the XREF option is set to Doc, the Object Handler checks that the cataloged object has a Predict program entry defined on the Predict system target file. If not, processing of the object is terminated. The cataloged objects that have cross-reference data are processed with their cross-reference data, and the cataloged objects that have none are also processed.
Only applies to LOAD.
If the XREF option is set to Special, the special case applies where a range of specified cataloged objects is processed with corresponding XRef data regardless of whether all of the cataloged objects have cross-reference data or not: the cataloged objects that have cross-reference data are processed with their cross-reference data, and the cataloged objects that have none are also processed.
If Natural Security is active, the following applies:
If the value of the XREF option in the utility profiles of Natural Security is
N
or S
, you can specify any value
(OFF/No,
ON/Yes, Doc,
Force or Special) for the XREF option
in the Object Handler.
If the value of the XREF option in the utility profiles of Natural Security is
D
, you can specify only the values Doc or
Force for the XREF option in the Object Handler. If you
specify ON/Yes, the value
Force is used internally. If you specify
OFF/No or
Special, the value Doc is used
internally.
If the value of the XREF option in the utility profiles of Natural Security is
Y
, you can specify only the values
ON/Yes or Force
for the XREF option in the Object Handler. If you specify
Doc, internally the value Force is used,
if you specify OFF/No or
Special, the value
ON/Yes is used internally.
If the value of the XREF option in the utility profiles of Natural Security is
F
, you can specify only the value Force for
the XREF option in the Object Handler. If you specify any other value, the value
Force is used internally.
The Version check option is only available when loading data in internal format, that is, if the field Transfer format has not been selected.
If Version check is selected, the Natural version under which the objects were cataloged and written to the work file is compared with the current Natural version. Objects cataloged under a Natural version higher than the current one will be rejected.
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 |
||||||||||||||||||||
Unshape Arabic characters |
This option is used to replace shaped Arabic characters (code page IBM420) with the corresponding unshaped characters in the following source objects: Natural programs, DDMs, user error messages and system error messages. |
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 are used to specify the Predict file (FDIC) to be used for processing XRef data (only applies if Predict is installed) or load DDMs:
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. |
||||
Terminal ID |
Check Value/New Value:
A single terminal ID or a range of terminal 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. |
||||
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. If required, enter the Adabas password (Password) and the cipher code (Cipher) for the system file. |
This section covers the following topic:
The following applies to New Value for Object name, Library, Date/Time, User ID and Terminal 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.