HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_PARTNER_LU
an APPC application that uses a partner LU alias when allocating a session, therefore you need to define a partner
LU in order to map the alias to a fully-qualified partner LU name.
If the local node or the remote node (where the partner LU is located) is a LEN node, note that you need
to define a directory entry for the partner LU to allow SNAplus2 to access it. This can be done using either
DEFINE_ADJACENT_LEN_NODE or DEFINE_DIRECTORY_ENTRY. If both the local and remote nodes are
network nodes, or if one is a network node and the other is an end node, the directory entry is not required, because
SNAplus2 can locate the LU dynamically.
3.38.1 VCB Structure
typedef struct define_partner_lu
{
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 */
PLU_CHARS plu_chars; /* partner LU characteristics */
} DEFINE_PARTNER_LU;
typedef struct plu_chars
{
unsigned char fqplu_name[17]; /* fully qualified partner LU name */
unsigned char plu_alias[8]; /* partner LU alias */
unsigned char description[32]; /* resource description */
unsigned char reserv2[16]; /* reserved */
unsigned char plu_un_name[8]; /* partner LU uninterpreted name */
unsigned char preference; /* reserved */
AP_UINT16 max_mc_ll_send_size; /* maximum MC send LL size */
unsigned char conv_security_ver; /* already-verified security */
/* supported? */
unsigned char parallel_sess_supp; /* parallel sessions supported? */
unsigned char reserv3[8]; /* reserved */
} PLU_CHARS;
3.38.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_PARTNER_LU
plu_chars.fqplu_name
Fully qualified LU name for the partner LU. 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.
plu_chars.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.
If the fqplu_name parameter above matches the fully qualified name of an existing partner LU, this parameter
must match the partner LU alias in the existing definition. You cannot change the partner LU alias for an
existing partner LU, or set up more than one LU alias for the same fully qualified name.
plu_chars.description
227