Load Wizard

This section provides instructions for using the load wizard and describes the items available in wizard windows.

Start of instruction set To start the load wizard

  • In the Welcome to the Natural Object Handler window, remove the mark from the Advanced user check box (if necessary) and choose the Load command button.

    Or:
    From the Actions menu, choose Load.

    The initial Load Wizard window appears.

    The options provided in the Load Wizard window are described in this section.


Load/Scan Objects from/in Work Files

With the wizard function Load objects from Natural work file(s) or Scan objects in Natural work file(s), you are routed through the sequence of windows described in this section, where you can specify the option or parameter settings and the type of object for the load or scan to be performed.

Set Options

In the options window of the load/scan wizard, select any of the options to be used for function processing and, if required, fill the text box.

Item Explanation
Transfer format Only valid if Use default options (this is the default) or Use additional options has been selected. See below.

If selected, the data to be processed is written in Transfer format from the work file. Load/scan data is expected to be in Transfer format. See also Work File Format in Work Files.

Local work file Only applies to remote environments.

Only valid if Use default options (this is the default) or Use additional options has been selected. See below.

Specifies the location of the work file when using Object Handler functions in connection with SpoD (Single Point of Development). If Local work file is selected, the data to be processed is read from the work file specified in the local file system.

See also WFLOC in Direct Commands.

Portable work file This option is not required for the load and scan functions, which automatically choose the appropriate work file type and ignore the option if set.

In addition, this option does not apply to work files located in a remote environment on a mainframe platform.

Portable work file is only valid if the following applies:

See also Work File Format in Work Files.

Load file
or
Scan file

(Server)

Only valid if Use default options (this is the default) or Use additional options has been selected. See below.

The name of the work file to be used for the function. See also Work Files. On mainframes, the current Work File 1 is used as the default load/scan file.

Browse

Not applicable to server load/scan files.

Invokes the browse function to select a work file from a directory.

Use default options Default options are used (this is the default). For the options available, see Set Additional Options in Settings - Options.
Use additional options Used in connection with Set (see below).
Set Only activated if Use additional options has been selected.

Invokes the Load/Scan Options window where you can modify the default settings and enter additional options for the processing sequence. See also Set Additional Options in Settings - Options.

Use Option Workplan If this option is selected, a Workplan of the type OPTION is used.

Select a Workplan from the combo box or type the name of a Workplan of the type OPTION.

See also Workplans.

List Only valid if Use Option Workplan (see above) has been selected and the name of a valid Workplan of the type OPTION was entered.

Displays the contents of the Workplan specified.

Set Parameters

Applies to the load function only.

In the parameters window of the load wizard, select any of the options to be used for function processing and, if required, fill the text box:

Item Explanation
Do not use parameters If selected (default setting), no parameters are set.
Use global parameters If selected, global parameters are used. See also Set Global Parameters in Settings.
Set Only activated if Use global parameters has been selected.

If selected, the global parameters window is invoked. See Set Global Parameters (Settings) and parameter-setting (Direct Commands) for descriptions of keywords and valid input values.

Use Parameter Workplan If selected, a Workplan of the type PARAMETER is used.

Select a Workplan from the combo box or type the name of a Workplan of the type PARAMETER.

See also Workplans.

List Only valid if Use Parameter Workplan (see above) has been selected and the name of a valid Workplan of the type PARAMETER was entered.

Displays the contents of the Workplan specified.

Select Objects

Note:
You cannot load or scan Natural-related objects or external files in remote environments located on mainframe platforms. Natural DDMs can only be loaded or scanned on mainframe platforms.

For loading FDTs, see also FDTs in the section Object Specification.

In the object type specification window, choose any of the following options to specify the type of object you want to process:

  1. Select Load/Scan all objects from work file if you want to process all objects from the work file.

  2. Select Load/Scan selected objects from work file to process a particular type of object:

    Depending on the type of object selected, a window appears where you can specify selection criteria for the objects to be processed.

    Specify the objects and choose Details (if available for the type of object selected) for more detailed specifications, if required.

    For the keywords and valid values that apply to each object type, see the relevant explanations in the section Object Specification.

  3. Select Use Selection or List if you want to use a Workplan of the type SELECTION or LIST that predefines object selection criteria: see the section Workplans for more information.

    In the Selection or List window, enter the name of a Workplan of the type SELECTION or LIST by using either option:

    Type in the name of a Workplan.

    Or:
    From the drop-down list box, choose a name from the list of Workplans available.

Choose the List command button if you want to list the contents of the Workplan specified.

Start Object Handler Command Procedure

Choose the function Start Object Handler command procedure if you want to execute a standard procedure (Workplan) of the type PROCEDURE with predefined settings and object specifications. See also the section Workplans for further information.

Start of instruction set To start and execute an Object Handler command procedure

  1. In the initial window of a wizard, choose Start Object Handler command procedure.

    The Start Procedure window appears.

  2. In the field Procedure name, enter the name of a Workplan of the type PROCEDURE (see also Workplans) by using either option:

    • Type in the name of a Workplan.

      Or:
      From the drop-down list box, choose a name from the list of Workplans available.

    • Choose List if you want to display the contents of the Workplan specified.

  3. Confirm the contents of the PROCEDURE Workplan and execute the transaction.

Load SYSPAUL Application

Note that the Object Handler covers the functionality of the utility SYSPAUL, which is no longer installed per default.

SYSPAUL Applications can only be loaded in local environments.

Start of instruction set To load a SYSPAUL Application

  1. Make sure that the utility SYSPAUL has been installed in the current FNAT system file.

  2. In the Load SYSPAUL Application window, choose Select to select the name of the file applinfo.txt of the SYSPAUL Application to be loaded. It is located in the first directory of the SYSPAUL Application.

  3. In the next window, the name of the SYSPAUL Application is displayed in the field Name.

  4. The Object Handler loads the SYSPAUL Application and displays the result. The report file sysload.log is located in the temporary directory of Natural.