endurox.tprecv

endurox.tprecv(cd: int, flags: int = 0) → endurox.TpRecvRet

Receive conversation data block. In case if TPEEVENT error is received, exception is not thrown, instead event code is loaded into revent return value. In case if event is not generated, revent is set to 0.

tprecv example

    cd = e.tpconnect("CONVSV", {"data":"HELLO"}, e.TPRECVONLY)
    tperrno, tpurcode, revent = e.tprecv(cd)

For more details see tprecv(3) C API call.

Raises:

AtmiException –

Following error codes may be present:

TPEINVAL - Invalid call descriptor.

TPETIME - Queue was blocked and it timeout out.

TPESYSTEM - System error occurred.

TPEOS - Operating system error occurred.

TPEPROTO - Protocol error is generated if given process is in receiver (TPRECVONLY) mode.

TPEBLOCK - TPNOBLOCK flag was set and message queue was full.

Parameters:

• cd (int) – Conversation descriptor.

• idata (dict) – ATMI buffer to send.

• flags (int) – Bitwise or’d TPNOBLOCK, TPSIGRSTRT, TPNOTIME.

Returns:

• int –

  tperrno - error code (0 or TPEEVENT). For other errors, exceptions

  thrown.

• int –

  tpurcode - return code passed to tpreturn(). Value is loaded in case

  if revent returned is TPEV_SVCFAIL or TPEV_SVCSUCC, otherwise previous tpurcode is returned.

• int –

  revent - In case if TPEEVENT tperrno was returned, may contain:

  TPEV_DISCONIMM, TPEV_SENDONLY, TPEV_SVCERR, TPEV_SVCFAIL, TPEV_SVCSUCC.

• dict – ATMI buffer send by peer.