View source for SESMGR.DLL

This file is the session manager dynamic link library. This file is part of the Session manager API. 

This DLL is part of OS/2's [[Control Program]]. 

On the latest version of OS/2, this file forwards it's functions to DOSCALL. 


The SESMGR API is pretty old, probably existing in OS/2 1.0 already, and thus most functions are 16 bit APIs. What you see and what you get through SESMGR.DLL is only the top of the iceberg; the kernel symbol table shows a lot of more SESMGR related functions; however these are not exported (by means of DOSCALLS entry points), so they are not usable, effectively. It appears that this API has been reduced to provide exactly the functions only that are required in certain programs, like TSHELL.EXE, PMMERGE.DLL, and HARDERR.EXE.

The general idea is the following: a single program, called the session shell or below, the shell owning the session manager will perform all session handling for the system. It will call DOSSMINITIALIZE and create a few notification threads (see Tshell description - to be published in the future) that control the way sessions will switched between foreground and background.

The session shell typically has a menue or alike to control how to dispatch sessions. In normal PM, this is what you can do with ALT-ESC and CTRL-ESC keys.

For switching between fullscreen sessions, as well as switching between FS and windowed mode of a DOS session, the session manager allows drivers to intercept the process before and after doing screen save/restore (this is actually what is needed for proper handling of switching between XFree86 and PM---in XFree86 it is emulated without SESMGR; thus it sometimes fails).

SESMGR also serializes error popups using screen locks, i. e. a process can ask the session manager to block change of sessions as long as it is displaying a modal box, for instance. 

==Version==

{| class="wikitable"
|-
! Date !!Version !! Size  !! Comments
|-
| 9-17-11  6:13a || 14.100 || 1,360 bytes || @#osFree:14.100#@  Session Manager API.
|-
| 2012/Aug/27 10:55:04 am || -	|| 3,136 bytes || Included on eComStation 2.1
|-
|}

==DLL Entry Points==                            
{| border="1"
|-
|1
|[[OS2 API:CPI:LEGACY:DosSMSGDoPopup|DosSMSGDoPopup]]
|2
|[[OS2 API:CPI:LEGACY:DosSMSwitch|DosSMSwitch]]
|-
|3
|[[OS2 API:CPI:LEGACY:DosSMServeAppReq|DosSMServeAppReq]]
|4
|[[OS2 API:CPI:LEGACY:DosGetTimes|DosGetTimes]]
|-
|5
|[[OS2 API:CPI:LEGACY:DosSMSetTitle|DosSMSetTitle]]
|6
|[[OS2 API:CPI:LEGACY:DosScrUnlock|DosScrUnlock]]
|-
|7
|[[OS2 API:CPI:LEGACY:DosSMDoAppReq|DosSMDoAppReq]]
|8
|[[OS2 API:CPI:DosStopSession|DosStopSession]]
|-
|9
|[[OS2 API:CPI:DosSelectSession|DosSelectSession]]
|10
|[[OS2 API:CPI:LEGACY:DosScrLock|DosScrLock]]
|-
|11
|[[OS2 API:CPI:LEGACY:DosSavRedrawWait|DosSavRedrawWait]]
|12
|[[OS2 API:CPI:LEGACY:DosSavRedrawUndo|DosSavRedrawUndo]]
|-
|13
|[[OS2 API:CPI:LEGACY:DosSMSGEndPopup|DosSMSGEndPopup]]
|14
|[[OS2 API:CPI:DosSetSession|DosSetSession]]
|-
|15
|[[OS2 API:CPI:LEGACY:DosSetMNLockTime|DosSetMNLockTime]]
|16
|[[OS2 API:CPI:LEGACY:DosModeUndo|DosModeUndo]]
|-
|17
|[[OS2 API:CPI:DosStartSession|DosStartSession]]
|18
|[[OS2 API:CPI:LEGACY:DosSMGetStatus|DosSMGetStatus]]
|-
|19
|[[OS2 API:CPI:LEGACY:DosModeWait|DosModeWait]]
|20
|[[OS2 API:CPI:LEGACY:DosSMTerminate|DosSMTerminate]]
|-
|21
|[[OS2 API:CPI:LEGACY:DosSMGetAppReq|DosSMGetAppReq]]
|22
|[[OS2 API:CPI:LEGACY:DosSMRealPrtSc|DosSMRealPrtSc]]
|-
|23
|[[OS2 API:CPI:LEGACY:DosSMInitialize|DosSMInitialize]]
|24
|[[OS2 API:CPI:LEGACY:DosSMStart|DosSMStart]]
|-
|25
|[[OS2 API:CPI:LEGACY:DosSMParentSwitch|DosSMParentSwitch]]
|26
|[[OS2 API:CPI:LEGACY:DosSMPause|DosSMPause]]
|-
|27
|[[OS2 API:CPI:LEGACY:DosSMHDEInit|DosSMHDEInit]]
|28
|[[OS2 API:CPI:LEGACY:DosSMPMPresent|DosSMPMPresent]]
|-
|29
|[[OS2 API:CPI:LEGACY:DosSMRegisterDD|DosSMRegisterDD]]
|30
|[[OS2 API:CPI:LEGACY:DosSMSysInit|DosSMSysInit]]
|-
|31
|[[OS2 API:CPI:LEGACY:DosSMNotifyDD|DosSMNotifyDD]]
|32
|[[OS2 API:CPI:LEGACY:DosSMNotifyDD2|DosSMNotifyDD2]]
|-
|33
|[[OS2 API:CPI:LEGACY:DosSMOpenDD|DosSMOpenDD]]
|34
|[[OS2 API:CPI:LEGACY:QhKeybdHandle|QhKeybdHandle]]
|-
|35
|[[OS2 API:CPI:LEGACY:QhMouseHandle|QhMouseHandle]]
|36
|[[OS2 API:CPI:LEGACY:DosSMSetSessionType|DosSMSetSessionType]]
|-
|37
|[[OS2 API:CPI:Dos32StartSession|Dos32StartSession]]
|38
|[[OS2 API:CPI:Dos32SelectSession|Dos32SelectSession]]
|-
|39
|[[OS2 API:CPI:Dos32SetSession|Dos32SetSession]]
|40
|[[OS2 API:CPI:Dos32StopSession|Dos32StopSession]]
|-
|41
|[[OS2 API:CPI:LEGACY:DosRegisterNotification|DosRegisterNotification]]
|}

==DLL's Loaded==
* [[DOSCALL1.DLL]]

[[image:SESMGR-PMDLL.png]]


==Alternative Version==
OSFree Project produced an alternative version of this file. 

[[Category:Files]]