HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_DLUR_PU
The pipe is in the process of being deactivated.
AP_INACTIVE
The pipe is not active.
dlur_pu_detail.fqpcid.pcid
Procedure Correlator ID used on the pipe. This is an 8-byte hexadecimal string. If the SSCP-PU session is
not active this field will be set to binary zeros.
dlur_pu_detail.fqpcid.fqcp_name
Fully qualified Control Point name used on the pipe. If the SSCP-PU session is not active this field will be
set to binary zeros.
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.
The combination of the
pcid and fqcp_name parameters uniquely identify each PU whose sessions are being
routed using DLUR. The fqcp_name parameter is the CP name of either the DLUR or DLUS node, depending
on which node initiated the SSCP-PU session activation.
dlur_pu_detail.dlus_retry_timeout
The interval in seconds between the second and subsequent attempts to contact the DLUS specified
by the def_data.dlus_name and def_data.bkup_dlus_name parameters. The interval between the first
and second attempts is always 1 second. If zero is specified, then the defaults specified using the
DEFINE_DLUR_DEFAULTS verb are used. .
dlur_pu_detail.dlus_retry_limit
Number of attempts to recontact a DLUS after an initial failure. A value of zero indicates that the value from
the DEFINE_DLUR_DEFAULTS verb is used. If
0xFFFF
is returned, SNAplus2 will retry indefinitely.
3.114.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_PU_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE to list all entries starting from the
supplied name, but the pu_name parameter was not valid.
AP_INVALID_FILTER_OPTION
The filter parameter was not set to a valid value.
AP_INVALID_LIST_OPTION
The list_options parameter was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.114.5 Returned Parameters: Function Not Supported
If the verb does not execute successfully because the local node configuration does not support it, SNAplus2 returns
the following parameters:
426