3270 User Record Format
The format of the 3270 user record is shown below. The first structure definition is an LU/session information record, which includes details of a 3270 LU; the second is the 3270 user record, which includes a number of LU/session information records.
Note that the user record is not a fixed length, because the number of LU/session information records in the remap list is variable. The structures used below are provided simply as a template to allow you to map to the correct offset in the record.
typedef struct tecwrksd {
UCHAR cwshost[9];
USHORT cwsestyp;
USHORT cwsmodov;
USHORT cwspad;
} TECWRKSD;
Members
-
cwshost[9]
-
LU/pool name accessed.
-
cwsestyp
-
Session type (M2, M3, M4, M5, printer).
-
cwsmodov
-
Whether or not the user has override permission.
-
cwspad
-
Two bytes of padding.
typedef struct tecwrkus {
USHORT cwlen;
USHORT cwtype;
UCHAR cwname[21];
UCHAR cwremark[26];
UCHAR cwstylef[9];
USHORT cwvewrtm;
USHORT cwalert;
USHORT cwchghan;
USHORT cwmaxses;
USHORT cwnumrec;
TECWRKSD cwsesdat[10];
USHORT cwmodisf;
UCHAR cwstatus;
UCHAR cwpad;
USHORT cwnumrmp;
TECWRKSD cwremap[1];
} TECWRKUS;
Members
-
cwlen
-
Length of record.
-
cwtype
-
Type of record.
-
cwname[21]
-
User name.
-
cwremark[26]
-
Comment field.
-
cwstylef[9]
-
Initial style file name.
-
cwvewrtm
-
Whether or not user can view RTM information.
-
cwalert
-
Whether or not user has ALERT permission.
-
cwchghan
-
Whether or not user can change LU/pool name accessed.
-
cwmaxses
-
Maximum number of active sessions (1–10).
-
cwnumrec
-
Number of sessions for user.
-
cwsesdat[10]
-
Session information records.
-
cwmodisf
-
Permission to modify initial style.
-
cwstatus
-
Status byte: user or group.
-
cwpad
-
One byte of padding.
-
cwnumrmp
-
Number of LUs/pools in remap list.
-
cwremap[1]
-
LU/Pool remap list.
For Win32
Microsoft® SNA Server for Microsoft® Windows NT® and Microsoft® Windows® 95 permits configuration of more than 10 sessions per user. If this is done, the first 10 sessions are placed in the cwsesdat array with cwnumrec set to 10 and the remainder are placed in the location of the remap list. The cwnumrmp member indicates the number of TECWRKSD structures in the remap list. Note that this permits cwmaxses to be greater than cwnumrec.
The following paragraphs explain the meaning of each field in the structures, and indicate how the application should use it. The sections on configuring 3270 users and LUs in the Microsoft SNA Server Administration Guide should also be used as a cross-reference.
Members
-
cwshost
-
The name (up to eight characters) of the LU or LU pool that this session is configured to use. The application specifies this name on the Open(SSCP) Request.
-
cwsestyp
-
The LU type (display or printer) of the LU used by this session and (if it is a display LU or a pool of display LUs) the screen model. The possible values are:
CERTMOD2 (0) Model 2 display (24 by 80)
CERTMOD3 (1) Model 3 display (32 by 80)
CERTMOD4 (2) Model 4 display (43 by 80)
CERTMOD5 (3) Model 5 display (27 by 132)
CERTPRNT (4) Host printer
The application should use this value to distinguish between display and printer sessions and to set the appropriate screen model for display sessions.
-
cwsmodov
-
TRUE if the user has permission to override the screen model for display sessions — that is, to change the session to use a different screen model from the one configured. If this value is FALSE, the user should not be permitted to change the screen model. This field is not used for printer sessions and should not be checked.
-
cwlen
-
The length of the 3270 user record (this is variable because it contains a variable number of LU/session records in the remap list). The application should use this value to locate the start of the next 3270 user record when searching for the correct record.
-
cwtype
-
Identifies this as a 3270 user record.
-
cwname
-
The LAN Manager user name, or other identifying name, of the 3270 user (up to 20 characters). The application uses this to search for the correct 3270 user record.
-
cwremark
-
An optional comment field (up to 25 characters), used in the configuration program to give more information about the user (for example, the user's full name).
-
cwstylef
-
The name (up to eight characters) of the default style file used by this user (a file containing the user's 3270 customization settings, used by the SNA Server 3270 emulation programs). This field can be used to identify the equivalent file for your 3270 emulator, if appropriate.
If this field is blank, no style file is used and the 3270 emulator should revert to its default settings (unless overridden by a style file specified by the user).
-
cwvewrtm
-
TRUE if this user is permitted to view a display of Response Time Monitor (RTM) statistics for his or her 3270 sessions. If this field is FALSE, the application should not display RTM statistics and should not display a last transaction time indicator (LTTI) on the status line of display sessions. See Diagnostics Record Format for more information on the use of RTM.
-
cwalert
-
TRUE if the user is permitted to send NetView user alerts. If this field is FALSE, the user should not be permitted to send alerts. See Diagnostics Record Format for more information on the use of alerts.
-
cwchghan
-
TRUE if the user is permitted to remap a 3270 session to use a different LU (in which case it can be changed to use any LU in the remap list—see cwremap). If this field is FALSE, the application should not allow the user to remap sessions.
-
cwmaxses
-
The maximum number of active sessions permitted to this user. If the number of sessions configured (see cwnumrec) is greater than this, the user must not be allowed to activate more sessions at a time than this field specifies.
-
cwnumrec
-
The total number of sessions configured for this user. The user record always contains 10 LU/session records (see cwsesdat), but only this number of the records will be used—the remainder will be filled with zeros.
-
cwsesdat
-
Ten LU/session records. Some of these records can be filled with zeros, indicating that they are unused (cwnumrec gives the number of sessions that are used). The application should list, and allow the user to use, only the sessions that have valid session records here.
-
cwmodisf
-
TRUE if the user is permitted to modify the initial 3270 customization. If this field is FALSE, the application should use the customization defined by cwstylef (if specified); the user should not be allowed to make changes to this style, or to override it by loading a different style file.
-
cwstatus
-
Indicates whether the user name in this record is to a LAN Manager user name or group name. The least significant bit of this byte is CERTGRUP (1) for a group, and zero for a user. Other bits are not used.
-
cwpad
-
Pad byte—not used by the application.
-
cwnumrmp
-
The number of LU/session records in the remap list (see cwremap).
-
cwremap
-
The list of LU/session records, which indicates the LUs to which the user can remap sessions (if any). If the user is not permitted to remap sessions (see cwchghan), this list is not used and should not be checked by the application.