HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
ACTIVATE_SESSION
3.1.1 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;
3.1.2 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.
lu_alias
LU alias of the local LU, as defined to SNAplus2. This is an 8-byte ASCII string, using any locally displayable
characters, padded on the right with spaces if the name is shorter than 8 bytes. This parameter is used only
if
lu_name is set to zeros.
If both the LU name and the LU alias are set to all zeros, the verb is forwarded to the LU associated with
the CP (the default LU).
plu_alias
LU alias of the partner LU. This is an 8-byte ASCII string, using any locally displayable characters, padded
on the right with spaces if the name is shorter than 8 bytes. To indicate that the partner LU is defined by its
fully qualified LU name instead of its LU alias, set this parameter to 8 binary zeros.
mode_name
Name of the mode to be used by the LUs. This is an 8-byte alphanumeric type-A EBCDIC string (starting
with a letter), padded on the right with EBCDIC spaces if the name is shorter than 8 bytes.
fqplu_name
Fully qualified LU name for the partner LU, as defined to SNAplus2. This parameter is used only if the
plu_alias field is set to zeros; it is ignored if plu_alias is specified.
The name is a 17-byte EBCDIC string, right-padded with EBCDIC spaces. It consists of a network ID of
up to 8 A-string characters, an EBCDIC dot (period) character, and a network name of up to 8 A-string
characters.
polarity
81