HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_TN3270_ACCESS
Specifies the level of TN3270 support. Possible values are:
AP_TN3270
Specifies that TN3270E protocols are disabled.
AP_TN3270E
Specifies that TN3270E protocols are enabled.
TN3270 and TN3287 protocols are always enabled.
For an AS/400 TN3270 client, this parameter must be set to AP_TN3270E.
allow_specific_lu
Indicates whether access to specific LUs is allowed. Possible values are:
AP_YES
Access to specific LUs is allowed.
AP_NO
Access to specific LUs is not allowed.
printer_lu_name
Name of the printer LU or LU pool that this session uses for connections requesting a generic printer LU.
This is a type-A EBCDIC string padded on the right with EBCDIC spaces. It must match the name of a LU
type 0–3 printer LU defined on this node, or an LU pool containing LUs on this node.
If a single printer LU is specified, this printer LU should not be associated with any display LU by the
DEFINE_TN3270_ASSOCIATION verb. If a printer LU pool is specified, none of the printer LUs in the
pool should be associated with display LUs. Allowing a single LU to be accessed as both a generic printer
LU and as an associated printer LU may result in the LU not being available as an associated printer LU
because it is already in use. (These rules are not enforced by the NOF API.)
This field has no effect on specific printer LU sessions.
port_number
The number of the server TCP/IP port that the TN3270 program uses to access the TN server node. If the
port number matches an existing port number defined for one of this TN3270 user’s sessions, the information
for that session is replaced; otherwise a new session is added.
If the TN3270 program 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 TN server and the Telnet daemon program. For more information, see Section 3.44.6,
Using the
Telnet Daemon’s TCP/IP Port.
lu_name
Name of the LU or LU pool that this session uses for connections requesting a generic display LU. This is
a type-A EBCDIC string padded on the right with EBCDIC spaces. It must match the name of a type 0–3
display LU defined on this node, or an LU pool containing LUs on this node.
If you specify an LU name, a TN3270 program with the specified TCP/IP address will be able to use only
one session at a time by connecting to the specified server port number on this TN server node. If you specify
an LU pool, the program can use multiple generic display LU sessions (or multiple copies of the program
can access generic display LU sessions using this TN server), up to the number of LUs on this node that are
available from the pool.
This parameter has no effect on specific display LU sessions.
3.44.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
257