SPARCWORKS(1) — USER COMMANDS

NAME

sparcworks — OpenWindows interface for the interactive session management of SPARCworks Tools.

SYNOPSIS

sparcworks [ configuration_file ... ]

The configuration_file defines the tools that appear on the tool palette, the path where the icons are located, the properties for the tools, and the properties for SPARCworks Manager. The properties for the tools and SPARCworks Manager can be modified by means of the Tool Properties sheet and SPARCworks Manager Properties sheet respectively.

AVAILABILITY

SPARCworks Manager is available with ANSI C, Sun FORTRAN, Pascal, C++, TeamWare, Ada, and Assembler.

DESCRIPTION

SPARCworks Manager is an OpenWindows graphical user interface managing SPARCworks applications. Before starting SPARCworks Manager the first time, add the following line to your .login file for C shell:

setenv PATH ${SWHOME}/bin:${PATH}

SWHOME is the directory where you installed Manager and the accompanying tools. The default for this directory is /opt/SUNWspro/bin.

For Bourne and Korn shells, add the following to your .login file:

PATH=${SWHOME}/bin:${PATH};export PATH

Source the .login file after modification.

To start SPARCworks Manager, type sparcworks on the command line.

SPARCworks Manager allows you to start, quit, and manage SPARCworks applications. It also supports session control for all applications started from the current Manager by means of the Open, Close, Hide, and Show options from the Session menu. The Manager passes most OPENLOOK(R) arguments to the tool it launches. This allows OpenWindows properties, such as foreground and background colors, to be set on a session-wide basis.

One or more (X11 resource format) tool palette configuration files can be specified at a time. Configuration files contain the SPARCworks icon, icon label, and command line for each application. Multiple SPARCworks Manager Property configuration files can be specified at one time. From the Manager Property sheet, you can change the working directory for starting SPARCworks tools, as well as the values of the current shell environment variables. By default, the palette displays all the tools installed in the SWHOME directory. Tool icons are displayed on the palette based on one or more configuration files. The search order for configuration files is:

1. the command line

2. .sunpro_defaults in your home directory

3. /lib/sunpro_defaults in the Manager installation directory

SPARCworks Manager spot help provides context-sensitive help for each control and area in the tool. For help on using the Manager, move the pointer onto the object for which you want help and press the Help key.

ENVIRONMENT

Environment variables communicate ToolTalk and GUI toolkits (such as XView, e.g. see xview(1)) command line arguments between SPARCworks Manager and the application. Application commands are executed by the Bourne Shell; see sh(1) for more information.

These variables are not set by the user; they are set by the Manager when an application is launched. They can be specified as command line arguments for the tool (either at a shell prompt or in the tool’s property sheet, which can be called from the Manager).

SUNPRO_SWM_TT_ARGS
Set by the SPARCworks Manager to −swtm (id). id is a unique number assigned by SPARCworks Manager to identify a specific invocation of a tool. Applications that support the SPARCworks session management protocol should specify $SUNPRO_SWM_TT_ARGS as their first command-line argument as it allows SPARCworks session commands to be recognized.

SUNPRO_SWM_GUI_ARGS
Command-line arguments that specify the initial size and position of windows when drag and drop is used. If double click is used to open a window, this variable is set to null. This variable is also used to pass session-wide OpenWindows arguments.

SUNPRO_SWM_APP_DIR
Directory path set when a path name or FileManager icon is dropped on the SPARCworks Manager Drop Target in the upper right corner of the Manager control panel. The current working directory is changed to the directory component of the path name and the SUNPRO_SWM_APP_DIR environment variable is updated.

SUNPRO_SWM_APP_FILE
Path set when a path name or FileManager icon is dropped on the SPARCworks Manager Drop Target in the upper right corner of the Manager control panel. SUNPRO_SWM_APP_FILE is set to the file component of the path. The tool icon labeled Application starts $SUNPRO_SWM_APP_FILE.

FILES

$SWHOME Directory where SPARCworks is installed. The default value for $SWHOME is /opt/SUNWspro/bin.

$SWHOME/lib/sunpro_defaults
A directory containing configuration files that define the initial properties of the tool palette, the SPARCworks tools, and SPARCworks Manager.

Museum

Related Articles