This section describes work files and valid formats that apply to the unload, load and scan functions of the Object Handler.
Object Handler functions invoked in a local environment will only process objects from this local environment, with a work file located in the current local file system. Object Handler functions invoked in a remote environment will only process objects from the same remote environment. The work file used for the load or unload function is located in the same remote environment or in your local file system.
See also General in Settings - Options, the
section Work
Files in the Operations documentation, the
statement DEFINE WORK FILE in the
Statements documentation and the profile parameter WORK in the Parameter
Reference documentation.
This section covers the following topics:
This section covers the following topics:
The following table lists the work files used by the Object Handler in local environments.
| File | Explanation |
|---|---|
| Work File 1 | Used for the unload, load and scan functions.
Contains the data unloaded. See also Transfer Work File in Tools. |
| Work File 3 | Used for internal reports.
Contains scan and find results. |
| Work File 4 | Used if the option Write report (see Settings -
Options) is set. Write report is the default
setting for object processing.
Contains report data. |
| Work File 5 | The target file for the Adabas FDTs (Field Definition Tables) loaded. |
| Work File 6 | Used for the load function if the option Write restart
information (see Restart Load in Functions)
is set.
Contains restart information data. |
| Work File 7 | An internal work file. |
| Work File 9 | An internal work file. |
| Work File 10 | Used if the trace mode is set.
See also Traces in Tools. |
| Work Files 11 to 15 | Internal work files. |
The following table lists the work files used in remote environments.
| File | Location | Explanation |
|---|---|---|
| Work File 1 | local system | If the option Local work file is set (see
Settings - Options), this work file is used for the unload,
load and scan functions. It contains the data processed.
Additionally, in mainframe environments, this work file is used to transfer work files from the local environment to the server and vice versa as described in Transfer Work File in Tools. |
| Work File 1 | server system |
If the option Local work file is not set (see Settings - Options), this work file is used for the unload, load and scan functions. It contains the data processed. Additionally, in mainframe environments, this work file is used to transfer work files from the local environment to the server and vice versa as described in Transfer Work File in Tools. Note that in a mainframe environment work files must be specified properly. See also Natural User Access Method for Print and Work Files in Configuring Natural in the documentation Natural Operations for Mainframes. |
| Work File 3 | local system | An internal work file. |
| Work File 9 | local system | An internal work file. |
| Work Files 11 to 15 | local system | Internal work files. |
There are two file formats for unloading objects in the source environment into work files and for loading them from work files into the target environment: an internal format and the Transfer format. Work files must be of internal format to transfer binary data. Work files must be of Transfer format to transfer text data.
This section covers the following topics:
The internal format is an internal record layout for work files that are used to transfer Natural sources and cataloged objects, error messages, Natural command processor sources, Adabas FDTs and non-Natural objects from one environment to another.
With the internal format activated, Natural objects are read from the source environment and written to a Natural work file by using the unload function of the Object Handler. This work file can be transported to another environment with standard file transfer services. In the target environment, the objects can then be read from the work file and loaded into the local file or database system with the load function of the Object Handler.
To transfer objects between identical platforms, use work files of internal
format. Use portable work files of internal format if you want to transport objects
between different UNIX or Windows platforms, for example, from a little-endian machine
to a big-endian machine. See also Portable work file in Settings -
Options, Portable Natural Generated
Programs (Programming Guide) and DEFINE WORK FILE
(Statements documentation).
The Object Handler uses internal format by default. When using the internal
format (Transfer format check box not selected), Work File
1 must be of binary format. To achieve this, omit the file extension or use the file
extension .sag.
Notes:
See also Transfer format in the section Settings - Options.
The Transfer format is a general record layout for work files that contain load or unload data. This format is platform-independent and can be used to transfer the sources of Natural objects, Natural command processor sources, error messages and Adabas FDTs (Field Definition Tables) from one hardware platform to another and between Windows and mainframe or UNIX platforms.
With the check box Transfer format selected, the unload function of the Object Handler reads Natural objects from a hardware platform and then restructures them.
Formatted records are written to a Natural work file that can be transported to another platform with standard file transfer services. On the target platform, the load function of the Object Handler then reads the objects from the work file and loads them into the local file or database system. The objects read from the work file are restructured according to the structure of the new hardware platform.
If Transfer format is specified (check box Transfer
format selected), Work File 1 must be of text (ASCII) format. To achieve
this, a file extension must be used, but not the file extension .sag. If
Transfer format is not specified, Work File 1 must be of binary format. To
achieve this, omit the file extension or use the file extension .sag.
Work File 1 must be defined in the server environment. If Transfer format is specified (check box Transfer format selected), Work File 1 contains data of text (ASCII) format. If Transfer format is not specified, Work File 1 contains data of internal format.
Transfer format is also used to unload or load sources of Natural objects in
Unicode/UTF-8 (Universal Transformation Format, 8-bit form). If you specify the
corresponding unload option (WORKFILETYPE set to UTF-8 in command mode or
Unicode work
file in menu mode), all object sources will be unloaded into a
work file in UTF-8. If you specify the corresponding load option (LOAD-CODE-PAGE in
command mode or Load
code page in menu mode), all object sources in UTF-8 will be
converted with the specified code page when they are loaded into a Natural system
file.
Work files created by the utility SYSTRANS must be processed in Transfer format. Work files that contain object sources encoded in UTF-8 cannot be processed with SYSTRANS.
