SaOpenHost(3tlib)


SaOpenHost: SaOpenHostCB, SaOpenHostDialog, SaOpenHostInvokeManager, SaOpenHostManagerRunning -- SCO Visual Tcl interface for the managing a remote host

Synopsis

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.

References

SaHost(3tlib), SaSelectHost(3tlib).

Notices

Applications using this interface must accept a host name as a command line argument:

Application [flags] [hostname] . . .


25 April 2004
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004