NAME

snalu62_process_session_limit − Processes the LU/mode session limit and contention-winner polarities for parallel-session connections.  This verb does not terminate active conversations. 
 
 

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
STATUS_RTN snalu62_process_session_limit(
       RES_ID resource,
       STATUS_VEC status_vec,
       char ∗target_lu_alias,
       char ∗source_lu_alias,
       MODE_INFO ∗mode_name
       );
 
 
 
 

SUPPLIED PARAMETERS

resource

A RES_ID value assigned to the conversation by the interface.  The interface returns this ID on the snalu62_allocate, snalu62_attach_listen, or snalu62_receive_allocate verb. 
 
 

RETURNED PARAMETERS

status_vec

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

target_lu_alias

A pointer to a 65-byte char buffer to receive the null-terminated ASCII string identifying the locally-known alias of the local (target) LU for which the CNOS request is being made. 
 

source_lu_alias

A pointer to a 65-byte char buffer to receive the null-terminated ASCII string identifying the locally-known alias of the remote (source) LU making the CNOS request. 
 

mode_name

A pointer to a MODE_INFO structure to receive an indication of whether one or all mode names are affected and, if one, the specified mode name. 
 
 

DESCRIPTION

 
This verb is called by the "CNOS service transaction program," identified with the name of hex 06F1. The CNOS service transaction program is involved at the target LU as a result of a CNOS verb being called at the source LU. The CNOS service transaction program then calls this verb to initiate the target LU’s processing of the CNOS request sent by the source LU.

The program calls the snalu62_display_mode verb to obtain the new session limit, contention-winner polarities, and related CNOS parameters. 

The Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX software contains an implementation of the CNOS service transaction program (hex 06F1). If you want to write your own version of this program, you must define a transaction program using the name hex 06F1.  Except in very unusual cases, Compaq recommends that you use the supplied program (that is, do NOT define the transaction program hex 06F1). 

RESTRICTIONS

 
This verb applies only to parallel-session connections.

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_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_RESFNO
resource failure no retry

SNALU62_S_UNSUC
verb did not execute successfully
 
 
 

ERRORS

 
None

RELATED INFORMATION

 
Functions: snalu62_initialize_sess_limit, snalu62_change_session_limit, and snalu62_reset_session_limit. 
 

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.