HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_MODE
3.36 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.
3.36.1 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[32]; /* 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 */
unsigned char cos_name[8]; /* class of service name */
unsigned char cryptography; /* reserved */
unsigned char compression; /* reserved */
AP_UINT16 auto_act; /* initial auto-activation count */
AP_UINT16 min_conloser_src; /* min source contention loser */
AP_UINT16 max_ru_size_low; /* maximum RU size lower bound */
AP_UINT16 max_receive_pacing_win; /* maximum receive pacing window */
unsigned char max_compress_lvl; /* reserved */
unsigned char max_decompress_lvl; /* reserved */
unsigned char comp_in_series; /* reserved */
unsigned char reserv4[25]; /* reserved */
} MODE_CHARS;
3.36.2 Supplied Parameters
The application supplies the following parameters:
opcode
211