HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
DEFINE_EMULATOR_USER
Chapter 3232
For compatability with future releases of SNAplus2,
your application must use this field to determine the
exact length of the overlay structure returned, and
should not rely on the use of the sizeof() function.
user_name
The name of the user or group. This is an ASCII string
of 1-32 characters, padded on the right with spaces if
the name is shorter than 32 characters, which must be
one of the following:
• The HP-UX user ID of a 3270 or 5250 user on the
SNAplus2 computer (or, for a Windows Client user,
the user name specified in the SNAplus2 client
network data file). The user_is_group parameter
below must be set to AP_NO.
• The HP-UX group ID of a group of 3270 or 5250
user on the SNAplus2 computer (or, for a Windows
Client user, the group name specified in the
SNAplus2 client network data file). The
user_is_group parameter below must be set to
AP_YES.
To set up a default record, which will be used by any
user not explicitly named in the configuration, specify
the name <DEFAULT> (in uppercase and including the
angle bracket characters), and set user_is_group to
AP_NO. To restrict use of the emulation program to
users and groups that are explicitly named in the
configuration, do not include a <DEFAULT> record.
When the user starts the emulation program,
SNAplus2 checks the user ID against the emulator
user records in the configuration to find the correct
record, in the following order:
• If the user ID matches a record for a specific user
name, this record is used.
• If the user ID cannot be matched but the user's
group ID matches a record for a group, this record
is used.