SaDisplay(TCL_ADM)
SaDisplay: SaDisplayErrorStacks, SaDisplayErrorInfo, SaDisplayNoAuths, SaDisplayNotRoot --
SCO Visual Tcl interface for displaying error stacks and other common errors
Syntax
SaDisplayErrorStacks dialogName errorStacks help
[callBack]
SaDisplayErrorInfo dialogName topErrorText help
[callback]
SaDisplayNoAuths dialogName manager callback
[host]
SaDisplayNotRoot dialogName manager callback
[host]
Description
These provide a common user interface for presenting error stacks and
other common error messages such as insufficient authorization.
The Error functions display an error box showing the top level error text
from the stack. They provide a Details button for viewing the complete
stack. This secondary dialog also provides a Save button for logging
the error stack to a file for future reference. An optional Help
button can be included where relevant help attachments are available. In the
case of multiple error stacks, each is displayed in a loop, one at a time,
after the previous error dialog is closed.
SaDisplayErrorInfo provides for displaying a simple text string rather
than a fully formed error stack. It creates a standard stack which
contains the topErrorText and then calls
SaDisplayErrorStacks. This
results in consistent error presentation regardless of its source.
The second group of functions provide a common error message for standard
problems that should be handled consistently across all SCOadmin applications.
SaDisplayNoAuths applies when the user does not have
required subsystem and/or kernel authorizations.
SaDisplayNotRoot applies when the user's UID
is not 0 but needs to be for the particular application.
Arguments
dialogName-
SCO Visual Tcl widget name for the new dialog.
errorStacks-
list of 1 or more error stacks.
help-
set to "HELP" to include a Help button on the error dialog box.
callback-
optional application callback to be called when the error dialog is closed.
topErrorText-
simple text string versus a fully formed error stack.
manager-
application title which will be included in the error text.
host-
optional host name. Defaults to the local host name. Used when the error
resulted from a remote administration action.
Notes
All application callbacks are auto locked. See SCO Visual Tcl and -autoLock.
See also
Error(TCL_ADM),
SCO Visual Tcl Programmer's Guide and Reference in SCO Visual Tcl Programmer's Guide and Reference.
16 September 2002
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003