IBM OS/2 User Profile Management: Difference between revisions

Revision as of 15:50, 12 September 2017

This component was introduced in OS/2 EE 1.2. It is where the users Logon to have access to other services like LAN Requester or Database Manager.

IBM OS/2 User Profile Management is located in the \MUGLIB\ directory.

API

Function Calls

16-bit	32-bit
UPMELOCL	U32ELOCL	Invokes UPM to display a local logon window.
UPMELOCU	U32ELOCU	Retrieves an ID of a local user that already is logged on to the system.
UPMEULGF	U32EULGF	Logs a user off the system.
UPMEULGN	U32EULGN	Logs on a user.
UPMEUSRL	U32EUSRL	Returns a list of logged-on user IDs.

Data Structure

struct upm_user_logon {
   unsigned char       userid [UPM_UIDLEN + 1];
   short               remotetype;
   unsigned char       remotename [UPM_REMLEN + 1];
   LSINT               sessionid;
};

Return Codes

Symbolic Constant	Meaning
UPM_OK	The call was completed successfully.
UPM_ERROR_MORE_DATA	All the available UPM_USER_LOGON entries did not fit into buf.
UPM_BAD_TYPE	The remote type specified is not valid.
UPM_BAD_PARAMETER	The remote name is not valid.
UPM_NOMEM	Insufficient memory is available to process the request.
UPM_SYS_ERROR	An unexpected system error occurred.

Files

\MUGLIB
Name	Comments
LANLOGON.ICO	icon for LAN logon
LOGOFF.EXE	logoff
LOGOFF.ICO	icon for logoff
LOGON.EXE	logon
LOGON.ICO	icon for local logon
LOGONIBM.EXE
MUGACCTS.EXE
MUGLEXEC.EXE
MUGLRQST.EXE
MUGMSG.MSG	messages
MUGW.HLP	help
MUGWEPOP.EXE
MUGWLOGF.EXE
SYSLEVEL.MUG
SYSLEVEL.UPE
UPM.CB
UPM.FOR
UPM.INC	include
UPMACCTS.EXE	account management
UPMACCTS.ICO	icon for account
UPMCSET.EXE
UPMFLDR.ICO	icon for folder

\MUGLIB\DLL
Name	Comments
MAILSLOT.DLL	Mailslot APIs provide one-way interprocess communication (IPC).
MUG.DLL
NETAPI.DLL	LAN Manager Library. Also operates on the basis of the OS/2 and NBF protocol
NETAPI32.DLL
NETAPINC.DLL
NETOEM.DLL
NETSPOOL.DLL
UPM.DLL
UPM32.DLL

Publications

GG24-3559-00 - IBM OS/2 Extended Edition 1.2 Cookbook: Database Manager - User Profile Management - 1990

Links

OS/2 Server Family Programming Reference

@@ Line 2: / Line 2: @@
 IBM OS/2 User Profile Management is located in the \MUGLIB\ directory.
+==API==
+===Function Calls===
+{|class="wikitable"
+!16-bit||32-bit||
+|-
+|UPMELOCL||U32ELOCL||Invokes UPM to display a local logon window.
+|-
+|UPMELOCU||U32ELOCU||Retrieves an ID of a local user that already is logged on to the system.
+|-
+|UPMEULGF||U32EULGF||Logs a user off the system.
+|-
+|UPMEULGN||U32EULGN||Logs on a user.
+|-
+|UPMEUSRL||U32EUSRL||Returns a list of logged-on user IDs.
+|}
+===Data Structure===
+ struct upm_user_logon {
+    unsigned char       userid [UPM_UIDLEN + 1];
+    short               remotetype;
+    unsigned char       remotename [UPM_REMLEN + 1];
+    LSINT               sessionid;
+ };
+===Return Codes===
+{|class="wikitable"
+!Symbolic Constant||Meaning
+|-
+|UPM_OK||The call was completed successfully.
+|-
+|UPM_ERROR_MORE_DATA||All the available UPM_USER_LOGON entries did not fit into buf.
+|-
+|UPM_BAD_TYPE||The remote type specified is not valid.
+|-
+|UPM_BAD_PARAMETER||The remote name is not valid.
+|-
+|UPM_NOMEM||Insufficient memory is available to process the request.
+|-
+|UPM_SYS_ERROR||An unexpected system error occurred.
+|}
 ==Files==
@@ Line 75: / Line 116: @@
 |[[UPM32.DLL]]||
 |}
-==Documentation==
-* [http://cyberkinetica.homeunix.net/os2tk45/srvfpgr/] - OS/2 Server Family Programming Reference
 ==Publications==
 *GG24-3559-00 - ''IBM OS/2 Extended Edition 1.2 Cookbook: Database Manager - User Profile Management'' - 1990
+==Links==
+* [http://cyberkinetica.homeunix.net/os2tk45/srvfpgr/ OS/2 Server Family Programming Reference]
 [[Category:Components]]