High Availability Monitors Version A.03.02 Release Notes
NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
DEFINE_MODE
Chapter 3 313
DEFINE_MODE
The DEFINE_MODE verb defines a mode (a set of networking
characteristics to be used by a group of sessions) or modifies a previously
defined mode. You cannot modify the SNA-defined mode CPSVCMG or
change the COS name used by the SNA-defined mode SNASVCMG.
If you use this verb to modify an existing mode, the changes will apply to
any new combination of local LU and partner LU that start to use the
mode after you have made the change. However, any combination of LUs
already using the mode will not pick up the changes until after the next
locally or remotely initiated CNOS command.
This verb can also be used to specify the default COS to which any
unrecognized modes will be mapped. If no default COS is specified, the
SNA-defined COS #CONNECT is used.
VCB Structure
typedef struct define_mode
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char mode_name[8]; /* mode name */
AP_UINT16 reserv3; /* reserved */
MODE_CHARS mode_chars; /* mode characteristics */
} DEFINE_MODE;
typedef struct mode_chars
{
unsigned char description; /* resource description */
unsigned char reserv2[16]; /* reserved */
AP_UINT16 max_ru_size_upp; /* maximum RU size upper bound */
unsigned char receive_pacing_win; /* receive pacing window */
unsigned char default_ru_size; /* default RU size to maximize */
/* performance */
AP_UINT16 max_neg_sess_lim; /* maximum negotiable session limit*/
AP_UINT16 plu_mode_session_limit; /* LU-mode session limit */
AP_UINT16 min_conwin_src; /* minimum source contention winner*/
/* sessions */