Statemate version 4.5.0.1 readme

IBM Corporation
01 March, 2009

 

 

ฉ Copyright IBM Corporation 1989, 2009
U.S. Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

This file contains last-minute product information and updates to Statemate 4.5 .0.1

It is divided into the following sections:

ท         System requirements

ท         Compatible products

ท         Installing Statemate 4.5

o        New Installation

o        Upgrade Installation

ท         What's new in version 4.5

For the latest news and information on Statemate, visit the website at http://www.ibm.com/software/rational/support/.

System requirements

To run Statemate 4.5 you need:

  • One of the following operating systems installed on your computer:
    • Sparc Solaris 2.8/2.9/2.10 with one of the following Windowing systems:
      • CDE
      • OpenWindows: 3
      • Motif
    • Windows XP SP2 with one of the following X-Servers Installed:
      • X-Vision
      • MKS X/Server
  • The system requirements for Windows:

The recommended memory (RAM) for Windows is 256 MB.
When working with large models on Windows platforms, you should allow more memory to enhance tool performance.
When working with models that contain 200 or more charts and 2500 or more dictionary elements (textual elements), allow at least 1 GB of physical memory.

For additional information on system requirements, including recommended configurations, visit the Support Web site.

At the time of writing, the third party products tested with Statemate 4.5 are: -hidden

For the latest information about third party products that are supported with Statemate, visit the Support Web site. -hidden


Compatible products

  • Adobe Acrobat Reader 6.0 or newer
  • CANoe V3.0
  • ClearCase V3.1.1
  • Continuous 4.5
  • DOORS 8.1 (Windows Systems)
  • dSPACE (models 1102 & 1103)
  • dSPACE ControlDesk 1.2 P2
  • FlexNet v 11.5.0.0
  • FrameMaker 7.0
  • PVCS Version Manager v6.7.00 (Build 894)
  • QNX V6.3.2
  • VxWorks: 5.3 (Kernel WIND 2.5; Tornado 1.0.1)
  • Word 97/2000
  • GNAT ADA version 2.8.1 (Solaris)


Installing Statemate 4.5

New Installation

See the Statemate Installation Guide found on the CD.

Upgrade Installation

To upgrade from a version prior to 4.3, a new license is required. For more information, see Obtaining a license.
Before installing, it is recommended that you check in and unlock all configuration items in all workareas.
For more information, see the Statemate Administrator’s Guide and Statemate Installation Guide, found on the CD.


Obtaining a license for Statemate

Statemate uses Telelogic Lifecycle Solutions licensing. - hidden
For more details about obtaining a license, please see “TLS_licensing_guide”. - hidden
The file can be found on the distribution CD, under “license_server_windows_1.3” - hidden
directory for Windows, and under “license_server_1.3” directory for Solaris. – hidden
For details about obtaining a license, please refer to Statemate customer support.


What's new in version 4.5

  • Dataport / Documentor Enhancements
    • New Dataport APIs
      • stm_r_if_consists
        stm_list stm_r_if_consists(stm_id if_id, int *status)
        A new Dataport API function was added to allow retrieval of element names in ‘consists of’ of Info Flow

        Function Parameters:
        • if_id - Info Flow element id
        • status - (out parameter) - can return the following:
                    – stm_success
                    – stm_id_not_found
                    – stm_id_out_of_range
        Return Value:
        List of Strings containing the names of the elements and fields in the Info Flow

      • stm_init_uad_for_stm_dll
        stm_boolean stm_init_uad_for_stm_dll(char *proj,char *work_area, stm_transaction self_trans, int *status)
        A new Dataport API function was added to allow initializing Dataport from a DLL used by Statemate.

        Function Parameters:
        • proj - Project Name
        • work_area - Workarea path
        • self_trans - Select user transaction control / automatic transaction control
        • status - (out parameter) - can return the following:
                    – stm_success
                    – stm_no_updated_pmdb
                    – stm_no_updated_projdb
                    – stm_no_legal_operator
                    – stm_deadlock
                    – stm_not_member_of_project
                    – stm_nonexistent_project
                    – stm_empty_file_of_licensed_host
                    – stm_no_file_of_licensed_host
                    – stm_cannot_chdir_to_work_area

    • New Documentor APIs
      • New Function : STM_R_IF_CONSISTS(IN if: INFORMATION_FLOW, OUT st: INTEGER): LIST OF STRING;
        New Documentor API was added to allow retrieval of element names in ‘consists of’ of an Information Flow.

 

What's new in version 4.5.0.1

  • Upgrade QNX Support
    • The "Embedded Rapid Prototyper" tool on Windows platform was enhanced to support code-generation for QNX 6.3.2, using gcc compiler version 2.95.3. The support for QNX 6.3.2 is at beta-level.

  • New OS-Implementation
    • A new OS-Implementation was added: “autosar_rte_310”. This OSI contains the set of definitions required by "Statemate AUTOSAR Generator" (SAG) users, for generating code and Software Component description (.arxml file), compatible with AUTOSAR 3.1 specifications.

  • Workarea Management
    • Allow Environment variable as part of Workarea path
      • The user can use an environment variable to point to a path on his local machine.
        For example:
        set MY_WORKAREAS=c:\local_workareas
        and in Statemate set the Workarea path to be:
        $MY_WORKAREAS\my_local_workarea

  • Workflow Enhancements
    • Overwrite option for Export Operation
      • When performing Export using the GUI a confirm overwrite message will be displayed.
      • In non-interactive operations (executing Export from command-line I/F or dataport), the STM_YES_TO_ALL environment variable will be checked. If set, overwrite will be done.
    • Environment Activities in Interface Reports
      • A new "Activity Interface Browser and Reports" preference was added:
        "Consider Environment Activity Flow-lines in Functional mode" (default value 'No')
        • When this preference is set to 'Yes', the Activity-interface reports (textual and browser) in 'Functional' mode will regard environment activities as source of elements that flow from them, and as target of  elements that flow to them.
  • DataImport Enhancements
    • Allow Setting the ‘Enforce’ flag for an attribute
      • 4 new functions were added to DataImport to allow setting the “Enforce” flag of an attribute.
        • stmAddAttributeEx
        • stmModifyAttributeEx
        • stmAddAttributeFieldEx
        • stmModifyAttributeFieldEx

The new functions’ syntax is the same as the Non-Extended functions, except for an additional parameter for the value of the ‘Enforce’ flag, stm_boolean enforced

    • Allow External file dependency modification
      • New Function : int stmModifyExternalFile(STMContextHandle *handle, char* chart_name, char* element_name,stm_element_type element_type, char* ext_file_value)

        New DataImport API was added to support modification of external file dependency for Statemate elements.
        If         ext_file_value is set to NULL, the reference to the external file will be deleted.

  • Dataport Enhancements
    • stm_init_uad behavior Modified
      • If no Dataport license was found, stm_init_uad() will return FALSE, and set appropriate status, instead of exiting the program.

    • New Dataport APIs
      • stm_pm_create_project
        void stm_ pm_create_project(char *project_name, char *manager_name, char *databank_path, char *CM_tool, char *RT_project, char *OS_implementation, char *description, stm_boolean define_as_library, char *mess, int *status)
        A New function was added to allow creation of a new project.
        Function Parameters:
        • project_name : Project Name
        • manager_name : Project Manager Name
        • databank_path : Path to the project’s Databank
        • CM_tool : CM tool to use
        • RT_project : Name of corresponding RT tool project
        • OS_implementation: OS Implementation
        • description : Description
        • define_as_library : Is this project a library project
        • mess : an allocated string in which to return an error message
        • status : output parameter to hold success status. Possible values:
            stm_success
            stm_illegal_parameter
            stm_error_in_create_project

      • stm_pm_delete_project
        void stm_pm_delete_project(char *project_name, char *mess, int    *status)
        A New function was added to allow deletion of a project.
        Function Parameters:
        • project_name - Project Name
        • mess -         an allocated string in which to return an error message
        • status -         output parameter to hold success status. Possible values:
            stm_success
            stm_illegal_parameter
            stm_error_in_delete_project

      • stm_pm_create_workarea
        void stm_pm_create_workarea(char *project_name, char *workarea_path, char *mess, int    *status)
        A New function was added to allow creation of a workarea.
        Function Parameters:
        • project_name - Project Name
        • workarea_path – Workarea Path
        • mess -         an allocated string in which to return an error message
        • status -         output parameter to hold success status. Possible values:
            stm_success
            stm_illegal_parameter
            stm_no_legal_operator
            stm_workarea_already_exists
            stm_fail_to_create_workarea          

      • stm_pm_delete_workarea
        void stm_pm_delete_workarea(char *project_name, char *workarea_path, char *mess, int    *status)
        A New function was added to allow deletion of a workarea.
        Function Parameters:
        • project_name - Project Name
        • workarea_path – Workarea Path
        • mess -         an allocated string in which to return an error message
        • status -         output parameter to hold success status. Possible values:
            stm_success
            stm_illegal_parameter
            stm_fail_to_delete_workarea          
         
      • stm_pm_modify_project
        void stm_pm_modify_project(char *project_name, char *new_project_name, char *manager_name, char *databank_path, char *CM_tool, char *RT_project, char *OS_implementation, char *description, stm_boolean define_as_library, char *mess, int *status)
        A New function was added to allow modification of a project.
        Function Parameters:
        • project_name - Project Name
        • new_project_name - New Project Name
        • manager_name – Project manager Name
        • databank_path – Databank Path
        • CM_tool – Cm Tool
        • RT_project – Name of corresponding RT tool project
        • OS_implementation – OS Implementation
        • description – Description
        • defined_as_library – Is this a library project
        • mess –         an allocated string in which to return an error message
        • status -         output parameter to hold success status. Possible values:
            stm_success
            stm_illegal_parameter
            stm_error_in_modify_project   

      • stm_pm_add_ member_to_project
        void stm_pm_add_ member_to_project(char *project_name, char *user_name, char *mess, int    *status)
        A New function was added to add member to a project.
        Function Parameters:
        • project_name - Project Name
        • user_name – Name of user to be added
        • mess -         an allocated string in which to return an error message
        • status -         output parameter to hold success status. Possible values:
            stm_success
            stm_illegal_parameter
            stm_error_in_modify_project

      • stm_pm_copy_workarea
        void stm_pm_copy_workarea (char *project_name, char *workarea_path, char *new_workarea_path, char *mess, int    *status)
        A New function was added to allow copying of a workarea.
        Function Parameters:
        • project_name - Project Name
        • workarea_path – workarea to be copied
        • new_workarea_path – destination path
        • mess -         an allocated string in which to return an error message
        • status -         output parameter to hold success status. Possible values:
            stm_success
            stm_illegal_parameter
            stm_error_in_copy_workarea

      • stm_pm_move_workarea
        void stm_pm_move_workarea (char *project_name, char *workarea_path, char *new_workarea_path, char *mess, int    *status)
        A New function was added to allow moving of a workarea.
        Function Parameters:
        • project_name - Project Name
        • workarea_path – workarea to be moved
        • new_workarea_path – destination path
        • mess -         an allocated string in which to return an error message
        • status -         output parameter to hold success status. Possible values:
            stm_success
            stm_illegal_parameter
            stm_error_in_move_workarea

 


Known problems

Compiling Generated Code for dSPACE

The stm_ds1102.lk file, required when linking generated code for DS1102, is no longer supplied with the Statemate installation.
Please refer to the DS1102_readme.txt file under $STM_ROOT\etc\rapid\ds1102 for further information.

Compiling MicroC Generated Code for Softune

The file Start905s_souftune.asm was removed from the following locations in the installation:
$STM_ROOT\etc\CTD\mainloop_sc_ext
$STM_ROOT\etc\CTD\mainloop_sc
$STM_ROOT\Demo\PingPongDemoKitWA\prt\pp_ffmc16_softun
When using the targets: ml_ext_FFMC16_Fujitsu_softune, ml_FFMC16_Fujitsu_softune, the file start905XXX.asm needs to be copied from the Softune installation in order to build the application.


Fixed problems

For details of problems that have been resolved in Statemate 4.5.0.1, visit the support center on the Support Web site.

To access the list of fixed defects, do the following:

1. Log in to the support site
2. Select Statemate in the product selection box
3. Go to Release Notes section.
4. Go to Statemate 4.5.0.1 - Defects Fixed List and click Download

Contact Support

Support and information for Telelogic products is currently being transitioned from the Telelogic Support site to the IBM Rational Software Support site. During this transition phase, your product support location depends on your customer history.

ท         If you are a heritage customer, meaning you were a Telelogic customer prior to November 1, 2008, please visit the Telelogic Statemate Support site.

Telelogic customers will be redirected automatically to the IBM Rational Software Support site after the product information has been migrated.

ท         If you are a new Rational customer, meaning you did not have Telelogic-licensed products prior to November 1, 2008, please visit the IBM Rational Software Support site.

 

Notices

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send written license inquiries to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send written inquiries to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions. Therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Intellectual Property Dept. for Rational Software
IBM Corporation
1 Rogers Street
Cambridge, Massachusetts 02142
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Trademarks

IBM, the IBM logo, ibm.com, Telelogic, Telelogic Synergy, and Telelogic Change are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. These and other IBM trademarked terms are marked on their first occurrence in this information with the appropriate symbol (ฎ or ™), indicating US registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at www.ibm.com/legal/copytrade.html.

Adobe, the Adobe logo, PostScript and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Other company, product or service names mentioned may be trademarks or service marks of others.