home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / SAM.ZIP / SAM.DOC < prev    next >
Text File  |  1991-01-28  |  3KB  |  77 lines
  1.          OS/2 System Administration Utility 
  2.          ==================================
  3.  
  4. SAM is a program package, that allows to boot OS/2 with different
  5. profiles (OS2.INI, normally placed in the OS2-directory).
  6. In this way every user can tailor its own, private "OS/2-outlook",
  7. provided by the Desktop Manager and the Control Panel.
  8.  
  9. Because the management of this PM-Initialization is contained in
  10. two files, I'll enumerate the contents of these files in brief:
  11. The "system initialization file" OS2SYS.INI contains:
  12.   -  Names of ports
  13.   -  Names of printers and printer drivers
  14.   -  Names of queues
  15.   -  The spooler path
  16. The "user initialization file" OS2.INI contains:
  17.   -  Screen colors
  18.   -  Default printer and queue
  19.   -  Desktop Manager list
  20.   -  Application settings
  21. (see OS/2 CP and PM Programming Guide Version 1.2, IBM).
  22.  
  23. This package consists of two executable files: SAM.EXE and INITOS2.EXE.
  24. The first is a PM-application, that interactively sets up a private
  25. environment. That is, it creates a file *.USR, which contains the
  26. shell, their parameters and a password, if necessary. Therefore it is
  27. intended for use only by a "system administrator".
  28.  
  29. The second program is a full-screen application, that is called on
  30. boot-time instead of the OS/2-Shell (PMSHELL.EXE). It prompts for a
  31. user name, looks for the *.USR file and reads the name of the
  32. shell and their parameters. Afterwards it starts this shell (by means
  33. of a synchronous DosExecPgm after freeing all allocated memory and
  34. stopping all unnecessary threads).
  35.  
  36. Optionally, an "Auto-User" may be defined. This is a default-Username, 
  37. which is started, when the user-prompt of INITOS2.EXE isn't answered
  38. within a specified time.
  39.  
  40. Installation:
  41. -------------
  42. 1. Create a new directory (e.g. C:\LOGIN)
  43. 2. Copy SAM.EXE and INITOS2.EXE into this directory
  44. 3. Place a 'REM' at the beginning of the PROTSHELL statement in the
  45.    CONFIG.SYS file
  46. 4. Insert a new PROTSHELL statement:
  47.     PROTSHELL=path\INITOS2.EXE loginpath
  48.    where path is the path to INITOS2.EXE and loginpath is the path, where
  49.    you want to place you user definition files. Example:
  50.         PROTSHELL=C:\LOGIN\INITOS2.EXE C:\LOGIN
  51. 5. Create at least one user with SAM. You have to start SAM out of the
  52.    loginpath or must add this loginpath to the invocation command:
  53.     SAM C:\LOGIN
  54.  
  55.    Two userfull examples for users are the following:
  56.    - GUEST:
  57.         PROTSHELL:         C:\OS2\PMSHELL.EXE
  58.         User Profile:      C:\LOGIN\GUEST.INI
  59.         Sys Profile:       C:\OS2\OS2SYS.INI
  60.         Protshell Options: C:\OS2\CMD.EXE /K C:\OS2INIT.CMD
  61.         Password:          (none)
  62.  
  63.    - QUICK:
  64.         PROTSHELL:         C:\OS2\CMD.EXE
  65.         User Profile:      (none)
  66.         Sys Profile:       (none)
  67.         Protshell Options: /K C:\OS2INIT.CMD
  68.         Password:          (???)
  69.  
  70.      The 'QUICK'-User sets up a DOS-like environment with one full screen
  71.      session but with all the multitasking and protected mode capabilities
  72.      of OS/2. It is useful, if you have a slow computer and want quickly
  73.      boot it only to copy some files or something else.
  74.  
  75. The SAM.RC and SAM.H files are delivered with this package. Thus you are
  76. able to convert this application to your favourite language.
  77.