HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_ADJACENT_LEN_NODE
This verb is equivalent to a series of DEFINE_DIRECTORY_ENTRY verbs for the LEN node and its associated
LUs; it provides a fast method of defining the LEN node’s configuration with a single verb. To query the directory
entries created by this verb, use QUERY_DIRECTORY_ENTRY.
If this verb is issued to the network node acting as the server for the LEN node, the LEN node
’s resources are
added to the network node’s directory database. This means that the network node will respond to network searches
for these resources, so that they are accessible to the entire network. If the verb is issued to an end node, the LEN
node’s resources are accessible only to that end node.
3.12.1 VCB Structure
typedef struct define_adjacent_len_node
{
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 cp_name[17]; /* CP name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char num_of_lus; /* number of LUs */
unsigned char wildcard_lus; /* wildcard LUs */
unsigned char reserv3[8]; /* reserved */
unsigned char lu_names[10][8]; /* LU names */
} DEFINE_ADJACENT_LEN_NODE;
3.12.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_ADJACENT_LEN_NODE
cp_name
The fully qualified name of the CP in the adjacent LEN node. This should match the name the LEN node
sends on its XIDs (if it supports them), and the adjacent CP name specified on the DEFINE_LS for the link
to the LEN node.
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.
description
A null-terminated text string (0–31 characters followed by a null character) describing the adjacent
LEN node. This string is for information only; it is stored in the configuration and returned on the
QUERY_DIRECTORY_ENTRY verb, but SNAplus2 does not make any other use of it.
num_of_lus
The number of LUs to be defined, in the range 0–10.Todefine an adjacent node with more than 10 LUs,
use multiple DEFINE_ADJACENT_LEN_NODE verbs for the same CP name.
wildcard_lus
Indicates whether the specified LU names are wildcard entries or explicit LU names. Possible values are:
AP_YES
109