home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / cpm3 / ccp105p.ark / CCP-PLUS.DOC < prev    next >
Encoding:
Text File  |  1986-10-18  |  7.4 KB  |  172 lines
  1.  
  2.      CCP+ is a  CP/M  Plus CCP replacement.    It  is a result of 
  3. dissasembling   the  CCP  supplied  with  CP/M  Version  3.0  and 
  4. modifying  the resultant source code for use in an RCP/M  system.  
  5. Because most of the code is copyright by Digital  Research,  only 
  6. registered users of CP/M Plus may use this CCP replacement.
  7.  
  8. This CCP includes the following changes:
  9.  
  10. 1.   All  built-in commands have been removed.   None are  needed 
  11.      since  Digital  Research supplies the  equivalent  transient 
  12.      commands  with  CP/M  3.   The  user number  is  changed  by 
  13.      entering  u: at the system prompt,  where u is the new  user 
  14.      number.
  15.  
  16. 2.   It is not necessary for .COM and .SUB files to have the  SYS 
  17.      attribute  to be accessable from other user areas.   The CCP 
  18.      searches  user  0 (if the current user number  is  non-zero) 
  19.      after the current user number is searched for each drive  in 
  20.      the command search path.
  21.  
  22. 3.   Commands  of the form du:command or ud:command or  u:command 
  23.      are allowed.
  24.  
  25. 4.   The display of the user/drive in the system prompt has  been 
  26.      reversed to be consistent with ZCPR.
  27.  
  28. 5.   If  the  command or submit file to be executed  is  password 
  29.      protected  and  the correct password is not supplied or  the 
  30.      default  password  does  not  match,  a  "Password:"  prompt 
  31.      appears  and  the  user is given one  chance  to  enter  the 
  32.      correct password.
  33.  
  34. 6.   The time (in the format [HH:MM]) is displayed at the  system 
  35.      prompt.  This can optionally be turned off.  Also, for RCP/M 
  36.      systems,  the  caller's connect time instead of the  current 
  37.      time can optionally be displayed at the system prompt.
  38.  
  39. 7.   The CCP checks for the presence of a BYE RSX,  and if BYE is 
  40.      active,  stop/start scroll support is turned off.   All RCPM 
  41.      listing  utilities monitor ^S input,  so the BDOS should not 
  42.      monitor  console  input  during console output  in  an  RCPM 
  43.      system.   The CCP uses function 60 (RSX function 4) to  test 
  44.      for BYE active.   My version of BYE returns 0 in register A.  
  45.      If  this  function  reaches  the  BDOS,  0FFH  is  returned.  
  46.      Checking for BYE active can optionally be turned off.
  47.  
  48. 8.   The  CCP uses offset +9 in the System Control Block to  pass 
  49.      the  user  number  of the file to load in  conjunction  with 
  50.      function 59.   The value passed is user number+1,  with 0  = 
  51.      current   user  number.    The Loader resets this value   to  
  52.      0.   Transient   programs  can  set  SCB+9  to  load   files  
  53.      from different user numbers.
  54.  
  55. 9.   If a .COM or .SUB file cannot be found, the message "command 
  56.      not found" is displayed.
  57.  
  58. 10.  Named  directories  are implemented (similar to  ZCPR).   If 
  59.      directory  names  were loaded via SETDIR,  the name  of  the 
  60.      drive/user is displayed.   The CCP also calls any active LBR 
  61.      RSX's  to  display  their Library  names.   The  display  of 
  62.      directory names can be turned on or off by using the DIRNAME 
  63.      utility.   The directory name file (ROOT.DIR) can be created 
  64.      using  your favorite editor.   Use the sample  supplied  for 
  65.      syntax.   The  CCP supports password protected  directories.  
  66.      To  log into a named directory,  simply enter its name as  a 
  67.      command  with  an optional password,  and if it is  password 
  68.      protected,  and  the correct password was  not  supplied,  a 
  69.      password will be prompted.
  70.  
  71. 11.  Full support of the ZCPR wheel byte is implemented including 
  72.      MAXDRIVE,  MAXUSER,  and WHEEL.   If the wheel byte is  set, 
  73.      access  is allowed to any named directory without regard  to 
  74.      password  protection or the settings of max drive and  user.  
  75.      If the wheel byte is zero, access is denied to out-of-bounds 
  76.      drive  and user areas as determined by MAXDRIVE and MAXUSER.  
  77.      To  log  into an out-of-bounds area when the wheel  byte  is 
  78.      zero,  you must enter the name of the target directory, then 
  79.      if  it is password protected,  supply the correct  password.  
  80.      If this is successfull,  the MAXDRIVE and MAXUSER  locations 
  81.      are modified to reflect the extended access.
  82.  
  83. 12.  A  Cmdrun facility similar to the ZCPR LRUN  command,  which 
  84.      executes  commands  from  a library  has  been  implemented.  
  85.      CMDRUN  can  load any CP/M+ command  file  from  COMMAND.LBR 
  86.      including  .COM,  .SUB  and .PRL files.   CMDRUN is  invoked 
  87.      automatically  if the CCP cannot find the required  command, 
  88.      and CMDRUN in turn, searches for COMMAND.LBR using the drive 
  89.      search chain,  and follows the filetype search order as  set 
  90.      by  SETDEF  for selecting members once COMMAND.LBR has  been 
  91.      found.   Note  that  the cmdrun facility can  be  optionally 
  92.      selected.
  93.  
  94.  
  95.      The  following options can be selected by using setting them 
  96. to YES in the file CCPHDR.MAC:
  97.  
  98. YESLBR    EQU  NO
  99.  
  100.      Yes, to allow library command processor to be loaded and run 
  101. if the command cannot be found.
  102.  
  103. WHLLBR    EQU  NO
  104.  
  105.      Yes,  to  check  Wheel byte before running  library  command 
  106. processor.   No effect unless YESLBR is YES.  If yes, the library 
  107. command processor will only be run if the wheel byte is 0FFH.
  108.  
  109. EXPAND    EQU  NO
  110.  
  111.      Yes,  to expand the users universe if the Wheel byte is zero 
  112. and the user enters the name of an out of bounds directory and is 
  113. successfully taken there.  This will cause the MAXDRV and MAXUSER 
  114. bytes to be updated to the expanded access.
  115.  
  116. BYECHK    EQU  NO
  117.  
  118.      Yes,  to check for presence of BYE, and if BYE is active, to 
  119. disable  flow-control  checking  (XON/XOFF).    For  this  to  be 
  120. effective, BYE509 or newer must be present and CCPPLUS set to YES 
  121. in BYE.
  122.  
  123. NOXOFF    EQU  NO
  124.  
  125.      Yes,  to always disable flow-control (XON/XOFF).   Should be 
  126. left NO,  except with an older version of BYE.   If set yes, then 
  127. there is no way to pause output from most non-RCPM utilities.
  128.  
  129. TIME      EQU  NO
  130.  
  131.      Yes,  to  display  current time at the system prompt in  the 
  132. form [HH:MM].  But see TIMEON below.
  133.  
  134. TIMEON    EQU  NO
  135.  
  136.      Yes,  to  display caller's connect time instead  of  current 
  137. time at the system prompt.  Both TIME and TIMEON must be set yes.
  138. Only effective with BYE509 or newer.   Reverts to display current 
  139. time if BYE is not active.
  140.  
  141. YESPRL    EQU  NO
  142.  
  143.      Yes,  to allow loading of MP/M PRL (page relocatable) files.  
  144. Leave this NO unless you have MP/M specific programs.
  145.  
  146.      You  can use SID or EDFILE to modify the following locations 
  147. in CCP.COM:
  148.  
  149. 3E0H:     FCB  for  locating  and  loading  the  library  command 
  150.           processor as follows:
  151.  
  152.      3E0H: User number+1. 0 = use default user number.
  153.  
  154.      3E1H: Drive code+1. 0 = use drive search chain.
  155.  
  156.      3E2H:  File  name (must be exactly 11 bytes).   The  current 
  157.      file name is 'CMDRUN  COM' (CMDRUN.COM).
  158.  
  159.  
  160. I   have  been  using the CCP in the Meadowlark RCPM for  over  3 
  161. years.    It offers ZCPR-like capabilities which most callers are 
  162. used to, and also allows the Sysop and privaleged users to easily 
  163. use password protected commands.
  164.  
  165. If    you  make  use  of  CCP+,    and  have  any   comments   or 
  166. suggestions, call the above RCPM at 403-435-6579 @ 300/1200 baud, 
  167. or voice at 403-437-2591.
  168.  
  169. Jul 14, 1986
  170. Jim Lopushinsky
  171. Edmonton, Alberta, Canada
  172.