endurox.tpacall

endurox.tpacall(svc: str, idata: object, flags: int = 0) → int

Asynchronous service call. Function returns call descriptor if TPNOREPLY flag is not set. The replies shall be collected with tpgetrply() API call by passing the returned call descriptor to the function.

tpacall example

    cd = e.tpacall("EXBENCH", { "data":{"T_STRING_FLD":"Hi Jim"}})
    tperrno, tpurcode, retbuf, cd = e.tpgetrply(cd)

For more details see tpacall(3).

Raises:

AtmiException –

Following error codes may be present:

TPEINVAL - Invalid arguments to function.

TPENOENT - Service not is advertised.

TPETIME - Destination queue was full/blocked on time-out expired.

TPESYSTEM - System error.

TPEOS - Operating system error.

TPEBLOCK - Blocking condition found and TPNOBLOCK flag was specified

TPEITYPE - Service error during input buffer handling.

Parameters:

• svc (str) – Service name to call

• idata (dict) – Input ATMI data buffer

• flags (int) – Or’d bit flags: TPNOTRAN, TPSIGRSTRT, TPNOBLOCK, TPNOREPLY, TPNOTIME. Default value is 0.

Returns:

cd - call descriptor. 0 in case if TPNOREPLY was specified.

Return type:

int