NAME

snalu62_deactivate_conv_group − Deactivates a session with the specified conversation group ID. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_deactivate_conv_group(
       UINT32 conversation_group_id,
       STATUS_VEC status_vec,
       UINT32 type,
       UINT32 sense_code,
       UINT32 return_control,
       SRV_INFO ∗server_info
       );
 
 
 
 

SUPPLIED PARAMETERS

conversation_group_id

A UINT32 value specifying the conversation group ID of the session that the interface should deactivate.  Retrieve this parameter using either the snalu62_get_attributes or snalu62_display_mode verb. 
 

type

A UINT32 value specifying the type of session deactivation that the interface should perform.  Specify one of the following values:
 
 
 
 

•SNALU62_C_CLEANUP (the default)

Specifies that the interface should deactivate the session immediately, regardless of whether there is a conversation currently associated with the session. 
 

•SNALU62_C_NORMAL

Specifies that the interface should deactivate the session after all conversations associated with the session are deallocated.  The interface does not allow new conversations.  However, it does allow queued conversations to use the session. 
 
 
 
 

sense_code

A UINT32 value specifying the sense code that the interface should use when it deactivates the session.  A value of zero means the interface should not supply a sense code when it deactivates the session. 
 
 

return_control

A UINT32 value specifying when the interface should return control to the local program. Specify one of the following values:
 
 
 
 

•SNALU62_C_IMMEDIATE (the default)

Specifies that the interface should return control immediately without waiting for the session deactivation to complete. 
 

•SNALU62_C_DELAYED

Specifies that the interface should return control when the session deactivation is complete. 
 
 
 
 

To avoid delays in returning control, specify a return_control value of SNALU62_C_IMMEDIATE if the type parameter specifies SNALU62_C_NORMAL. 

server_info

A pointer to a SRV_INFO structure specifying the LU6.2 Server to use.  Supply sufficient information to uniquely identify the LU6.2 Server.  If this parameter is not specified, the interface attempts to connect a local server with the name LU62_SRV. 
 
 

RETURNED PARAMETER

status_vec

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

DESCRIPTION

 
Each session is assigned a unique conversation group ID when it is activated. The conversation group ID exists for the duration of the session. When the session is deactivated (normally or otherwise), the conversation group ID for the session is deleted and the ID no longer exists.

If the conversation_group_id parameter specifies a value that does not match an existing session ID, the interface assumes that the session was previously deactivated (or was never activated), and returns a return code of OK to the program.  That is, a return code of OK means the session will be, or has been, deactivated, or that it was never active.  No error check is performed on the conversation_group_id value for validity. 
 
 

RESTRICTIONS

 
Only a process having superuser privileges or a user listed in the system group in the /etc/group file can call this verb. 

If you are using this verb to manage an LU6.2 Server on a remote node, the remote server must have access to an LU6.2 Server access validation file that includes your node name. 
 
 
For a description of the LU6.2 Server access validation file, see the Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Administrator’s Guide. 
 
 

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_UNSUC
verb did not execute successfully
 
 
 

ERRORS

 
None

RELATED INFORMATION

 
Functions: snalu62_deactivate_session

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.