Program Directory for 


CAA RADE Products, 

CATIA CAA APIs, 

ENOVIA CAA APIs 

 

V5R15


Program Number 5628-CAA Version 5 Release 15


Last Updated : 2005/04/01

 

Trademarks and Copyrights: please read legal notice

 

Copyright © 1994-2005, Dassault Systèmes. All rights reserved.

 

Installation Requirements and Considerations

The following sections identify the system requirements for installation and activation.

System Requirements

Windows Intel Platforms

Hardware Requirements

The hardware requirements are the same as the ones for CATIA, DELMIA, and ENOVIA products depending on the API you will work on, except the followings:

Software Requirements

The following components at the indicated level are required:

Note: On Windows , the Fortran runtime DLL previously at level 5 are now delivered at level 6.6B (.6.913.106) in the intel_a\code\bin directory.

Required Patches

Please refer to Program Directories for CATIA, DELMIA, and ENOVIA products for patches generally recommended for these product lines and not specific to CAA RADE products or CAA APIs.

IBM AIX Platforms

Hardware Requirements

The hardware requirements are the same as the ones for CATIA, DELMIA, and ENOVIA products depending on the API you will work on, except the followings:

Software Requirements

The following components at the indicated level are required, applying to both AIX 32 bit and AIX 64 bit:

Required Patches

Following build-time patches are required in addition to the run-time patches recommended in the CATIA, DELMIA and Enovia V5 program directories :

HP-UX Platforms

Hardware Requirements

The hardware requirements are the same as the ones for CATIA, DELMIA, and ENOVIA products depending on the API you will work on, except the followings:

Software Requirements

The following components at the indicated level are required:

Required Patches

Please refer to Program Directories for CATIA, DELMIA, and ENOVIA products for patches generally recommended for these product lines and not specific to CAA RADE products or CAA APIs.

SGI Irix Platforms

Hardware Requirements

The hardware requirements are the same as the ones for CATIA, DELMIA, and ENOVIA products depending on the API you will work on, except the followings:

Software Requirements

The following components at the indicated level are required:

Required Patches

Following build-time patches are required in addition to the run-time patches recommended for CATIA Version 5 Release 15 (listed in the CATIA Program Directory):

SUN Solaris Platforms

Hardware Requirements

The hardware requirements are the same as the ones for CATIA, DELMIA, and ENOVIA products depending on the API you will work on, except the followings:

Software Requirements

The following components at the indicated level are required

Required Patches

Following build-time patch is required in addition to the run-time patches recommended for CATIA Version 5 Release 15 (listed in the CATIA Program Directory):

Additional Software Requirements for CAA RADE V5

(*) These functionalities are not supported with Windows XP.

Additional Software Requirements for Online Access to Documentation

Prerequisites for the Licensing Environment

Disk Storage Requirements

An approximate size of 300 Mb on Windows and 375 Mb on UNIX is needed to install the software.

Installation Instructions

This chapter describes the installation method to install the functions.

Installing CATIA V5 Solutions CAA APIs, DELMIA V5 Solutions CAA APIs, ENOVIA Solutions CAA APIs

Delivery Contents

CATIA V5 Solutions CAA APIs, DELMIA V5 Solutions CAA APIs and ENOVIA Solutions CAA APIs media contain all deliveries necessary to install all available APIs.

If you use a CAA vendor-written application, the CATIA V5 Solutions CAA APIs, DELMIA V5 Solutions CAA APIs or ENOVIA Solutions CAA APIs level must be at the same level as the applicable CATIA V5 Solutions, DELMIA V5 Solutions or ENOVIA Solutions level installed. In addition, the CAA vendor must supply the application rebuilt on that level.

Overview

Installation of CATIA V5 Solutions CAA APIs, DELMIA V5 Solutions CAA APIs, ENOVIA Solutions CAA APIs can be divided into three main steps:

  1. Managing the installation path. On NT or 2000 the path is automatically computed, on UNIX you should prompt the CATIA, DELMIA, or ENOVIA installation path.
  2. Checking on the available disk space.
  3. Downloading the software.

Windows

  1. Log on as an administrator.
    You must belong to the administrator group, or have the privileges assigned to the Administrator group. Otherwise, you will not be able to start the installation.
  2. Insert the CD-ROM into the drive.
    The installation procedure starts automatically. A full self-explanatory graphic interface appears, where you can easily navigate.

UNIX

  1. Logging on as an administrator is mandatory.
  2. Insert the CD-ROM into the drive.

    Special CD-ROM mount configuration on HP-UX only:

    After mounting the CD-ROM, change directory to the mount point and enter the command: ./start
    Then a full self-explanatory graphic interface appears, where you can easily navigate.

Remark:

To build AIX 64 bit CAA applications on top of AIX 64 bit CATIA, DELMIA, or ENOVIA DMU runtime, the dedicated CAA 64 bits CD must be used. UNIX instructions then apply.

Accessing the CAA Online Documentation

The CAA online documentation, also named CAA Encyclopedia, is installed with the CAA APIs. You can access it with an HTML browser at the following addresses:

<CATIA, DELMIA, or ENOVIA CAA APIs installation path>/CAAV5HomePage.htm

or

<CATIA, DELMIA, or ENOVIA CAA APIs installation path>/CAADoc/Doc/online/CAACenV5Default.htm

Please refer to the CAA Encyclopedia for information on deprecated APIs.

Interoperability Considerations

Please refer to the homepage.htm file on the CD-ROM.

Installing CAA RADE V5

Delivery contents

CAA RADE V5 medium contains all deliveries necessary to install all available products and options.

Overview

CAA RADE V5 installation can be divided into three main steps:

  1. Choosing the installation path
  2. Checking on the available disk space
  3. Downloading the software

Windows

  1. Log on as an administrator.

    You must belong to the administrator group, or have the privileges assigned to the Administrator group. Otherwise, you will not be able to start the installation.

  2. Insert the CD-ROM into the drive.

    The installation procedure starts automatically. A full self-explanatory graphic interface appears, where you can easily navigate.

    The installation procedure is described in the CAA Encyclopedia installed with the CAA APIs CD-ROM. To find this procedure documentation, from the CAA Encyclopedia home page, click Getting Started, and click Installing CAA RADE V5 Products. To initialize the TCK which defines the tool configuration you can use, refer to the Tools documentation in the CAA Encyclopedia. From the home page, click Tools at the bottom right corner, then click TCK Tool Config, and click Introducing TCK.

  3. Run <CAA RADE installation path>\intel_a\code\bin\CATVBTSetup.exe to enable access to the CAA API documentation and possibly to run commands under Unix from Windows. This is also described in the installation procedure documentation.

UNIX

  1. Logging on as an administrator is mandatory
  2. Insert the CD-ROM into the drive.

    After mounting the CD-ROM, change directory to the mount point and enter the command: ./start
    The installation procedure starts automatically. A full self-explanatory graphic interface appears, where you can easily navigate.

    The installation procedure is described in the CAA Encyclopedia installed with the CAA APIs CD-ROM. To find this procedure documentation, from the CAA Encyclopedia home page, click Getting Started, and click Installing CAA RADE V5 Products. To initialize the TCK which defines the tool configuration you can use, refer to the Tools documentation in the CAA Encyclopedia. From the home page, click Tools at the bottom right corner, then click TCK Tool Config, and click Introducing TCK.

Licensing Considerations

The licensing product is delivered on the CD-ROM released with CAA RADE V5. The installation procedure for LUM is included in the CAA RADE V5 installation documentation. Refer to the Memo to Users for instructions on obtaining keys for CAA RADE V5.

Interoperability Considerations

Please refer to the homepage.htm file on the CD-ROM.

NLS Considerations

CAA RADE V5 is NLS-enabled. It is supplied with the english and french localizations.

CAA RADE V5 supports DBCS.

Activating CAA RADE V5

This procedure describes how to get started with the C++ Interactive Dashboard on Windows.

Known Problems & Tips

CAA Authorized APIs Are in PublicInterfaces

The CAA authorized C++ , Java, and IDL APIs are located in the PublicInterfaces directories of the exposing frameworks.

CAA authorized APIs:

As a rule, never use other APIs from the PublicInterfaces directories. APIs from header files located in the PublicInterfaces directories that include the CAA Tag @CAA2Level L0 at the top are beta-authorized APIs. They are not intended to be used in your applications, except for tests. They are neither build time stable, nor run time stable, and can disappear without previous notice.

V5R15 CAA Media Content Changes

In order to help customers' and partners' applications comply with the CAA V5 usage rules described in the CAA Encyclopedia, our offering is refined by better aligning the CAA build time media content with the CAA Encyclopedia content. Thus, starting with V5R15, non-CAA Authorized APIs previously located in the ProtectedInterfaces folders are no longer available from the CAA build time media. While enriching the CAA Authorized APIs offering with new CAA APIs matching new needs, we will continue to deliver with CAA RADE a more and more secure development environment by protecting CAA applications from the risks of using non-CAA Authorized APIs.

As a reminder, CAA RADE tools prevent the usage of undocumented resources located in ProtectedInterfaces starting with V5R12. In some cases, the CAA RADE tools may not have detected all uses of the non-CAA authorized APIs.

To ensure that all non-CAA Authorized APIs have been detected, CAA RADE V5R15 provides a new audit tool. Launch it before attempting to build your CAA applications. Please refer to the What's New in the CAA Encyclopedia for further information on how to use this audit tool. Please contact your local support if you need assistance.

Locating Documentation and Use Cases

You can access the CAA Encyclopedia online documentation with a HTML browser at the following addresses:

<CATIA, DELMIA, or ENOVIA CAA APIs installation path>/CAAV5HomePage.htm>
or
<CATIA, DELMIA, or ENOVIA CAA APIs installation path>/CAADoc/Doc/online/CAACenV5Default.htm>

Recommendations for Multiple Release Support

When using two CAA RADE V5 releases on the same workstation:

Installing a CAA API Limited Availability CD

While installing CAA CATIA LA media, if you choose Complete Installation and you see that the required space is OKb in the Start Copying Files panel, please cancel installation otherwise unpredictable results may occur. A workaround is to perform a complete installation of the base CAA CATIA media, before installing CAA CATIA LA media.

Installing RADE

RADE can be installed in the same folder as other V5 brands, such as CATIA, DELMIA, or ENOVIA LCA. This is proposed by default. If you choose to install in a folder other than V5 brand, pay attention when launching RADE and/or this brand. The environment taken by default is the last one installed. You should then always declare the appropriate environment using the -env and -direnv options. For example:

catstart -env CATIAEnv -direnv CATIAEnvFolder

CATVBTLicenser.exe -env RADEEnv -direnv RADEEnvFolder

If you modify your RADE environment and change the CATUserSettingPath variable, pay attention that the last folder name must always end with RADE.

NB: There is no more specific Service Pack CD-ROMs for RADE. To Apply a Service Pack on a RADE installation, use the usual runtime Service Pack CD-ROMs.

Installing a 'Configuration Plus Add-on' License on Top of a Configuration License

If you have already installed a configuration and its license, and if you later on install an add-on and another license for both the same configuration and the add-on, you may have messages when using the products packaged in the configuration when they search for their licenses, but they will run normally.

For example, if you have already installed the CAA C++ Extended Development Configuration (CDC) and its license, and if you install the CAA Source Code Manager (SCM) product and a license for both CDC and SCM, the CAA RADE products you were previously using with CDC will issue a message similar to "No license available to fulfill CDC request" before getting their licenses from the license manager, but they will run normally.

Using CAA Interfaces with a PDM Product

Since V5R7, when using the implementation of the CATIDocEnvironment interface of the ObjectModelerBase framework, the CATIA Team PDM license is checked and the methods fail if no license is found.

Using Implementations of Specs Modeler Interfaces

A new MkCheckSource error (VISI) detects the usage of prohibited implementations of Specs Modeler interfaces. An example is the CATSpecObject class. You are invited to check this error, and modify your code to use the appropriate interface in place of the internal class. For example, do not use CATSpecObject, but instead use the interface that CATSpecObject implements and that supplies the CATSpecObject method. In V5R15, without this migration, your code could fail.

Using CAA-RADE Source Code Manager

When launching the SCM monitor on HP-UX with a local DB2 server, the SQL1224N error may be raised. To overcome this problem, configure DB2 to use a client/server connection  (typically, "db2 catalog tctpip node" + "db2 catalog database at node" statements).

Using CAA-RADE Data Model Customizer

CAA Samples/Applications That Can't Execute on AIX with non US Locale Settings

On locales other than English (en_US) on the AIX Operating System, you can get following error messages on standard output/error when executing a CAA sample or application:

Can't open library libTheViewLibrary.a
--> reason = A file or directory in the path name does not exist

or:

Could not load program MainExe:
Could not load module libShared_1.a.
        Dependent module Shared_2.exp could not be loaded.

Whereas the library exists and is accessible from the application.

In the case the command /usr/bin/dump -H on the impacted library shows an invalid dependency on an export file, such as:

dump -H libShared_1.a
INDEX PATH                 BASE             MEMBER
0 /lib:/usr/lib
1                          libJS0GROUP.a
2                          Shared_2.exp

The problem may be caused by unexpected collation order in non English locales. Problem was reported with German locale setting (de_DE), but other locales may be impacted.

To workaround this problem, you should:

You can also add the export of the environment variable at the end /usr/Dassault/Systemes/T14/aix_a/code/command/mkinit.sh

CAA Samples/Applications That Can't Build in Debug Mode on Solaris

Building CAA samples or applications in debug mode (mkmk -g) on Solaris may fail due to additional links to unauthorized symbols added by the Solaris C++ compiler.

CATIExtendable Deprecated

CATIExtendable is deprecated starting with V5R15 and replaced with CATIOsmExtendable. For this V5R15 GA level, the internal Product Structure platform is not ready for this new interface. As a result, do not change your code relying onto Product Structure to CATIOsmExtendable. The CAAPstProductIcon use case that uses CATIOsmExtendable does not work.

LIST OF CORRECTED APARs