3 12 1 Loading IBM i Files

LANSA Technical

3.12.1 Loading IBM i Files

In order to load IBM i file definitions, you search an IBM i library and select the file name from the list of files located. Your search will include:

Remote System

Select remote IBM i system to be searched. System must be defined as a Remote System.

Library containing files

Mandatory.

Specify the name of the library in which the files to be loaded reside.

Full or partial file name

Specify the full name or part of the file name to be found.

If no full or partial file name has been specified all files in the library will be listed in the search results. If the library contains many files, the search results may take some time to be displayed.

Search Results

Once the search criteria have been specified, and the Find button has been pressed, a list of matching files will be displayed.

Each file displayed in the search results list includes:

  • A clickable expansion button, if the file has logical views. Clicking the button when it shows a plus sign (+) will display the file's logical views. Clicking it when a minus sign (-) is shown will hide them. Once a file has been selected, any logical views belonging to the file will be enabled and may also be selected for loading.
  • A check box. Select the check box to load the file definition. Note that until a check box is checked/selected, the check boxes for any logical files belonging to the file will be disabled.  The Select All, Deselect All and Invert Selection buttons at the bottom of the form can be used for managing multiple selections.
  • A green tick or red cross, indicating whether or not its definition has been previously loaded into the repository.

Selected files are loaded by clicking the Load button on the toolbar. Prior to the load being performed, the Load Options dialog will be displayed.  Refer to 3.12.3 IBM i Load Options for more information.

If warning or error messages are generated by the load process, a warning or error triangle will be displayed adjacent to the physical file's check box. Click on the triangle to view the messages.

Note that warning and error messages for all selected files, as well as those messages that may not be specific to a particular file, are accessible by clicking the inverted triangle that appears adjacent to the Search results text, above the list of files.

Load messages can also be displayed by clicking the Messages button on the toolbar.  From the resultant messages dialog,  the text can be copied and then pasted elsewhere.  This can be useful if you need to contact LANSA Support about a loading issue.

Once a file definition has been loaded, its repository definitions can be previewed by selecting the file and clicking the Preview button.

If no error messages have been generated by the validation process, the Save button will be enabled. Click it to save the selected file definitions to the LANSA repository.

Note that, by changing the selection of files in the Search results, the Save button will be disabled and the load must be performed again.

Also See

Load Other Files in the Developer Guide

Ý 3.12 Load Other File