HP-UX SNAplus2 R7 NOF Programmer's Guide
NOF API Verbs
DEFINE_TP
AP_TN3270_NOP
Send Telnet NOP messages.
AP_TN3270_TM
Send Telnet DO TIMING-MARK messages.
def_data.keepalive_interval
Interval (in seconds) between consecutive keep-alive messages. The interval should be long enough to
minimize network traffic, especially if there are typically many idle client connections. The shorter the keep-
alive interval, the quicker failures are detected, but the more network traffic is generated. If the keep-alive
interval is too short and there are many clients, this traffic can be significant.
Typical values are in the range
600–7200 (10 minutes to 2 hours). The value 0 (zero) is not valid when the
keepalive_method parameter is set to AP_TN3270_NOP or AP_TN3270_TM.
Because of the way TCP/IP operates, the keepalive interval that you configure is not the exact time that it
will take for the server to recognize that a client has disappeared. The exact time depends on various factors,
but will be no more than twice the configured timeout plus a few extra minutes (the exact number depends
on how TCP/IP is configured).
3.46.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
3.46.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_KEEPALIVE
The keepalive_method 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.46.5 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.47 DEFINE_TP
The DEFINE_TP verb provides information that SNAplus2 needs to start a TP as a result of an incoming attach
from a partner LU. This verb can also be used to modify one or more fields on a previously defined TP.
262