SOMobjects Error Codes

System Object Model Programming Guide

About This Book Introduction to the SOMobjects Developer Toolkit Tutorial for Implementing SOM Classes Using SOM Classes in Client Programs SOM IDL and the SOM Compiler Implementing Classes in SOM Distributed SOM (DSOM) The SOM Interface Repository Framework The Metaclass Framework The Event Management Framework SOMobjects Error Codes SOM IDL Language Grammar Implementing Sockets Subclasses Glossary

Reprint Courtesy of International Business Machines Corporation, © International Business Machines Corporation

This section covers the following subjects:

• SOM Kernel Error Codes
• DSOM Error Codes
• Metaclass Framework Error Codes

SOM Kernel Error Codes

Following are error codes with messages/explanations for the SOM kernel and the various frameworks of the SOMobjects Developer Toolkit.

Value	Symbolic Name	Description
20011	SOMERROR_CCNullClass	The somDescendedFrom method was passed a null class argument.
20029	SOMERROR_SompntOverflow	The internal buffer used in somPrintf overflowed.
20039	SOMERROR_MethodNotFound	somFindMethodOk failed to find the indicated method.
20049	SOMERROR_StaticMethodTableOverflow	A Method-table overflow occurred in somAddStaticMethod.
20059	SOMERROR_DefaultMethod	The somDefaultMethod was called; a defined method probably was not added before it was invoked.
20069	SOMERROR_MissingMethod	The specified method was not defined on the target object.
20079	SOMERROR_BadVersion	An attempt to load, create, or use a version of a class-object implementation is incompatible with the using program.
20089	SOMERROR_NullId	The SOM_CheckId was given a null ID to check.
20099	SOMERROR_OutOfMemory	Memory is exhausted.
20109	SOMERROR_TestObjectFailure	The somObjectTest found problems with the object it was testing.
20119	SOMERROR_FailedTest	The somTest detected a failure; generated only by test code.
20121	SOMERROR_ClassNotFound	The somFindClass could not find the requested class.
20131	SOMERROR_OldMethod	An old-style method name was used; change to an appropriate name.
20149	SOMERROR_CouldNotStartup	The somEnvironmentNew failed to complete.
20159	SOMERROR_NotRegistered	The somUnloadClassFile argument was not a registered class.
20169	SOMERROR_BadOverride	The somOverrideSMethod was invoked for a method that was not defined in a parent class.
20179	SOMERROR_NotImplementedYet	The method raising the error message is not implemented yet.
20189	SOMERROR_MustOverride	The method raising the error message should have been overridden.
20199	SOMERROR_BadArgument	An argument to a core SOM method failed a validity test.
20219	SOMERROR_NoParentClass	During the creation of a class object, the parent class could not be found.
20229	SOMERROR_NoMetaClass	During the creation of a class object, the metaclass object could not be found.

DSOM Error Codes

The following table lists the error codes that may be encountered when using DSOM.

Value	Symbolic Name	Description
30001	SOMDERROR_NoMemory	Memory is exhausted.
30002	SOMDERROR_NotImplemented	Function or method has a null implementation.
30003	SOMDERROR_UnexpectedNULL	Internal error: a pointer variable was found to be NULL, unexpectedly.
30004	SOMDERROR_IO	I/O error while accessing a file located in SOMDDIR.
30005	SOMDERROR_BadVersion	Internal error: incorrect version of an object reference data table.
30006	SOMDERROR_ParmSize	Internal error: a parameter of incorrect size was detected.
30007	SOMDERROR_HostName	Communications error: unable to retrieve local host name.
30008	SOMDERROR_HostAddress	Communications error: unable to retrieve local host address.
30009	SOMDERROR_SocketCreate	Communications error: unable to create socket.
30010	SOMDERROR_SocketBind	Communications error: unable to bind address to socket.
30011	SOMDERROR_SocketName	Communications error: unable to query socket information.
30012	SOMDERROR_SocketReceive	Communications error: unable to receive message from socket.
30013	SOMDERROR_SocketSend	Communications error: indicates socket error.
30014	SOMDERROR_SocketIoctl	Communications error: unable to set socket blocking state.
30015	SOMDERROR_SocketSelect	Communications error: unable to select on socket.
30016	SOMDERROR_PacketSequence	Communications error: unexpected message packet received.
30017	SOMDERROR_PacketTooBig	Communications error: packet too big for allocated message space.
30018	SOMDERROR_AddressNotFound	Uninitialized DSOM communications object.
30019	SOMDERROR_NoMessages	No messages available (and caller specified "no wait").
30020	SOMDERROR_UnknownAddress	Invalid client or server address.
30021	SOMDERROR_RecvError	Communications error during receive.
30022	SOMDERROR_SendError	Communications error in sending the request.
30023	SOMDERROR_CommTimeOut	Communications timeout.
30024	SOMDERROR_CannotConnect	Unable to initialize connection information.
30025	SOMDERROR_BadConnection	Invalid connection information detected.
30026	SOMDERROR_NoHostName	Unable to get host name.
30027	SOMDERROR_BadBinding	Invalid server location information in proxy object.
30028	SOMDERROR_BadMethodName	Invalid method name in request message.
30029	SOMDERROR_BadEnvironment	Invalid Environment value in request message.
30030	SOMDERROR_BadContext	Invalid Context object in request message.
30031	SOMDERROR_BadNVList	Invalid Named Value List (NVList).
30032	SOMDERROR_BadFlag	Bad flag in NVList item.
30033	SOMDERROR_BadLength	Bad length in NVList item.
30034	SOMDERROR_BadObjref	Invalid object reference.
30035	SOMDERROR_NullField	Unexpected null field in request message.
30036	SOMDERROR_UnknownReposId	Attempt to use Invalid Interface Repository ID.
30037	SOMDERROR_NVListAccess	Invalid NVList object in request message.
30038	SOMDERROR_NVIndexError	Attempt to use an out-of-range NVList index.
30039	SOMDERROR_SysTime	Error retrieving system time.
30040	SOMDERROR_SystemCallFailed	System call failed.
30041	SOMDERROR_CouldNotStartProcess	Unable to start a new process.
30042	SOMDERROR_NoServerClass	No SOMDServer (sub)class specified for server implementation.
30043	SOMDERROR_NoSOMDInit	Missing SOMD_Init call in program.
30044	SOMDERROR_SOMDDIRNotSet	SOMDDIR environment variable not set.
30045	SOMDERROR_NoImplDatabase	Could not open Implementation Repository database.
30046	SOMDERROR_ImplNotFound	Implementation not found in implementation repository.
30047	SOMDERROR_ClassNotFound	Class not found in implementation repository.
30048	SOMDERROR_ServerNotFound	Server not found in somdd's active server table.
30049	SOMDERROR_ServerAlreadyExists	Server already exists in somdd's active server table.
30050	SOMDERROR_ServerNotActive	Server is not active.
30051	SOMDERROR_CouldNotStartSOM	SOM initialization error.
30052	SOMDERROR_ObjectNotFound	Could not find desired object.
30053	SOMDERROR_NoParentClass	Unable to find / load parent class during proxy class creation.
30054	SOMDERROR_DispatchError	Unable to dispatch method.
30055	SOMDERROR_BadTypeCode	Invalid type code.
30056	SOMDERROR_BadDescriptor	Invalid method descriptor.
30057	SOMDERROR_BadResultType	Invalid method result type.
30058	SOMDERROR_KeyInUse	Internal object key is in use.
30059	SOMDERROR_KeyNotFound	Internal object key not found.
30060	SOMDERROR_CtxInvalidPropName	Illegal context property name.
30061	SOMDERROR_CtxNoPropFound	Could not find property name in context.
30062	SOMDERROR_CtxStartScopeNotFound	Could not find specified context start scope.
30063	SOMDERROR_CtxAccess	Error accessing context object.
30064	SOMDERROR_CouldNotStartThread	System error: Could not start thread.
30065	SOMDERROR_AccessDenied	System error: Access to a system resource (file, queue, shared memory, etc.) denied.
30066	SOMDERROR_BadParm	System error: invalid parameter supplied to a operating system call.
30067	SOMDERROR_Interrupt	System error: Interrupted system call.
30068	SOMDERROR_Locked	System error: Drive locked by another process.
30069	SOMDERROR_Pointer	System error: Invalid physical address.
30070	SOMDERROR_Boundary	OS/2 system error: ERROR_CROSSES_OBJECT_BOUNDARY.
30071	SOMDERROR_UnknownError	System error: Unknown error on operating system call.
30072	SOMDERROR_NoSpace	System error: No space left on device.
30073	SOMDERROR_DuplicateQueue	System error: Duplicate queue name.
30074	SOMDERROR_BadQueueName	System error: Invalid queue name.
30075	SOMDERROR_DuplicateSem	System error: Duplicate semaphore name used.
30076	SOMDERROR_BadSemName	System error: Invalid semaphore name.
30077	SOMDERROR_TooManyHandles	System error: Too many files open (no file handles left).
30078	SOMDERROR_BadAddrFamily	System error: Invalid address family.
30079	SOMDERROR_BadFormat	System error: Invalid format.
30080	SOMDERROR_BadDrive	System error: Invalid drive.
30081	SOMDERROR_SharingViolation	System error: Sharing violation.
30082	SOMDERROR_BadExeSignature	System error: Program file contains a DOS mode program or invalid program.
30083	SOMDERROR_BadExe	Executable file is invalid (linker errors occurred when program file was created).
30084	SOMDERROR_Busy	System error: Segment is busy.
30085	SOMDERROR_BadThread	System error: Invalid thread id.
30086	SOMDERROR_SOMDPORTNotDefined	SOMDPORT not defined.
30087	SOMDERROR_ResourceExists	System resource (file, queue, shared memory segment,. etc.) already exists.
30088	SOMDERROR_UserName	USER environment variable is not set.
30089	SOMDERROR_WrongRefType	Operation attempted on an object reference is incompatible with the reference type.
30090	SOMDERROR_MustOverride	This method has no default implementation and must be overridden.
30091	SOMDERROR_NoSocketsClass	Could not find/load Sockets class.
30092	SOMDERROR_EManRegData	Unable to register DSOM events with the Event Manager.
30093	SOMDERROR_NoRemoteComm	Remote communications is disabled (for Workstation DSOM).
30096	SOMDERROR_GlobalAtomError	On Windows only, an error occurred while adding a segment name to the Windows atom table.
30097	SOMDERROR_NamedMemoryTableError	On Windows only, an error occurred while creating or deleting a (named) shared memory segment.
30098	SOMDERROR_WMQUIT	On Windows only, indicates DSOM received a Windows WM_QUIT message. The developer of a server application should check for SOMDERROR_WMQUIT returned from method execute_request_loop and handle the error by cleaning up and exiting.
30105	SOMDERROR_DuplicateImplEntry	Implementation repository identifier already exists. Add wait time between `regimpl' calls.
30106	SOMDERROR_InvalidSOMSOCKETS	SOMSOCKETS environment variable set incorrectly.
30107	SOMDERR0R_IRNotFound	Interface Repository not found.
30108	SOMDERR0R_ClassNotInIR	Attempt to create an object whose Class is not in the Interface Repository.
30110	SOMDERROR_SocketError	A communications socket error has occurred. Make sure the DSOM daemon is running.
30111	SOMDERROR_PacketError	A communications packet error has occurred.
30112	SOMDERROR_Marshal
30113	SOMDERROR_NotProcessOwner	This error code is returned when the somdd daemon is trying to kill the server process and if the owner of the server process is different from that of the somdd daemon.
30114	SOMDERROR_ServerInactive	The specified server is in the process of being activated.
30115	SOMDERROR_ServerDisabled	The server has been disabled by the program servmgr.
30117	SOMDERROR_SOMDAlreadyRunning	The DSOM daemon has been started when another daemon is already running.
30118	SOMDERROR_ServerToBeDeleted	An attempt has been made to start or connect to a server marked for deletion.
30119	SOMDERROR_NoObjRefTable	The Object Reference Table cannot be found.
30120	SOMDERROR_UpdateImplDef	The Implementation Repository cannot be updated.
30138	SOMDERROR_NoImplDirectory	The directory signified by SOMDDIR does not exist.
30169	SOMDERROR_ServerNotStoppable	An attempt has been made to stop a server (using the dsom stop command or a SOMDServerMgr object) registered as nonstoppable.
XXXXX	SOMDERROR_OperatingSystem	On AIX, this is the value of the C error variable "errno" defined in errno.h; on OS/2 and Windows, it is the DOS API return code.

Metaclass Framework Error Codes

It is possible to receive the following messages from the Metaclass Framework while an application is running.

60001

An attempt was made to construct a class with SOMMSingleInstance as a metaclass constraint. (This may occur indirectly because of the construction of a derived metaclass). The initialization of the class failed because somInitMIClass defined by SOMMSingleInstance is in conflict with another metaclass that has overridden somNew. That is, some other metaclass has already claimed the right to return the value for somNew.

60002

An attempt was made to construct a class with SOMMSingleInstance as a metaclass constraint. (This may occur indirectly because of the construction of a derived metaclass). The initialization of the class failed because somInitMIClass defined by SOMMSingleInstance is in conflict with another metaclass that has overridden somFree. That is, some other metaclass has already claimed this right to override somFree.

60004

An invocation of somrRepInit was made with a logging type other tha `o' or `v'.

60005

The sommBeforeMethod or the sommAfterMethod was invoked on a SOMRReplicableObject whose logging type is other than `o' or `v'. This error cannot occur normally. The likely cause is that some method invoked on another object has overwritten this object's memory.

60006

A Before/After Metaclass must override both sommBeforeMethod and sommAfterMethod. This message indicates an attempt to create a Before/After Metaclass where only one of the above methods is overridden.