PROWORKS(1)

NAME

proworks — OpenWindows interface for the interactive session management of ProWorks Tools.

SYNOPSIS

proworks [ 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 ProWorks Manager. The properties for the tools and ProWorks Manager can be modified by means of the Tool Properties sheet and ProWorks Manager Properties sheet respectively.

AVAILABILITY

ProWorks Manager is available with ANSI C, C++, TeamWare, Ada, and Assembler.

DESCRIPTION

ProWorks Manager is an OpenWindows graphical user interface managing ProWorks applications. Before starting ProWorks 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 ProWorks Manager, type proworks on the command line.

ProWorks Manager allows you to start, quit, and manage ProWorks 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 ProWorks icon, icon label, and command line for each application. Multiple ProWorks Manager Property configuration files can be specified at one time. From the Manager Property sheet, you can change the working directory for starting ProWorks 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

ProWorks 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 ProWorks 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 ProWorks Manager to −swtm (id). id is a unique number assigned by ProWorks Manager to identify a specific invocation of a tool. Applications that support the ProWorks session management protocol should specify $SUNPRO_SWM_TT_ARGS as their first command-line argument as it allows ProWorks 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 ProWorks 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 ProWorks 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 ProWorks 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 ProWorks tools, and ProWorks Manager.

Museum

Related Articles