ui.Interface.loadTopMenu() is used to load a top menu:
CALL ui.Interface.LoadTopMenu (file_name)
where file_name is a STRING variable standing for the file name containing the top menu to be loaded definition and the path which is optional (the file should be located on an application server).
When you specify a file name, be careful with its case.
UNIX is case-sensitive, so it will treat files which names come in different cases as separate files.
Usage
Here is an example of the method calling:
#loads the top menu defined in my_topmenu_file
CALL ui.Interface.LoadTopMenu("my_topmenu_file")
If there is a top menu already specified for the target form, it will be replaced by the one loaded.
It is advisable not to specify the file extension. It is automatically added by the runtime system when the file is determined: initially the system searches for the file with the name specified with the .tm2 extension, if it does not exist the .fm2 file is being searched for. In case the file with the name specified does not exist, the corresponding runtime error occurs.
However, it is still possible to specify the file containing the top menu definition as "my_topmenu_file.fm2". If there is no such a file, an error will occur at runtime.