lrt_set_carray_error_list

Sets an error list for use with a CARRAY reply buffer.

void lrt_set_carray_error_list( CARRAY_ERROR_INFO *newcarrayErrors );

The lrt_set_carray_error_list function sets a list of error messages that can be used in a CARRAY reply buffer. Before using this function, you define the error messages in a CARRAY_ERROR_INFO structure.

For each error message you include the Tuxedo service, the error string for which you want to search, and the error message to issue. You list each error as a separate entry in the structure. To indicate the end of the structure, use three NULL strings. After you set the structure, you issue an lrt_set_carray_error_list function.

For more information about the CARRAY_ERROR_INFO structure, see the lrt.h file in include directory of the installation.

Return Values

The function is declared as void, so it does not return anything.

Parameterization

You cannot use standard parameterization for any arguments in this function.

Example

In the following example, lrt_set_carray_error_list function sets a list of error messages for a panel update error in the PprSave service.

static CARRAY_ERROR_INFO my_carray_errors[] = {
    {"PprSave", "Another user has updated the panel", "Need to correlate query."},
    {"PprSave", "Panel data is inconsistent with database", "Need to correlate query."},
    {"PprSave", "FSMM.CatalogJ", "Service error. Probably need to correlate query."},
    {"", "", ""}
};
lrt_set_carray_error_list(my_carray_errors);