Setup new Output Level

This Subprogram allows the Programmer to specify the Output Level for the Package. This Level determines whether any prompts or menus are displayed on the terminal screen.

Short Name Calling Sequence

STATUS = UIOULV(OUTLEV[,OLDLEV])

Long Name Calling Sequence

STATUS = UI_OUTPUT_LEVEL(...)

Input Arguments

OUTLEV (Integer) Output Level (see notes)

Output Arguments

OLDLEV (Integer) Old Output Level (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

Note:

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

   UIOUTPUTDISABLED ) Output to the Screen UIOUDI ) is disabled

   UIOUTPUTSWITCHED ) Output to the Screen is UIOUSW ) inhibited for the duration ) of Indirect Command Files

   UIOUTPUTENABLED ) Output to the Screen is UIOUEN ) always enabled

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