[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 1

odm_terminate Subroutine


Terminates an ODM session.


Object Data Manager Library (libodm.a)


#include <odmi.h>
int odm_terminate ( )


The odm_terminate subroutine performs the cleanup necessary to terminate an ODM session. After running an odm_terminate subroutine, an application must issue an odm_initialize subroutine to resume ODM operations.

Return Values

Upon successful completion, a value of 0 is returned. If the odm_terminate subroutine is unsuccessful, a value of -1 is returned and the odmerrno variable is set to an error code.

Error Codes

Failure of the odm_terminate subroutine sets the odmerrno variable to one of the following error codes:

                          The specified object class does not exist. Check path name and permissions.
                          The object class cannot be opened because of the file permissions.
                          Either the specified collection is not a valid object class collection or the collection does not contain consistent data.
                          The specified path does not exist on the file system. Make sure the path is accessible.
                          The lock identifier does not refer to a valid lock. The lock identifier must be the same as what was returned from the odm_lock subroutine.
                          The class symbol does not identify a valid object class.
                          Cannot open the object class. Check path name and permissions.
                          Too many object classes have been accessed. An application can only access less than 1024 object classes.
                          Cannot unlock the lock file. Make sure the lock file exists.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The odm_initialize subroutine.

List of ODM Commands and Subroutines.

Object Data Manager (ODM) Overview for Programmers in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

[ Previous | Next | Contents | Glossary | Home | Search ]