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 . ..