Enterprise Communication Interface (ECI)

ECI Function call via IPC

Description

Transfers the specified input parameters of the desired ECI function.

Calls the appropriate ECI function within the Agile e6 process.

Transfers the specified output parameters of the desired ECI function.

If an ECI function finished successfully, then argument ret_code contains the name of the called ECI-function (e.g.: "eci_ins_ent"). If an error occurred, then the value of ret_code is set to "eci_error". In this case the parameter ret_par consists of function_name/error_message/error_number (these parameters can be read with eci_get_par).

If an input parameter should not be defined, an empty string ("") has to be added to the parameter string.

The names of the desired fields correspond directly to the names of the table columns in Agile e6.

Syntax

int eci_call (edb_data_header *ipc_id, char *fun_code, eci_param *fun_par, char **ret_code, eci_param *ret_par)

Input Parameter

ipc_id

Identifier of IPC connection

fun_code

Identification of desired ECI function (e.g. "eci_ins_ent")

fun_par

See input parameters of specific ECI function

Output Parameter

ret_code

Return code for specified ECI function.

Contains name of called ECI function (e.g."eci_ins_ent") or "eci_error" if ECI function failed.
In this case the return parameter contains the error message function_name/error_message/error_number and additional error information in the second part of the return parameter. (use eci_set_par/eci_get_par to get the parameter parts).

ret_par

See output parameters of specific ECI function

Return Value

0 transfer successful
<> 0 error during transfer