Puts an exclusive lock on the requested path name.
Object Data Manager Library (libodm.a)
#include <odmi.h>
int odm_lock (LockPath, TimeOut) char *LockPath; int 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.
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:
ODMI_BAD_LOCK | |
Cannot set a lock on the file. Check path name and permissions. | |
ODMI_BAD_TIMEOUT | |
The time-out value was not valid. It must be a positive integer. | |
ODMI_BAD_TOKEN | |
Cannot create or open the lock file. Check path name and permissions. | |
ODMI_LOCK_BLOCKED | |
Cannot grant the lock. Another process already has the lock. | |
ODMI_LOCK_ENV | |
Cannot retrieve or set the lock environment variable. Remove some environment variables and try again. | |
ODMI_MALLOC_ERR | |
Cannot allocate sufficient storage. Try again later or contact the person responsible for the system. | |
ODMI_UNLOCK | |
Cannot unlock the lock file. Make sure the lock file exists. |
This subroutine is part of Base Operating System (BOS) Runtime.
The odm_unlock 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.