SaOpenHost(TCL_ADM)
SaOpenHost: SaOpenHostCB, SaOpenHostDialog, SaOpenHostInvokeManager, SaOpenHostManagerRunning --
SCO Visual Tcl interface for the managing a remote host
Syntax
SaOpenHostCB cbs
SaOpenHostDialog parent instance value okCallback
SaOpenHostInvokeManager script cbs
SaOpenHostManagerRunning script host
Description
SaOpenHostCB-
interface for selecting host to manage
SaOpenHostInvokeManager-
start manager for managed host
SaOpenHostManagerRunning-
checks if application is running locally and managing remote host
These provide a consistent and convenient interface for all SCOadmin
applications providing remote management functionality using a
Open Host interface. When activated, the Open Host
interface prompts for a host name, then attempts to launch a second instance
of the application passing the remote host name as a command line
argument. The Host name input form also provides a Select button for
a graphical browser of valid host names accessible to the local host.
The main interface is the SaOpenHostCB procedure itself, designed as
a callback suitable for attaching directly to an application pulldown
menu item. For most applications, this should completely provide
the desired functionality. The additional interfaces are used by
SaOpenHostCB and are documented for use as a potential
lower level interface.
SaOpenHostCB-
provides a complete interface launched by activating the application widget
where this is attached as a primary callback. It presents a host selection
dialog including a text field and a select button for graphical browsing
of available hosts (SaOpenHostDialog).
Once the user selects a host and
closes the dialog with OK, this interface executes a new instance of the
application, passing it the selected host name on the command line
(SaInvokeManager).
The new application instance has effectively opened a view
on a remote host for systems management.
SaOpenHostCB takes a callback structure and is therefore suited to
be the direct callback of a widget such as a pulldown menu item, a
push button, toolbar button etc.
SaOpenHostDialog-
creates an Open Host dialog. This includes a text field for the host
name as well as a Select button for graphical browsing of available
host names.
SaOpenHostInvokeManager-
Invokes the application passing a host name on the command line.
This results in two application instances, each a separate process.
Note, this handles the special casing of the MOTIF
versus CHARM graphical modes of SCO Visual Tcl.
SaOpenHostManagerRunning-
Checks to see if a particular application is running locally and managing
a remote host. Returns true (1) or false (0) accordingly.
Arguments
parent-
SCO Visual Tcl parent widget for new form dialog
instance-
a unique identifier string for each open host dialog
value-
default host name value for the text widget on the open host dialog
okCallback-
application callback invoked after ok is pressed
script-
name of executable application file
host-
host name
cbs-
SCO Visual Tcl callback structure. Generally, SCO Visual Tcl provides this
automatically when invoking the callback. In the event that
applications call these procedures directly, an argument must be
passed as a callback structure.
Notes
Applications using this interface must accept a host name as a command line
argument:
Application [flags] [hostname] . . .
See also
SaHost(TCL_ADM),
SaSelectHost(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