PM84924: Missing SXF documentation

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • There is a lack of SXF documentation, despite the fact that
    certain references to information are made in other Rhapsody
    documents. In the guide found at:
    
    http://pic.dhe.ibm.com/infocenter/rhaphlp/v8/topic/com.ibm.rhp.o
    em.pdf.doc/pdf/btc/IBM%20Rational%20Rhapsody%20Reference%20Workf
    low%20Guide.pdf
    
    It states on p.21: 'Besides adding the right profiles and/or
    settings to the model, the code generation configurations that
    are used in order to generate code for the model must be
    attached with certain stereotypes. Details about which
    stereotypes must be used in order to use SXF framework ... can
    also be found in the IBM Rational Rhapsody SXF ... help'. I
    could not find what this is referring to, can you please let me
    know where this is located?
    
    It also states on p.21:  'In order to be able using the SXF or
    SMXF for safety related developments it is needed to do a
    systematic qualification of the simplified frameworks. The SXF
    and SMXF come equipped with validation suites containing...'. I
    only can find '...\7.6.1\Samples\CppSamples\SXF\DishPongSXF' on
    my machine. Where do I find those validation suites and the
    respective documentation (maybe only with Rhapsody 8.x)?
    
    There is also a confusing explanation concerning ports with SXF
    in the Rhapsody help found at:
    
    http://pic.dhe.ibm.com/infocenter/rhaphlp/v8/topic/com.ibm.rhp.m
    isra.doc/topics/t_misracpp.html?resultof=%22%73%78%66%22%20
    
    Specifically, in the 2nd note, it says 'To avoid a violation of
    MISRA C++ rules 5-2-4, 7-1-2, and 18-4-1, do not use ports.'.
    But a few lines later it states 'For using new or delete in
    ports, all attributes generated for ports are by value so no new
    or delete is generated.' Does this mean that ports can be used
    with SXF, or something else entirely?
    
    Finally, in the DishPong sample SXF model there are separate
    configurations for the SXF and the OXF frameworks, with the SXF
    stereotype being utilised. The guide mentioned above states that
    'No containers (can be added)': but no mention of how this can
    be done without violating the requirement that no dynamic memory
    allocation shall be used.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    A number of points are ambiguous in the SXF documentation.
    

Problem conclusion

  • Fixed in version 8.0.5.
    
    1) The question regarding "validation suites" was answered
    in the framework of the original escalation.
    
    2) In the steps to create projects that use the SXF
    framework, the following step was added:
       "Before generating code, apply the "SXF" stereotype to
    the configuration that you are using to generate the code."
    
    3) In the topic on Misra C++, the following sentence was
    removed:
    "For using new or delete in ports, all attributes generated
    for ports are by value so no new or delete is generated."
    The sentence about avoiding the use of ports in order to
    avoid MISRA violations is still correct.
    
    Note that with regard to the SXF, the table in the topic
    "Simplified C++ execution framework"
    (http://pic.dhe.ibm.com/infocenter/rhaphlp/v8/topic/com.ibm.
    rhp.frameworks.doc/topics/rhp_c_fw_sxf_framework.html)
    clearly states that ports are not supported with the SXF.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM84924

  • Reported component name

    TLOGIC RHAPSODY

  • Reported component ID

    5724V74RP

  • Reported release

    761

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-03-15

  • Closed date

    2013-12-25

  • Last modified date

    2013-12-25

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

  • Fixed component name

    TLOGIC RHAPSODY

  • Fixed component ID

    5724V74RP

Applicable component levels

  • R761 PSN

       UP



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational Rhapsody

Software version:

761

Reference #:

PM84924

Modified date:

2013-12-25

Translate my page

Machine Translation

Content navigation