Welcome to SCX Help’s documentation!

Contents:

• CX Online Help
• Contact
  • Contact PrismTech
  • European Headquarters
  • USA Corporate Headquarters - PrismTech Corporation
• Spectra CX Release Notes
• System Requirements
• Additional Requirements
• Installation
  • Un-installing Spectra CX
  • Installing RSA 9.1.x
    • Download installation files
    • Running the installer
  • Installing the Spectra CX plugin
    • Downloading the Spectra CX plugin, documentation and licenses
    • Installing the Spectra CX plugin
  • Product documentation
  • Known Installation Issues
  • Product Licensing
  • Importing the RSA license
  • Importing the Spectra CX License
• Product Licensing
  • Importing the RSA license
  • Importing the Spectra CX License
• New features and changes
  • New features and changes in 3.6.4
  • New features and changes in 3.6.2
  • New features and changes in 3.6.1
• Known Issues
  • Generated tests may fail on Linux hosts when using a separate target system
  • Test Generation
  • XML import connector ID to external port is failing validation
  • Unable to save model from Project Explorer
  • Missing validation constraints
  • Un-setting a build configuration
  • Error indications not always cleared after the error has been fixed
  • DCD validation error on interNode connection
  • Product updates need to be installed as root on Linux and by an Admin user on Windows
  • SCA XML import limitations
  • Model element names should not contain spaces.
  • Changes to imported model libraries
  • Generated code conforms to minimum CORBA specification
  • IDL operation length exceeds 80 characters
  • Line break required in IDL file
  • NamingService and ResourceFactory-ref collision
  • Support for SCA 2.2
  • IDL Generation does not work for multiple selections.
  • Save model changes before importing IDL.
  • Build fails with make versions earlier than 3.81
  • Cannot create an application with 2 or more components
  • Test generation fails when referencing external IDL files
  • Application fails to create on VxWorks
  • Free Standing Ports and External Ports (FSP) are not created where they are dropped
  • Online help responds slowly
  • SCA Validation action opens all models in workspace
  • Error undoing DTLTCR port
  • Problems with IDL comments
  • Problem with Generation of JUnit tests with external allocation properties
  • SpectraCX does not Support IDL defines
  • Runtime Monitor
  • Migration
  • Dependency File Names
  • Constraint Overridden Property Duplicate ID Type and Name
  • Mounting File System Using Run Time Monitor
• Class modeling and code generation known Issues
• Model Migration
• Upgrade RSA 8.5.0 to RSA 8.5.1
• Installing Software Updates
  • View versions of installed software
  • Uninstall Software
  • Reverting to a Previous Installation
  • Applying Software Updates
    • Updating from an Archive
    • Updating from a URL
    • Updating from Local
    • Common
• Introduction
• Component-based Development
• What is Component-based Development?
  • CBD Concepts
    • Components
    • Interfaces
    • Layering
    • Assemblies
  • Component Details
    • Component Interface
      • Interfaces
    • Component Realization
    • Component Structure
    • Component Implementation
  • Physical and Logical Layers
    • Physical Platform
    • Logical Platform
  • Deployment and Configuration
  • Validation and Transformation
    • Validation
    • Transformation
• CX and Domain Specialization
• Working with Spectra CX
• User Interface Conventions
  • Perspectives
  • Quick UI Reference
  • Project Explorer View
  • Palette
  • Properties View
  • SCAConnectors View
• CX Preferences
  • Modifying Preferences
  • Modeling
    • SCA Modeling
  • SCA
    • XML
  • Validation
• Spectra CX SCA Workflow Overview
  • Create a new project and model
  • Model Waveform
  • Elaborate Elements
    • Modeling Assistant
  • Model Platform
  • Generate Code and Descriptors
• Modeling
• Application and Platform Modeling
  • Components
  • Applications
  • Logical Platform
• Creating Project Models
  • To create a project model
• Default SCA Model Folders
• IDL Modeling
• IDL Import
  • Import new IDL into CX model
  • Re-importing IDL into a Spectra CX model
    • IDL Merge
  • Modifying IDL files and re-importing
    • Adding to IDL files and re-importing
    • Removing information from IDL files and re-importing
    • Renaming IDL file elements and re-importing
      • Rename Interfaces
      • Rename Operations
      • Rename Modules
• IDL Generation
• XML Import
  • Spectra CX Project and Model Creation
  • XML Import
  • Model Organization after Import
    • Components, Devices, CF Elements
    • User Defined SCA Properties
    • Dependencies
    • Node Diagram
    • Application Diagram
    • External Ports
    • Importing Resource Factories
    • Code Generation
• Elements
• Creating Elements
• Working with Elements
• SCA Application
  • SCA Application
• Packages
• Applications
• Connectors
• Component Interfaces
• Components
  • Component Wizard
  • Changing Component Type
• Implementation Artifacts
  • Component Implementation
• Libraries
• SCA Port Libraries
• Resource Factories
• Generalizations
• Interface Realizations
• Property Types
• Dependencies
• Ports
  • Conjugation
  • External Ports
  • Creating a Port
  • Creating a Free Standing Port
  • Creating an External Port
  • Changing Conjugation
  • Changing Port Interface
• Freestanding FindBy Ports
• FSP DTLTCR and DUBTCR
• Uses Device
  • Uses Device Dependency
• Operating Systems
• OS Link
• Processors
  • Processor Link
• Implementation Options
  • Link
• SCA Platform
  • SCA Platform
• Packages
• Platforms
• Nodes
• Connectors
• Component Interfaces
• Devices
• Services
  • Naming Service
  • Filesystem and Filemanager
• Aggregate Devices
• Implementation Artifacts
  • Component Implementation
• Libraries
• Generalizations
• Interface Realizations
• Property Types
• Dependencies
• Freestanding FindBy Ports
• Event Channels
• Uses Device
  • Uses Device Dependency
• Operating Systems
• OS Link
• Processors
  • Processor Link
• Implementation Options
  • Link
• Managers
• Domain Manager Descriptor (DMD)
  • Domain
  • DMD Service
• CORBA
  • CORBA
• IDL Files
• IDL Include
• Modules
• Interface
• Supported Interface
• Generalizations
• CORBA Elements
  • CORBA Enumeration
  • CORBA Array
  • CORBA Sequence
  • CORBA Struct
  • CORBA Typedef
  • CORBA Union
  • CORBA Constants
  • CORBA Exception
  • CORBA Operation
  • CORBA Operation parameter
  • CORBA Attribute
  • CORBA String
  • CORBA WString
  • CORBA Native
• Port Types
• Generalizations
• Interface Realizations
• C++ Language Drawer
• Editing and Viewing Elements
• Deleting Elements
• CX Component Diagrams
• Adding CX Component Diagrams
• Deleting CX Component Diagrams
• SCA Connectors View
  • Showing the view
  • Sorting
  • Inserting a connection
  • Deleting a connection
  • Navigate To
• Properties
  • SCA
  • General
  • Attributes
  • Operations
  • Stereotypes
  • Documentation
  • Constraints
  • Relationships
  • Appearance
  • Literals
  • Advanced
• SCA Model Properties
  • Name
  • Abstract Uses Port Attribute
  • Generate Attribute
    • Attribute Initialization
    • Configure and Query Methods
  • Generate Connection Handler
  • Generate Types
    • Attribute Type Generation
    • Compilation
  • Use Snprintf
  • Version
• Defining Property Types
  • Enumeration Property Type
  • Primitive Property Type
  • Struct Property Type
  • Sequence Property Type
  • Test Property Type
• Defining SCA Properties
  • Create a Property Type
  • Create an SCA Property
  • The following SCA properties are created for each SCA property you define
    • Name
    • ID
    • Description
    • Mode
    • Range
    • Units
    • Value
    • Override generate attribute
    • Generate attribute
  • The following details how to create each type
    • SCA Simple Property
    • SCA Simple Sequence Property
    • SCA Test Property
    • SCA Struct Property
    • SCA Struct Sequence Property
• Overriding SCA Property Values
  • Setting Values At SCA Property Level
  • Overriding Values at Component, Component Interface or SCA Implementation Level
  • Overriding SCA Property Values at Assembly Level
• External Allocation Properties
• SCA Application
• Applications
• Component Interface
• Component Properties
  • ID
  • PRF Description
  • PRF File Name
  • SPD File Name
  • Author
  • Description
  • SCA Compliant
  • Suppress Generation
  • Override generate attribute
  • Generate attribute
  • Abstract Uses Port Attribute
  • Generate servant access
  • Generate executable parameters
  • Generate connection handler
  • Title
  • Version
• Implementation Artifact
  • Other Implementation Properties
• Library
• Resource Factory
• Connector
• Port Properties
  • Conjugation
  • Kind
  • Porttype
  • Max Connections
• Freestanding FindBy Port
• FSP DTLTCR and DUBTCR
  • FSP DeviceThatLoadedThisComponentRef (DTLTCR)
  • FSP DeviceUsedByThisComponentRef (DUBTCR)
• Uses Device
• Operating System
• Implementation Options
• SCA Platform
• Nodes
• Component Interface
• Devices
• Implementation Artifact
  • Other Implementation Properties
• Library
• Property Types
  • SCAProperty
  • SCAPrimitive, SCAEnum, SCAStruct and SCASequence
• Connector
• Port Properties
  • Conjugation
  • Kind
  • Porttype
  • Max Connections
• Freestanding FindBy Port
• Uses Device
• Operating System
• Implementation Options
• Manager
  • Device Manager
  • Domain Manager
• DMD
  • Domain
  • DMD Service
• CORBA
• Interface
• Port Type
• Deployments
• SCA Deployments
• Deployment Editor
• Model Libraries
  • JTRS Model Libraries
  • Importing Model Libraries
• Shared Libraries
  • Shared Library Modeling
  • Shared Library Generation
    • XML generation
    • Source code generation
  • Shared library build configurations
    • SONAME
  • Execution environment for shared library elements
• Inter-DCD connections
• Example Models
• Class Modeling and Generation
• C++ context menu
• C++ language Palette drawer
• Classes
  • CPP Generalizations
  • Class Operations
  • Class operation parameters
• Data Types
• Primitives
• Indirection
• Associations
  • Associations and Shared Associations
  • Composition
  • Association Accessors and Modifiers
  • Creating an Association
  • Association Options
    • Properties View SCA tab
    • Properties View General tab
• CPP Attributes
  • Creating a CPP Attribute
  • CPP Attribute Options
    • Properties View SCA tab
    • Properties View General tab
• Editor
  • User Tags
  • Editor Context Menus
    • Class Editor
    • Class Operation Editor
• Generation
• Compilation
• Validation
• Activating Validation
• Validation Process
  • Navigating to Error Sources
    • Problems View
• Generation
• Code Generation
  • Component Makeup
  • Device Makeup
  • CORBA Versus Non-CORBA
    • Figure 1: Visualization of a Component
    • Generation Overview
• Code Generation Overview
  • Source directory structure
• Code Generation Workflow
• Build Configurations
  • Getting Build Configurations
  • Installing Build Configurations
  • Importing Build Configurations
  • Licensing
  • Updating a Build Configuration
  • Modifying
  • Adding Build Configurations to Implementations
  • Deleting Build Configurations from Implementations
  • Build Configuration Details
    • Operating Environment Specific Source Code
    • Native vs. Non-Native Exceptions
    • TargetLoader
  • Build Configuration Options
    • General Options
    • SCA Domain Options
    • Overriding and Adding Build Configuration Options
    • Use Binary Configuration
      • Binary Build Configuration Copy Directory
• Open Editor
• Running Code Generation
• SCA Code Responsibilities
  • SCA Interfaces
    • CF::Resource
    • Device CF Interfaces
    • CF::Resource Example
      • Figure 1: CF::Resource Example
  • Ports
  • Properties
    • Properties Example
      • Figure 3: Properties
    • Interfaces
• Code Pattern
  • SCA Code Pattern
    • Figure 1: Code Pattern
  • Main Class
  • Servant Class
  • Worker Class
  • Port Class
  • Provides Port
  • Uses Port
    • Connections
    • Broadcast Semantics
      • Oneway operations
      • Operations with return parameter
      • Operations with Out or InOut parameters
      • Uses Port Common Methods
• C++ Portable Exception Layer Macros
  • Description
    • Example 1 Using Portable Exception Layer Macros
  • Macro Definitions
    • SCX_DECLARE_ENV
    • SCX_ENV_ARG[1 | N]
    • SCX_ENV_VAR[1 | N]
    • SCX_TRY
    • SCX_TRY_LABEL(lbl)
    • SCX_THROW (exc)
    • SCX_THROW_LABEL (exc, lbl)
    • SCX_THROW_RETURN (exc, ret)
    • SCX_THROW_RETURN_VOID (exc)
    • SCX_CATCH(type,var)
    • SCX_CATCH_NOOP(type)
    • SCX_CATCH_ANY
    • SCX_RETHROW_RETURN(ret)
    • SCX_RETHROW_RETURN_VOID
    • SCX_CHECK_ENV
    • SCX_CHECK_ENV_LABEL (lbl)
    • SCX_CHECK_ENV_RETURN (ret)
    • SCX_CHECK_ENV_RETURN_VOID
    • SCX_END_TRY
• C-code generation
• Building for Multiple targets
• C API
• Port API
  • __init() and __fini() methods
  • Uses Port
  • Provides Port
• Component API
• Component Worker API
  • User edit tags
  • Worker__init() and Worker__fini() methods
  • Configure Properties
  • Query Properties
  • Test Properties
  • Provides Ports Operations
  • Supports Interface Operations
• Examples
  • Sending data out a uses port
  • Executable Parameters
  • Initialization
  • Finalization
  • Configure Sequences
  • Query Sequences
• C++ API
• Port API
  • Uses Port
  • Provides Port
  • Provides Port Handler
• Component API
• Component Worker API
  • User edit tags
  • Configure Properties
  • Query Properties
  • Test Properties
  • Provides Ports Operations implemented in Worker
  • Supports Interface Operations
  • Servant Access
• Examples
  • Sending data out a uses port
  • Executable Parameters
• Delegate Worker
• IDL Generated Files Suffixes
  • Supported Code Generation Languages
  • Setting Suffixes
  • Default Suffixes
  • Model Migration
  • SCA Validation
• Descriptor Generation
• Generating XML Descriptors
• Shared Descriptor Files
• SCA Descriptors
• Software Package Descriptor (SPD)
• Device Package Descriptor (DPD)
• Property File (PRF)
• Software Component Descriptor (SCD)
• Software Assembly Descriptor (SAD)
• Device Configuration Descriptor (DCD)
• DomainManager ConfigurationDescriptor (DMD)
• Preamble in Generated XML
  • Enabling the preamble
  • Editing the preamble and pattern
  • Variables
  • Valid XML Comment
  • Preview preamble using the pattern
  • Saving changes
  • Example
  • Reset to Default values
• Headless Generation
  • Overview
  • Prerequisites
  • Usage
  • Options
  • Examples
    • Generating specific action for a model element
    • Generating all available content for a model
    • Generating specific action for an element in a different directory using a different project name
    • Bring up the help options
  • Notes
  • Additional References
• Runtime Monitor
  • Add a Runtime Monitor to a Model
    • Context Menu
    • Palette
  • Runtime Monitor Options
  • Open a Runtime Monitor
  • Control and Deployment Panes
  • Monitor Tabs
    • Monitor Tab
    • Naming Service Browser Tab
    • File System Browser Tab
  • Properties View
    • Attributes Tab
    • SCA Properties Tab
  • Log Console
  • Monitor Applications
    • Install an Application Factory
    • Uninstall an Application Factory
    • Create an Application
    • Create an Application Using Device Assignment Sequence
    • Start an Application
    • Stop an Application
    • Release an Application
    • Refresh a Monitor
    • Restarting a Monitor
  • Supported transport protocols
• Product Line Management
  • Add the PLM capability to a Model
    • Verify that the PLM capability has been enabled
  • Variation Points
    • Add a Variation Point to a model element
    • Add a Variation Point with Value to a model element
    • Add a Variation Point with Settings to a model element
    • Add a Variation Point to multiple elements
  • Generate a Variation Point Model
    • Generate a Variation Point Model from a Model
    • Generate a Variation Point Model from a Node
    • Generate a Variation Point Model from a Platform
    • Generate a Variation Point Model from an Application
    • Specify Generated Variation Point Model Location
  • Variation Point Model
    • VP Model Options
    • Variation Points
      • Variation Point Options
      • Constrained Element Options
      • Attribute Options
    • Configurations
      • Create a Configuration
      • Configuration Options
      • Editing Configurations
    • Configuration Points
      • Configuration Point Options
      • Configuration Point with Value Options
      • Configuration Point with Settings Options
      • Settable Attributes Options
      • Supported Settable Attributes and valid values
      • Editing Configuration Points - VP-To-CP Mapping View
      • Populating the View
      • Undo/Redo Editing
      • Column Sorting
    • Validate the VPModel
    • Modify the VPModel
      • Delete a Variation Point
      • Merge changes made to base model
    • Generate a Spectra CX Model Variant from a Configuration
    • Product Variant Model
      • Element retention
      • Modifications
  • Remove the PLM Capability from a Model
  • Locate all Variation Points in CX Model
• Headless Model Variant Generation
  • Overview
  • Prerequisites
  • Usage
  • Options
  • Example
    • Generating all model variants and their xml descriptors from a vpm file
  • Additional References
• Testing
• SCA Unit Testing
  • Test Artifacts
    • TargetLoader
    • TargetLoaderInstance
    • Target Loader Instantiation
    • Loads implementation
  • Create a Test Model
    • Create a Model
    • Create and Configure a TargetLoader
    • Create and Configure a TargetLoaderInstance
    • Add SCA Implementations to the Test Model
    • Validate the Test Model
  • Generate Test Artifacts
    • Generate the TargetLoader
    • Compile the TargetLoader
    • Generate the JUnit Tests
    • Compile the JUnit Tests
  • Run the Tests
    • Start the TargetLoader
    • Run the Unit Test Suite
    • Run the Unit Test for a Component
  • Adding Unit Tests for an SCA Component
• Introduction
  • Report Generation
• Run the Tests
  • Start the TargetLoader
• Run the Unit Test for a Component
• Run the Reports
• Tutorials
  • Overview
• Tutorial 1: Learning the Basics
  • Outline
  • Create a new project and model
  • Define preference settings
  • Create a package
  • Create a component
  • Add User IDL to the Model
  • Create ports
  • Create an application
  • Create connections
  • Application port development
  • Save project and model
  • Tutorial Summary
• Tutorial 2: Developing the Model
  • Open the project and model
  • Run SCA Validation 1/3
  • Create an assembly controller
  • Run SCA Validation 2/3
  • Property type creation
  • User-defined SCA property creation
  • Components and Devices: Definitions, Implementations, and Instances
  • Define implementation dependencies
  • Create a DTLTCR Freestanding Port
  • Run SCA Validation 3/3
  • Tutorial Summary
• Tutorial 3: Platform Development
  • Open the project and model
  • Create a device
  • Create ports on the device interface
  • Define Executable Device SCA properties
  • Define allocation properties
  • Create SCA Primitive Property Types
  • Create SCA Properties and assign them
  • Validate the Modem Device
  • Create a node
  • Core Framework elements
  • Create a Device Manager
  • Create a Domain Manager
  • Create a Log Service
  • Add Core Framework elements to the node
  • Configure the node
  • Validate the node
  • Define the platform
  • Tutorial Summary
• Tutorial 4: Finalizing the Model
  • Open the project and model
  • Add a PropertyReference Dependency
  • Add a Software Package Reference Dependency
    • Uses Devices and Uses Devices Dependencies
  • Validate the model
  • Tutorial summary
• Tutorial 5: Implementing
  • Import the Build Configuration
  • Define the Make Location
  • Generate Code
  • Browse Generated Code
  • Edit Worker Code
  • Compile the Source
  • Descriptor Generation
  • Descriptor Validation
  • Packaging Files for Deployment
  • Tutorial Summary
• Tutorial 6: Testing the Components
  • Configure the model for test generation
    • Create a new model
    • Create a package and diagram
    • Add a TargetLoader to the model
    • Define the build configuration
    • Add a TargetLoaderInstance to the model
    • Configure the components to be tested
  • Generate test components
  • Compile test components
  • Run the tests
  • Tutorial Summary
• Tutorial 7: Deploying on a Spectra Core Framework
  • Amending Components for Spectra CF
  • Open the project and model
  • Adding Properties
    • Spectra CF Components
      • DeviceManager
      • DomainManager
    • Threadpool Settings
      • DomainManager domain profile
      • PRODUCER_LOG_LEVEL
    • Spectra CX Components
      • Modem
  • Building Source Code
  • Copying the XML, object files and CF elements
  • Running OE Platform
  • Stopping OE Platform
  • Loading and Running Application
  • Tutorial Summary
• Tutorial 8: Deploying on VxWorks 5.5.1
  • Amending Components for VxWorks 5.5.1
    • Open the project and model
    • Amending Component Implementations
    • Import VxWorks 5.5.1 Model Library
      • DeviceManager
      • DomainLog
      • DomainManager
      • Modem
      • AssemblyController
      • Decryptor
      • Filter
      • TargetLoader
      • LinuxTargetLoaderInstance
  • Amending the OS and Processor Values
    • OS and Processor Dependencies
    • Component Properties
  • VxWorks 5.5.1 Shared Libraries
  • Building Source Code
  • Deploying on the VxWorks 5.5.1 Target System
  • Testing the components
  • Running OE Platform
  • Tutorial Summary
• Key Concepts
  • Application
  • Application Layer
  • Assembly
  • Attributes
  • Class
  • Class Diagram
  • Component
  • Component Interface
  • Component Realization
  • Communication Path
  • Configuration
  • Connection
  • Dependency
  • Deployment
  • Deployment Specification
  • Device
  • Domain Specialization
  • Execution Environment
  • Implementation
  • Interface
  • Layer
  • Logical Layer
  • Monolithic Implementation
  • Node
  • Part
  • Physical Layer
  • Platform
  • Port
  • Property
  • Properties Descriptor
  • Software Communications Architecture (SCA)
  • Structural Realization
  • CX Component Diagram
• Domain Profile DTDs Overview
• Software Package Descriptor DTD
• Device Package Descriptor DTD
• Properties Descriptor DTD
• Software Component Descriptor DTD
• Software Assembly Descriptor DTD
• Device Configuration Descriptor DTD
• DomainManager Configuration Descriptor DTD

Indices and tables

• Index
• Module Index
• Search Page