# 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