HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_TN3270_ACCESS
AP_NO
This verb defines a normal TN3270 user record.
A default record provides access to the TN server function for any TN3270 user that can determine the TCP/
IP address of the computer where the TN server is running. To restrict the use of TN server to a speci
fic
group of users, either do not include the default record, or leave it with no 3270 LU or LU pool con
figured
so that it cannot be used.
You can also set up a default record for most users, but explicitly exclude one or more TCP/IP addresses. To
do this, define the addresses to be excluded as TN server users, and leave them with no 3270 LU or LU pool
configured.
client_address
The TCP/IP address of the computer on which the TN3270 program runs. This is a string of 1–64 characters;
the remaining bytes in the string should be set to nulls.
The address can be specified as a dotted-decimal IP address (such as
193.1.11.100), as a name (such as
newbox.this.co.uk), or as an alias (such as newbox); the format is indicated by the address_format
parameter.
If you use a name or alias, the following restrictions apply:
• The HP-UX system must be able to resolve the name or alias to a fully qualified name (either using the
local TCP/IP configuration or using a Domain Name server).
• Each name or alias must expand to a unique fully qualified name; you should not configure two names
for users of the same TN server node that will be resolved to the same fully qualified name.
• Fully-qualified names are not case-sensitive; for example, Newbox.THIS.CO.UK is equivalent to
newbox.this.co.uk.
def_data.description
An optional text string (0–31 characters followed by a null character). The string is for informa-
tion only; it is stored in the configuration file and returned on a
query_tn3270_access_def structure for a
QUERY_TN3270_ACCESS_DEF verb, but SNAplus2 does not make use of it. You can use it to store addi-
tional information to help distinguish between users.
def_data.address_format
Specifies the format of the client_address parameter. Possible values are:
AP_ADDRESS_IP
IP address
AP_ADDRESS_FQN
Alias or fully qualified name
def_data.num_sessions
The number of sessions being defined or modified by this verb. Each TN3270 user may access the same TN
server node with multiple sessions, by using a different TCP/IP port for each session. Each session must be
specified by a
tn3270_session_def_data structure following the
tn3270_access_def_data structure.
For each session, a
tn3270_session_data structure is required with the following information:
description
An optional text string (0–31 characters followed by a null character). The string is for information
only; it is stored in the configuration file and returned on a
query_tn3270_access_def structure for a
QUERY_TN3270_ACCESS_DEF verb, but SNAplus2 does not make use of it.
tn3270_support
256