NAME

snalu62_deallocate − Deallocates a conversation between the local transaction program and a remote transaction program. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_deallocate(
       RES_ID resource,
       STATUS_VEC status_vec,
       UINT32 type,
       BUFFER ∗log_data,
       UINT8 ∗exp_data_recv,
       ASYNC_INFO ∗wait_object
       );
 
 
 
 
 
 
 

Valid Conversation States

 
For snalu62_deallocate(type=SNALU62_C_FLUSH):

  HDX: Send
 
  FDX: Send-Receive and Send-Only

For snalu62_deallocate(type=SNALU62_C_CONFIRM):

  HDX: Send and Deallocate-Pending
 
  FDX: Not supported

For snalu62_deallocate(type=SNALU62_C_ABEND_∗):

  HDX: All except Reset, Deallocate, and Deallocate-Pending
 
  FDX: Send-Receive, Send-Only, and Receive-Only

For snalu62_deallocate(type=SNALU62_C_LOCAL):

  HDX: Deallocate
 
  FDX: Not supported

For snalu62_deallocate(type=SNALU62_C_SYNC_LEVEL):

  HDX: Send
 
  FDX: Send-Receive and Send
 
 
 
 

SUPPLIED PARAMETERS

resource

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

type

A UINT32 value specifying how the interface should deallocate the conversation.  Specify one of the following values:
 
 
 
 

•SNALU62_C_SYNC_LEVEL (the default)

Specifies that the interface should deallocate the conversation based on the synchronization level of the conversation. 
 

•SNALU62_C_FLUSH

Specifies that the interface should precede the deallocation operation by a call to the snalu62_flush verb. 
 

•SNALU62_C_CONFIRM (half-duplex conversations only)

Specifies that the interface should precede the deallocation operation by a call to the snalu62_confirm verb. 
 

•SNALU62_C_ABEND_PROG

Specifies that the interface should precede the deallocation operation by a call to the snalu62_flush verb and that it should deallocate the conversation abnormally.  Use this option when your transaction program detects unexpected behavior. Using this option returns the sense code 0x08640000. 
 

•SNALU62_C_ABEND_SVC

Specifies that the interface should precede the deallocation operation by a call to the snalu62_flush verb and that it should deallocate the conversation abnormally.  Use this option when your transaction program detects an interface error. Using this option returns the sense code 0x08640001. 
 
 

•SNALU62_C_ABEND_TIMER

Specifies that the interface should precede the deallocation operation by a call to the snalu62_flush verb and that it should deallocate the conversation abnormally.  Use this option when your transaction program has not received data within a certain amount of time determined by your transaction program. Using this option returns the sense code 0x08640002. 
 
 

•SNALU62_C_LOCAL (half-duplex conversations only)

Specifies that the interface should deallocate the resources for a conversation that has already been deallocated by the partner transaction program. 
 
 
 

log_data

A pointer to a BUFFER structure specifying log data that the interface should send when the type parameter is any of the SNALU62_C_ABEND_∗ values.  The buffer contains a single logical record.  The logical record consist of a 2-byte length field followed by a data field.  The high-order bit of this length field is not used.  The remaining 15 bits contain the length of the record (including the 2-byte length field). Therefore, the maximum length of the data field is 32,765 bytes and logical-record length values of 0 and 1 are invalid.  Supply this parameter in ASCII format; the interface translates it to EBCDIC. 
 
 

wait_object

A pointer to an ASYNC_INFO structure specifying whether the interface should process this verb in a blocking or non-blocking manner. 
 
 

RETURNED PARAMETERS

exp_data_recv

A pointer to a UINT8 location to receive a boolean value indicating whether an expedited data notification has been received.  A value of TRUE (1) indicates an expedited data notification has been received.  A value of FALSE (0) indicates no expedited data notification has been received. 
 

status_vec

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

DESCRIPTION

 
Half-Duplex Processing

When the verb completes, the conversation that has been using the session ends.  If the session does not require deactivation because of a change-number-of-sessions (CNOS) operation, the session remains active and available for use by another conversation. 

Full-Duplex Processing

When the verb completes, the local transaction program’s send queue is closed. Both the local and remote transaction program must close their send queues independently.  Notification that the remote transaction program has closed its send queue is given in the form of an SNALU62_S_DEALNOR return code. 

All Conversations

 
snalu62_deallocate(type=SNALU62_C_ABEND_∗) is an abrupt termination that closes both sides of the conversation simultaneously.  The type of ABEND deallocation controls the specific sense code that the interface transmits with the deallocate ABEND.  Refer to the following table for more information. 
 

 
SNALU62_C_ABEND_PROG@0x08640000@T{ Deallocate ABEND program T} SNALU62_C_ABEND_SVC@0x08640001@T{ Deallocate ABEND service T} SNALU62_C_ABEND_TIMER@0x08640002@T{ Deallocate ABEND timer T}

An ABEND deallocation cancels or resets posting. For more information, see the description of the snalu62_post_on_receipt verb. 
 
 

RESTRICTIONS

 
Full-duplex conversations do not support the following deallocation types when the conversation sync-level is anything other than SNALU62_C_NONE:
 
 
 

•type=SNALU62_C_CONFIRM
 

•type=SNALU62_C_LOCAL
 

•type=SNALU62_C_SYNC_LEVEL
 
 

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_ALLERR
conversation could not be allocated

SNALU62_S_CONVCANC
conversation canceled

SNALU62_S_DEABPR
deallocate ABEND program

SNALU62_S_DEABSVC
deallocate ABEND services

SNALU62_S_DEABTIM
deallocate ABEND timer

SNALU62_S_ERRIND
error indication

SNALU62_S_FMHNOT
user control data (FMH) not supported

SNALU62_S_MAPEFAI
map execution failure

SNALU62_S_MAPNFOU
map name not found

SNALU62_S_MAPNSUP
mapping not supported

SNALU62_S_OPINCOMP
non-blocking operation not completed

SNALU62_S_OPNOTACC
non-blocking operation not accepted

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRERPU
program error purging

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_RESFNO
resource failure no retry

SNALU62_S_RESFRET
resource failure retry

SNALU62_S_STAERR
LU6.2 verb function-name invalid with conversation in current state

SNALU62_S_SVCERPU
service error purging

SNALU62_S_UNSUC
verb did not execute successfully
 
 
 

ERRORS

 
None

RELATED INFORMATION

 
Functions: snalu62_allocate

Manuals: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Programming and IBM’s Systems Network Architecture Transaction Programmer’s Reference Manual for LU Type 6.2.