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
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
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.
