launch

NAME

launch - the Tornado launcher (UNIX)

SYNOPSIS

launch [-T.clmode] [-v.ersion] [-h.elp] [Xt_Standard_Command_line_Parameters]

DESCRIPTION

The launcher is a graphical control tool for the Tornado environment. It displays information about target servers and target agents (see tgtsvr) registered by the Tornado Registry (see wtxregd). It provides a convenient interface to launch any of the Tornado tools attached to a target server (see windsh, browser, and so on). It also provides access to Tornado administrative functions.

INFORMATION DISPLAY

The launcher presents a continuously updated list of the registered target servers. Clicking on one of the listed targets will display information about the target.
Information displayed by the launcher includes:

Name
unique identifier of the target in the form target@serverhost.

Version
target server version.

Status
either of the strings unreserved or reserved depending on whether the target server is available for use.

Runtime
identification string of the runtime system on the target.

Agent
target agent type and version number.

CPU
target CPU architecture.

BSP
name of runtime board support package.

Memory
amount of target memory configured.

Link
name of transport layer between target and target server.

User
user ID of the target's most recent user.

Start
target server start time and date.

Last
time and date of last tool attachment.

Tools
a list of the tools attached to the target.

TORNADO TOOLS

Some of the Tornado tools are directly available from the launcher. They are shown as icons in the toolbar at the bottom of the launcher's window. Many tools require the selection of a target server before activation.
The fundamental collection of Tornado tools is:

windsh
the Tornado shell, which incorporates both a C and a Tcl interpreter.

crosswind
the Tornado graphical source-level debugger.

browser
a graphical tool that monitors the target system.

project
The Tornado graphical project manager (further help on Project Facility is available from within the Project tool itself).

The launcher will also let you directly call VxSim, the VxWorks simulator, and WindView, the Wind River logic analyser.

SERVICES AND MENUS

The menu bar at the top of the launcher window gives access to various services. Just under this menu bar is a collection of small icons each of which (from left to right) is a shortcut to the Target menu's entries (read top-down). Available services are provided in the following menus:

File menu:

Quit
Quit the launcher program.

Target menu:

Create
Display a specific window to record all information needed to launch a target server and to save this configuration for further use.

Unregister
Unregister the target server from the wind registry (wtxregd)

Reattach
Send an attach request to a target server. The target server then tries to reattach to the target agent. This is useful if the target agent stops communicating with its server (because the target board rebooted, for example).

Reserve
Restrict access to a target. This service is usable only if an unreserved target has been previously selected.

Unreserve
Allow widespread access to a reserved target. This service is usable only if the selected target is owned by the user.

Restart
Send a restart request to a target server. This causes the target server to restart. Information related to a previous session (such the list of the object modules loaded on the target) will be lost.

Kill
Terminate the selected target server. Beware: any unreserved target server can be killed.

Reboot
Send a reboot command to the target.

Support menu:

Tornado
Display a form to submit a Technical Support Request for Tornado to WRS.

VxWorks
Display a form to submit a Technical Support Request for VxWorks to WRS.

CrossWind
Display a form to submit a Technical Support Request for CrossWind to WRS.

GNU
Display a form to submit a Technical Support Request for the GNU toolkit to WRS.

WindView
Display a form to submit a Technical Support Request for WindView to WRS.

Admin menu:

License
Display the License Request form and transmit the request to WRS.

Install CD
Run the appropriate system command to read and extract product components from a CD-ROM.

Install Tape
Run the installOption tool to read and extract product components from a tape.

FTP WRS
Start an anonymous FTP connection with the Wind River Systems FTP server.

Authorize
Start an editor, as defined in the EDITOR environment variable, that lets you view the contents of the file of authorized users. If no local userlock files exists, a new one is created.

Info menu:

Products
Access the Sales Contact Information page on the WRS Web server through your system's WWW browser.

Training
Access the training page on the WRS Web server through your system's WWW browser.

Announcements
Access the Sales Contact Information page on the WRS Web server through your system's WWW browser.

User's Group
Access user-group information and the VxWorks archive on the WRS Web server through your system's WWW browser.

www.wrs.com
Access the WRS Web home page through your system's WWW browser,

comp.os.vxworks
Access an archive of VxWorks user discussions maintained on the WRS Web server through your system's WWW browser.

About menu:

Tornado
Display Tornado development environment version.

Help menu:

On launch
Display the launch manual page.

Manuals
Display the Tornado Online Manuals (run your favorite HTML browser).

OPTIONS

The launcher accepts the X Toolkit Intrinsics standard command-line parameters such as -display or -iconic, plus the following:

-T | -Tclmode
Run a Tcl interpreter on standard input. This is useful for adding and debugging new features.

-v | -version
Print the current version of the Tornado development environment.

-h | -help
Print the help message.

ENVIRONMENT VARIABLES

WIND_BASE
The root location of the Tornado tree.

WIND_REGISTRY
The host on which the Tornado Registry daemon runs (see wtxregd).

FILES

The following resource files are required by the launcher:

$WIND_BASE/host/resource/tcl/Launch.tcl
Tcl implementation of the launcher interface.

$WIND_BASE/host/resource/tcl/app-config/all/host.tcl
Tcl default host commands bindings.

$WIND_BASE/host/resource/tcl/app-config/all/host_type.tcl
Tcl host_type-specific defines that overwrite default defines.

$WIND_BASE/host/resource/tcl/app-config/Launch/01Adm.tcl
Tcl administration library.

$WIND_BASE/host/resource/tcl/app-config/Launch/01BspCfg.tcl
Tcl support for VxWorks BSP configuration.

$WIND_BASE/host/resource/tcl/app-config/Launch/01Supprt.tcl
Tcl Technical Support Request library.

$WIND_BASE/host/resource/tcl/app-config/Launch/01TgtSvr.tcl
Tcl target server managing library.

$WIND_BASE/host/resource/tcl/app-config/Launch/01VxSim.tcl
Tcl VxSim support.

$WIND_BASE/host/resource/tcl/app-config/Launch/01WView.tcl
Tcl WindView support.

The following resource file is applied if present:

$HOME/.wind/launch.tcl
Tcl implementation of the user's facilities for the launcher.

launch

NAME

SYNOPSIS

DESCRIPTION

INFORMATION DISPLAY

TORNADO TOOLS

SERVICES AND MENUS

File menu:

Target menu:

Support menu:

Admin menu:

Info menu:

About menu:

Help menu:

OPTIONS

ENVIRONMENT VARIABLES

FILES

SEE ALSO