home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / 22RSX / BYERSX.ARK / RSXBYE.DOC < prev    next >
Text File  |  1985-11-27  |  5KB  |  104 lines

  1. ; Some program notes for RSXMAIN.BYE.
  2. ;
  3. ; Name this file BYERSX.INC for inclusion in an assembly listing.
  4. ;
  5. ; The RSX has available to it the routines from RSXMAST
  6. ; TSTR     (like DOS string call, but registers preserved)
  7. ; DOS    (like BDOS call, but register A specifies the function,
  8. ;      and the bc, de and hl registers are preserved)
  9. ; GOBDOS (Just like the original BDOS call).
  10. ;  note that DOS and GOBDOS do not use the RSX code.
  11. ;
  12. ; RSXMAIN.BYE defines a BYE replacement RSX.  It is a customization
  13. ; of the RSXMAIN.XXX outline.  The system is designed so that
  14. ; simple programs can replace BYE, XMODEM, MODEM etc.  The system
  15. ; will be installed and then the appropriate program can be run.
  16. ; Rerunning BYERSX will bring down the system (or a BDOS call 57h
  17. ; with a parameter 0ffffh can do it programatically).
  18. ;
  19. ; This system makes no attempt to answer phones, etc, but simply
  20. ; provides a suitable environment for other applications.  It does,
  21. ; however, monitor remote carrier and inactivity.  If any of these
  22. ; conditions cause call termination, the program ENDCALL will be
  23. ; automatically executed.  Further operation is entirely up to
  24. ; ENDCALL.  It is expected to record whatever is needed, and call
  25. ; BYE (not the original, but a co-operating application), which
  26. ; will perform the call reception and system initiation.  The 
  27. ; chain operation (BDOS call #2fh, chain to command line in 
  28. ; dmaadr) is available to perform these operations.  Note that
  29. ; if the e value is 0ffh during a chain, the current logged drive
  30. ; and user will be made the default.
  31. ;
  32. ; All operations are intended to be performed through BDOS calls.
  33. ; No external program should need to refer to the load point of
  34. ; this module in any way.  Pointers and values are returned thru
  35. ; the various calls.  See documentation of functions available.
  36. ;
  37. ; The mxdrv value is used, but is replaceable by a bit vector of
  38. ; available drives.  This vector initially allows all drives, for
  39. ; compatibility.  Setting the mxdrv to 15, and using the vector,
  40. ; provides precise control, especially useful when "holes" in the
  41. ; drive map exist (for example an M drive).
  42. ;
  43. ; Acknowledgement: This system draws heavily on the features and
  44. ; function of BYE334 through 339.
  45. ;
  46. ; DO NOT MAKE A SEPARATE dseg.  When this system is executing is
  47. ; is either as the result of a BDOS call, on the user stack, which
  48. ; is switched on entry, or as a bios replacement, when the BDOS
  49. ; stack may be in effect.  Any operations that may originate from
  50. ; BDOS cannot use BDOS itself, unless they are aborts, which will
  51. ; never return to BDOS, and switch stacks.
  52. ;
  53. ; Copyright (c) 1985 by
  54. ;     C.B. Falconer, 680 Hartford Tpk.,
  55. ;    Hamden, Conn. 06517        (203) 281-1438
  56. ; all rights reserved.
  57. ;
  58. ; This program may be freely used and copied for non-profit purposes.
  59. ; It may not be sold without the express permission of C.B. Falconer.
  60. ;
  61. ; Note: peak stack use occurs with function keys, and is mainly
  62. ; aggravated by the bios call register protection.  If the bios can
  63. ; be trusted not to disturb registers other than a and f, this
  64. ; use can be reduced.
  65. ;
  66. ; Note: debugging is simplified by:
  67. ;   1.    Mount rsx with "byersx"
  68. ;   2.  Dismount with "enquire 57 ffff"
  69. ;   3.    Load DDT with "ddt"
  70. ; at this point the RSX code is still in protected memory, but has
  71. ; been disconnected from BDOS/BIOS.  DDT can load and execute test
  72. ; programs (but set up your own stack area).  The ^C which exits
  73. ; DDT will remove BYERSX from memory, and reset the protection.
  74. ;
  75. ; Note: Mysterious crashes can result from excessive stack use. The
  76. ; normal BDOS stack of 48 bytes handles this.  If interrupts are
  77. ; occurring or if the bios proper uses too much stack this may not
  78. ; be adequate.  For CPM 2.2 the entry point at BDOS+11h shortly
  79. ; loads SP, and you should examine usage under DDT while exercising
  80. ; the functions.  The heavy usage can be eliminated by removing 
  81. ; the function key abilities.
  82. ;
  83. ; Some systatus values of interest, and meanings:
  84. ;   Binary Hex  Meaning
  85. ; xxx00000  0   Normal system operation.  Default condition.
  86. ; xxx00100  4   Remote console, showing on local. Hard wired remote.
  87. ; xxx10100 14   Remote console, showing, via modem. Carrier checked.
  88. ;
  89. ; Modes with local kbd/screen functioning as a terminal. Conoff set.
  90. ; With conoff set any executing programs are paused.  No disk access.
  91. ; xxx01100  c   Operating as console on remote cpu that echoes
  92. ; xxx01110  e   Half duplex, operating as console.
  93. ; xxx01101  d   Conversation with remote console.
  94. ;
  95. ; --------------------------------
  96. ;
  97. ; This file may be used to include data areas compatible with
  98. ; the existing BYE programs.  A BYE replacement must always
  99. ; have "driver" set true, and "nodrive" set false.  When code
  100. ; is included here it will cause the replacement bios jump
  101. ; vector to be located higher than usual, which may cause 
  102. ; problems with some programs that are careless in calling
  103. ; the bios directly.  For most RSXs this file contains no code.
  104. °¢