Puts an exclusive lock on the requested path name.
Object Data Manager Library (libodm.a)
int odm_lock ( LockPath, TimeOut)
The odm_lock subroutine is used by an application to prevent other applications or methods from accessing an object class or group of object classes. A lock on a directory path name does not prevent another application from acquiring a lock on a subdirectory or object class within that directory.
Note: Coordination of locking is the responsibility of the application accessing the object classes.
The odm_lock subroutine returns a lock identifier that is used to call the odm_unlock subroutine.
|LockPath||Specifies a string containing the path name in the file system in which to locate object classes or the path name to an object class to lock.|
|TimeOut||Specifies the amount of time, in seconds, to wait if another application
or method holds a lock on the requested object class or classes. The
possible values for the TimeOut parameter are:
Upon successful completion, a lock identifier is returned. If the odm_lock subroutine is unsuccessful, a value of -1 is returned and the odmerrno variable is set to an error code.
Failure of the odm_lock subroutine sets the odmerrno variable to one of the following error codes:
See Appendix B, ODM Error Codes in AIX 5L Version 5.1 Technical Reference: Base Operating System and Extensions Volume 1 for explanations of the ODM error codes.
This subroutine is part of Base Operating System (BOS) Runtime.
The odm_unlock (odm_unlock Subroutine) subroutine.
List of ODM Commands and Subroutines.
Object Data Manager (ODM) Overview for Programmers in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.