[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 1

odm_set_path Subroutine


Sets the default path for locating object classes.


Object Data Manager Library (libodm.a)


#include <odmi.h>
char *odm_set_path (NewPath)
char *NewPath;


The odm_set_path subroutine is used to set the default path for locating object classes. The subroutine allocates memory, sets the default path, and returns the pointer to memory. Once the operation is complete, the calling application should free the pointer using the free subroutine.


NewPath Contains, as a string, the path name in the file system in which to locate object classes.

Return Values

Upon successful completion, a string pointing to the previous default path is returned. If the odm_set_path 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_set_path subroutine sets the odmerrno variable to one of the following error codes:

                          The specified path does not exist on the file system. Make sure the path is accessible.
                          Cannot allocate sufficient storage. Try again later or contact the person responsible for the system.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The free 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.

[ Previous | Next | Contents | Glossary | Home | Search ]