OSF DCE Application Development Guide--Core Components

OSF DCE Application Development Guide—Core Components
2.8 Managing Server Key Tables .............. 2-25
Chapter 3. DCE Application Messaging ................ 3-1
3.1 DCE and Messages ................. 3-1
3.2 DCE Messaging Interface Usage ............. 3-2
3.2.1 A Simple DCE Messaging Example ......... 3-2
3.2.2 The DCE Message Interface and sams Input and Output
Files ................... 3-6
3.3 DCE Messaging Routines ............... 3-8
3.3.1 Message Output Routines ............ 3-10
3.3.2 Message Retrieval Routines ............ 3-12
3.3.3 Message Table Routines ............. 3-14
3.3.4 DCE XPG4 Routines .............. 3-15
Chapter 4. Using the DCE Serviceability Application Interface ......... 4-1
4.1 Overview .................... 4-1
4.1.1 How Programs Use Serviceability .......... 4-2
4.1.2 Simple Serviceability Interface Tutorial ........ 4-3
4.1.3 Serviceability Input and Output Files ......... 4-12
4.2 Integrating Serviceability into a Server ........... 4-14
4.2.1 Serviceability Strategy ............. 4-14
4.2.2 Components and Subcomponents .......... 4-15
4.2.3 Identifying Event Points ............. 4-15
4.3 Application Use of Serviceability ............. 4-16
4.3.1 Basic Server Calls ............... 4-16
4.3.2 Extended Format Notation for Message Text ....... 4-20
4.3.3 Specifying Message Severity ........... 4-20
4.3.4 How to Route Messages ............. 4-22
4.3.5 Table of Message Processing Specifiers ........ 4-26
4.3.6 Logging and Log Reading ............ 4-27
4.3.7 Message Action Attributes ............ 4-28
4.3.8 Suppressing the Serviceability Message Prolog ...... 4-28
4.3.9 Serviceability Use of the __FILE__ Macro ....... 4-29
4.3.10 Forcing Use of the In-Memory Message Table ...... 4-29
4.3.11 Dynamically Filtering Messages Before Output ...... 4-30
4.3.12 Using Serviceability for Debug Messages ........ 4-33
4.3.13 Performance Costs of Serviceability Debugging ...... 4-38
4.3.14 Using the Remote Serviceability Interface ....... 4-39
Chapter 5. The DCE Backing Store ................. 5-1
5.1 Data in a Backing Store ............... 5-1
5.2 Using a Backing Store ................ 5-2
5.3 Header for Data .................. 5-2
5.4 The User Interface ................. 5-3
5.5 The IDL Encoding Services .............. 5-4
5.5.1 Encoding and Decoding in the Backing Store ...... 5-4
5.5.2 Conformant Arrays Not Allowed .......... 5-5
5.6 The Backing Store Routines .............. 5-6
5.6.1 O pe n i n g a B a cking Store ............. 5-6
5.6.2 Closing a Backing Store ............. 5-6
iv Tandem Computers Incorporated 124245