Name

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

FORMAT

STATUS_RTN snalu62_activate_session(
     STATUS_VEC status_vec,
     char ∗local_lu_name,
     char ∗remote_lu_name,
     char ∗mode_name,
     SRV_INFO ∗server_info
     );
 
 
 
 

Arguments

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

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

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 access validation file that includes your node name.
 

Return Values

SNALU62_S_OK
normal successful completion

SNALU62_S_OK_ASSPEC
normal successful completion as specified

SNALU62_S_OK_ASNEG
normal successful completion was negotiated

SNALU62_S_MSLIM
LU-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