Rogue Wave Knowledge Base
Browse by category:
Knowledgebase | Glossary | Ask a Question |

Software Parts Manager Builds on Unsupported/Non-GUI platforms

Article ID: 1039
Last updated: 05 Feb, 2008
Revision: 1
print  Print
share  Share
Views: 3357
Posted: 05 Aug, 1997
by Dean J.
Updated: 05 Feb, 2008
by Dean J.

How do I build my Rogue Wave software products on a unsupported or non-GUI based system?


There are several reasons users cannot run the Software Parts Manager(SPM):
  1. You have an unsupported platform and the machine code associated with a particular compilation of the SPM will not run on your machine
  2. You are not able to run a GUI such as X-Windows, even on a supported platform.
In cases such as these, you must perform a command line build of the product. A successful command line build requires four steps:
  1. You must have already installed the SPM (even though the GUI will not run on your system)
  2. You must have received your RogueWave software parts either on floppy or you must have downloaded them from the web -- you cannot access the individual products from the CD.
  3. You must delete several files out of the SPM installation.
  4. You must run the rwspm script to build your library.
The following process may be used for both Windows and Unix based systems. The process is not exactly the same, but they are very similar. For instance the products are distributed as .zip instead of .tar files.


1. Installing the SPM

Why install the SPM if you cannot execute it? The SPM ships with several shell scripts that are platform independent, and currently the only way to get these scripts is to install the SPM.

You can either download the SPM from our website, at or if you have the CD, you can install it from the CD. Note that it is OK to install the SPM from the CD. Installing the individual products from the CD as mentioned above is not possible.

You must run the install utility ( for Unix, setup.exe for PC's) from the korn shell (ksh) to install the SPM successfully.

2. You must delete several files out of the SPM installation

This is to trick the script into believing that you don't have a partmgr executable installed. You can do this as follows:

  1. delete the file /partmgr
    rm /partmgr

  2. delete the subdirectories of /bin. You will need to leave the script /bin/wizards for user input.
    rm -rf /bin/[A-Z]*
Once this is done you can install and build products from floppy onto unsupported platforms.

3. Installing the product from the installation tar file

When you download a product from the web or get it on a floppy it contains the following:

> $ tar tvf std0121u.tar
> -r-xr-xr-x 20079/2030 12838 Jun 4 13:44 1997
> -rw-r--r-- 20079/20304503040 Jun 4 13:44 1997 data.tar
> $ expects a spm directory to be present before it will install anything. If the doesn't exist, return to step 1. If it does, you need to install the product from the archive (zip or tar).

> $     
> Welcome to the Software Parts Manager individual product install script!
> This script will add another Rogue Wave product to your SPM installation.
> First, we need to determine where you have installed the Software Parts
> Manager. Please enter the name of your SPM root directory (often, this
> is c:spm or /usr/local/spm) or enter 'q' to quit:
> Enter SPM root: /nfs/g4/home/gorman/spm

> Good, you appear to have a valid SPM installation at
> '/nfs/g4/home/gorman/spm'.
> Excellent, you appear to have a valid archive in '.'.
> Let's pull some files out of the individual product's archive...
> x dd, 0 bytes, 0 tape blocks
> x dd/product, 0 bytes, 0 tape blocks
> x dd/product/std0121u, 0 bytes, 0 tape blocks
> x dd/product/std0121u/src, 0 bytes, 0 tape blocks
> x dd/product/std0121u/src/src.tar, 2043392 bytes, 3991 tape blocks
> x dd/product/std0121u/src/exam.tar, 469504 bytes, 917 tape blocks
> x dd/product/std0121u/src/docs.tar, 1934848 bytes, 3779 tape blocks
> x dd/product/std0121u/working.rep, 34452 bytes, 68 tape blocks
> x distrepo, 0 bytes, 0 tape blocks
> x distrepo/std0121u.rep, 12470 bytes, 25 tape blocks
> x support, 0 bytes, 0 tape blocks
> x support/, 314 bytes, 1 tape blocks
> ...done.
> It looks like you don't have the SPM graphical user interface, which
> would normally be used to unpack a product's fileset into an RW root
> area. I can unpack this product's fileset for you. But first, you
> have to tell me where your RW root area is located or (if you don't
> already have an RW root area) where you would like your RW root area
> to be located. Often, RW root areas are c:
wav or /usr/local/rwav.
> Enter RW root:

4. You must invoke rwspm to build the product(s) you just downloaded.

To do this you must change into the /scripts directory. A brief synopsis of the rwspm script is given below:

Rogue Wave does not advise that you circumvent the Software Parts Manager interface to build your software parts. If you do, be aware that you give up the following protections Software Parts Manager offers:

Dependency checking: Software Parts Manager has complete knowledge of the dependencies between Rogue Wave software parts, and warns you if the library you propose to build depends on another library that does not exist.
Configuration checking: Software Parts Manager also checks that the build configuration is consistent with Rogue Wave's support matrix and with the configurations of dependent products.
If you do build from the command line, we strongly advise that you do so through the control script rwspm . The explanation below assumes that you are taking this safer course.

Please note: As invoked from the command line, rwspm can only be used to build libraries and create makefiles that support examples. To build example executables, you must use make to apply an examples makefile to build the desired targets. Examples makefiles are created and exported to the workspace immediately following the building of a library.

Before you compile, you must know the name of the compiler properties file that pertains to your environment. This file name is passed through the -f option when you invoke rwspm.

These files are located in scriptsplatform (/scripts/platform on UNIX platforms). The names are based on the pattern For example, the file for MSVC on Windows platforms is

The example below shows the file as installed with Software Parts Manager. The only lines you are likely to edit would be RWCCOPTS= and RWLINKOPTS=, which allow you to specify custom compiler and link options.

# Shell script used as an input file to rwsetup

# --- General Settings ---
RWOVERWRITE=yes //leave as is

# --- Compiler Settings ---
RWCPP=cl //compiler invocation
RWCCOPTS= //custom compiler options
RWLINKOPTS= //custom link options

# --- Compiler and OS Names ---
RWOPSYS=WINNT //operating system

To build a part from the command line:

  1. Make scripts (/scripts on UNIX platforms) your working directory.
  2. Enter rwspm ...

The arguments to rwspm are:

-d                    (Optional) Build a shared library
-f Name of compiler properties file (DO NOT supply
the path; the file MUST be in the platform directory
-p Path to the product tree top level directory of
the part to be built

-t Numeric build type code. The number is
generated as a set of flags:
8 -Turns on Standard Library
4 -Turns on multithreading.
2 and 1-Together, these turn on
debugging options.

-w (Optional) Path to the workspace top level directory
if you want this to be different from the default
An example of how to build the Standard C++ Library is shown below:
    $ cd spm/scripts
$ rwspm -d -f -p /package/0/rogue/parts/std0121u -t0
This article was:   Helpful | Not helpful Report an issue

Prev     Next
Objective Grid/J: Database Connectivity       Standard C++ Library manual examples will not build on Solaris

Others in this category
b Internationalization of Blend.J TextField
b How do I add a subject header to my SMTP application?
b Core dumps described in the Tools.h++ Professional readme document
b Failure building Standard C++ Library with aCC 3.25
b How can I print charts from Chart.J?
b Installation of StudioJ on Unix or Mac
b The StockCursor SizeCursor is not working in zApp
b Catching exceptions from the inet module in Tools.h++ Professional
b Can Money.h++ be used in multi-threaded applications?
b Objective Grid/J: Database Connectivity
b Standard C++ Library manual examples will not build on Solaris
b Using custom build configurations
b The Use of Virtual Destructors in Tools.h++ classes
b Runtime error in DBTools.h++
b How to create a custom overlay
b Retrieving Blobs from Oracle using DBToolsJ
b The addSubItem() method causes the Tree application or applet to freeze at runtime
b RWMutexLock Recursive Acquisition error in Debug - Not True! - Threads 2.0.1 only
b Using DBTools.J with the Oracle Driver: Objects Are Not Getting Released Correctly
b JDK 1.1.6 JIT update and later versions cause Labels to disappear in StudioJ
b How do I create a list of lists?
b UnsatisfiedLinkError when installing StudioJ
b StudioJ product unlock code not accepted during installation
b Column titles using center justification disappear when using JFC/Swing
b Retrieving return parameters from oracle Storedprocedures
b Specifying a frozen column attribute does not lock the selected column
b Building native Win32 applications with Visual Cafe using Grid.J.
b When trying to establish a connection to my database using DBTools.h++, I get the error: DB NOT FOUND
b How do I use binaryStoreSize and recursiveStoreSize?
b Using the clipboard paste function with a JMaskEdit control
b Passing strings containing quotes causes problems with DBTools.J
b Location of Visual CASE
b Unlock keys do not work
b RW virtual streams and RWCollectableString ambiguity error
b TreeControl image not updating correctly in JWidgets
b Creating custom configurations with SPM 1.4
b RWDBTracer and asString() method behave differently in DBTools 4.0.0
b Objective Grid/J: Footprint
b Throwing exceptions using Sybase or MS SQL Server corrupts connections
b Changing the state of a GXCheckBox with a single click when the control does not have focus?
b I cannot execute the script for Software Parts Manager
b Submitting HTML GET/POST Requests to a CGI Program
b Undefined Symbol RWAll when Linking Application
b What relation does the RW Standard C++ Library 1.x have to the ANSI Standard?
b Informix stored procedure does not execute an INSERT
b How to avoid a database hit when instantiating a RWDBStoredProc
b The commit / rollback transaction request has no corresponding BEGIN TRANSACTION
b Trapping shift, escape and return keys for a ComboBox
b How to add ESQL function calls to the Informix Access Library
b Using char datatype in C++ Application for char(1) datatype of the database
b Having problems with the server when using callbacks.
b LAPACK.h++ with Math.h++ v0613 gives dependancy check failure on Solaris 2.5 and SunOS 4.1.x
b RWTime/RWDate displays incorrect time and date
b The zApp isShown() function does not work correctly
b Creating image buttons of the correct size
b Adding a scroll bar to a non-overlay chart in JChart 2.1
b How do I trap the enter key in zComboBox (any type, portable solution)?
b How RWDecimal classes cast ints and doubles
b Modifying zApp 3.0 Makefiles to use Borland v5.02 compiler
b Horizontal Scroll Bars on Combo Boxes
b Can I use DBTools.h++ 3.1.0 with MSVC 5.0?
b Memory Leak in Threads.h++ with POSIX Threads
b Control object minimizes or disappears when moving to another window or dialog.
b Re-definition of parent table alias inside the sub-query of DML
b How can I do Oracle row-level locking with DBTools.h++?
b RAISE ERROR statement in my RWDBStoredProc never catches that error.
b Using the schema from an existing table to create a new table
b Error compiling on SGI
b Default and Explicit Connections and the DBTools Connection Pool
b Can't compile Math.h++ source files on SunOS4.1.3 with SunPro 4.0.1 compiler
b Why does JFactory flicker between the object manager and the integrated editor when I'm trying to edit the source?
b JFactory won't open; gives error
b In Chapter 4 of the tutorial, why can't I find the Menu Edit button?
b When compiling, why can't JDK find LogFontLayout.class?
b SPM doesn't install correctly under Windows
b 'Tried to dereference a null RWENode handle' error running SPM
b 'Unresolved external symbol opinit' runtime error
b Porting Tools Pro.h++ 1.1.2 to Linux
b Command line builds for Threads 2.0.1 on Solaris7 with SunPro 4.2
b When bulk reading a database column that allows NULL values, you must check for null in the receiving vector object.
b Improving the performance of an application that uses a lot of RWCStrings on the heap.
b Resizing a connection pool with the defaultConnections() method does not work
b Changing source code to support link time template instantiation
b Can't Enter Information Into Dialog Boxes
b can't insert an RWDBDateTime object into the database, formatted as a UTC time.
b How to deal with lost database connections?
b Euro conversion rates as of Jan 1, 1999.
b Error when Building DBTools Access library for Oracle8 with Microsoft Standard Library
b Rounding Errors in RWDecimal<T>
b I get error C2065: 'localtime_r' : undeclared identifier
b Tools.h++ compile error: C2065: 'localtime_r' : undeclared identifier
b Why won't the InfoBrowser contents update in response to selection changes in ClassView or FileView?
b I've installed Visual CASE and loaded a project. Now what?
b Why aren't the ATL and MFC libraries just loaded at startup?
b Blend.J's ShortcutBar demo throws exceptions
b Blend.J vertically-oriented sliders don't respond correctly
b How can I tell if my socket's peer closes the socket?
b RWCString::operator[] doesn't compile in MSVC
b Software Parts Manager doesn't run
b hasChanged() method never set to TRUE
b How do I kill all the running threads in RWThreadPool?
b No insertion (<<) or extraction (>>) operator to stream a bool
b Having problems using Standard C++ Library 2.x with Orbix 2000
b Building Tools.h++ 7.1.1 with Visual Age 5.x
b Linux multithreaded limitation with the Oracle8 805 client
b RWMetro Supported Platforms, Metro-Platforms
b SQL Server Access Library 3.x does not support bulk operations
b Color printouts of Grid.J lose the background colors
b Using Chart.J with Swing/jfc
b Using RWDBConnection in nested RWDBReaders
b Running setup.exe to install StudioJ
b getNumberRowCol() method in Grid.J throwing exceptions
b Assertion failure with DBTools.h++ examples
b Problems Compiling Math.h++ 6.x on HP, DEC and Windows 3.1
b Binary Files downloaded using Tools.h++ Professional are the Wrong Size
b How to build an RWDBCriterion with dynamic restrictions
b Oracle8 AL: How can I use a RWDBBlob with LONG RAW or BLOB columns that hold 32k or more
b How Do I Send a Basic Password to a Web Page?
b Building .h++ products with +DAportable
b Building zApp 3.0 as a DLL under Windows 16-bit crashes with Borland C++ 4.52
b Understanding Rogue Wave Build Codes
b Trying to rollback a transaction and it is not working
b Building on Solaris with the g++ compiler
b Sybase AL: syntax error when trying to bulk insert a vector object of size 1
b Unresolved symbol opinit at runtime
b Establishing a connection to Personal Oracle 8
b Compile problems with View.h++ v.1.3.0
b Building zApp 3.1 with MSVC 6.0
b Viewing a JFactory-made ComboBox with Netscape
b Adding a Timeout to an RWSocket::connect() Call
b Creating a Global Database Object
b Application crashing in the RWDBBlob destructor in DBTools 3.1.3 version
b RWZone::os() Returns Unexpected Result
b Errors installing products with SPM and RedHat Linux
b Accessing _servInst in zApp 3.x on NT
b Objective Grid/J: Which .class files do I deploy with OG/J?
b Unresolved symbols during linking with DBTools static libraries
b I get the error: [DBNOTFOUND] No access library
b Transaction control with DBTools 3.1
b Porting Math 6.1.8 to Redhat Linux 6.0 (Linux 2.2.5-15)
b Assertion failed, attempting to add intrusive link...
b How can I force RWDate to display a four digit year?
b Undefined symbols when linking the Math.h++ on SGI
b How Do Math.h++ Random Number Classes Generate Random Numbers?
b Compiling Math.h++ 6.x with MSVC 4.2 results in errors in the file <tt>rwlpbla.cpp</tt>
b Compiler trouble on IRIX 5.3
b My Sun compiler reports a Sig 10 error when building with Tools.h++
b When using Money.h++ as a DLL in my application, the symbol NaN is undefined during a link.
b Warning messages in link phase using Math.h++ in OWL project
b RWTime Can Only Represent Times Up to the Year 2037
b Visual CASE and Visual C++ 6 Service Pack 3
b How do I construct an unbounded Producer-Consumer Queue (or Stack)
b RWDBTracer and asString() method behave differently in DBTools 4.0.0
b Assigning the Empty String to an RWCString
b Fix for modeless MDI dialog when modal non-MDI Dialog is opened
b Table will not accept data
b How can I enable and disable radio buttons in a zRadioController?
b Accelerator keys in modal dialog
b Detecting changes in text in an edit line
b SPM error - file truncated
b How can I have a timestamp inserted with a row into my Oracle table
b JChart 1.0 will not print charts to the printer
b Compiler errors involving min() and max() macros
b Problems compiling .c files in the rogue/mathsrc directory
b RWDBCursor write fails at runtime sometimes with a syntax error
b MDI menus appending items instead of inserting
b Assertion failure in rw/, line 0
b Does DBTools.h++ support the Oracle Array type?
b Installing products with SPM as root accidentally deletes device /dev/null
b How do I stop a thread that is blocked on a system call or performing I/O?
b Trouble transferring binary files with FTP examples
b Beanbox integration for JWidgets
b Error installing parts using SPM
b Borland C++ 5.02 and SPM 1.3 Edition 5, November 1997
b Stored procedure on Sybase returns empty result set.
b How To build RW-Metro examples on WINNT4-MSVC6.0 ?
b Will DBTools.h++ operate properly with WIN32s?
b Is Informix transaction logging required?
b Memory leaks reported on different calls to DBTools.h++ or Tools.h++ methods.
b My RWIFtpClient is behaving erratically.
b Tools.h++ PC Patches
b _ex_keylock undefined symbol problem
b How do I access tables on different databases on the same server?
b Library Mismatch with MSVC4.x Compiler
b Installation order of Math.h++ and Tools.h++ is critical
b Moving Unix applications to Windows when using RPC
b Can DBTools.h++ run under DOS?
b Problems Running the Software Parts Manager (Unix)
b Link Error when Building DBTools Application
b When installing JFactory from InstallShield, why does it start installing other programs?
b Memory leaks in Tools.h++ code?
b DBTools.h++ generates a unique table alias each time a select statement is executed
b RWCString::toLower() function call creates runtime error.
b How to use the Rogue Wave Informix Access Library for DBTools.h++ in a multi-threaded application
b Creating Charts using ChartJ Component Beans
b How do I implement a select count (*) in DBTools.h++?
b Informix DB-Access Library fails to build on HP/aCC platforms.
b Integrating JWidgets into Symantec Visual Cafe version 2.0
b Error ORA-12154 while connecting to ORACLE via DBTools.h++.
b Executing multiple SQL statements with RWDBDatabase::executeSql() on ORACLE
b Does DBTools.h++ support Dynamic SQL?
b Error when executing a stored procedure.
b Establishing connectivity between an RDBMS and DBTools.h++
b Error ORA-06401 while connecting to ORACLE via DBTools.h++
b Are project files (IDE files) provided for building DBTools.h++ under Windows?
b The details of RW_CENTURY_REQD
b rwMakeThreadFunctions and Passing Parameters By-reference
b Problems Running the Software Parts Manager (Windows)
b DB2 AL guide: RWDate should map with DB2 DATE type, instead of RWDBDateTime
b How can I get the port number from an RWSocket?
b Building Rogue Wave Products on Solaris 2.6 with SunPro 5.2
b How to produce an interleaved output in a multithreaded program?
b RWDBInserter.isValid() always returns OK even the SQL generated is incorrect
b Symbol Table Program fails to compile
b Reading a Sybase user defined type results in an error
b Installing a DBTools error handler
b The Software Parts Manager(SPM) cannot find CL.EXE
b JChart 2.1 Java Beans do not work well with certain Java IDEs
b How to change the font in a zTable cell and column and row label
b Determining what style bit is set from inside your program
b Control Size Problems from Win16 to Win32
b Using RWDBBlob with a stored procedure on Sybase
b How do I move to the end of my grid
b Math.h++ Allocates Excessive Memory for Vector, Matrix, and Array Classes
b Distributing Visual CASE Diagrams and Projects
b Visual CASE Errors After Installation of Another Stingray Product
b Refreshing the Contents in the UML View
b Why is the UML InfoBrowser no longer updating its contents in response to selection changes?
b No UML Diagraming Without an Active Project
b Base Class Shows Up Empty in UML Diagram
b No Visual CASE Tab in the Tools|Options Property Sheet
b Removing UML modeling Information from a Workspace
b Add UML Model and Integrated UML Modeling Buttons
b Location of MFC and ATL UML Libraries
b Location of Visual CASE Project Files
b All Visual CASE Menus and Toolbars Disabled
b Using absolute paths with a URL in SerializableImage
b Repository Read Error in Unix for SPM
b JChart pie piece value = 0 gives error message
b zApp 3.0.3 Online Documentation for Windows
b How do I delete a row in a cell grid?
b zHelp crashes when F1 is pressed twice
b What platforms and compilers will View.h++ build on?
b Adding a menu item dynamically when ID of DropDown is not known
b Assertion Failure Running DBTools Examples
b Drag-and-drop columns not working in cellgrid
b Which Tools.h++ classes require the Standard C++ Library?
b Why am I still connected to my database after my RWDBConnections have gone out of scope?
b How do I use an RWDBCursor for Write?
b Putting a static frame around a zStaticText
b Compiler error when building zApp as shared library
b Help and On Apply buttons call the same function from zNoteBookDialog
b zComboBoxFull on tab stop on zNoteBkDialog prevents tab from reaching any farther
b zFont does not display the size I specified.
b Unresolved externals when trying to link zApp application with MSVC4.2
b Building zApp with the CTL3D option turned on
b Multiple radio buttons are checked and will not disable.
b How to store/retrieve large blobs in SybaseCT
b Second constructor for zFormDialog
b How to create and run Stored Procedures in DB2
b In zHelp, the <A NAME=> tag does not work correctly
b Radio buttons on zNotebookDialog pages
b Making a vertically scrolling zEditBox
b How to call Oracle PL/SQL functions from DBTools
b Building Tools.h++ as a DLL with Borland C++ Builder
b zApp Error Codes
b Restore button does not work in MDI apps
b Memory leak when using zNotebook and zWizard dialogs
b Placing combo boxes on the tool bar
b NullPointerException with JWidgets 3.0 and Netscape 4.04
b Accessing command line arguments in zApp
b RWDBDateTime is Returning an Incorrect Time
b Sybase warning: Changed database context
b Updating sliders after calling setCurrent()