HP-UX SNAplus2 NOF Programmer's Guide
NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
ACTIVATE_SESSION
Chapter 3 117
ACTIVATE_SESSION
The ACTIVATE_SESSION verb requests SNAplus2 to activate a session
between the local LU and a specified partner LU, using a specified mode.
You must issue an INITIALIZE_SESSION_LIMIT verb before issuing an
ACTIVATE_SESSION verb, unless
cnos_permitted
is set to AP_YES.
This verb must be issued to a running node.
VCB Structure
typedef struct activate_session
{
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 lu_name[8]; /* local LU name */
unsigned char lu_alias[8]; /* local LU alias */
unsigned char plu_alias[8]; /* partner LU alias */
unsigned char mode_name[8]; /* mode name */
unsigned char fqplu_name[17]; /* fully qualified partner LU name */
unsigned char polarity; /* requested session polarity */
unsigned char session_id[8]; /* session ID */
unsigned char cnos_permitted; /* is implicit CNOS permitted? */
unsigned char reserv4[15]; /* reserved */
ACTIVATE_SESSION;
Supplied Parameters
The application supplies the following parameters:
opcode
AP_ACTIVATE_SESSION
lu_name
LU name of the local LU, as defined to SNAplus2. This
is an 8-byte type-A EBCDIC string,padded on the right
with spaces if the name is shorter than 8 bytes. To
indicate that the LU is defined by its LU alias instead
of its LU name, set this parameter to 8 binary zeros.