HP-UX SNAplus2 R7 Administration Command Reference

Administration Commands
define_tn3270_access
port_number
The number of the server TCP/IP port that the TN3270 emulator uses to access TN server. If the port
number matches an existing port number defined for one of this TN3270 sessions, the information for
that session is replaced; otherwise, a new session is added.
If the TN server uses TCP/IP port number
23 (the port number used by the Telnet daemon program on
the HP-UX computer), you will need to set up an additional initialization file to share this port number
between the TN server and the Telnet daemon program. For more information, see Section 2.54.4,
Using the Telnet Daemon’s TCP/IP Port.
lu_name
Name of the display LU or LU pool that this session uses for connections requesting a generic display
LU. This name is an 8-byte type-A character string. It must match the name of a type 0–3 display LU
defined on this node, or an LU pool containing display LUs on this node.
If you specify an LU name, the client with the specified TCP/IP address can use only one generic
display LU at a time through this TN server node. If you specify an LU pool, the client can use
multiple generic display LU sessions, up to the number of LUs on this node that are available from the
pool.
This parameter has no effect if the client requests access to a specific display LU.
2.54.2 Returned Parameters
No parameters are returned by SNAplus2 when this command executes successfully.
2.54.3 Error Return Codes
If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a
secondary return code to provide specific details about the reason for unsuccessful execution.
Parameter Check
If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
PARAMETER_CHECK
secondary_rc
UNKNOWN_CLIENT_ADDRESS
The name or alias specified by the client_address parameter could not be mapped to a fully qualified
name.
CLIENT_ADDRESS_CLASH
The fully qualified name, resolved from the client_address parameter, matches one that has already
been defined.
TCPIP_PORT_IN_USE
The TCP/IP port number specified by the port_number parameter cannot be used by TN server because
it is already in use by a different program.
State Check
No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands,
occur for this command.
Other Conditions
Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary
return codes that are common to all commands.
214