snalu62_cancel_conversation(3) — Subroutines

Name

snalu62_cancel_conversation − Terminates the indicated conversation immediately.

FORMAT

STATUS_RTN snalu62_cancel_conversation(
     RES_ID resource,
     STATUS_VEC status_vec
     );

Arguments

resource

A RES_ID value assigned to the conversation by the interface. This ID was returned by the snalu62_allocate, snalu62_attach_listen, or snalu62_receive_allocate verb.

status_vec

A pointer to a STATUS_VEC array to receive the completion status information.

Description

Use this unarchitected verb to immediately cancel a conversation. This verb immediately terminates all operations in progress for the indicated conversation. The terminated verbs receive a return code of SNALU62_S_CONVCANC. Operations terminated by this verb may or may not have completed their intended action. All arguments returned on the terminated verbs, with the exception of the SNALU62_S_CONVCANC status return, are indeterminate. For example, a snalu62_send_data verb terminated by this call may or may not have sent any data.

Return Values

SNALU62_S_OK
normal successful completion

SNALU62_S_CONVCANC
conversation cancelled