HP UX Internet and Networking Software manual 214

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