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