snalu62_process_session_limit(3) — Subroutines
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.
FORMAT
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
);
Arguments
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.
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 an ASCII string identifying the locally-known alias of the remote (target) LU.
source_lu_alias
A pointer to a 65-byte char buffer to receive an ASCII string identifying the locally-known alias of the source LU.
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 an SNA service transaction program known as the "CNOS service transaction program", identified with the name of hex 06F1. The CNOS service transaction program is involved at the remote (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.
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 access validation file that includes your node name.
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