Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ snalu62_process_session_limit(3) — SNA APPC LU6.2 3.2

Media Vault

Software Library

Restoration Projects

Artifacts Sought

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
 

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026