[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Base Operating System and Extensions Technical Reference, Volume 1

odm_terminate Subroutine

Purpose

Terminates an ODM session.

Library

Object Data Manager Library (libodm.a)

Syntax

#include <odmi.h>
int odm_terminate ( )

Description

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:

ODMI_CLASS_DNE
                          The specified object class does not exist. Check path name and permissions.
ODMI_CLASS_PERMS
                          The object class cannot be opened because of the file permissions.
ODMI_INVALID_CLXN
                          Either the specified collection is not a valid object class collection or the collection does not contain consistent data.
ODMI_INVALID_PATH
                          The specified path does not exist on the file system. Make sure the path is accessible.
ODMI_LOCK_ID
                          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.
ODMI_MAGICNO_ERR
                          The class symbol does not identify a valid object class.
ODMI_OPEN_ERR
                          Cannot open the object class. Check path name and permissions.
ODMI_TOOMANYCLASSES
                          Too many object classes have been accessed. An application can only access less than 1024 object classes.
ODMI_UNLOCK
                          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.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]