HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_EMULATOR_USER
Specifies whether the user has permission to change the mapping of 3270 sessions to LUs, either by remapping
them from within the 3270 user interface, or by specifying LU names on the command line when starting the
3270 emulation program. (For a 5250-only user, this field is ignored.) Possible values are:
AP_YES
The user can change the LU/session mapping.
AP_NO
The user cannot change the LU/session mapping.
def_data.change_style
Specifies whether the user has permission to load style files, modify style files, or both. Possible values are:
AP_STYLE_ADVANCED
The user can specify a style file name when starting the emulation program, and can create or modify
style files using the emulation program’s menu interface.
AP_STYLE_NORMAL
The user can specify a style file name when starting the emulation program, and can create or modify
style files using the emulation program’s menu interface. The user cannot modify the default style file
specified by the
style_file parameter.
The 3270 emulation program does not distinguish between the two values AP_STYLE_ADVANCED and
AP_STYLE_NORMAL; to prevent users from modifying the default style file, set the permissions on
this file so that users do not have write access to it.
AP_STYLE_INITIAL
The user can specify a style file name on the command line when starting the emulation program, but
cannot load, create, or modify style files from within the menu interface. This option allows you to
provide a choice of standard initial style files for a user.
AP_STYLE_RESTRICTED
The user is restricted to the default style file specified by the style_file parameter, and cannot create or
modify style files.
def_data.user_is_group
Specifies whether the user_name parameter identifies a user name or a group name. Possible values are:
AP_YES
The user_name parameter identifies a group name. Any user in this group will use this emulator user
record unless there is an explicit record for the user’s user name.
AP_NO
The user_name parameter identifies a user name.
For each session being defined by this verb, up to the number specified in num_sessions,a
session_def_data structure
is required with the following information:
session_def_data.session_name
A name identifying the session. This is an 8-byte ASCII string, padded on the right with spaces if the name is
shorter than 8 characters. If the name matches an existing session name defined for this user, the information
for that session is replaced; otherwise a new session is added.
To define 3270 sessions that are initially displayed in the 3270 emulation program’s control interface, specify
a name in the range SESS0001–SESS0010. These names correspond to the session numbers 1–10 in
the control interface; that is, if you use the names SESS0002, SESS0003, and SESS0005, the control
153