HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_TN3270_ACCESS_DEF
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.159.5 Returned Parameters: State Check
If the verb does not execute because of a state error, SNAplus2 returns the following parameters.
primary_rc
AP_STATE_CHECK
secondary_rc
Possible values are:
AP_LINK_DEACTIVATED
The specified link is not currently active.
AP_PORT_DEACTIVATED
The specified port is not currently active.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_STATE_CHECK
, which
are common to all NOF verbs.
3.159.6 Returned Parameters: Function Not Supported
If the verb does not execute because the DLC type does not support returning statistics information, SNAplus2
returns the following parameter:
primary_rc
AP_FUNCTION_NOT_SUPPORTED
3.159.7 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.160 QUERY_TN3270_ACCESS_DEF
QUERY_TN3270_ACCESS_DEF returns information about TN3270 users on other computers that can use the TN
server feature of SNAplus2 to access a host for 3270 emulation.
This verb can return either summary or detailed information, about a single user or multiple users, depending on
the options used.
3.160.1 VCB Structure
typedef struct query_tn3270_access_def
{
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 */
668