Jump to content

IBM OS/2 User Profile Management: Difference between revisions

From EDM2
← Older edit
Ak120 (talk | contribs)
35,819 edits
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This component came since OS/2 1.3 EE. It is where the users Logon to have access to other services like LAN Requester or Database Manager. This component is also part of "IBM OS/2 LAN Server".  
[[File:UPM-OS2V12.png|thumb|User Profile Management]]
This component was introduced in OS/2 EE 1.2. It controls local user access and provides services to other services like LAN Requester or [[Database Manager]].


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


==Documentation==
==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.
|}


==Files==
===Data Types===
*LSFAR


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


 
===Return Codes===
===\muglib===
{|class="wikitable"
{| border="1"
!Symbolic Constant||Meaning
|-
|UPM_ACTIVE||The domain logon or logoff failed. A domain logon, logoff or the LAN Requester GUI is active.
|-
|UPM_BAD_PARAMETER||The remote name is not valid.
|-
|UPM_BAD_TYPE||The remote type specified is not valid.
|-
|UPM_ERROR_MORE_DATA||All the available UPM_USER_LOGON entries did not fit into buf.
|-
|UPM_FAIL_SECURITY||The user ID or remote name could not be validated.
|-
|-
!Name !!Comments
|UPM_LOG_CANCEL||The user is cancelled from the logon panel.
|-
|-
||[[LANLOGON.ICO]]||
|UPM_LOG_FILE_NOT_FOUND||A required logon program was not found.
|-
|-
||[[LOGOFF.EXE]]||
|UPM_LOG_INPROC||Another logon was being processed, the logon attempt was not successful.
|-
|-
||[[LOGOFF.ICO]]||
|UPM_LOGGED||The domain logon failed because a domain logon has already occurred.
|-
|-
||[[LOGON.EXE]]||
|UPM_NOMEM||Insufficient memory is available to process the request.
|-
|-
||[[LOGON.ICO]]||
|UPM_NOT_LOGGED||The user has not logged on locally.
|-
|-
||[[LOGONIBM.EXE]]||
|UPM_OK||The user was logged on successfully.
|-
|-
||[[MUGACCTS.EXE]]||
|UPM_OPEN_SESSIONS||The domain logoff failed because a domain logon has active open sessions.
|-
|-
||[[MUGLEXEC.EXE]]||
|UPM_PASSWORD_EXP||The logon failed. The user's password is expired.
|-
|-
||[[MUGLRQST.EXE]]||
|UPM_SS_BUSY||The local logon failed. The secure shell was busy.
|-
|-
||[[MUGMSG.MSG]]||
|UPM_SS_DEAD||The local logon failed. The secure shell has stopped.
|-
|-
||[[MUGW.HLP]]||
|UPM_SS_PWDEXPWARNING||The local logon succeeded. The user's password is expired.
|-
|-
||[[MUGWEPOP.EXE]]||
|UPM_SYS_ERROR||An unexpected system error occurred.
|-
|-
||[[MUGWLOGF.EXE]]||
|UPM_ULP_LOADED||The local logon failed. A local logon with a user logon profile is already active.
|-
|-
||[[SYSLEVEL.MUG]]||
|UPM_UNAVAIL||The local logon failed. The remote node or domain could not be contacted to process the logon request.
|}
 
==Files==
{|class="wikitable"
|+\MUGLIB
!Name||Comments
|-
|-
||[[SYSLEVEL.UPE]]||
|LANLOGON.ICO||icon for LAN logon
|-
|-
||[[UPM.CB]]||
|LOGOFF.EXE||logoff
|-
|-
||[[UPM.FOR]]||
|LOGOFF.ICO||icon for logoff
|-
|-
||[[UPM.INC]]||
|LOGON.EXE||logon
|-
|-
||[[UPMACCTS.EXE]]||
|LOGON.ICO||icon for local logon
|-
|-
||[[UPMACCTS.ICO]] ||
|MUGACCTS.EXE||
|-
|-
||[[UPMCSET.EXE]] ||
|MUGLEXEC.EXE||
|-
|-
||[[UPMFLDR.ICO]]||
|MUGLRQST.EXE||
|-
|-
|}
|MUGMSG.MSG||message catalogue
 
|-
===\muglib\DLL===
|MUGW.HLP||online help
 
{| border="1"
|-
|-
!Name !!Comments
|MUGWEPOP.EXE||
|-
|-
|| [[MAILSLOT.DLL]]  || Mailslot APIs provide one-way interprocess communication (IPC).
|MUGWLOGF.EXE||
|-
|-
|| [[MUG.DLL]]  ||
|SYSLEVEL.MUG||
|-
|-
|| [[NETAPI.DLL]]  ||
|SYSLEVEL.UPE||
|-
|-
|| [[NETAPI32.DLL]]  ||
|UPM.CB||
|-
|-
|| [[NETAPINC.DLL]]  ||
|UPM.FOR||
|-
|-
|| [[NETOEM.DLL]]  ||
|UPM.INC||include
|-
|-
|| [[NETSPOOL.DLL]] ||
|UPMACCTS.EXE||User Account Management
|-
|-
|| [[UPM.DLL ]]  ||
|UPMACCTS.ICO||icon for account
|-
|-
|| [[UPM32.DLL ]]  ||
|UPMCSET.EXE||character set check
|-
|-
|UPMFLDR.ICO||icon for folder
|}
|}


==Articles==
{|class="wikitable"
|+\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==
==Publications==
* OPEN32.INF - OS/2 Server Family Programming Reference  [http://cyberkinetica.homeunix.net/os2tk45/srvfpgr/]
*GG24-3559-00 - ''IBM OS/2 Extended Edition 1.2 Cookbook: Database Manager - User Profile Management'' - 1990
 
==Replacements==


==Links==
==Links==
* [https://archive.org/download/IBMOS2Warp4ToolkitDocuments2/srvfpgr.inf OS/2 Server Family Programming Reference]


[[Category:Components]]
[[Category:Components]]

Latest revision as of 23:11, 23 October 2019

User Profile Management

This component was introduced in OS/2 EE 1.2. It controls local user access and provides services 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 Types

  • LSFAR

UPM Logon 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_ACTIVE The domain logon or logoff failed. A domain logon, logoff or the LAN Requester GUI is active.
UPM_BAD_PARAMETER The remote name is not valid.
UPM_BAD_TYPE The remote type specified is not valid.
UPM_ERROR_MORE_DATA All the available UPM_USER_LOGON entries did not fit into buf.
UPM_FAIL_SECURITY The user ID or remote name could not be validated.
UPM_LOG_CANCEL The user is cancelled from the logon panel.
UPM_LOG_FILE_NOT_FOUND A required logon program was not found.
UPM_LOG_INPROC Another logon was being processed, the logon attempt was not successful.
UPM_LOGGED The domain logon failed because a domain logon has already occurred.
UPM_NOMEM Insufficient memory is available to process the request.
UPM_NOT_LOGGED The user has not logged on locally.
UPM_OK The user was logged on successfully.
UPM_OPEN_SESSIONS The domain logoff failed because a domain logon has active open sessions.
UPM_PASSWORD_EXP The logon failed. The user's password is expired.
UPM_SS_BUSY The local logon failed. The secure shell was busy.
UPM_SS_DEAD The local logon failed. The secure shell has stopped.
UPM_SS_PWDEXPWARNING The local logon succeeded. The user's password is expired.
UPM_SYS_ERROR An unexpected system error occurred.
UPM_ULP_LOADED The local logon failed. A local logon with a user logon profile is already active.
UPM_UNAVAIL The local logon failed. The remote node or domain could not be contacted to process the logon request.

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
MUGACCTS.EXE
MUGLEXEC.EXE
MUGLRQST.EXE
MUGMSG.MSG message catalogue
MUGW.HLP online help
MUGWEPOP.EXE
MUGWLOGF.EXE
SYSLEVEL.MUG
SYSLEVEL.UPE
UPM.CB
UPM.FOR
UPM.INC include
UPMACCTS.EXE User Account Management
UPMACCTS.ICO icon for account
UPMCSET.EXE character set check
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

Retrieved from "https://www.edm2.com/index.php?title=IBM_OS/2_User_Profile_Management&oldid=64372"