NAME

snalu62_activate_session − Activates a session with the specified mode name to the remote LU. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_activate_session(
       STATUS_VEC status_vec,
       char ∗local_lu_name,
       char ∗remote_lu_name,
       char ∗mode_name,
       SRV_INFO ∗server_info
       );
 
 
 
 

SUPPLIED PARAMETERS

local_lu_name

A pointer to a null-terminated ASCII string specifying either the fully-qualified network name or the locally-known alias of the local LU. 
 
 

remote_lu_name

A pointer to a null-terminated ASCII string specifying either the fully-qualified network name or the locally-known alias of the remote LU. 
 
 

mode_name

A pointer to a null-terminated ASCII string specifying the mode name to be used when activating the session. 
 

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 to 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

 
Use this verb to activate a parallel session as a contention winner for either the source LU or the remote (target) LU. The session is activated as a contention winner for the source LU when the number of currently active contention-winner LU/mode sessions for the source LU is less than the new LU/mode session limit minus the new number of contention-winner sessions for the target LU. Otherwise, the session is activated as a contention winner for the target LU.

In addition, use this verb to activate one or both parallel sessions for the SNASVCMG mode name to a target LU. The source LU is the contention winner for one of the LU/mode sessions; the target LU is the contention winner for the other session. 
 
 

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_OK_ASSPEC
normal successful completion as specified

SNALU62_S_OK_ASNEG
normal successful completion was negotiated

SNALU62_S_MSLIMLU-mode session limit exceeded

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_RESFNO
resource failure no retry

SNALU62_S_RESFRET
resource failure retry

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.