Installing and Building Your SourcePro® Products
Introduction
Welcome
What is RCB?
Creating Buildspecs
Executing Buildspecs
Features
Wizard-Like Interface
Built-In Intelligence
Understanding Your Environment
Selectable Component Set
Sequential Multiple Builds
Single, Multipurpose Buildspace
Three Selectable Build Activities
Command Line Interface
Flexible Naming Conventions
Reusable Data for Building Applications
3rd-Party Software Use
Resources
Products and Services Information
Quick Start
Getting Started
Installing RCB and Components
License Key File
Installing RCB and SourcePro Components
The Buildspace Directory
Starting RCB
Creating Buildspecs
Select a Buildspec
Specify a Buildspace
Select Components
Specify Build Options
Submit Buildspec to the Build Queue
Consider Build Queue Options
Buildspecs in the Build Queue
Buildspecs Outside the Build Queue
Navigation Buttons
Build Output Screen
Executing Buildspecs
License Message
Executing a Buildspec from the GUI
Executing a Buildspec from the Command Line
Running the Build Manager from the Command Line (Method 1)
Running make from the Command Line (Method 2)
Results of Running a Buildspec
Directory Structure
Directory Naming
Directory Structure Variations
Build Report
Keyboard Shortcuts
Accelerator Keys
Navigating Through the Items on a Screen
“Clicking” Buttons Without the Mouse
Checkbox and Radio Button Selection and Deselection
Shortcuts Specific to the Component Selection Screen
Dropdown Menus
Dismissing the Help Window
Limitations
UNC Path Incompatibility
Launching Multiple RCB Instances on Windows
Known Problems
Buildspec Details
Introducing Buildspecs
Working with Buildspecs
What is a Buildspec?
Common Buildspec Mistakes
Changing Answers and Accidentally Creating a New Buildspec
Accidentally Overwriting a Buildspec
Modifying a Buildspec Without Changing Its Name
Migrating from an Earlier RCB Version
Answering Questions to Create a Buildspec
Question List
How RCB Determines Which Questions to Ask
Context-Sensitive Q&A
Unavailable (Greyed-out) Answers
Options Dialog
Advanced Options
Welcome Screen
General Buildspec Questions
Select Buildspec
Select Buildspace
Local Buildspace
Copying Buildspecs
Export Buildspace
Select Components
Dependency Checking
Select Build Action
Select Operating System
Select Compiler
Select Dialect
Select Bitwidth
Select Linking
Select Threading
Select Debugging
C++ Standard Library Selection Screen
Select Compile and Link Options
Custom Compile Flags
Custom Executable Link Flags
Custom Library Link Flags
Select Naming Convention
Naming Conventions
Select Clean Options
Prebuild Clean Optons
Postbuild Clean Options
Module-Specific Questions
Essential Tools Module
Snappy Version
RWCString and RWWString Implementation
Requiring Four-Digit Years
Internationalization Module
ICU Selection
ICU Directory Path
Threads Module
Tracing Question
Performance Option (Windows)
Secure Communication Module
Library Location
SourcePro DB Access Modules
DB Access Modules
Microsoft SQL Server Access Module
Rerunning Example Builds After Correcting DB Connection Information
XA Module of SourcePro DB
Essential Math Module
Working with Buildspaces
Buildspace Issues
Multiple Buildspaces
Using an Imported Buildspec
Using the Export Buildspace Feature
Cleaning Up Buildspaces
Invoking rwclean
Deleting All Buildspace Files
Deleting Buildspace Files According to Buildtype and Module
Command Line Syntax
Examples Using rwclean
Compiling Issues
Invoking RCB's Makefiles from the Command Line
Example
Appendix A, Glossary
Appendix B, Third‑Party Licenses
Apache Software License v. 1.1
Sun Binary Code License 2.0
Appendix C, Build Tag Conventions
Summary Tables
Supported Conventions
The RCB Convention
Build Tags
Rogue Wave Component Builder (RCB)
PART I General Build Information
The Basics
The Four Basic Build Requirements
More About Include Path
More About Linking to Libraries
More About _RWCONFIG
More About System Requirements
Products and Services Information
Additional Topics
Procedure for Building Your Applications
Dueling Compiler Flags
Working With Dynamic Binding
Linking to Required Libraries
Running the Application
Windows requirements
UNIX requirements
Using Rogue Wave Static Libraries with MSVC
PART II Module-Specific Build Information
Essential Tools Module Build Information
Google Snappy
Location
Required Include Paths
Required Link Libraries
Linking to Snappy on Windows
Linking to Snappy on UNIX
Internationalization Module Build Information
International Components for Unicode (ICU)
Location
Required Include Paths
Required Link Libraries
The Default Locale
DB Interface Module Build Information
Required Link Libraries
Statically-linked Applications
Dynamically-linked Applications
Runtime Issues
Statically-linked Applications
Dynamically-linked Applications
Setting Environment Variables
Setting Environment Variables in Windows
Setting Environment Variables in UNIX
Establishing Connectivity
Establishing a Database Connection
Establishing a C Connection to the Database
Establishing a Connection Between the DB Interface Module and the Database Server
Secure Communication Module Build Information
OpenSSL
OpenSSL Location
Required Include Paths
Required Link Libraries
Linking to OpenSSL on Windows
Linking to OpenSSL on UNIX
Essential Math Module Build Information
Issues to Consider
Building the Essential Math Module Library
Building Applications that Depend on the Essential Math Module
Windows
NetLib CLAPACK Library
MKL BLA Library
UNIX
Linux
Oracle Developer Studio on Solaris or Linux
All Other Modules
No Module-Specific Explanations Needed
PART III Appendices
Appendix A, Build Tag Conventions
Summary Tables
Supported Conventions
The RCB Convention
Build Tags
Appendix B, Location of Key Files
Rogue Wave Buildspace
Installing and Building Your SourcePro® Products
Appendix B, Location of Key Files
RCB-Interface-Overview
RCB-Opening-Screen
rcbug-using-rcb_SpecifyABuildspace
rcbug-using-rcb_SelectComponents
Build-Options
Buildspec-Editing-Sessions-Summary
Build-Queue
Build-Specifications
Options-Dialog
rcbug-buildspecs_GeneralBuildspecQuestions
Buildspace-Selection-Screen
Component-Selection-Screen
Build-Action
Operating-System
Compiler
Dialect
Bitwidth
Linking
Threading
Debugging
Standard-Library-Options
Compile-and-Link-Options
Naming-Convention
Clean-Options
rcbug-buildspecs_ModuleSpecificQuestions
Essential-Tools-Module
Snappy-Version
Internationalization-Module
rcbug-buildspecs_ThreadsModule
Threads-Tracing
Threads-Performance-Option
Secure-Communication-Module
Secure-Communication-Library-Location
SourcePro-DB-Access-Modules
SQL-Server-Client
Essential-Math-Module
Basic-Linear-Algebra-Library-Selection