odm_run_method Subroutine

Purpose

Runs a specified method.

Library

Object Data Manager Library (libodm.a)

Syntax

#include <odmi.h>

int odm_run_method(MethodNameMethodParametersNewStdOutNewStdError)
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:

See Object Data Manager (ODM) error codes in AIX Version 7.1 Technical Reference: Base Operating System and Extensions, Volume 1 for explanations of the ODM error codes.