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, OpenVMS 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, UNIX or OpenVMS 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.