Setup new Echo Level

This Subprogram allows the Programmer to specify the Input Echo Level for the Package. This Level determines whether any input from Indirect Command Files is echoed on the terminal screen.

Short Name Calling Sequence

STATUS = UIECLV(ECHLEV[,OLDLEV])

Long Name Calling Sequence

STATUS = UI_ECHO_LEVEL(...)

Input Arguments

ECHLEV (Integer) Echo Level (see notes)

Output Arguments

OLDLEV (Integer) Old Echo Level (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

Note:

1. The ECHLEV Argument may take on three values:-

   UIECHODISABLED ) Echo to the Screen UIECDI ) is totally disabled

   UIECHOSWITCHED ) Echo to the Screen is UIECSW ) disabled for the duration ) of Indirect Command Files

   UIECHOENABLED ) Echo to the Screen is UIECEN ) always enabled

2. UIPACK is initialized with the Echo Level set to UI_ECHO_SWITCHED.
3. The present Echo Level of the package will remain unchanged if the ECHLEV argument does not correspond to a valid Echo Level.
4. The OLDLEV Argument is Optional and, if present, will be set to the Old Echo Level prior to this call.