HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
DEFINE_LS
Chapter 3258
DEFINE_LS
DEFINE_LS is used to define a new link station (LS) or modify an
existing one. Before issuing this verb, you must issue the
DEFINE_PORT verb to define the port that this LS uses. Link specific
data is concatenated to the basic structure.
You cannot use DEFINE_LS to modify the port used by an existing LS;
the port_name specified on the verb must match the previous definition
of the LS. The LS can be modified only if it is not started.
VCB Structure
typedef struct define_ls
{
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 ls_name[8]; /* name of link station */
LS_DEF_DATA def_data; /* LS defined data */
} DEFINE_LS;
typedef struct ls_def_data
{
unsigned char description[32]; /* resource description */
unsigned char initially_active; /* is this LS initially active? */
AP_UINT16 reserv2; /* reserved */
AP_UINT16 react_timer; /* timer for retrying failed LS */
AP_UINT16 react_timer_retry; /* retry count for failed LS */
unsigned char reserv3[10]; /* reserved */
unsigned char port_name[8]; /* name of associated port */
unsigned char adj_cp_name[17]; /* adjacent CP name */
unsigned char adj_cp_type; /* adjacent node type */
LINK_ADDRESS dest_address; /* destination address */
unsigned char auto_act_supp; /* auto-activate supported */
unsigned char tg_number; /* pre-assigned TG number */
unsigned char limited_resource; /* limited resource */
unsigned char solicit_sscp_sessions; /* solicit SSCP sessions */
unsigned char pu_name[8]; /* Local PU name (reserved if */
/* solicit_sscp_sessions is set */
/* to AP_NO) */
unsigned char disable_remote_act; /* disable remote activation */
unsigned char dspu_services; /* services provided for downstream
PU */