SaOpenHost(TCL_ADM)

Syntax

SaOpenHostDialog parent instance value okCallback
SaOpenHostInvokeManager script cbs
SaOpenHostManagerRunning script host

Description

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

See also