HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_EMULATOR_USER
interface will display session numbers 2, 3, and 5 using the information defined for these names. (The names
SESS0001–SESS0010 are not displayed in the control interface; they are replaced by the long names
defined for these sessions in the 3270 style file.)
3270 sessions that are available for the user to remap to must be given names that are not in the range above.
The user will be able to access these sessions only if the
change_lu parameter (see above) allows the user to
remap sessions.
session_def_data.emulator_type
Type of the emulation program that uses this session. Possible values are:
AP_3270_SESSION
Session used for 3270 emulation
AP_5250_SESSION
Session used for 5250 emulation
session_def_data.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 the QUERY_EMULATOR_USER_DEF verb, but SNAplus2
does not make use of it.
For a 3270 session, the following fields are included:
session_def_data.session_variant.def_data_3270.lu_name
Name of the LU or LU pool that this session uses. This is an 8-byte type-A EBCDIC string, padded on the
right with EBCDIC spaces. It must match the name of a type 0–3 LU or LU pool that has already been
defined.
If you assign the session to an LU that is in an LU pool, SNAplus2 will try to use this LU when the session is
activated. If the LU is not available, SNAplus2 will then attempt to find a free LU from the pool (as though
the session had been assigned to the pool).
session_def_data.session_variant.def_data_3270.session_type
Type of the LU or pool (display or printer, and the screen model for display LUs). Possible values are:
AP_3270_DISPLAY_MODEL_2
Display model 2 (80 x 24)
AP_3270_DISPLAY_MODEL_3
Display model 3 (80 x 32)
AP_3270_DISPLAY_MODEL_4
Display model 4 (80 x 43)
AP_3270_DISPLAY_MODEL_5
Display model 5 (132 x 27)
AP_PRINTER
Printer LU. (This value is not valid if lu_name specifies an LU pool.)
session_def_data.session_variant.def_data_3270.model_override
Specifies whether the user has permission to change the session to use a different screen model from the one
specified. Possible values are:
AP_YES
154