HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_CONVERSATION
cn_port_data.fqcn_name
Fully qualified name of the CN. The name is a 17-byte EBCDIC string, padded on the right with EBCDIC
spaces. It consists of a network ID of 1–8 A-string characters, an EBCDIC dot (period) character, and a
network name of 1–8 A-string characters.
cn_port_data.port_name
Name of the port. This is an 8-byte ASCII string, padded on the right with spaces if the name is shorter than
8 characters.
cn_port_data.tg_num
Transmission group number for the specified port.
3.98.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_CN_NAME
The
list_options parameter was set to AP_LIST_INCLUSIVE, to list all entries starting from the
supplied name, but the fqcn_name parameter was not valid.
AP_INVALID_PORT_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE, to list all entries starting from the
supplied name, but the port_name parameter was not valid.
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.98.5 Returned Parameters: Function Not Supported
If the verb does not execute successfully because the local node is a LEN node, SNAplus2 returns the following
parameters:
primary_rc
AP_FUNCTION_NOT_SUPPORTED
The local node is a LEN node. This verb is valid only at a network node or an end node.
3.98.6 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.99 QUERY_CONVERSATION
QUERY_CONVERSATION returns information about conversations using a particular local LU.
365