Version 6.3.8 for Windows
 —  Tools and Utilities  —

Importing Objects

The Import function of SYSMAIN is used to copy objects (files) from an external source to a Natural library. Alternatively, you can use the unload and load functions of the Object Handler (see the relevant documentation).

When you import objects, the file directory FILEDIR.SAG of the target library is automatically updated to contain information on the newly imported objects. Be aware that Natural will not update the file directory FILEDIR.SAG if you use a non-Natural function or facility (such as the Windows Explorer) to copy objects to a Natural library. As a result, you cannot access the objects contained in this library. FILEDIR.SAG contains internal library information required by Natural such as programming mode (structured or reporting), object form (source object and/or cataloged object) and user ID.

The objects to be imported with SYSMAIN must have been created with Natural.

Note:
You cannot import shared resources into a remote environment located on a mainframe platform.

Start of instruction set To import an object

  1. In the Source group box, specify the object(s) you want to import:

  2. In the Target group box, specify the target environment for the objects to be imported:

  3. Choose Object List when you have finished specifying the source and target environments.

    If you entered a single name in the Name box, skip the following instructions and proceed with Confirm on replace in Step 5.

    If you specified a range of names in the Name box, an additional dialog box similar to the example below appears with a list of all matching objects:

    The dialog box shows the name of the source path, the number of objects found and the object names and types. It also indicates whether a source (S) and/or a cataloged (C) object exists.

  4. Select or deselect the required object(s) from the list:

  5. Choose Import to process the selected object(s).

    (Cancel exits the dialog box without any action.)

    If the Confirm on replace check box has been selected and if the target environment already contains an object with the same name as the object to be imported, an additional dialog box appears with a warning message.

    Confirm or reject object replacement by choosing one of the following buttons:

    Yes to confirm each object replacement individually one after another.

    Or:
    Yes to All to confirm all object replacements in one go.

    Or:
    No to not replace the current object.

    Or:
    Cancel to exit the dialog box without any action.

  6. After all objects have been imported into the specified library, the Object Maintenance - Import dialog box is closed and the Object Maintenance menu appears.

    An imported objects is contained in the library folder appropriate for its type. For example, a Natural object of the type program is contained in the Programs folder (in the Logical View) of the library. If a type of object is imported for which no folder yet exists, Natural automatically creates the appropriate folder when performing the Import.

Top of page