odm_run_method Subroutine
Purpose
Runs a specified method.
Library
Object Data Manager Library (libodm.a)
Syntax
#include <odmi.h>int odm_run_method(MethodName, MethodParameters, NewStdOut, NewStdError)
char * MethodName, * MethodParameters;
char ** NewStdOut, ** NewStdError;
char * MethodName, * MethodParameters;
char ** NewStdOut, ** NewStdError;
Description
The odm_run_method subroutine takes as input the name of the method to run, any parameters for the method, and addresses of locations for the odm_run_method subroutine to store pointers to the stdout (standard output) and stderr (standard error output) buffers. The application uses the pointers to access the stdout and stderr information generated by the method.
Parameters
| Item | Description |
|---|---|
| MethodName | Indicates the method to execute. The method can already be known by the applications, or can be retrieved as part of an odm_get_obj subroutine call. |
| MethodParameters | Specifies a list of parameters for the specified method. |
| NewStdOut | Specifies the address of a pointer to the memory where the standard output of the method is stored. If the NewStdOut parameter is a null value (NewStdOut == NULL), standard output is not captured. |
| NewStdError | Specifies the address of a pointer to the memory where the standard error output of the method will be stored. If the NewStdError parameter is a null value (NewStdError == NULL), standard error output is not captured. |
Return Values
If successful,
the odm_run_method subroutine returns the exit status and out_ptr and err_ptr should
contain the relevant information. If unsuccessful, the odm_run_method subroutine
will return -1 and set the odmerrno variable to an error code.
Note: AIX®methods usually
return the exit code defined in the cf.h file if the methods
exit on error.
Error Codes
Failure of the odm_run_method subroutine sets the odmerrno variable to one of the following error codes: