home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / sysutl / xuser.lbr / XUSER.DZC / XUSER.DOC
Encoding:
Text File  |  1987-01-15  |  2.9 KB  |  104 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. Then, as a check on
  60. our work, and to illustrate both uses of #32, it is
  61. called again to ask CPM what area we are in. The 
  62. result is stored in the A register, where the pro-
  63. gram converts and displays it (with thanks to B. D.
  64. DePaola and R. S. Burkey, PORTABLE COMPANION, Dec.
  65. 82/Jan 83, pgs 50-53).
  66.  
  67.  
  68. _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .
  69.  
  70.  
  71. N O T E S:
  72.  
  73.     - Before implementing this program, you must 
  74.           use STAT to declare XUSER.COM to be a 
  75.        system file (i.e., STAT XUSER.COM $SYS),
  76.       so that CPM can still find it when you 
  77.       wander off into some exotic area...
  78.  
  79.     - also, any application that invokes XUSER
  80.       must have an image in the target area, or
  81.       CPM will not find its way back to your
  82.       application. I use my WestWind(tm) utility
  83.       DISKMGR to establish multiple directory
  84.       entries referring to the same data blocks
  85.       on the disk; one could also use DU or SID
  86.       to set up such entries...
  87.  
  88. _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .  _  .
  89.  
  90. I hope that you find this as useful as I have. It is
  91. a small trade for all the truly spectacular public
  92. domain gems that FOG members have shared, and cont-
  93. inue to share. 
  94.  
  95. My next submittal is going to be in a similar vein;
  96. once I started using User Area, I had to get to them
  97. from within MBASIC and dBASE... coming soon!
  98.  
  99.  
  100.                      PAX,
  101.  
  102.                      John Evancie
  103.                          07-22-85
  104.