HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_TN3270_ACCESS
primary_rc
AP_OK
3.44.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_UNKNOWN_CLIENT_ADDRESS
The specified name or alias could not be mapped to a fully qualified name.
AP_CLIENT_ADDRESS_CLASH
The fully qualified name, resolved from the
client_address parameter, clashes with one that has already
been defined.
AP_TCPIP_PORT_IN_USE
The TCP/IP port number cannot be used by TN server because it is already in use by a different
program.
AP_INVALID_TN3270_SUPPORT
The tn3270_support parameter for one or more sessions 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.44.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.44.6 Using the Telnet Daemon’s TCP/IP Port
If you are setting up TN server for use with a TN3270 program that uses TCP/IP port number 23, you will need
to set up the HP-UX computer where the node owning this TN server runs, to share this port number between TN
server and the Telnet daemon program. To do this, take the following steps:
1. Ensure that the SNAplus2 software is stopped on the HP-UX computer.
2. Log on to the HP-UX computer as
root.
3. Edit the file /etc/inetd.conf, and find the line beginning with telnet. Make a note of the full pathname
for the Telnet daemon executable program, and any supplied parameters for this program, which are included
at the end of this line; typically these are /etc/telnetd and telnetd. Comment out this line by inserting
a # character at the start of the line, and save the file.
4. Create an ASCII text file /etc/snapinetd.conf. This file should consist of a single line containing the
Telnet daemon executable pathname and parameters, as determined in step 3, for example:
/etc/telnetd telnetd
5. Use the HP-UX ps command to find the process ID of the Internet daemon program inetd.
6. Use the HP-UX kill command to stop this process, by issuing the following command:
258