Enable Learn Mode

This Subprogram enables ``learn" mode such that all subsequent Input will be saved in the specified file. This file may later be used as an Indirect Command File.

Short Name Calling Sequence

STATUS = UIENLE(FILNAM[,OLDENA])

Long Name Calling Sequence

STATUS = UI_ENABLE_LEARN(...)

Input Arguments

FILNAM (Character) File Name

Output Arguments

OLDENA (Logical) Old Learn Mode (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__OPEN_OUTPUT ) Unable to open File UICOFI

Note:

1. This call will be ignored if ``Learn" Mode is already enabled.
2. Learn Mode may be disabled by a later call to UI_DISABLE_LEARN.
3. A failure to open the specified Learn File will give to rise to Function Value UI__OPEN_OUTPUT. This is treated as a User Interaction Error and causes the Command File Stack to be unwound and further input to be taken from the keyboard.
4. On a VAX, the file type defaults to ``.UIC" if it isn't explicitly specified within FILNAM, and the file defaults to ``UIPACK.UIC" if FILNAM is null (all spaces).
5. The OLDENA Argument is optional and, if present, will be set to the old Learn Enabled Status (.TRUE. or .FALSE.) prior to this call.