HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_EMULATOR_USER
The local node does not support PU concentration; this is defined by the pu_conc_support parameter
on the DEFINE_NODE verb.
3.24.7 Returned Parameters: Other Conditions
Appendix B, Common Return Codes, lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.25 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.
3.25.1 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? */
unsigned char user_is_group; /* Does user_name specify a group? */
unsigned char status; /* reserved */
unsigned char reserv2[14]; /* reserved */
} EMULATOR_USER_DEF_DATA;
150