Name

snalu62_deactivate_session − Deactivates a session with the specified session ID. 
 
 
 

FORMAT

STATUS_RTN snalu62_deactivate_session(
     SES_ID session_id,
     STATUS_VEC status_vec,
     UINT32 type,
     UINT32 sense_code,
     UINT32 return_control,
     SRV_INFO ∗server_info
     );
 
 
 
 

Arguments

session_id
 
A pointer to a SES_ID value assigned to the session by the interface.  The interface returns this ID on either the snalu62_get_attributes, or snalu62_display_mode verb. 
 
 

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

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 utilize.  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. 
 
 
 

Description

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

 
If the session_id parameter specifies a value that does not match an existing session ID, the session is considered to have been previously deactivated (or never activated), and a return code of OK is returned 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 session_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 access validation file that includes your node name.
 

Return Values

SNALU62_S_OK
normal successful completion

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_UNSUC
verb did not execute successfully