snalu62_cancel_conversation(3) — Subroutines

NAME

snalu62_cancel_conversation − Terminates the indicated conversation immediately.

LIBRARY

/usr/shlib/libsnatprm.so

SYNOPSIS

#include <sna/snatprmdf.h>

STATUS_RTN snalu62_cancel_conversation(
       RES_ID resource,
       STATUS_VEC status_vec
       );

Valid Conversation States

HDX: All except Reset

FDX: All except Reset

SUPPLIED PARAMETER

resource

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

RETURNED PARAMETER

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 parameters returned on the terminated verbs, with the exception of the SNALU62_S_CONVCANC status return, are indeterminate. For example, an snalu62_send_data verb terminated by this verb may or may not have sent any data.

RESTRICTIONS

None

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_CONVCANC
conversation cancelled

SNALU62_S_PARERR
parameter error, function-name

ERRORS