The option-setting clause is used to change the default values of Object Handler command options.
The syntax that applies to the option-setting clause is shown and explained in the following section. The keywords and variable values contained in the syntax diagrams shown represent the parameters that are used to specify the default values. If indicated, a variable value must be supplied with a keyword.
WHERE
|
||
|
|
(option-workplan) |
|
The syntax diagram that applies to option-workplan is shown and described in Referencing Workplans in the section Workplans.
The syntax of the option-clause is shown in the following section.
|
|
REPLACE
|
|
|
|
|||||||||||
|
|
|
||||||||||||||
|
|
|
|
|||||||||||||
|
|
REPORT-OPTION-1 |
|
|
|
|
||||||||||
|
|
REPORT-FORMAT |
|
|
|
|
||||||||||
|
|
REPORT-MODE |
|
|
|
|
||||||||||
|
|
|
||||||||||||||
[NUMBERPROCESS
number] |
|||||||||||||||
[FIXEDLENGTH] |
|||||||||||||||
[FDIC
(dbid,fnr,password,cipher)] |
|||||||||||||||
[FSEC
(dbid,fnr,password,cipher)] |
|||||||||||||||
|
|
|
|
|
|
|
||||||||||
|
|
|
|
[file-name] |
|
|||||||||||
|
|
|
|
command-file-number |
|
|||||||||||
|
|
USE-FDDM |
|
|
|
|||||||||||
|
|
|
|
file-name |
|
|
|
|
|
|
|
|||||
[ADAFDUWORKFILE
file-name] |
|||||||||||||||
Commas must be used as separators between the values following the FDIC
and FSEC keywords, or if a value is missing. For example: FDIC
(10,21,,2a).
If the session parameter ID (see ID - Input Delimiter Character in the
Parameter Reference documentation) has been set to a comma, use a
slash (/) as the separator between values.
TRANSFER
|
|||||
|
|
CONVERSION-TABLE
|
|
|
|
|
[SUBSTITUTE] |
|||||
[INCLUDE-LINE-NUMBERS]
|
|||||
[UPPERCASE-TRANSLATION] |
|||||
[INCORPORATE-FREE-RULES] |
|||||
[LOAD-CODE-PAGE
code-page-name]
|
|||||
[DA-FORMAT
data-area-format]
|
|||||
|
|
XREF |
|
|
|
||
[DELETEALLOWED] |
||||||
The keywords and the variable values (if relevant) of option-setting are explained in the following section:
| Option | Explanation | Restricted to Command | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
REPLACE |
Replaces existing objects according to the option specified:
|
|
||||||||||
TRANSFER |
Set Transfer mode.
The data is read and written in Transfer format. For valid options, see Keyword Explanation of transfer-options. |
|
||||||||||
NOREPORT |
Specifies the report file setting:
No data is recorded to a report file.
This is the default setting for the |
|||||||||||
NEWREPORT |
Specifies the report file setting:
Report data is recorded and written to Work File 4 or file-name. An existing file will be overwritten. |
|||||||||||
REPORT
|
Specifies the report file setting:
Report data is recorded and written to
Work File 4 or
file-name. This is the default setting
for the commands |
|||||||||||
BATCHREPORT |
Specifies the report setting for batch processing or when using the OBJHAPI Application Programming Interface: Report data is either written to SYSOUT or output on the screen respectively (report data is not written to a file). |
|||||||||||
|
|
Specifies the report option to be used when a direct command
is executed and a report is to be written:
|
|
||||||||||
|
|
Specifies the report format to be used when a direct command
is executed and a report is to be written:
|
|
||||||||||
|
|
Specifies the report mode to be used when a direct command is
executed and a report is to be written:
|
|||||||||||
NORESTART
|
No restart information is written to a file. | LOAD |
||||||||||
RESTART
|
Restart information is written to Work File 6 or restart-file. | LOAD |
||||||||||
NUMBERPROCESS
|
Specifies the number of objects to be processed.
The
|
|
||||||||||
FIXEDLENGTH
|
Sets the format of the unload work file to a maximum record length of fixed
size.
Every data record contains 256 bytes if written in internal format, or 100 bytes in Transfer format.
|
UNLOAD |
||||||||||
FDIC |
Specifies the system file FDIC to be used for processing:
the database ID (dbid), file number (fnr), password (password) and cipher code (cipher) of the Adabas file. If no values (or |
|
||||||||||
FSEC |
Specifies the system file FSEC to be used for processing:
the database ID (dbid), file number (fnr), password (password) and cipher code (cipher) of the Adabas file. If no values (or |
|
||||||||||
USE-FDDM |
Specifies that the FDDM system file is used for processing: see Keyword Explanation of USE-FDDM below. |
|
||||||||||
| Specifies the work file to be used.
The |
|
|||||||||||
Not required by the LOAD and
SCAN commands, which automatically choose the
appropriate work file type and ignore this keyword if specified.
The work file type of Natural Work File 1 when data is read and written in internal format:
(See also Work File Format in Work Files.) If |
|
|||||||||||
ADAFDUWORKFILE
|
The complete path name assigned to the work file (Natural Work File 5) into which Adabas FDT data is loaded. | LOAD |
||||||||||
| Only applies if Entire Connection is installed.
Writes data to or reads data from an Entire Connection work file. file-name denotes 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. If you do not specify file-name, Entire Connection prompts you for the name of a work file. If See also Work File Assignment in Work Files. |
|
|||||||||||
| Only applies if Entire Connection is installed.
Specifies the number of the work file that is used for processing Entire Connection commands. The default value is See also Work File Assignment in Work Files. |
|
The keywords and the variable values (if relevant) of transfer-options and internal-format-options are explained in the following section:
When using the TRANSFER keyword, you can specify the following
options:
| Option | Explanation | Restricted to Command | ||||
|---|---|---|---|---|---|---|
CONVERSION-TABLE |
Converts data processed in Transfer format by using either of the
following conversion tables:
The internal Natural conversion table.
A user-defined conversion table if conversion-program has been specified. This program must be stored in the library SYSOBJH or one of its steplibs; see the example programs OTNCONAE and OTNCONEA in the library SYSOBJH. If no conversion-program is specified, the corresponding conversion table is used in NATCONV.INI ([ISO8859_1->EBCDIC] or [EBCDIC->ISO8859_1]). |
|
||||
SUBSTITUTE
|
Replaces line references by labels during the unload in Transfer format. This option only applies if your source-code line numbers are used for statement references. If so, the line numbers of referenced lines and the line number references are replaced by labels. The sources are not modified in the database. |
UNLOAD |
||||
INCLUDE-LINE-NUMBERS |
Transfers line numbers during the unload in Transfer format. |
UNLOAD |
||||
|
|
|
|
||||
UPPERCASE-TRANSLATION |
Translates any source code into upper case during the load in Transfer
format. |
LOAD |
||||
INCORPORATE-FREE-RULES |
Incorporates source text of Predict free rules associated with a map into a map source during the unload in Transfer format if Predict is installed. | UNLOAD |
||||
LOAD-CODE-PAGE |
Specifies the code page to be used for converting object sources encoded in Unicode/UTF-8 (Universal Transformation Format, 8-bit form). If you use this option, 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. If you specify If code-page-name is not specified, the source objects are converted with the code page used when unloading them. If |
|
||||
DA-FORMAT |
Specifies format conversion of data area sources: see Data area format in Transfer Options in Settings. |
|
When using internal-format-options, you can specify the following:
Specifies that the FDDM system file is used for processing.
If the FDDM file has been activated in the NATPARM parameter file, the default setting
is YES.
The following applies when specifying the values YES or
NO:
| Value | Explanation |
|---|---|
YES
|
UNLOAD, FIND and
DELETE:
If the parameter No DDMs are processed if the parameter
DDMs are loaded into the library SYSTEM located in the FDDM file. See also |
NO |
UNLOAD, FIND and
DELETE:
DDMs are processed from the libraries specified.
DDMs are loaded into the libraries specified. |
