HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
DEFINE_EMULATOR_USER
Chapter 3230
DEFINE_EMULATOR_USER
DEFINE_EMULATOR_USER identifies a user of the SNAplus2 system
that can use 3270 emulation or 5250 emulation, and defines the
resources available to that user. It can be used to define a new user, to
define new sessions for use by an existing user, or to modify the user
parameters and session parameters for an existing user. (To delete
sessions from an existing user, use DELETE_EMULATOR_USER.)
This verb must be issued to the domain configuration file.
VCB Structure
The DEFINE_EMULATOR_USER verb contains a variable number of
session_def_data structures; these define the user's sessions and
(optionally) the user's remap list. The session structures are included at
the end of the def_data structure; the number of these structures is
specified by the num_sessions parameter.
typedef struct define_emulator_user
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char user_name[32]; /* 3270 user name */
EMULATOR_USER_DEF_DATA def_data;
} DEFINE_EMULATOR_USER;
typedef struct emulator_user_def_data
{
unsigned char description[32]; /* Description - null terminated */
unsigned char reserv3[16]; /* reserved */
unsigned char style_file[9]; /* Initial 3270 style file name */
/* - null terminated */
unsigned char reserv1[3]; /* reserved */
AP_UINT32 num_sessions; /* Number of sessions being added */
AP_UINT32 max_act_sessions; /* Max number of active 3270 sessions */
unsigned char view_rtm; /* Can user view RTM info? */
unsigned char alert_permission; /* Can user send alerts? */
unsigned char change_lu; /* Can user change LU/Pool accessed? */
unsigned char change_style; /* Can user modify initial style file? */