HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_DLUR_PU
dlur_pu_summary.pu_name
Name of the PU. The name is an 8-byte EBCDIC type-A string, padded on the right with EBCDIC spaces if
the name is shorter than 8 characters.
dlur_pu_summary.description
A null-terminated text string describing the PU, as specified in the definition of the PU. If the PU is an active
downstream PU, rather than a defined internal PU, this parameter is reserved.
dlur_pu_detail.overlay_size
The size of the returned
dlur_pu_detail structure, and therefore the offset to the start of the next entry in the
data buffer.
When your application needs to go through the returned buffer to find each
dlur_pu_detail structure in turn, it
must use this value to move to the correct offset for the next data structure, and must not use the C
sizeof()
operator. This is because the size of the returned overlay may increase in future releases of SNAplus2; using
the returned overlay size ensures that your application will continue to work with future releases.
dlur_pu_detail.pu_name
Name of the PU. The name is an 8-byte EBCDIC type-A string, padded on the right with EBCDIC spaces if
the name is shorter than 8 characters.
dlur_pu_detail.description
A null-terminated text string describing the PU, as specified in the definition of the PU. If the PU is an active
downstream PU, rather than a defined internal PU, this parameter is reserved.
dlur_pu_detail.initially_active
Specifies whether this PU is automatically started when the node is started. For a downstream PU, this
parameter is reserved. Possible values for an internal PU are:
AP_YES
The PU is automatically started when the node is started.
AP_NO
The PU is not automatically started; it must be started manually.
dlur_pu_detail.defined_dlus_name
Name of DLUS node, defined by either a DEFINE_INTERNAL_PU verb or a DEFINE_LS verb (with
dspu_services set to AP_DLUR).
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.
dlur_pu_detail.bkup_dlus_name
Name of backup DLUS node, defined by either a DEFINE_INTERNAL_PU verb or a DEFINE_LS verb
(with dspu_services set to AP_DLUR).
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.
dlur_pu_detail.pu_id
PU identifier, either defined on DEFINE_INTERNAL_PU or obtained in an XID from a downstream PU.
This is a 4-byte hexadecimal string, consisting of a block number (3 hexadecimal digits) and a node number
(5 hexadecimal digits).
dlur_pu_detail.pu_location
Location of PU.
424