SOMObjects Base Toolkit Quick Reference Guide

SC23-2682
Bull DPX/20
SOMobject Base Toolkit
Quick Reference Guide
AIX
ORDER REFERENCE
86 A2 29AQ 01
Bull DPX/20
SOMobject Base Toolkit
Quick Reference Guide
AIX
Software
June 1995
BULL S.A. CEDOC
Atelier de Reproduction
FRAN–231
331 Avenue Patton BP 428
49 005 ANGERS CEDEX
FRANCE
ORDER REFERENCE
86 A2 29AQ 01
The following copyright notice protects this book under the Copyright laws of the United States and other
countries which prohibit such actions as, but not limited to, copying, distributing, modifying, and making
derivative works.
Copyright
Bull S.A. 1992, 1995
Printed in France
Suggestions and criticisms concerning the form, content, and presentation of
this book are invited. A form is provided at the end of this book for this purpose.
Trademarks and Acknowledgements
We acknowledge the right of proprietors of trademarks mentioned in this book.
AIXR is a registered trademark of International Business Machines Corporation, and is being used under
licence.
UNIX is a registered trademark in the USA and other countries licensed exclusively through X/Open.
The information in this document is subject to change without notice. Groupe Bull will not be liable for errors
contained herein, or for incidental or consequential damages in connection with the use of this material.
About This Book
This book is a handy reference, much like a “pocket reference guide.” It gives the syntax
and a one-sentence purpose statement for every method, function, and macro defined in
the SOMobjects Base Toolkit, Version 2.0, plus a listing of the SOM Compiler
commands/flags. The references are organized by each framework of the SOMobjects
Base Toolkit and are further subdivided by class. The Quick Reference Guide is abstracted
from the SOMobjects Base Toolkit Programmer’s Reference Manual. Experienced
programmers will find the Quick Reference a convenient reminder of keywords and
parameters, without having to refer to the complete Programmer’s Reference Manual.
For complete explanations of the purpose, syntax parameters, return type, and an example
of the SOMobjects methods, functions, and macros, refer to the SOMobjects Base Toolkit
Programmer’s Reference Manual. In addition, refer to the SOMobjects Base Toolkit Users
Guide for introductory information.
Who Should Use This Book
This book is for the professional programmer using the SOMobjects Base Toolkit to build
object-oriented class libraries or application programs that use SOM class libraries or the
frameworks in the SOMobjects Base Toolkit.
This book assumes that you are an experienced programmer and that you have a general
familiarity with the basic notions of object-oriented programming. In addition, it assumes
that you are already familiar with the SOMobjects system and with the information
presented in the related manuals for the SOMobjects Base Toolkit.
Preface
iii
iv
SOMobjects Base Toolkit Quick Reference Guide
Contents
SOM Compiler Quick Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOM Compiler ‘sc’ or ‘somc’ command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modifiers for –m option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Pragmas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1-1
1-1
1-2
1-3
1-3
1-4
SOM Kernel Quick Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Class Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOM Functions
(see somapi.h and somcorba.h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C/C++ Macros
(see somcdev.h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMClass class
(see somcls.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMClassMgr class
(see somcm.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMObject class
(see somobj.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2-1
2-1
DSOM Framework Quick Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Class Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSOM functions
(see request.h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSOM macros
(see cntxt.h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
BOA class
(see boa.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Context class
(see cntxt.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ImplementationDef class
(see impldef.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ImplRepository class
(see implrep.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
NVList class
(see nvlist.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ObjectMgr class
(see om.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ORB class
(see orb.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Principal class
(see principl.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Request class
(see request.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMDClientProxy class
(see somdcprx.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMDObject class
(see somdobj.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMDObjectMgr class
(see somdom.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMDServer class
(see somdserv.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMDServerMgr class
(see servmgr.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMOA class
(see somoa.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface
2-1
2-5
2-6
2-9
2-10
3-1
3-1
3-2
3-3
3-4
3-5
3-6
3-7
3-8
3-9
3-10
3-11
3-12
3-13
3-14
3-15
3-16
3-17
3-18
v
vi
Interface Repository Framework Quick Reference . . . . . . . . . . . . . . . . . . . . . . . . . . .
Class Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contained class
(see containd.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Container class
(see containr.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
InterfaceDef class
(see intfacdf.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Repository class
(see repostry.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Interface Repository functions
(see somtc.h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4-1
4-1
Metaclass Framework Quick Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Class Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMMBeforeAfter metaclass
(see sombacls.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMMSingleInstance metaclass
(see snglicls.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMMTraced metaclass
(see somtrcls.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5-1
5-1
Event Management Framework Quick Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Class Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMEClientEvent class
(see clientev.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMEEMan class
(see eman.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMEEMRegisterData class
(see emregdat.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMEEvent class
(see event.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMESinkEvent class
(see sinkev.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SOMETimerEvent class
(see timerev.idl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6-1
6-1
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
X-1
SOMobjects Base Toolkit Quick Reference Guide
4-1
4-1
4-2
4-2
4-2
5-1
5-1
5-2
6-1
6-2
6-3
6-4
6-4
6-4
SOM Compiler Quick Reference
SOM Compiler ‘sc’ or ‘somc’ command
Usage:
sc [–C:D:E:I:S:U:V:c:d:h:i:m:p:r:s:u:v:w] f1 f2 ...
somc [–C:D:E:I:S:U:V:c:d:h:i:m:p:r:s:u:v:w] f1 f2 ...
(On AIX or OS/2)
(On Windows)
Compiles the specified .idl file(s) and produces
binding files as the options, –m modifiers,
and environment variables direct.
where:
–C <n>
Sets size of comment buffer (default: 32767).
–D <DEFINE>
Has same effect as –D option for cpp.
–E <var>=<value>
Sets an environment variable.
–I <INCLUDE>
Has same effect as –I option for cpp.
–S <n>
Sets size of string buffer (default: 32767)
–U <UNDEFINE>
Has same effect as –U option for cpp.
–V
Show version number of compiler.
–c
Ignore all comments.
–d <dir>
Send output to directory for each emitted file.
–h
Displays a listing of this option list.
–i <file>
Use filename as specified (not a default .idl file).
–m <name[=value]>
Adds a global modifier (see valid Modifiers, below).
SOM Compiler Quick Reference
1-1
–p
Denotes shorthand for the option –D__PRIVATE__.
–r
Check release order entries exist (default: FALSE).
–s <string>
Replaces SMEMIT variable with <string>.
Note: Windows users should not use quotes in the string; for example,
somc –sh;ih *.idl
Correct
somc –s”h;ih” *.idl
Incorrect
–u
Updates Interface Repository.
–v
Sets verbose debugging mode (default: FALSE).
–w
Don’t display warnings (default: FALSE).
Modifiers for –m option
addprefixes
Adds ‘functionprefix’ to method names in the template file.
addstar
Adds ‘*’ to C bindings for interface references.
corba
Checks the source for CORBA compliance.
csc
Forces running of the OIDL compiler.
emitappend
Appends the emitted files at the end of the existing file.
noheader
Don’t add a header to the emitted file.
noint
Don’t warn about “int” causing portability problems.
nolock
Don’t lock the IR during update.
nopp
Don’t run the source through the pre-processor.
1-2
SOMobjects Base Toolkit Quick Reference Guide
notc
Don’t use typecodes for emit information.
nouseshort
Don’t generate short names for types
pp=<path>
Specifies a local pre-processor to use.
tcconsts
Generate CORBA TypeCode constants.
Note: All command-line modifiers can be set in the environment by changing them to UPPERCASE and
prepending “SM” to them.
Environment variables
SMEMIT=[h; ih; c; xh; xih; xc; def; ir; pdl]
Determines which emitters to run (default: h; ih).
SMINCLUDE=<dir1>[;<dir2>]+
Determines where to search for .idl and .efw files.
SMKNOWNEXTS=ext[;ext]+
Adds headers to user-written emitters.
SMTMP=<dir>
Sets a directory to hold intermediate files.
SOMIR=<path>[;<path>]+
Gives a list of Interface Repositories to search.
Pragmas
#pragma somemittypes on
Turns on emission of global types.
#pragma somemittypes off
Turns off emission of global types.
#pragma modifier <modifier stm>;
Use this statement instead of the definition for the same ‘modifier’ in the implementation section of the .idl file.
SOM Compiler Quick Reference
1-3
Other commands
pdl –d<dir> *.idl
Install public versions of the .idl files in the indicated directory.
ctoi *.csc
Convert file from .csc to .idl. (See Appendix B of the SOMobjects Developer Toolkit Users Guide.)
1-4
SOMobjects Base Toolkit Quick Reference Guide
SOM Kernel Quick Reference
Class Organization
SOMObject
— The root class for all SOM objects.
Provides behavior (methods) common to all SOM objects.
SOMClass
metaclass
— The root class of all SOM metaclasses.
Defines the essential behavior (methods) common to all
SOM classes.
SOMClassMgr
— An instance of SOMClassMgr is created automatically during SOM
initialization. It acts as a run-time registry for all SOM class objects
and assists with dynamic loading and unloading of class libraries.
SOM Functions
(see somapi.h and somcorba.h)
Note: function prototypes are given using C syntax, assuming the type environment
created by: #include <som.h>. Pointers to objects that support an interface are typed
using the interface name, without an explicit asterisk (*).
boolean somApply (
SOMObject objPtr,
somToken *retVal,
somMethodDataPtr mdPtr,
va_list args);
Invokes (on the object pointed to by objPtr) the apply stub for the method described by the structure pointed to by
the somMethodDataPtr. The result of the method invocation is stored in the memory location pointed to by
retVal (which cannot be null). The va_list must include objPtr as its first entry.
void somBeginPersistentIds ();
Tells SOM to begin a “persistent ID interval.”
void somBuildClass (
unsigned long inheritVars,
somStaticClassInfoPtr sciPtr,
long majorVersion,
long minorVersion);
Automates the process of building a new SOM class object; used by C and C++ implementation bindings.
somId somCheckId (somId id);
Registers a SOM ID.
somMethodPtr somClassResolve ( SOMClass clsPtr,
somMToken mToken);
Obtains a pointer to the procedure that implements a static method for instances of a particular SOM class.
SOM Kernel Quick Reference
2-1
int somCompareIds (
somId id1,
somId id2);
Determines whether two SOM IDs represent the same string. Returns true (1) if they are the same and false (0)
otherwise.
somToken somDataResolve (
SOMObject objPtr,
somDToken dToken);
Supports access to instance data within an object. Used by C and C++ implementation bindings.
void somEndPersistentIds ();
Tells SOM to end a “persistent ID interval.”
void somEnvironmentEnd ( );
Provides general cleanup for applications.
SOMClassMgr somEnvironmentNew ();
Initializes the SOM runtime environment.
void somExceptionFree (
Environment *ev);
Frees the memory held by the Exception structure within an Environment structure.
string somExceptionId (
Environment *ev);
Gets the name of the exception contained in an Environment structure.
somToken somExceptionValue (
Environment *ev);
Gets the value of the exception contained in an Environment structure.
Environment
*somGetGlobalEnvironment ();
Returns a pointer to the current global Environment structure.
somId somIdFromString (string aString);
Returns the SOM ID corresponding to a given text string.
boolean somIsObj (somToken memPtr);
Failsafe routine to determine whether a pointer references a valid SOM object.
long somLPrintf (
long level,
string fmt, ...);
Prints a formatted string in the manner of the C printf function, at the specified indentation level.
SOMClassMgr *somMainProgram ( );
Performs SOM initialization on behalf of a new program.
2-2
SOMobjects Base Toolkit Quick Reference Guide
somMethodPtr somParentNumResolve (
somMethodTabs parentMtabs,
int parentNum,
somMToken mToken);
Obtains a pointer to a procedure that implements the static method identified by mToken. Used by C and C++
implementation bindings to support parent method calls for multiple-inheritance classes.
somMethodPtr somParentResolve ( somMethodTabs parentMtab,
somMToken mToken);
Obtains a pointer to the procedure that implements the static method identified by mToken. Used by old binaries to
support parent method calls for single inheritance classes.
void somPrefixLevel (long level);
Outputs blanks to prefix a line at the indicated level.
long somPrintf (string fmt, ...);
Prints a formatted string in the manner of the C printf function.
int somRegisterId (somId id);
Registers a SOM ID and determines whether or not it was previously registered.
somMethodPtr somResolve (
SOMObject objPtr,
somMToken mToken);
Obtains a pointer to the procedure that implements the static method identified by mToken for a particular SOM
object.
somMethodPtr somResolveByName ( SOMObject objref,
string methodName);
Obtains a pointer to the procedure that implements a (static or dynamic) method for a particular SOM object.
void somSetException (
Environment *ev,
enum exception_type major,
string exceptionName,
somToken params);
Sets an exception value in an Environment structure.
void somSetExpectedIds (
unsigned long numIds);
Tells SOM how many unique SOM IDs a client program expects to use.
void somSetOutChar (
somTD_SOMOutCharRoutine * outCharRtn);
Changes the behavior of the somPrintf function.
string somStringFromId (somId id);
Returns the string that a SOM ID represents.
unsigned long somTotalRegIds ();
Returns the total number of SOM IDs that have been registered.
SOM Kernel Quick Reference
2-3
unsigned long somUniqueKey (somID id);
Returns the unique key associated with a SOM ID.
long somVprintf (
string fmt,
va_list ap);
Prints a formatted string in the manner of the C vprintf function.
somToken (*SOMCalloc) (
size_t num,
size_t size);
Allocates sufficient zeroed memory for an array of objects of a specified size. Replaceable.
string (*SOMClassInitFuncName) ( );
Returns the name of the function used to initialize classes in a DLL. Replaceable.
int (*SOMDeleteModule) (
somToken modHandle);
Unloads a dynamically linked library (DLL).
Replaceable.
void (*SOMError) (
int errorCode,
string fileName,
int lineNum);
Handles an error condition. Replaceable.
void (*SOMFree) (somToken memPtr);
Frees the specified block of memory. Replaceable.
SOMEXTERN void SOMLINK SOMInitModule (
long majorVersion,
long minorVersion,
string className);
Invokes the class creation routines for the classes contained in an OS/2 or Windows class library (DLL).
int (*SOMLoadModule) (
string className,
string fileName,
string functionName,
long majorVersion,
long minorVersion,
somToken *modHandle);
Loads the dynamically linked library (DLL) containing a SOM class. Replaceable.
somToken (*SOMMalloc) (size_t size);
Allocates the specified amount of memory.
Replaceable.
int (*SOMOutCharRoutine) (char c);
Prints a character. Replaceable.
somToken (*SOMRealloc) (
somToken ptr,
size_t size);
Changes the size of a previously allocated region of memory. Replaceable.
2-4
SOMobjects Base Toolkit Quick Reference Guide
C/C++ Macros
(see somcdev.h)
Note: Macro arguments are given using C argument declaration syntax for arguments
that are C expressions (for example,, “string className” denotes an argument expression
that evaluates to a char* value in C), whereas macro arguments that are simply tokens
manipulated by the preprocessor in order to create C expressions are identified with
the prefix <token>.
void SOM_Assert (
boolean expression,
long errorCode);
Asserts that a boolean condition is true — that is, a C/C++ expression evaluates to a non-zero value.
void SOM_ClassLibrary (
string “ libname.dll ”);
Identifies the file name of the DLL for a SOM class library in a Windows LibMain function.
Environment * SOM_CreateLocalEnvironment ();
Creates and initializes a local Environment structure that can be passed to methods as the Environment argument.
void SOM_DestroyLocalEnvironment ( Environment * ev);
Destroys a local Environment structure; calls somExceptionFree and SOMFree.
void SOM_Error (
long errorCode);
Reports an error condition.
void SOM_Expect (
boolean expression);
Asserts that a boolean condition is expected to be true.
SOMClass SOM_GetClass (
SOMObject objPtr);
Returns a pointer to the class object of which a SOM object is an instance. Invokes no methods.
void SOM_InitEnvironment (
Environment * ev);
Initializes a locally declared Environment structure that can be passed to methods as the Environment argument.
SOMClassMgr SOM_MainProgram ( );
Identifies an application as a SOM program and registers an end-of-program exit procedure to release SOM
resources when the application terminates.
SOM_NoTrace (
<token> className,
<token> methodName);
Used to turn off method debugging. The macro arguments are not C/C++ expressions,
but simply text used by the preprocessor to create expressions.
somMethodPtr SOM_ParentNumResolve (
<token> className,
long parentNum,
somMethodTabs mtabs,
<token> methodName);
Obtains a pointer to a method procedure from a list of method tables. Used by C and C++ implementation bindings
to implement parent method calls.
SOM Kernel Quick Reference
2-5
somMethodPtr SOM_Resolve (
SOMObject objPtr,
<token> className,
<token> methodName);
Obtains a pointer to a static method procedure.
somMethodPtr SOM_ResolveNoCheck (
SOMObject objPtr
<token> className,
<token> methodName);
Obtains a pointer to a static method procedure, without doing consistency checks.
long SOM_SubstituteClass (
<token> oldClass,
<token> newClass);
Provides a convenience macro for invoking :the somSubstituteClass method.
void SOM_Test (boolean expression);
Tests whether a boolean condition is true; if not, a fatal error is raised.
void SOM_TestC (
boolean expression);
Tests whether a boolean condition is true; if not, a warning message is output.
void SOM_UninitEnvironment (
Environment * ev);
Uninitializes a local Environment structure; calls somExceptionFree (but not SOMFree).
void SOM_WarnMsg (string msg);
Reports a warning message.
SOMClass class
(see somcls.idl)
Note: All following method prototypes for the SOM kernel classes are expressed using
IDL syntax for OIDL callstyle methods. That is, the receiver of the method is implicit, and
the two possible CORBA implicit arguments (environment and context) are not passed.
For example, to call the _get_somInstanceDataOffsets method from C (assuming an
#include <somcls.h>) the following prototype specifies that a programmer could write
the statement: __get_somInstanceDataOffsets(classPtr).
somOffsets _get_somInstanceDataOffsets();
Returns a sequence of structures, each of which indicates a class and the offset to the beginning of the instance
data introduced by the indicated class in an instance of the receiver class.
void somAddDynamicMethod (
in somId methodId,
in somId methodDescriptor,
in somMethodPtr method,
in somMethodPtr applyStub);
Adds a new dynamic instance method to a class. Dynamic methods must be invoked using name-lookup or dispatch
resolution.
2-6
SOMobjects Base Toolkit Quick Reference Guide
string somAllocate (
in long size);
Supports class-specific memory allocation for class instances. Cannot be overridden.
boolean somCheckVersion (
In long majorVersion,
In long minorVersion);
Checks a class for compatibility with the specified major and minor version numbers.
void somClassReady ();
Indicates that a class has been constructed and is ready for normal use.
void somDeallocate (
in string memPtr);
Frees memory originally allocated by the somAllocate method from the same class object. Cannot be overridden.
boolean somDescendedFrom (
in SOMClass clsPtr);
Tests whether a specified class is derived from the receiving class.
boolean somFindMethod (
in somId methodId,
out somMethodPtr m);
Finds the method procedure that implements the indicated method for a class of objects, and indicates whether the
method is a static.
boolean somFindMethodOk (
in somId methodId,
out somMethodPtr m);
As above; but if the method is not supported, this method raises an error and halts execution.
somMethodPtr somFindSMethod (
in somId methodId);
Finds the method procedure for a static method.
somMethodPtr somFindSMethodOk (
in somId methodId);
Like somFindSmethod; but if the desired static method is not supported, an error is raised and execution is halted.
long somGetInstancePartSize ();
Returns the size of the instance variables introduced by a class, in all instances of that class.
long somGetInstanceSize ();
Returns the size of an instance of a class.
somDToken somGetInstanceToken ();
Returns a token for the instance data introduced by a class.
somDToken somGetMemberToken (
long memberOffset,
somDToken instanceToken);
Returns an access token for an instance variable.
SOM Kernel Quick Reference
2-7
boolean somGetMethodData (
in somId methodId,
out somMethodData md);
Gets the method data for the indicated method, which must have been introduced by the receiver or an ancestor of
the receiver.
somId somGetMethodDescriptor (
in somId methodId);
Returns the method descriptor for a method.
long somGetMethodIndex (
in somId methodid);
Returns the index for the specified method. Can be used as input to somGetNthMethodData.
somMToken somGetMethodToken (
in somId methodId);
Returns a static method’s access token.
string somGetName ();
Obtains the name of the receiving class.
boolean somGetNthMethodData (
in long index,
out somMethodData md);
Loads the somMethodData structure for the nth (static or dynamic) method known to the receiver class, given the
index to the method. See also somGetNumMethods and somGetNumStaticMethods.
somId somGetNthMethodInfo (
in long index,
out somId descriptor);
Returns the method ID of the nth (static or dynamic) method known to this class. Also loads the location pointed to
by the passed descriptor address with a somId for the method descriptor.
long somGetNumMethods ();
Obtains the number of methods available for a class.
long somGetNumStaticMethods ();
Obtains the number of static methods available for a class.
SOMClassSequence somGetParents ();
Returns a sequence containing pointers to the parents of the receiver class.
void somGetVersionNumbers (
out long majorVersion,
out long minorVersion);
Gets the major and minor version numbers of the receiving class’s implementation code.
somMethodPtr somLookupMethod (
in somId methodId);
Like somFindSMethod except dynamic methods can also be returned. Used by bindings for name-lookup resolution.
2-8
SOMobjects Base Toolkit Quick Reference Guide
SOMObject somNew ();
Creates a new instance of the receiving class and calls somInit to initialize it.
SOMObject somNewNoInit ();
Creates a new instance of a class, but does not initialize it.
SOMObject somRenew (
in somToken memPtr);
Creates a new object instance of the receiver class in the indicated memory location. Zeros memory, and calls
somInit to re-initialize the object.
SOMObject somRenewNoInit (
in somToken memPtr);
Like somRenew, but does not call somInit to initialize it.
SOMObject somRenewNoZero (
in somToken memPtr);
Like somRenew, but does not zero memory.
SOMObject somRenewNoInitNoZero (
in somToken memPtr);
Like somRenew, but does not call somInit and does not zero memory.
boolean somSupportsMethod (
in somId methodId);
Indicates whether instances of a given class support a given (static or dynamic) method.
SOMClassMgr class
(see somcm.idl)
Note: Method prototypes for the SOM kernel classes are expressed using IDL syntax
for OIDL callstyle methods. That is, the receiver of the method is implicit, and the two possible
CORBA implicit arguments (environment and context) are not passed.
SOMClass somClassFromId (
in somId classId);
Finds a class object, given its ID, if it already exists. Does not load the class.
SOMClass somFindClass (
in somId classId,
in long majorVersion,
in long minorVersion);
Finds a class object, given its ID. If necessary, loads the class and initializes it.
SOMClass somFindClsInFile (
in somId classId,
in long majorVersion,
in long minorVersion,
in string file);
Finds a class object for a class when the correct file is known beforehand. If necessary, loads the class and
initializes it.
string somGetInitFunction ();
Obtains the name of the function that initializes the SOM classes in a shared library.
SOM Kernel Quick Reference
2-9
SOMClass *somGetRelatedClasses (
in SOMClass classObj);
Returns an array of class objects that were all registered during the dynamic loading of a class.
SOMClass somLoadClassFile (
in somId classId,
in long majorVersion,
in long minorVersion,
in string fileName);
Dynamically loads a class.
string somLocateClassFile (
in somId classId,
in long majorVersion,
in long minorVersion);
Determines the file that holds a class to be dynamically loaded.
void somMergeInto (
in SOMClassMgr target);
Transfers SOM class registry to another SOMClassMgr instance.
void somRegisterClass (
in SOMClass classObj);
Adds a class object to the SOM run-time class registry.
long somSubstituteClass (
in string origClassName,
in string newClassName);
Causes the somFindClass, somFindClsInFile, and somClassFromId methods to substitute one class for another.
long somUnloadClassFile (
in SOMClass class);
Unloads a dynamically loaded class and frees the class’s object.
long somUnregisterClass (
in SOMClass class);
Removes a class object from the SOM run-time class registry.
SOMObject class
(see somobj.idl)
Note: Method prototypes for the SOM kernel classes are expressed using IDL syntax
for OIDL callstyle methods. That is, the receiver of the method is implicit, and the two possible
CORBA implicit arguments (environment and context) are not passed.
boolean somCastObj (
in SOMClass ancestor);
Changes the behavior of an object to that defined by any ancestor of the true class of the object.
void somDefaultInit (
inout somInitCtrl ctrl );
Initializes instance variables and attributes in a newly created object. Replaces somInit as the preferred method for
default object initialization. For performance reasons, it is recommended that somDefaultInit always be
overridden by classes.
2-10
SOMobjects Base Toolkit Quick Reference Guide
void somDestruct (
in octet dofree,
inout somDestructCtrl ctrl );
Uninitializes the receiving object, and (if so directed) frees object storage after uninitialization has been completed.
Replaces somUninit as the preferred method for uninitializing objects. It is recommended that somDestruct
always be overridden. Not normally invoked directly by object clients.
boolean somDispatch (
out somToken retValue,
in somId methodId,
in va_list args);
Invokes the indicated method on the receiver. For static methods, resolution of the indicated method is performed
using the method table of the receiver’s class. The result returned by the method is stored into the location
pointed to by retValue. The va_list must include the target object as well as the arguments.
boolean somClassDispatch (
in SOMClass clsObj,
out somToken retValue,
in somId methodId,
in va_list args);
Like somDispatch, except that static method resolution is performed using the instance method table of the specified
class (clsObj).
somToken somDispatchA (
in somId methodId,
in somId descriptor,
in va_list args);
Obsolete. Like somDispatch, but restricted to methods that return a pointer. The va_list must not include the target
object. This method has been superseded by somDispatch and is included solely for backward
compatibility.
double somDispatchD (
in somId methodId,
in somId descriptor,
in va_list args);
Obsolete. As above, but restricted to methods that return a double precision floating point.
long somDispatchL (
in somId methodId,
in somId descriptor,
in va_list args);
Obsolete. As above, but restricted to methods that return a long.
void somDispatchV (
in somId methodId,
in somId descriptor,
in va_list args);
Obsolete. As above, but restricted to methods that return void.
void somDumpSelf (
in long level);
Clients of an object use this method to write out a detailed description of the object.
void somDumpSelfInt (
in long level);
Implementors of a class override this method to support somDumpSelf.
SOM Kernel Quick Reference
2-11
void somFree ();
Releases the storage used by an object and frees the object.
SOMClass somGetClass ();
Returns a pointer to an object’s class object.
string somGetClassName ();
Returns the name of the class of an object.
long somGetSize ();
Returns the size of an object.
void somInit ();
Implementors of a class may override this method to initialize instance variables or attributes introduced by the
class.
boolean somIsA (
in SOMClass aClass);
Tests whether the receiving object is an instance of the indicated class or of one of its subclasses.
boolean somIsInstanceOf(
in SOMClass aClass);
Tests whether the receiving object is an instance of the indicated class.
SOMObject somPrintSelf ();
Implementors of a class may override this method to write a brief description of the receiving object. A pointer to the
receiving object is returned as the result of the method call.
boolean somResetObj ( );
Resets an object’s class to its true class after use of the somCastObj method.
boolean somRespondsTo (
in somId methodId);
Tests whether an object can respond to an invocation of the indicated method.
void somUninit ();
Un-initializes the receiving object. Implementors of a class may override this method to free any allocated memory
pointed to by instance data or attributes introduced by the class.
2-12
SOMobjects Base Toolkit Quick Reference Guide
DSOM Framework Quick Reference
Class Organization
SOMObject
BOA
–
Basic Object Adapter. Abstract class which defines basic interfaces that a
server process uses to access services of an Object Request Broker like
DSOM. Defines methods for creating and exporting object references,
registering and activating implementations, and authenticating requests.
SOMOA
–
SOM Object Adapter. Subclass of BOA. Implements BOA methods, and
introduces methods for receiving and dispatching requests.
Context
–
Context. List of properties (Environment variables) that can be
passed in a method invocation. Each property consists of a name
and a string value.
ImplementationDef
–
Implementation Definition. Attributes define the implementation of a server.
ImplRepository
–
Implementation Repository. Defines and implements methods used to
query and update the DSOM implementation repository, which stores
copies of the ImplementationDef objects.
NVList
–
Named Value List. Implements a list of <name,value> pairs. NVLists
are used in building Request objects and Context objects.
ObjectMgr
–
Object Manager. Abstract class which defines basic interfaces for
creating objects, destroying objects, and mapping between objects and
their ids.
SOMDObjectMgr
–
DSOM Object Manager. Provides a DSOM-specific implementations
of the ObjectMgr abstract class. Also, introduces methods for finding
DSOM server implementations, by id, alias, and class.
ORB
–
Object Request Broker. Defines and implements various utility
methods as defined in the CORBA 1.1 specification. Included are
methods for converting object references to and from strings, for
creating NVLists to be used in building specific Requests, and for
obtaining a default Context object.
Principal
–
Principal. Attributes contain the ids of the user and host from which a
request originated. Used by application for access control checking.
Request
–
Request. Represents a method call and parameters, in the Dynamic
Invocation Interface. Includes methods used to invoke the request,
either synchronously (waits for a response) or asynchronously.
SOMDServer
–
SOMDObject
–
SOMDClientProxy
–
SOMDServerMgr
–
DSOM Server. Base class which defines and implements methods for
managing objects in a server. Includes methods for object creation and
deletion, and mapping between SOM objects and object references. Also
supports intercepting and redispatching method calls.
DSOM Object. Implements an “object reference” in DSOM. Includes
methods for getting an implementation or interface from a reference,
testing whether it is nil, and duplicating or releasing the reference.
DSOM Client Proxy. Subclass of SOMDObject. This “mixin” class is
used to implement proxy objects in client processes. Provides the
remote dispatching function used to forward requests to target objects.
Also supports the construction of dynamic requests to be invoked
against the proxy object.
DSOM Server Mgr. Provides a programmatic interface to manage
server processes. Server processes that can be managed are limited
to those in the Implementation Repository (as set by the SOMDDIR
environment variable).
DSOM Framework Quick Reference
3-1
DSOM functions
(see request.h)
ORBStatus get_next_response (
Environment* env,
Flags response_flags,
Request * req );
Returns the next Request object to complete, after starting multiple requests in parallel.
ORBStatus send_multiple_requests (
Request reqs[ ],
Environment* env,
long count,
Flags invoke_flags );
Initiates multiple Requests in parallel.
(see somdext.h)
void ORBfree ( void* ptr );
Frees memory allocated by DSOM for return
values and output arguments.
void somdExceptionFree (
Environment *ev);
Frees the memory held by the exception structure within an Environment structure, regardless of whether the
exception was returned by a local or a remote method call.
void SOMD_Init ( Environment* env );
Initializes DSOM in the calling process.
void SOMD_NoORBfree ();
Specifies to DSOM that the client program will use the SOMFree function to free memory allocated by DSOM, rather
than using the ORBfree function.
void SOMD_RegisterCallback (
SOMEEMan emanObj,
EMRegProc *func );
Registers a callback function for handling DSOM request events.
void SOMD_Uninit ( Environment* env );
Frees system resources allocated for use by DSOM.
3-2
SOMobjects Base Toolkit Quick Reference Guide
DSOM macros
(see cntxt.h)
ORBStatus Context_delete (
Context ctxobj,
Environment *env,
Flags del_flag);
Deletes a Context object.
(see request.h)
ORBStatus Request_delete (
Request reqobj,
Environment *env);
Deletes the memory allocated by the ORB for a Request object.
DSOM Framework Quick Reference
3-3
BOA class
(see boa.idl)
void change_implementation (
in SOMDObject obj,
in ImplementationDef impl );
Changes the implementation definition associated with the referenced object. (Not implemented.)
SOMDObject create (
in ReferenceData id,
in InterfaceDef intf,
in ImplementationDef impl );
Creates a “reference” for a local application object which can be exported to remote clients.
void deactivate_impl (
in ImplementationDef impl );
Indicates that a server implementation is no longer ready to process requests.
void deactivate_obj (
in SOMDObject obj );
Indicates that an object server is no longer ready to process requests. (Not implemented.)
void dispose (
in SOMDObject obj );
Destroys an object reference.
ReferenceData get_id (
in SOMDObject obj );
Returns reference data associated with the referenced object.
Principal get_principal (
in SOMDObject obj,
in Environment* req_ev );
Returns the ID of the principal that issued the
request.
void impl_is_ready (
in ImplementationDef impl );
Indicates that the server implementation is ready to process requests.
void obj_is_ready (
in SOMDObject obj,
in ImplementationDef impl );
Indicates that the object (server) is ready to process requests. (Not implemented.)
void set_exception (
in exception_type major,
in string except_name,
in void *param );
Returns an exception to a client.
3-4
SOMobjects Base Toolkit Quick Reference Guide
Context class
(see cntxt.idl)
ORBStatus create_child (
in Identifier ctx_name,
out Context child_ctx );
Creates a child of a Context object.
ORBStatus delete_values (
in Identifier prop_name );
Deletes property value(s).
ORBStatus destroy (
in Flags del_flag );
Deletes a Context object.
ORBStatus get_values (
in Identifier start_scope,
in Flags op_flags,
in Identifier prop_name,
out NVList values );
Retrieves the specified property values.
ORBStatus set_one_value (
in Identifier prop_name,
in string value );
Adds a single property to the specified Context object.
ORBStatus set_values (
in NVList values );
Adds/changes one or more property values in the specified Context object.
DSOM Framework Quick Reference
3-5
ImplementationDef class
(see impldef.idl)
attribute string impl_id;
Contains the DSOM-generated identifier for a server implementation.
attribute string impl_alias;
Contains the “alias” (user-friendly name) for a server implementation.
attribute string impl_program;
Contains the full pathname of the program which will be executed by the process for this server.
attribute Flags impl_flags;
Contains a bit-vector of flags used to identify server options (for example, multi-threading).
attribute string impl_server_class;
Contains the name of the SOMDServer class or subclass created by the server process.
attribute string impl_refdata_file;
Contains the full pathname of the file used to store ReferenceData for the server.
attribute string impl_refdata_bkup;
Contains the full pathname of the backup mirror
file used to store ReferenceData for the server.
attribute string impl_hostname;
Contains the hostname of the machine where the server is located.
3-6
SOMobjects Base Toolkit Quick Reference Guide
ImplRepository class
(see implrep.idl)
void add_class_to_impldef (
in ImplId implid,
in string classname );
Associates a class with a server.
void add_impldef (
in ImplementationDef impldef );
Adds an implementation definition to the Implementation Repository.
void delete_impldef (
in ImplId implid );
Deletes an implementation definition from the Implementation Repository.
ORBStatus find_all_impldefs (
out sequence<ImplementationDef>
outimpldefs );
Returns all the implementation definitions in the Implementation Repository.
sequence<string>
find_classes_by_impldef (
in ImplId implid );
Returns a sequence of class names associated with a server.
ImplementationDef find_impldef (
in ImplId implid );
Returns a server implementation definition given its ID.
ImplementationDef find_impldef_by_alias (
in string alias_name );
Returns a server implementation definition given its user-friendly alias.
sequence<ImplementationDef> find_impldef_by_class (
in string classname );
Returns a sequence of implementation definitions for servers that are associated with a specified class.
void remove_class_from_all (
in string className);
Removes the association of a particular class from all servers.
void remove_class_from_impldef (
in ImplId implid,
in string classname );
Removes the association of a particular class with a server.
void update_impldef (
in ImplementationDef impldef );
Updates an implementation definition in the Implementation Repository.
DSOM Framework Quick Reference
3-7
NVList class
(see nvlist.idl)
ORBStatus add_item (
in Identifier item_name,
in TypeCode item_type,
in void *value,
in long value_len,
in Flags item_flags );
Adds an item to the specified NVList.
ORBStatus free ( );
Frees a specified list structure.
ORBStatus free_memory ( );
Frees any dynamically allocated out-arg memory associated with the specified list.
ORBStatus get_count (
out long count);
Returns the total number of items allocated for a list.
ORBStatus get_item (
in long item_number,
out Identifier item_name,
out TypeCode item_type,
out void *value,
out long value_len,
out Flags item_flags);
Returns the contents of a specified list item.
ORBStatus set_item (
in long item_number,
in Identifier item_name,
in TypeCode item_type,
in void *value,
in long value_len,
in Flags item_flags);
Sets the contents of an item in an NVList.
3-8
SOMobjects Base Toolkit Quick Reference Guide
ObjectMgr class
(see om.idl)
void somdDestroyObject (
in SOMObject obj );
Requests destruction of the target object.
string somdGetIdFromObject (
in SOMObject obj );
Returns the persistent ID for an object managed by a specified Object Manager.
SOMObject somdGetObjectFromId (
in string id );
Finds and activates an object implemented by a specified object manager, given its ID.
SOMObject somdNewObject (
in Identifier objclass,
in string hints );
Returns a new object of the named type and implementation.
void somdReleaseObject (
in SOMObject obj );
Indicates that the client has finished using the object.
DSOM Framework Quick Reference
3-9
ORB class
(see orb.idl)
ORBStatus create_list (
in long count,
out NVList new_list );
Creates an NVList of the specified size.
ORBStatus create_operation_list (
in OperationDef operation,
out NVList new_list );
Creates an NVList initialized with the argument descriptions for a given operation.
ORBStatus get_default_context (
out Context ctx) ;
Returns the default process Context object.
string object_to_string (
in SOMDObject obj );
Converts an object reference to an external form (string) that can be stored outside the ORB.
SOMDObject string_to_object (
in string str );
Converts an externalized (string) form of an object reference into an object reference.
3-10
SOMobjects Base Toolkit Quick Reference Guide
Principal class
(see principl.idl)
attribute string userName;
Identifies the name of the user associated with the request invocation.
(Currently, this value is obtained from
the USER environment variable in the process which invoked the request.)
attribute string hostName;
Identifies the name of the host from where the request originated.
(Currently, this value is obtained from the HOSTNAME environment variable in the process which invoked
the request.)
DSOM Framework Quick Reference
3-11
Request class
(see request.idl)
ORBStatus add_arg (
in Identifier name,
in TypeCode arg_type,
in void *value,
in long len,
in Flags arg_flags);
Incrementally adds an argument to a Request object.
ORBStatus destroy ( );
Deletes the memory allocated by DSOM for a Request object.
ORBStatus get_response (
in Flags response_flags);
Determines whether an asynchronous Request has completed.
ORBStatus invoke (
in Flags invoke_flags);
Invokes a Request synchronously, waiting for the response.
ORBStatus send (
in Flags invoke_flags);
Invokes a Request asynchronously.
3-12
SOMobjects Base Toolkit Quick Reference Guide
SOMDClientProxy class
(see somdcprx.idl)
void somdProxyFree ( );
Executes somFree on the local proxy object.
SOMClass somdProxyGetClass ( );
Returns the class object for the local proxy object.
string somdProxyGetClassName ( );
Returns the class name for the local proxy object.
void somdReleaseResources ();
Instructs a proxy object to release any memory it is holding as a result of a remote method invocation in which a
parameter or result was designated as “object-owned”.
void somdTargetFree ( );
Forwards the somFree method call to the remote target object.
SOMClass somdTargetGetClass ( );
Returns (a proxy for) the class object for the remote target object.
string somdTargetGetClassName ( );
Returns the class name for the remote target
object.
DSOM Framework Quick Reference
3-13
SOMDObject class
(see somdobj.idl)
ORBStatus create_request (
in Context ctx,
in Identifier operation,
in NVList arg_list,
inout NamedValue result,
out Request request,
in Flags req_flags );
Creates a request to execute a particular operation (method) on the referenced object.
ORBStatus create_request_args (
in Identifier operation,
out NVList arg_list,
out NamedValue result );
Creates an argument list appropriate for the specified operation (method).
SOMDObject duplicate ( );
Makes a duplicate of an object reference.
ImplementationDef get_implementation ( );
Returns the implementation definition for the referenced object.
InterfaceDef get_interface ( );
Returns the interface definition object for the referenced object.
boolean is_constant ( );
Tests to see if the object reference is a constant (that is, its ReferenceData is a constant value associated with the
reference).
boolean is_nil ( );
Tests to see if the object reference is nil.
boolean is_SOM_ref ( );
Tests to see if the object reference is a simple reference to a SOM object.
boolean is_proxy ( );
Tests to see if the object reference is a proxy.
void release ( );
Releases the memory associated with the specified object reference.
3-14
SOMobjects Base Toolkit Quick Reference Guide
SOMDObjectMgr class
(see somdom.idl)
SOMDServer somdFindAnyServerByClass (
in Identifier objclass );
Finds a server capable of creating the specified object.
SOMDServer somdFindServer (
in ImplId serverid );
Finds a server given its ImplementationDef name (alias).
sequence<SOMDServer> somdFindServersByClass (
in Identifier objclass );
Finds all servers capable of creating a particular object.
SOMDServer somdFindServerByName (
in string servername );
Finds a server, given its ImplementationDef ID.
attribute boolean somd21somFree
Determines whether somFree, when invoked on a proxy object, will free the proxy object along with the remote
object.
DSOM Framework Quick Reference
3-15
SOMDServer class
(see somdserv.idl)
SOMObject somdCreateObj (
in Identifier objclass,
in string hint );
Creates an object of the specified class.
void somdDeleteObj (
in SOMObject somobj );
Deletes the specified object.
void somdDispatchMethod (
in SOMObject somobj,
out somToken retValue,
in somId methodId,
in va_list ap );
Dispatch a method on the specified SOM object.
SOMClass somdGetClassObj (
in Identifier objclass );
Creates a class object for the specified class.
boolean somdObjReferencesCached ( );
Indicates whether a server object retains ownership of the object references it creates via the somdRefFromSOMObj
method.
SOMDObject somdRefFromSOMObj (
in SOMObject somobj );
Returns an object reference corresponding to the specified SOM object.
SOMObject somdSOMObjFromRef (
in SOMDObject objref );
Returns the SOM object corresponding to the specified object reference.
3-16
SOMobjects Base Toolkit Quick Reference Guide
SOMDServerMgr class
(see servmgr.idl)
ORBStatus somdDisableServer (
in string server_alias);
Disables a server process from starting until it is explicitly enabled again.
ORBStatus somdEnableServer (
in string server_alias);
Enables a server process so that it can be started when required. Initially, all server processes are enabled by
default.
boolean somdIsServerEnabled (
in ImplementationDef impldef);
Determines whether a server process is enabled or not.
ORBStatus somdListServer (
in string server_alias);
Queries the state of a server process.
ORBStatus somdRestartServer (
in string server_alias);
Restarts a server process.
ORBStatus somdShutdownServer (
in string server_alias);
Stops a server process.
ORBStatus somdStartServer (
in string server_alias);
Starts a server process.
DSOM Framework Quick Reference
3-17
SOMOA class
(see somoa.idl)
void activate_impl_failed (
in ImplementationDef implDef,
in long rc);
Sends a message to the DSOM daemon indicating that the server process did not activate.
void change_id (
in SOMDObject objref,
in ReferenceData id );
Changes the reference data associated with an object.
SOMDObject create_constant (
in ReferenceData id,
in InterfaceDef intf,
in ImplementationDef impl);
Creates a “constant” object reference.
SOMDObject create_SOM_ref (
in SOMObject somobj,
in ImplementationDef impl);
Creates a simple, transient DSOM reference to a SOM object.
ORBStatus execute_next_request (
in Flags waitFlag );
Receive a request message, execute the request, and return the result to the caller.
ORBStatus execute_request_loop (
in Flags waitFlag );
Continuously receives request messages, executing them and returning results.
SOMObject get_SOM_object (
in SOMDObject somref );
Get the SOM object associated with a simple DSOM reference.
3-18
SOMobjects Base Toolkit Quick Reference Guide
Interface Repository Framework Quick Reference
Class Organization
SOMObject
Container
Repository
InterfaceDef
ModuleDef
OperationDef
Contained
— Provides common behavior for objects that contain other
objects.
— Provides information about the Interface Repository itself.
— Provides a description of an interface’s methods and
attributes.
— Provides information about a module.
— Provides information about an operation.
— Provides common behavior for objects contained by other
objects.
AttributeDef
— Provides information about an attribute.
ConstantDef
— Provides information about a constant.
ExceptionDef
— Provides information about an exception.
ParameterDef
— Provides information about a parameter.
TypeDef
— Provides information about a typedef, struct, union, or
enum.
Contained class
(see containd.idl)
Description describe ( );
Returns a structure containing all of the information defined in the IDL specification that corresponds to a specified
Contained object in the Interface Repository.
sequence(Container) within ( );
Returns a list of objects (in the Interface Repository) that contain a specified Contained object.
Container class
(see containr.idl)
sequence(Contained) contents (
in InterfaceName limit_type,
in boolean exclude_inherited);
Returns a sequence indicating the objects contained within a specified Container object of the Interface Repository.
sequence(ContainerDescription) describe_contents (
in InterfaceName limit_type,
in boolean exclude_inherited,
in long max_returned_objs);
Returns a sequence of descriptions of the objects contained within a specified Container object of the Interface
Repository.
Interface Repository Quick Reference
4-1
sequence(Contained) lookup_name (
in Identifier search_name,
in long levels_to_search,
in InterfaceName limit_type,
in boolean exclude_inherited);
Locates an object by name within a specified Container object of the Interface Repository, or within objects
contained in the Container object.
InterfaceDef class
(see intfacdf.idl)
FullInterfaceDescription describe_interface ( );
Returns (from the Interface Repository) a description of all the methods and attributes of an interface definition.
Repository class
(see repostry.idl)
Contained lookup_id (
in RepositoryId search_id);
Returns the object having a specified RepositoryId.
string lookup_modifier (
in RepositoryId id,
in string modifier);
Returns the value of a given SOM modifier for a specified object [that is, for an object that is a component of an IDL
interface (class) definition maintained within the Interface Repository].
void release_cache ( );
Releases implicitly referenced objects in the internal Interface Repository cache.
Interface Repository functions
(see somtc.h)
short TypeCode_alignment ( );
Returns the alignment value from a given TypeCode.
TypeCode TypeCode_copy ( );
Creates a new copy of a given TypeCode.
boolean TypeCode_equal (
TypeCode tc2);
Compares two TypeCodes for equality.
void TypeCode_free ( );
Destroys a given TypeCode by freeing all of the memory used to represent it.
TCKind TypeCode_kind ( );
Categorizes the abstract data type described by a TypeCode.
4-2
SOMobjects Base Toolkit Quick Reference Guide
enum TCKind {
tk_null, tk_void,
tk_short, tk_long,
tk_ushort, tk_ulong,
tk_float, tk_double, tk_boolean, tk_char, tk_octet, tk_any, tk_TypeCode, tk_Principal,
tk_objref, tk_struct, tk_union, tk_enum, tk_string, tk_sequence, tk_array, tk_pointer,
tk_self, tk_foreign
};
TypeCode TypeCodeNew (TCKind tag, ...); [
Creates a new TypeCode instance.
[ Takes no implicit parameters.
TypeCodeNew (tk_objref, string interfaceId);
TypeCodeNew (tk_string, long maxLength);
TypeCodeNew (tk_sequence, TypeCode seqTC, long maxLength);
TypeCodeNew (tk_array, TypeCode arrayTC, long length);
TypeCodeNew (tk_pointer, TypeCode ptrTC);
TypeCodeNew (tk_self, string structOrUnionName);
TypeCodeNew (tk_foreign, string typename, string impCtx, long instSize);
TypeCodeNew (tk_struct,
string name,
string mbrName,
TypeCode mbrTC, [...,]
[mbrName and mbrTC repeat as needed]
NULL);
TypeCodeNew (tk_union,
string name,
TypeCode swTC,
long flag,
long labelValue,
string mbrName,
TypeCode mbrTC, [...,]
[flag, labelValue, mbrName and mbrTC repeat as needed]
NULL);
TypeCodeNew (tk_enum,
string name,
string enumId, [...,]
[enumIds repeat as needed]
NULL);
TypeCodeNew (TCKind allOtherTagValues);
‘allOtherTagValues’ represents one of the values:
tk_null, tk_void, tk_short, tk_long,
tk_ushort, tk_ulong, tk_float, tk_double,
tk_boolean, tk_char, tk_octet,
tk_any, tk_TypeCode, or tk_Principal
All of these tags represent basic IDL data types that
do not require any other descriptive parameters.
long TypeCode_param_count ( );
Obtains the number of parameters available in a given TypeCode.
any TypeCode_parameter (
long index);
Obtains a specified parameter from a given TypeCode.
Interface Repository Quick Reference
4-3
void TypeCode_print ( );
Writes all of the information contained in a given TypeCode to “stdout”.
void TypeCode_setAlignment (
short alignment);
Overrides the default alignment associated with the given TypeCode.
long TypeCode_size ( );
Provides the minimum size of an instance of the abstract data type described by a given TypeCode.
4-4
SOMobjects Base Toolkit Quick Reference Guide
Metaclass Framework Quick Reference
Class Organization
SOMObject
SOMClass
metaclass
— The root class of all SOM metaclasses.
Defines the essential behavior (methods) common to all
SOM classes.
SOMMBeforeAfter
metaclass
— Serves as the metaclass when defining a class whose
instances will call given methods before and after each
instance method.
SOMMSingleInstance
metaclass
— Serves as the metaclass when defining a class for which only
one instance can ever be created.
SOMMTraced
metaclass
— Serves as the metaclass when defining a class whose instances’
methods (inherited or introduced) when invoked print a message
giving the method parameters and unpon completion print the return
value.
SOMMBeforeAfter metaclass
(see sombacls.idl)
void sommAfterMethod (
in SOMObject object,
in somId methodID,
in void *returnedvalue,
in va_list ap);
Specifies a method that is automatically called after execution of each client method.
boolean sommBeforeMethod (
in SOMObject object,
in somId methodID,
in va_list ap);
Specifies a method that is automatically called before execution of each client method.
SOMMSingleInstance metaclass
(see snglicls.idl)
SOMObject sommGetSingleInstance ( );
Gets the one instance of a specified class for which only a single instance can exist.
Metaclass Framework Quick Reference
5-1
SOMMTraced metaclass
(see somtrcls.idl)
attribute boolean sommTraceIsOn
Indicates whether or not tracing is turned on for a class, giving dynamic control over the trace facility.
5-2
SOMobjects Base Toolkit Quick Reference Guide
Event Management Framework Quick Reference
Class Organization
SOMObject
SOMEEman
— Handles input events. EMan performs a blocked (or timed) wait
on all registered event sources concurrently.
SOMEEMRegisterData
— Holds registration information for event types to be registered with
the SOMEEman class.
SOMEEvent
— Timestamps an event before it is passed to a callback routine. This
is the base class for all generic events within the Event Manager.
SOMEClientEvent
— Describes generic client events within EMan. Client events are
defined created, processed, and destroyed entirely by the application.
SOMESinkEvent
— Describes a sink event generated by EMan when activity occurs on
a registered sink. EMan passes an instance of SOMESinkEvent to
the callback registered for sink events, so the callback can query it.
SOMETimerEvent
— Describes a timer event generated by EMan when a registered timer
pops. EMan passes an instance of SOMETimerEvent to the callback
registered for timer events, so the callback can query it.
SOMEWorkProcEvent — Describes a work procedure event object generated by EMan
when a work procedure is registered and there are no other
events to process in EMan. EMan passes an instance of
SOMEWorkProcEvent to the callbacks of each registered
Work Procedure.
SOMEClientEvent class
(see clientev.idl)
void* somevGetEventClientData ( );
Returns the user-defined data associated with a client event.
string somevGetEventClientType ( );
Returns the type name of a client event.
void somevSetEventClientData (
in void* clientData);
Sets the user-defined data of a client event.
void somevSetEventClientType (
in string clientType);
Sets the type name of a client event.
Event Management Framework Quick Reference
6-1
SOMEEMan class
(see eman.idl)
void someChangeRegData (
in long registrationId,
in SOMEEMRegisterData registerData);
Changes the registration data associated with a specified registration ID.
void someGetEManSem ( );
Acquires EMan semaphore(s) to achieve mutual exclusion with EMan’s activity.
void someProcessEvent (
in unsigned long mask);
Processes one event.
void someProcessEvents ( );
Processes infinite events.
void someQueueEvent (
in SOMEClientEvent event );
Enqueues the specified client event.
long someRegister (
in SOMEEMRegisterData registerData,
in SOMObject targetObject,
in string targetMethod,
in void *targetData );
Registers an object/method pair with EMan, given a specified registerData object.
long someRegisterEv (
in SOMEEMRegisterData registerData,
in SOMObject targetObject,
inout Environment callbackEv,
in string targetMethod,
in void *targetData );
Registers the (object, method, Environment parameter) combination of a callback with EMan, given a specified
registerData object.
long someRegisterProc (
in SOMEEMRegisterData registerData,
in EMRegProc *targetProcedure,
in void *targetData );
Register the procedure with EMan given the specified registerData.
void someReleaseEManSem ( );
Releases the semaphore obtained by the someGetEManSem method.
void someShutdown ( );
Shuts down an EMan event loop. (That is, this makes the someProcessEvents return!)
void someUnRegister (
in long registrationId);
Unregisters the event interest associated with a specified registrationId within EMan.
6-2
SOMobjects Base Toolkit Quick Reference Guide
SOMEEMRegisterData class
(see emregdat.idl)
void someClearRegData ( );
Clears the registration data.
void someSetRegDataClientType (
in string clientType);
Sets the type name for a client event.
void someSetRegDataEventMask (
in long eventType,
in va_list ap);
Sets the generic event mask within the registration data using NULL terminated event type list.
void someSetRegDataSink (
in long sink);
Sets the file descriptor (or socket ID, or message queue ID) for the sink event.
void someSetRegDataSinkMask (
in unsigned long sinkmask);
Sets the sink mask within the registration data object.
void someSetRegDataTimerCount (
in long count);
Sets the number of times the timer will trigger, within the registration data.
void someSetRegDataTimerInterval (
in long interval);
Sets the timer interval within the registration data.
Event Management Framework Quick Reference
6-3
SOMEEvent class
(see event.idl)
unsigned long somevGetEventTime ( );
Returns the time of the generic event in milliseconds.
unsigned long somevGetEventType ( );
Returns the type of the generic event.
void somevSetEventTime (
in unsigned long time);
Sets the time of the generic event (time is in milliseconds).
void somevSetEventType (
in unsigned long type);
Sets the type of the generic event.
SOMESinkEvent class
(see sinkev.idl)
long somevGetEventSink ( );
Returns the sink, or source of I/O, of the generic sink event.
void somevSetEventSink (
in long sink);
Sets the sink, or source of I/O, of the generic sink event.
SOMETimerEvent class
(see timerev.idl)
void somevGetEventInterval ( );
Returns the interval of the generic timer event (time in milliseconds).
void somevSetEventInterval (
in long interval);
Sets the interval of the generic timer event (in milliseconds).
6-4
SOMobjects Base Toolkit Quick Reference Guide
Index
A
activate_impl_failed method, 3-18
add_arg method, 3-12
add_class_to_impldef method, 3-7
add_impldef method, 3-7
add_item method, 3-8
B
BOA class, 3-4
C
change_id method, 3-18
change_implementation method, 3-4
Contained class, 4-1
Container class, 4-1
contents method, 4-1
Context class, 3-5
Context_delete macro, 3-3
create method, 3-4
create_child method, 3-5
create_constant method, 3-18
create_list method, 3-10
create_operation_list method, 3-10
create_request method, 3-14
create_request_args method, 3-14
create_SOM_ref method, 3-18
D
deactivate_impl method, 3-4
deactivate_obj method, 3-4
delete_impldef method, 3-7
delete_values method, 3-5
describe method, 4-1
describe_contents method, 4-1
describe_interface method, 4-2
destroy method (Context object), 3-5
destroy method (Request object), 3-12
dispose method, 3-4
DSOM Framework, quick reference, 3-1
duplicate method, 3-14
E
Event Management Framework, quick reference,
6-1
execute_next_request method, 3-18
execute_request_loop method, 3-18
F
find_all_impldefs method, 3-7
find_classes_by_impldef method, 3-7
find_impldef method, 3-7
find_impldef_by_alias method, 3-7
find_impldef_by_class method, 3-7
free method, 3-8
free_memory method, 3-8
Functions
DSOM, 3-2
Interface Repository, 4-2
SOM kernel, 2-1
G
get_count method, 3-8
get_default_context method, 3-10
get_id method, 3-4
get_implementation method, 3-14
get_interface method, 3-14
get_item method, 3-8
get_next_response function, 3-2
get_principal method, 3-4
get_response method, 3-12
get_somInstanceDataOffsets method, 2-6
get_SOM_object method, 3-18
get_values method, 3-5
H
hostName attribute, 3-11
I
impl_alias attribute, 3-6
ImplementationDef class, 3-6
impl_flags attribute, 3-6
impl_hostname attribute, 3-6
impl_id attribute, 3-6
impl_is_ready method, 3-4
impl_program attribute, 3-6
impl_refdata_bkup attribute, 3-6
impl_refdata_file attribute, 3-6
ImplRepository class, 3-7
impl_server_class attribute, 3-6
Interface Repository Framework, quick reference,
4-1
InterfaceDef class, 4-2
invoke method, 3-12
is_constant method, 3-14
is_nil method, 3-14
is_proxy method, 3-14
is_SOM_ref method, 3-14
L
lookup_id method, 4-2
lookup_modifier method, 4-2
lookup_name method, 4-2
M
Macros
DSOM, 3-3
SOM kernel, 2-5
Metaclass Framework quick reference, 5-1
N
NVList class, 3-8
O
ObjectMgr class, 3-9
Index
X-1
object_to_string method, 3-10
obj_is_ready method, 3-4
ORB class, 3-10
ORBfree function, 3-2
P
Principal class, 3-11
Q
Quick reference
DSOM Framework, 3-1
Event Management Framework, 6-1
Interface Repository Framework, 4-1
Metaclass Framework, 5-1
SOM Compiler, 1-1
SOM kernel, 2-1
R
release method, 3-14
release_cache method, 4-2
remove_class_from_all method, 3-7
remove_class_from_impldef method, 3-7
Repository class, 4-2
Request class, 3-12
Request_delete macro, 3-3
S
send method, 3-12
send_multiple_requests function, 3-2
set_exception method, 3-4
set_item method, 3-8
set_one_value method, 3-5
set_values method, 3-5
SOM Compiler, quick reference, 1-1
SOM kernel, quick reference, 2-1
somAddDynamicMethod method, 2-6
somAllocate method, 2-7
somApply function, 2-1
SOM_Assert macro, 2-5
somBeginPersistentIds function, 2-1
somBuildClass function, 2-1
SOMCalloc function, 2-4
somCastObj method, 2-10
somCheckId function, 2-1
somCheckVersion method, 2-7
SOMClass class, 2-6
somClassDispatch method, 2-11
somClassFromId method, 2-9
SOMClassInitFuncName function, 2-4
SOM_ClassLibrary macro, 2-5
SOMClassMgr class, 2-9
somClassReady method, 2-7
somClassResolve function, 2-1
somCompareIds function, 2-2
SOM_CreateLocalEnvironment macro, 2-5
somd21somFree attribute, 3-15
somDataResolve function, 2-2
SOMDClientProxy class, 3-13
somdCreateObj method, 3-16
somdDeleteObj method, 3-16
somdDestroyObject method, 3-9
somdDisableServer method, 3-17
somdDispatchMethod method, 3-16
X-2
SOMobjects Base Toolkit Quick Reference Guide
somDeallocate method, 2-7
somDefaultInit method, 2-10
SOMDeleteModule function, 2-4
somdEnableServer method, 3-17
somDescendedFrom method, 2-7
SOM_DestroyLocalEnvironment macro, 2-5
somDestruct method, 2-11
somdExceptionFree function, 3-2
somdFindAnyServerByClass method, 3-15
somdFindServer method, 3-15
somdFindServerByName method, 3-15
somdFindServersByClass method, 3-15
somdGetClassObj method, 3-16
somdGetIdFromObject method, 3-9
somdGetObjectFromId method, 3-9
SOMD_Init function, 3-2
somDispatch method, 2-11
somDispatchA method, 2-11
somDispatchD method, 2-11
somDispatchM method, 2-11
somDispatchV method, 2-11
somdIsServerEnabled method, 3-17
somdListServer method, 3-17
somdNewObject method, 3-9
SOMD_NoORBfree function, 3-2
SOMDObject class, 3-14
SOMDObjectMgr class, 3-15
somdObjReferencesCached method, 3-16
somdProxyFree method, 3-13
somdProxyGetClass method, 3-13
somdProxyGetClassName method, 3-13
somdRefFromSOMObj method, 3-16
SOMD_RegisterCallback function, 3-2
somdReleaseObject method, 3-9
somdReleaseResources method, 3-13
somdRestartServer method, 3-17
SOMDServer class, 3-16, 3-17
somdShutdownServer method, 3-17
somdSOMObjFromRef method, 3-16
somdStartServer method, 3-17
somdTargetFree method, 3-13
somdTargetGetClass method, 3-13
somdTargetGetClassName method, 3-13
somDumpSelf method, 2-11
somDumpSelfInt method, 2-11
SOMD_Uninit function, 3-2
someChangeRegData method, 6-2
someClearRegData method, 6-3
SOMEClientEvent class, 6-1
SOMEEMan class, 6-2
SOMEEMRegisterData class, 6-3
SOMEEvent class, 6-4
someGetEManSem method, 6-2
somEndPersistentIds function, 2-2
somEnvironmentEnd function, 2-2
somEnvironmentNew function, 2-2
someProcessEvent method, 6-2
someProcessEvents method, 6-2
someQueueEvent method, 6-2
someRegister method, 6-2
someRegisterEv method, 6-2
someRegisterProc method, 6-2
someReleaseEManSem method, 6-2
SOMError function, 2-4
SOM_Error macro, 2-5
someSetRegDataClientType method, 6-3
someSetRegDataEventMask method, 6-3
someSetRegDataSink method, 6-3
someSetRegDataSinkMask method, 6-3
someSetRegDataTimerCount method, 6-3
someSetRegDataTimerInterval method, 6-3
someShutdown method, 6-2
SOMESinkEvent class, 6-4
SOMETimerEvent class, 6-4
someUnRegister method, 6-2
somevGetEventClientData method, 6-1
somevGetEventClientType method, 6-1
somevGetEventInterval method, 6-4
somevGetEventSink method, 6-4
somevGetEventTime method, 6-4
somevGetEventType method, 6-4
somevSetEventClientData method, 6-1
somevSetEventClientType method, 6-1
somevSetEventInterval method, 6-4
somevSetEventSink method, 6-4
somevSetEventTime method, 6-4
somevSetEventType method, 6-4
somExceptionFree function, 2-2
somExceptionId function, 2-2
somExceptionValue function, 2-2
SOM_Expect macro, 2-5
somFindClass method, 2-9
somFindClsInFile method, 2-9
somFindMethod method, 2-7
somFindMethodOk method, 2-7
somFindSMethod method, 2-7
somFindSMethodOk method, 2-7
SOMFree function, 2-4
somFree method, 2-12
SOM_GetClass macro, 2-5
somGetClass method, 2-12
somGetClassName method, 2-12
somGetGlobalEnvironment function, 2-2
somGetInitFunction method, 2-9
somGetInstancePartSize method, 2-7
somGetInstanceSize method, 2-7
somGetInstanceToken method, 2-7
somGetMemberToken method, 2-7
somGetMethodData method, 2-8
somGetMethodDescriptor method, 2-8
somGetMethodIndex method, 2-8
somGetMethodToken method, 2-8
somGetName method, 2-8
somGetNthMethodData method, 2-8
somGetNthMethodInfo method, 2-8
somGetNumMethods method, 2-8
somGetNumStaticMethods method, 2-8
somGetParents method, 2-8
somGetRelatedClasses method, 2-10
somGetSize method, 2-12
somGetVersionNumbers method, 2-8
somIdFromString function, 2-2
somInit method, 2-12
SOM_InitEnvironment macro, 2-5
SOMInitModule function, 2-4
somIsA method, 2-12
somIsInstanceOf method, 2-12
somIsObj function, 2-2
somLoadClassFile method, 2-10
SOMLoadModule function, 2-4
somLocateClassFile method, 2-10
somLookupMethod method, 2-8
somLPrintf function, 2-2
sommAfterMethod method, 5-1
somMainProgram function, 2-2
SOM_MainProgram macro, 2-5
SOMMalloc function, 2-4
SOMMBeforeAfter metaclass, 5-1
sommBeforeMethod method, 5-1
somMergeInto method, 2-10
sommGetSingleInstance method, 5-1
SOMMSingleInstance metaclass, 5-1
SOMMTraced metaclass, 5-2
sommTraceIsOn attribute, 5-2
somNew method, 2-9
somNewNoInit method, 2-9
SOM_NoTrace macro, 2-5
SOMOA class, 3-18
SOMObject class, 2-10
SOMOutCharRoutine function, 2-4
somParentNumResolve function, 2-3
SOM_ParentNumResolve macro, 2-5
somParentResolve function, 2-3
somPrefixLevel function, 2-3
somPrintf function, 2-3
somPrintSelf method, 2-12
SOMRealloc function, 2-4
somRegisterClass method, 2-10
somRegisterId function, 2-3
somRenew method, 2-9
somRenewNoInit method, 2-9
somRenewNoInitNoZero method, 2-9
somRenewNoZero method, 2-9
somResetObj method, 2-12
somResolve function, 2-3
SOM_Resolve macro, 2-6
somResolveByName function, 2-3
SOM_ResolveNoCheck macro, 2-6
somRespondsTo method, 2-12
somSetException function, 2-3
somSetExpectedIds function, 2-3
somSetOutChar function, 2-3
somStringFromId function, 2-3
SOM_SubstituteClass macro, 2-6
somSubstituteClass method, 2-10
somSupportsMethod method, 2-9
SOM_Test macro, 2-6
SOM_TestC macro, 2-6
somTotalRegIds function, 2-3
somUninit method, 2-12
SOM_UninitEnvironment macro, 2-6
somUniqueKey function, 2-4
somUnloadClassFile method, 2-10
somUnregisterClass method, 2-10
somVprintf function, 2-4
SOM_WarnMsg macro, 2-6
string_to_object method, 3-10
T
TypeCode_alignment function, 4-2
TypeCode_setAlignment function, 4-4
Index
X-3
TypeCode_copy function, 4-2
TypeCode_equal function, 4-2
TypeCode_free function, 4-2
TypeCode_kind function, 4-2
TypeCodeNew function, 4-3
TypeCode_param_count function, 4-3
TypeCode_parameter function, 4-3
TypeCode_print function, 4-4
TypeCode_size function, 4-4
X-4
SOMobjects Base Toolkit Quick Reference Guide
U
update_impldef method, 3-7
userName attribute, 3-11
Utility metaclasses, quick reference, 5-1
W
within method, 4-1
Vos remarques sur ce document / Technical publication remark form
Titre / Title :
Bull DPX/20 SOMobject Base Toolkit Quick Reference Guide
Nº Reférence / Reference Nº :
86 A2 29AQ 01
Daté / Dated :
June 1995
ERREURS DETECTEES / ERRORS IN PUBLICATION
AMELIORATIONS SUGGEREES / SUGGESTIONS FOR IMPROVEMENT TO PUBLICATION
Vos remarques et suggestions seront examinées attentivement
Si vous désirez une réponse écrite, veuillez indiquer ci-après votre adresse postale complète.
Your comments will be promptly investigated by qualified technical personnel and action will be taken as required.
If you require a written reply, please furnish your complete mailing address below.
NOM / NAME :
SOCIETE / COMPANY :
ADRESSE / ADDRESS :
Remettez cet imprimé à un responsable BULL ou envoyez-le directement à :
Please give this technical publication remark form to your BULL representative or mail to:
BULL S.A. CEDOC
Atelier de Reproduction
FRAN–231
331 Avenue Patton BP 428
49 005 ANGERS CEDEX
FRANCE
Date :
ORDER REFERENCE
86 A2 29AQ 01
PLACE BAR CODE IN LOWER
LEFT CORNER
BULL S.A. CEDOC
Atelier de Reproduction
FRAN–231
331 Avenue Patton BP 428
49 005 ANGERS CEDEX
FRANCE
Utiliser les marques de découpe pour obtenir les étiquettes.
Use the cut marks to get the labels.
DPX/20
AIX
SOMobject Base
Toolkit
Quick Reference
Guide
86 A2 29AQ 01
DPX/20
AIX
SOMobject Base
Toolkit
Quick Reference
Guide
86 A2 29AQ 01
DPX/20
AIX
SOMobject Base
Toolkit
Quick Reference
Guide
86 A2 29AQ 01