HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_TN3270_ASSOCIATION
opcode
AP_DEFINE_TN3270_ASSOCIATION
display_lu_name
Name of the display LU to be associated with the printer that was specified by the def_data.printer_lu_name
parameter. This is a type-A EBCDIC string padded on the right with EBCDIC spaces.
The specified display LU should be a display LU defined on the local node, but this is not enforced by the
NOF API.
def_data.description
Description of the association being defined. This parameter is optional.
def_data.printer_lu_name
Name of the printer LU to be associated with the display LU that was specified by the display_lu_name
parameter. This is a type-A EBCDIC string padded on the right with EBCDIC spaces.
The specified printer LU should be a printer LU defined on the local node.
It is not possible for a single printer LU to be shared by two TN3270E emulators; no two TN3270 associations
can specify the same printer LU.
The printer LU should not be accessible as a generic printer LU; otherwise it may not be available as an
associated printer LU because it is already in use. Therefore, the associated printer LU should not be configured
(directly or indirectly as a member of an LU pool) as the printer_lu_name in a DEFINE_TN3270_ACCESS
verb.
(These rules are not enforced by the NOF API.)
3.45.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
3.45.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_LU_NAME
Either the supplied display LU name or the supplied printer LU name was not a valid EBCDIC string.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.45.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
260