Load Wizard

#### Search Results

Search

# Load Wizard

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

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

- Start Object Handler Command Procedure for Load

- Load SYSPAUL Application

## 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 for Load

- Set Parameters for Load

- Select Objects for Load

### Set Options for Load

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 z/OS. Portable work file is only valid if the following applies: Use default options (this is the default) or Use additional options has been selected (see below). Transfer format has not been selected. 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 z/OS, 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 for Load

#### 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 for Load

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

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:

   - Natural library objects

   - Natural system error messages

   - Natural command processor sources

   - Natural-related objects

   - External files

   - FDTs

   - Natural DDMs (remote environments only)

   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 for Load

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.

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.

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.

### On this page

- Load/Scan Objects from/in Work Files
- Start Object Handler Command Procedure for Load
- Load SYSPAUL Application