home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / sysutl / xuser11.lbr / XUSER11.DQC / XUSER11.DOC
Encoding:
Text File  |  1987-01-24  |  3.4 KB  |  116 lines
  1.  
  2. ___/Documentation for XUSER.COM  by John Evancie\___
  3.  
  4.     FOG contribution, July, 1985
  5.  
  6. _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .
  7.  
  8.   What is XUSER.COM?
  9.  
  10. It is a program to emulate and extend CPM's built-in
  11. USER function, allowing access to areas 0 thru 31, 
  12. inclusive. CPM version 2.0 or higher is required.
  13.  
  14. _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .
  15.  
  16.  
  17.   Why is it needed?
  18.  
  19.  
  20. If you work with user areas, you may be interested
  21. in this program for two reasons:
  22.  
  23.     - it extends the range of areas open to you
  24.  
  25.     - it emulates the built-in USER function,
  26.       so you can reach it from within an 
  27.           application that restricts you to external 
  28.           commands (e.g., WordStar's "R" option)
  29.  
  30.  
  31. _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .
  32.  
  33.  
  34.    How is it used?
  35.  
  36.  
  37. Simple! Just type:
  38.  
  39.  
  40.  XUSER nn<cr>
  41.  
  42.    This will switch you into User Area nn, for
  43.    nn between 0 and 31, inclusive; if nn is 
  44.    omitted, you are returned to User Area 0.
  45.    (that <cr> means press RETURN)
  46.  
  47. You can execute this command at the A> prompt, or 
  48. from within WordStar (via the "R" option)
  49.  
  50. _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .
  51.  
  52.    How does it work?
  53.  
  54.  
  55. The program makes use of BDOS function call 32 to
  56. set and then get CPM's current User Area. First the
  57. command line is checked, and the target user area is
  58. extracted and stashed in the E register. BDOS # 32
  59. is called to set the new area.  (The requested user
  60. number is now stored - in ASCII! - in the print string
  61. displayed on exit. I removed the silly, buggy,
  62. "educational" routines for converting and displaying
  63. the user number - this is supposed to be a utility,
  64. isn't it? - b/m, v1.1)
  65.  
  66.  
  67. _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .
  68.  
  69.  
  70. N O T E S:
  71.  
  72.     - Before implementing this program, you must 
  73.           use STAT to declare XUSER.COM to be a 
  74.        system file (i.e., STAT XUSER.COM $SYS),
  75.       so that CPM can still find it when you 
  76.       wander off into some exotic area...
  77.       (unfortunately, this tip only works for
  78.       CP/M Plus, CP/M 2.2 users will have to
  79.       use the Plu*Perfect Systems PUBlic patch
  80.       on their BDOSs and declare XUSER.COM as
  81.       a PUBlic file - b/m, v1.1)
  82.     - also, any application that invokes XUSER
  83.       must have an image in the target area, or
  84.       CPM will not find its way back to your
  85.       application. I use my WestWind(tm) utility
  86.       DISKMGR to establish multiple directory
  87.       entries referring to the same data blocks
  88.       on the disk; one could also use DU or SID
  89.       to set up such entries...
  90.       (PUBlic is a much better solution for 2.2
  91.       users, DUPUSER by Bruce Ratoff can also be
  92.       do the job in the less elegant manner of
  93.       the WestWind utility,  Mike Rubenstein's
  94.       SETDRU is another worthy method - b/m, v1.1)
  95. _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .
  96.  
  97. I hope that you find this as useful as I have. It is
  98. a small trade for all the truly spectacular public
  99. domain gems that FOG members have shared, and cont-
  100. inue to share. 
  101.  
  102. My next submittal is going to be in a similar vein;
  103. once I started using User Areas, I had to get to them
  104. from within MBASIC and dBASE... coming soon!
  105.  
  106.  
  107.                      PAX,
  108.  
  109.                      John Evancie
  110.                          07-22-85
  111.  
  112. Notes for version 1.1 added by Bruce Morgen, 9/25/85.
  113.                      John Evancie
  114.                          07-22-85
  115.  
  116. Notes for version 1.1