FMP Selection

Function presentation

This display gives the list of available FMPs and allows maintaining a user-preferred list.
This user preferred list will be proposed by default for the different queries when a Selected list of FMPs has to be presented.
This user preferred list is stored in a property file for later references.

Opening the window

This modal dialog may be opened from the different functions where the query to the server system includes a list of FMPs.
Currently these functions are :

A click on the Select button in the Selected FMP(s) frame in one of the functions listed above, will open the FMP Selection dialog.

On opening the dialog, the list of available FMPs is retrieved from the server.
The date to be used for the retrieval is the one selected on the invoking window. It is displayed in the top left corner of the dialog.
This Available list of FMPs is displayed on the left side of the dialog.
The FMP Selected list is stored in the user preference CHMI / ATFCM application / General / Query / Selected FMP Identifiers.
This FMP Selected list, if any, is displayed on the right side of the dialog.
The focus sequence between the different controls starts from the Available list and the attached scroll bar, then it reaches the Selected TVS list and the attached scroll bar. Finally it goes on the different buttons: Right and Left arrows and then OK and Cancel.
There is no resizing allowed on this dialog.

User interactions

This dialog allows adding and removing FMPs from the user Selected list, based on the retrieved FMP Available list.
FMPs stored previously in the Selected list may no more exist in the newly retrieved Available list. In such a case, a message box will prompt the user to ask if these erroneous FMP entries may be removed from the Selected list because this might lead to unsuccessful queries.
Select one or more FMPs from the Available list on the left side and click on the ">>" button to add them to the Selected list.
Multiple selection is possible by combining the mouse click with the <Ctrl> or the <Shift> keys.
Eventual duplicates are automatically suppressed.
Select one or more FMPs from the Selected list on the right side and click on the "<<" button to remove them from the current Selected list.
A double click on an FMP in either list will immediately request the transfer action.
When the Selected list is up to date, click on the OK button to save the list and come back to the previous window.
This will save the new preferred list in the user preference CHMI / ATFCM application / General / Query / Selected FMP Identifiers.

Following update rules will be applied on all opened windows using a Selected FMP(s) list for the query :

If the opened window has not yet processed a valid query / reply, newly added FMPs are inserted and checked in the Selected FMP(s) list. Deleted entries are removed from the Selected FMP(s) list independently from the current check state.
If a valid query / reply has already been processed, newly added FMPs are inserted unchecked in the Selected FMP(s) list. Deleted entries are removed from the Selected FMP(s) list only if they were unchecked before opening the dialog.
All other existing FMPs remain in the Selected FMP(s) list with the previous check state.

New windows opened after this list update will use the new user preferred Selected list.
To stop editing and leave the FMP Selection without saving the modifications to the list, click on the Cancel button.
If the user clicks the close dialog button ("X" on top right) and the Selected list was changed, a confirmation dialog will pop up asking if the modifications to the list shall be saved or ignored.