HP-UX C SIP Stack Programmer's Guide (Novembery 2007)

Working with Call-legs (Dialogs) 77

Call-leg Transactions

RvSipCallLegTranscCreatedEv()

Notifies the application that a new general transaction (other than BYE or

PRACK) was created and relates to the specified call-leg. In this callback, the

application can replace handles with the call-leg transaction and specify

whether it wishes to handle the incoming request. If so, the application will be

informed of the transaction states where it will have to respond to the request.

If the application indicates that it does not wish to handle the request, the call-

leg will apply its default behavior according to the request method. For example,

requests such as REFER and SUBSCRIBE will be handled using dedicated state

machines and callbacks. Unknown requests will be responded to with 501.

RvSipCallLegTranscStateChangedEv()

Notifies the application that the state of a general transaction that belongs to the

specified call-leg has changed. When the state indicated that a request was

received, the application should use the RvSipCallLegTranscResponse()

function and respond to the request.

CALL-LEG

TRANSACTION STATE

MACHINE

The Call-leg Transaction state machine represents the state of a general

transaction that belongs to a call-leg. The

RvSipCallLegTranscStateChangedEv() callback reports call-leg transaction

state changes and state change reason. The state change reason indicates how the

transaction reached the new state.

A call-leg transaction associates with the following states:

RVSIP_CALL_LEG_TRANSC_STATE_IDLE

The IDLE state is the initial state of a call-leg transaction.

RVSIP_CALL_LEG_TRANSC_STATE_SERVER_GEN_REQUEST_RCVD

The REQUEST_RCVD state indicates that a general request was received. The

application should use the RvSipCallLegTranscResponse() function to respond

to the transaction.

RVSIP_CALL_LEG_TRANSC_STATE_SERVER_GEN_FINAL_RESPONSE_SENT

After calling RvSipCallLegTranscResponse(), a final response is sent and the

transaction assumes the FINAL_RESPONSE_SENT state.