home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / c.lbr / CD.HZP / CD.HLP
Encoding:
Text File  |  1991-11-18  |  6.9 KB  |  154 lines
  1. ;
  2.                                     CD.COM                                    
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. CD.COM         3k (20)   26FD  3.9        Carson Wilson 6/89       Z3COM2
  6. CD.3OM         3k (20)   B501  3.9        Carson Wilson 6/89       Z3COM2
  7.  
  8.   1- Syntax  2- Usage  3- ST.COM  4- Notes  5- Err Msgs  6- Examples of Use   
  9.  
  10.    Change Directory is used to move from one directory to another by using the 
  11. names or literal DU forms associated with the directories.  CD first logs into 
  12. the referenced directory,  and, if there is a file named ST.COM in it, CD will 
  13. log the user into the referenced directory and invoke ST.COM.   If there is no 
  14. file named ST.COM, CD will simply log the user in.  
  15.  
  16.    CD.COM is for ZCPR 3.0; CD.3OM is for ZCPR 3.3, 3.4, and Z3PLUS.
  17.  
  18.    Original by R. Conn, 4/84.
  19. :1
  20.  
  21.  
  22.     Syntax  CD or CD //      <-- Print help message
  23.  
  24.             CD du[:]         <-- Activates ST.COM upon logging into directory
  25.  
  26.         or  CD du password   <-- Allows changing to a passworded directory
  27.  
  28.         or  CD dir[:]        <-- Activates ST.COM upon logging into directory
  29.  
  30.         or  CD dir password  <-- Allows changing to a passworded directory
  31. :2
  32.  Usage - 1/2 
  33.  
  34.    Under ZCPR3, there are two basic ways to log into a directory.   One way is
  35. by using the DU: or DIR: prefix, like:
  36.  
  37.           B1:ASM>TEXT:     ...or
  38.           B1:ASM>C7:
  39.  
  40. The other way is by using CD, like:
  41.  
  42.           B1:ASM>CD TEXT:  ...or
  43.           B1:ASM>CD C7:
  44.  
  45.    The tradeoff  is  in user efficiency.  If a directory is always  used for a 
  46. particular function, such as cataloging disks, CD may be preferred because  it 
  47. will not only log the user in but  will also run ST.COM,  which can set up his
  48. environment,  such  as by  running MENU  or  some  other  program  or group of 
  49. programs.
  50.  Usage - 2/2 
  51.  
  52.    The user's environment can change drastically by using CD to log into a new
  53. directory.  The names of the directories he can access can change (LDR changes 
  54. the Memory-Based  names),  the command search  path he uses can change, and he 
  55. can even find himself in a MENU environment or  other front-end instead  of  a 
  56. ZCPR3 command environment.
  57.  
  58.    As distributed, ZCPR3 permits 14 named directories simultaneously in memory 
  59. (though it's  easy to allocate more memory buffer space, 18 bytes per name, if 
  60. that's desired).   By  running ST,  a different named directory  file  can  be 
  61. loaded for each directory entered,  permitting  up to  448 names per (logical) 
  62. drive (14 names x 32 areas). 
  63. :3
  64.  
  65.  ST.COM 
  66.  
  67.    ST.COM  is  an  alias  file  used to  establish  desired  conditions  in  a 
  68. directory.  The only purpose of ST is to load the multiple command line buffer 
  69. with  a  command line when it is executed without any options.   This  command 
  70. line may contain a reasonable number of commands which perform any desired set 
  71. of  functions.   ST.COM  is searched for in the  current  directory.   CD  may 
  72. require a password to move to the new directory.  
  73.  
  74.    In the ZCPR3 environment, good candidate commands to be executed by running
  75. ST via CD include the following:
  76.  
  77.           LDR file.NDR   <-- Set up a new directory environ
  78.           PATH path-exp  <-- Set up a new Command Search Path
  79.           MENU           <-- Invoke the MENU Preprocessor
  80.           ECHO message   <-- Print a Message to the User
  81. :4
  82.  CD Notes - 1/3 
  83.  
  84.    a. Version 3.9 updates (6/89):
  85.       - help screen  no  longer shows  "CD DU password,"  as  this  was  never
  86.         actually an option.  
  87.       - all ZCPR 3.0 version errors now clear the command line before exiting.
  88.       - Previously CD would cause ZCPR to ask for  a password a second time if
  89.         the "CD dir password" form was used with the wrong password.   Version 
  90.         3.9 performs the appropriate error procedure immediately.  
  91.  
  92.    b. Version 3.8 updates (5/89)
  93.       - changed so that both versions work with BGii.   If BGii present, chain 
  94.         to error handler, but don't write to message drive/user bytes.
  95.       - tests for Z80 processor.
  96.       - added local  stack  save/restore  because Z3INIT/ZSYSCHK overflow CP/M 
  97.         2.2's CCP stack.
  98.  CD Notes - 2/3 
  99.  
  100.    c. Version 3.7 updates:
  101.       - Puts back space following STCL and LOGCL,  which were  deleted  due to 
  102.         poor Z3LIB documentation on  the PUTCL routine.   Though the help file 
  103.         says PUTCL takes a "null  terminated  command line"  as  a  parameter, 
  104.         PUTCL really  requires  a command BUFFER the size  of the current ZCPR 
  105.         multiple command  line  buffer.   CD  uses 256  bytes,  which  is  the 
  106.         current maximum for  Z-System.   PUTCL should implement its own buffer 
  107.         rather than requiring the user to provide one for it.
  108.  
  109.    d. Version 3.6 updates:
  110.       - Bruce Morgen pointed out that  a type-3 header does  not  prevent ZCPR 
  111.         3.0 from  loading  a  type-3  program  compiled  to  run  at  100 hex.  
  112.         CDxx.3OM therefore is  no longer a  type-3 program,  and now tests for 
  113.         ZCPR33  or above via  the  Z3LIB Z33CHK routine.   Z33CHK also returns 
  114.         false if BGii is present.
  115.       - If you  are  using  BGii  you  should  run  CDxx.1OM as  BGii does not
  116.         implement  the  message  buffer  drive  and  user  bytes  required  by  
  117.         CDxx.3OM.
  118.  CD Notes - 3/3 
  119.  
  120.       - Removed extra pages of space following labels STCL and LOGCL.
  121.       - Removed BGii existence check from CDxx.3OM, as Z33CHK handles this.
  122.       - Added ZSYSCHK for CDxx.1OM to test for ZCPR environment.
  123.  
  124.    e. Version 3.5 updates:
  125.       - All Z33 errors chain to error handler.
  126.       - All Z30 errors give message and abort.
  127.       - Only NON-error status messages are suppressed  by the ZCPR Quiet Flag.
  128.       - Uses Z3LIB GETCCP routine to  find  CCP,  allowing  CD  to  work under 
  129.         Z3PLUS.
  130.       - Implements assembly-time equate TYPE3 instead  of using Z33CHK,  which 
  131.         was inconsistent since  a type-3  header  would  have  prevented  CD's 
  132.         running under type-1 no  matter  what  Z33CHK said,  and  compiled two 
  133.         versions:  CD35.1OM is type 1 and  should  be installed with Z3INS and
  134.         used for ZCPR 3.0.  CD35.3OM is type 3 and is for ZCPR 3.3 and 3.4 and
  135.         Z3PLUS.  It has a type-3 header so will not run under ZCPR 3.0.
  136. :5
  137.  
  138.  
  139.  Selected Error Messages 
  140.  
  141.    "Command Line Overflow" 
  142.  
  143.       -- there was not enough room in the command line to insert the command
  144.          to invoke ST.COM.
  145. :6
  146.  
  147.  
  148.  Examples of Use 
  149.  
  150.    a. B0:WORK>cd text:<cr>     <-- Log into  directory TEXT:.  An ST alias
  151.       PW? mypass<cr>               in TEXT: might then load a new .NDR, set
  152.       C7:TEXT>                     up a new command search path and place
  153.                                    the user in a menu.
  154.