HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_LS
3.29 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.
3.29.1 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 */
AP_UINT16 activation_count; /* reserved */
unsigned char restart_on_normal_deact; /* restart the link on any */
/* failure */
unsigned char reserv3[7]; /* 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 */
unsigned char dspu_name[8]; /* Downstream PU name (reserved */
/* if dspu_services is AP_NONE) */
unsigned char dlus_name[17]; /* DLUS name if dspu_services */
/* set to AP_DLUR */
unsigned char bkup_dlus_name[17]; /* Backup DLUS name if */
/* dspu_services set to AP_DLUR */
unsigned char hpr_supported; /* does the link support HPR? */
unsigned char hpr_link_lvl_error; /* does the link use link-level */
/* error recovery for HPR frms? */
167