Inquire Learn Filename

This Subprogram may be used as an alternative to UI_INQUIRE_LEARN to not only inquire whether Learning is enabled, but also the name of the file.

Short Name Calling Sequence

STATUS = UIIQLF(FILNAM[,FILLEN])

Long Name Calling Sequence

STATUS = UI_INQUIRE_LEARN_FILE(...)

Input Arguments

None

Output Arguments

FILNAM (Character) Learn Filename FILLEN (Integer) Length of Filename (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

Note:

1. The FILNAM Argument will be set to null (all spaces) if Learn Mode is not enabled. Otherwise it will be set to the name of the Learn File as specified by a prior call to UI_ENABLE_LEARN or Operator response of the form ``{filename".
2. The FILLEN Argument is optional and, if present, will be set to the length of the Learn Filename (in characters) or zero if learning is disabled.