Rational Rhapsody Frameworks and Operating Systems Reference
Total Page:16
File Type:pdf, Size:1020Kb
Rational Rhapsody Frameworks and Operating Systems Reference Before using the information in this manual, be sure to read the “Notices” section of the Help or the PDF available from Help > List of Books. This edition applies to IBM® Rational® Rhapsody® 7.5 and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright IBM Corporation 1997, 2009. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. ii Contents Frameworks and Operating Systems . 1 Real-Time Frameworks . 1 Rational Rhapsody Statecharts . 2 The Object Execution Framework (OXF). 3 Working with the Object Execution Framework . 3 The OXF Library. 4 Rational Rhapsody Applications and the RTOS. 5 Operating System Abstraction Layer (OSAL). 5 Threads . 7 Stack Size . 7 Synchronization Services . 8 Message Queues . 8 Communication Port. 9 Timer Service . 10 Real-time Operating System (RTOS) . 11 AbstractLayer Package (OSAL) . 11 Classes . 12 OSWrappers Package . 12 Adapting Rational Rhapsody for a New RTOS . 13 Run-Time Sources . 13 Adding the New Adapter . 13 Creating the Batch File and Makefiles. 14 Sample <env>build.mak File . 15 Creating New Makefiles . 16 OXF Versions . 16 Animation Libraries. 16 Implementing the Adapter Classes . 18 Modifying rawtypes.h . 19 Other Operating System-Related Modifications . 19 Building the Framework Libraries . 20 Rational Rhapsody i Table of Contents Building the C or C++ Framework for Windows Systems . 20 Building the Ada Framework . 21 Building the Java Framework . 22 Building the Framework for Solaris Systems . 22 Creating Properties for a New RTOS . .24 Modifying the site<lang>.prp Files . 24 Setting the Environment . 26 Configuring the OXF Properties for the C++ Framework . 27 Validating the New Adapter . 30 Modifying the Framework . 31 Implementing the Abstract Factory. 31 Plugging in the Factory. 31 OSAL Methods. 34 The OSAL Classes . 37 Rational Rhapsody Developer for C . .38 RiCOSConnectionPort Class . 39 RiCOSEventFlag Interface . 45 RiCOSMessageQueue Class. .50 RiCOSMutex Class . 59 RiCOSOXF Class. 64 RiCOSSemaphore Class . 67 RiCOSSocket Class . 73 RiCOSTask Class . 80 RiCOSTimer . 93 RiCHandleCloser Class . 97 Rational Rhapsody Developer for C++ . 98 OMEventQueue Class . 98 OMMessageQueue Class . .100 OMOS Class . 100 OMOSConnectionPort Class . .102 OMOSEventFlag Class . ..