HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_EMULATOR_USER
typedef struct session_def_data
{
AP_UINT16 sub_overlay_size; /* reserved */
unsigned char session_name[8]; /* Long session name */
unsigned char emulator_type; /* Emulator type - 3270 or 5250 */
unsigned char reserv1; /* reserved */
unsigned char description[32]; /* Session description */
unsigned char reserv2[16]; /* reserved */
union
{
SESSION_3270_DEF_DATA def_data_3270; /* definition of 3270 session */
SESSION_5250_DEF_DATA def_data_5250; /* definition of 5250 session */
} session_variant;
unsigned char reserv3[4]; /* reserved */
AP_UINT32 reserv4; /* reserved */
} SESSION_DEF_DATA;
typedef struct session_3270_def_data
{
unsigned char lu_name[8]; /* LU/pool name accessed */
unsigned char session_type; /* Session type - Model 2-5 or printer */
unsigned char model_override; /* Can the user override the model? */
} SESSION_3270_DEF_DATA;
typedef struct session_5250_def_data
{
unsigned char local_lu_alias[8]; /* Local LU alias */
unsigned char plu_alias[8]; /* Partner LU alias */
unsigned char fqplu_name[17]; /* Fully-qualified partner LU name */
unsigned char mode_name[8]; /* Mode name */
unsigned char session_type; /* Session type - display or printer */
} SESSION_5250_DEF_DATA;
3.25.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_EMULATOR_USER
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 Win16 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.
151