Removes objects from an ODM object class.
Object Data Manager Library (libodm.a)
int odm_rm_obj (ClassSymbol, Criteria) CLASS_SYMBOL ClassSymbol; char *Criteria;
The odm_rm_obj subroutine deletes objects from an object class.
|ClassSymbol||Identifies a class symbol returned from an odm_open_class subroutine. If the odm_open_class subroutine has not been called, this is the ClassName_CLASS structure that was created by the odmcreate command.|
|Criteria||Contains as a string the qualifying criteria for selecting the objects to remove.|
Upon successful completion, the number of objects deleted is returned. If the odm_rm_obj subroutine is unsuccessful, a value of -1 is returned and the odmerrno variable is set to an error code.
Failure of the odm_rm_obj subroutine sets the odmerrno variable to one of the following error codes:
|The specified search criteria is incorrectly formed. Make sure the criteria contains only valid descriptor names and the search values are correct.|
|The specified object class does not exist. Check path name and permissions.|
|The object class cannot be opened because of the file permissions.|
|Cannot fork the child process. Make sure the child process is executable and try again.|
|An internal consistency problem occurred. Make sure the object class is valid or contact the person responsible for the system.|
|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 class symbol does not identify a valid object class.|
|Cannot allocate sufficient storage. Try again later or contact the person responsible for the system.|
|Cannot open the object class. Check path name and permissions.|
|Cannot open a pipe to a child process. Make sure the child process is executable and try again.|
|The parameters passed to the subroutine were not correct. Make sure there are the correct number of parameters and that they are valid.|
|The specified object class is opened as read-only and cannot be modified.|
|Cannot read from the pipe of the child process. Make sure the child process is executable and try again.|
|Too many object classes have been accessed. An application can only access less than 1024 object classes.|
This subroutine is part of Base Operating System (BOS) Runtime.
The odm_add_obj subroutine, odm_open_class subroutine.
The odmcreate command, odmdelete command.
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.
For information on qualifying criteria, see "Understanding ODM Object Searches" in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.