HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_DIRECTORY_ENTRY
AP_ENCP_RESOURCE
End node or LEN node
AP_NNCP_RESOURCE
Network node
AP_LU_RESOURCE
LU
AP_WILDCARD_LU_RESOURCE
Wildcard LU name.
For an LU or wildcard LU, the directory entry for the parent resource (the owning CP) must already be
defined.
description
A null-terminated text string (0–31 characters followed by a null character) describing the directory entry.
This string is for information only; it is stored in the node’s configuration file and returned on the
QUERY_DIRECTORY_ENTRY and QUERY_DIRECTORY_LU verbs, but SNAplus2 does not make any
other use of it.
parent_name
Fully qualified name of the parent resource; for an LU the parent resource is the owning Control Point, and for
an end node or LEN node it is the network node server. 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.
This parameter should be set to all binary zeros in the following cases:
• When registering a network node CP
• When the verb is being issued to an end node or LEN node to define an adjacent LEN node CP with
which the local node communicates directly.
parent_type
Specifies the parent type of the resource being defined. Possible values are:
AP_ENCP_RESOURCE
End node (for an LU resource owned by an end node)
AP_NNCP_RESOURCE
Network node (for an LU resource owned by a network node, or for an EN or LEN resource).
Set this parameter to zero when no parent resource name is supplied.
3.18.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
3.18.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
128