Changes an object in the object class.
Object Data Manager Library (libodm.a)
#include <odmi.h>
int odm_change_obj (ClassSymbol, DataStructure) CLASS_SYMBOL ClassSymbol; struct ClassName *DataStructure;
The odm_change_obj subroutine takes as input the class symbol that identifies both the object class to change and a pointer to the data structure containing the object to be changed. The application program must first retrieve the object with an odm_get_obj subroutine call, change the data values in the returned structure, and then pass that structure to the odm_change_obj subroutine.
The odm_change_obj subroutine opens and closes the object class around the change if the object class was not previously opened. If the object class was previously opened, then the subroutine leaves the object class open when it returns.
Upon successful completion, a value of 0 is returned. If the odm_change_obj subroutine fails, a value of -1 is returned and the odmerrno variable is set to an error code.
Failure of the odm_change_obj 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_MAGICNO_ERR | |
The class symbol does not identify a valid object class. | |
ODMI_NO_OBJECT | |
The specified object identifier did not refer to a valid object. | |
ODMI_OPEN_ERR | |
Cannot open the object class. Check path name and permissions. | |
ODMI_PARAMS | |
The parameters passed to the subroutine were not correct. Make sure there are the correct number of parameters and that they are valid. | |
ODMI_READ_ONLY | |
The specified object class is opened as read-only and cannot be modified. | |
ODMI_TOOMANYCLASSES | |
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_get_obj subroutine.
The odmchange command, odmcreate command.
List of ODM Commands and Subroutines.
See ODM Example Code and Output in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs for an example of a .h file.
Object Data Manager (ODM) Overview for Programmers in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.