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 / ZCPR33 / ZRDOS12.DOC < prev   
Text File  |  2000-06-30  |  14KB  |  375 lines
  1.      ZRDOS Version 1.2 Additions and Modifications to ZRDOS
  2.  
  3.  
  4.                       ZRDOS 1.2 ERROR CODES
  5.  
  6.      Inorder to make more efficent use of code space,  the  error
  7. messages  have been removed from ZRDOS 1.2 and replaced with  the
  8. error codes described below.
  9.  
  10.  
  11. ZRDOS Error 1 - A disk read error occured.
  12.  
  13.      A  ZRDOS  error  1 message is given whenever  any  error  is
  14. detected  during the reading or writing of a sector on the  disk.
  15. After the message is given, the Z-System waits for console input.
  16. If <ENTER> is pressed the bad sector is ignored and the operation
  17. continues. If <CTL-C> is pressed, the operation (and the program)
  18. is  aborted,  a warm boot is done,  and the system returns to the
  19. command level.
  20.  
  21.      NOTE: In the case of a write operation, pressing <ENTER> can
  22. jeopardize  the integrity of data on the diskette  being  written
  23. to.
  24.                    ---------------------------
  25.  
  26. ZRDOS Error 2 - A drive selection error occured.
  27.  
  28.      A  ZRDOS error 2 message is given when an attempt is made to
  29. select  a  drive  which is not valid on  the  system.  After  the
  30. message  is  given, a warm boot will occur and  the  system  will
  31. return to the command level.
  32.  
  33.                    ---------------------------
  34.  
  35. ZRDOS Error 3 - A read only disk error occured.
  36.  
  37.      A  ZRDOS error 3 message is given when an attempt is made to
  38. write on a disk that has been set to "read only" status.  A  disk
  39. can  be set to "read only" status with the SRO utility program or
  40. a standard system call.  After a error 3 message is given, a warm
  41. boot will occur and the system will return to the command level.
  42.  
  43.                    ---------------------------
  44.  
  45. ZRDOS Error 4 - A read only file error occured.
  46.  
  47.      A  ZRDOS error 4 message is given when an attempt is made to
  48. write to,  rename, or erase a file that is marked as "read only".
  49. Once  the  message is given,  a warm boot occurs and  the  system
  50. returns to the command level.
  51.  
  52.      NOTE:  A  warm  boot has no effect on a file that  has  been
  53. tagged as "read only".
  54.  
  55. .pa
  56.  
  57. ZRDOS Error 5 - A disk changed error occured.
  58.  
  59.      A  ZRDOS error 5 message is given when an attempt is made to
  60. write  to  a file on a disk that has been changed while the  file
  61. was still open on the previous disk.  After a error 5 message  is
  62. given,  a  warm boot will occur and the system will return to the
  63. command level.
  64.  
  65.                    ---------------------------
  66.  
  67. ZRDOS Error 6 - A wheel protect file error occured.
  68.  
  69.      A  ZRDOS error 6 message is given when an attempt is made to
  70. write to,  rename,  set file attributes,  or erase a file that is
  71. marked  as  "wheel protected" and the Z-System wheel byte is  not
  72. set.   Once  the  message is given,  a warm boot occurs  and  the
  73. system returns to the command level.
  74.  
  75.      NOTE:  A  warm  boot has no effect on a file that  has  been
  76. tagged as "wheel protected".  The wheel protect file attribute of
  77. a wheel protected file can only be changed when the wheel byte is
  78. set.
  79.  
  80.                    ---------------------------
  81.  
  82.      The  above information is also available online thru the use
  83. of  the ZRDOS 1.2 utility DOSERR.COM.  To display the information
  84. for a given dos error type:
  85.  
  86.      DOSERR n
  87.  
  88.      Where 'n' is the ZRDOS error number you wish to review.
  89.  
  90. .pa
  91.  
  92.                         PUBLIC USER AREAS
  93.  
  94.      ZRDOS  1.2 uses bytes 126 and 127 (the last 2  bytes  before
  95. Z3TCAP)  of  the  Z3  environment discriptor as  mask  bytes  for
  96. setting  PUBLIC  user areas.  Byte 126 is the mask byte  for  the
  97. drives that are to be allowed to contain public user areas.  Byte
  98. 127  contains  the mask byte for the declared public user  areas.
  99. Public  user areas can be on drives A - H and can be assigned  to
  100. user  areas  1 - 8.  Any file kept in a public user area  can  be
  101. accessed  directly from any other user area on the same drive  as
  102. long as the fcb specifying the file contains no wild  cards.  The
  103. mask bytes are as follows:
  104.  
  105.           Drive Byte (126)             User Byte (127)
  106.  
  107.    Bit    7 6 5 4 3 2 1 0              7 6 5 4 3 2 1 0
  108.           | | | | | | | |              | | | | | | | |
  109.    Drive  H G F E D C B A   User Area  8 7 6 5 4 3 2 1
  110.  
  111.      The  setting and displaying of these bytes is done with  the
  112. ZRDOS 1.2 utility, PUBLIC.COM (see section on ZRDOS 1.2 Utilities
  113. for more details).
  114.  
  115.      A  PUBLIC  user area is a handy place to keep  the  overlays
  116. used  by programs such as WordStar,  dBASE II,  and SuperCalc  as
  117. well  as many other commercially available  programs.  With  some
  118. programs, like WordStar (which first try to load the overlay from
  119. the current drive/user then default to drive A) the overlay files
  120. can  be kept in a PUBLIC user area on drive A and be accessed  by
  121. the program from any other drive and/or user area. Other programs
  122. such  as dBASE II and SuperCalc require that the overlays  be  on
  123. the  currently logged in drive,  but if declared PUBLIC any  user
  124. area.
  125.  
  126.      A PUBLIC user area could also be assigned to basic files for
  127. Mbasic.  For example lets say we want to use drive B user area  6
  128. as  a PUBLIC user area for our basic programs and that we want to
  129. keep  Mbasic on drive A.  As long as we are logged onto  drive  B
  130. (any user area) Mbasic can access our programs as follows:
  131.  
  132. B1>MBASIC MYPROG       -   User  is on same drive  but  different
  133.                            user area.
  134.  
  135.      or
  136.  
  137. C3>MBASIC B:MYPROG     -   User  is  on different drive and  user
  138.                            area but specifies drive.
  139.  
  140.      As can be seen from above this allows the user a great  deal
  141. of  flexablity  and  can  be used to better  organize  files  and
  142. disk/user areas.
  143. .pa
  144.  
  145.                    ZRDOS Version 1.2 Utilities
  146.  
  147.      Besides  the standard ZRDOS utilities several new  utilities
  148. have  been  added to manipulate and support the  PUBLIC  feature.
  149. These utilities are as follows:
  150.  
  151.      PUBLIC.COM     - Allows user to set, clear or display PUBLIC
  152.                       user status.
  153.  
  154.      DIR.COM        - This version of the ZCPR3 directory utility
  155.                       supports  the  displaying  of  PUBLIC  user
  156.                       areas.
  157.  
  158.      DOSERR.COM     - This  utility,   as  previously  described,
  159.                       displays   information  pertaining  to  the
  160.                       error codes generated by ZRDOS 1.2.
  161.  
  162.      VTYPE.COM      - A  full screen video oriented file  display
  163.                       utility.
  164.  
  165. .pa
  166.  
  167.                        THE PUBLIC UTILITY
  168.  
  169.      The utility PUBLIC.COM is the utility used to manipulate the
  170. PUBLIC feature of ZRDOS 1.2. A sample use session follows.
  171.  
  172.      In  the first sample we display PUBLIC.COM's built  in  help
  173. information.
  174.  
  175. B0:WORK>PUBLIC //
  176. PUBLIC Version 1.0
  177. Syntax:
  178.         PUBLIC
  179. or      PUBLIC /oooo...
  180. Options:
  181.         Cc - Clear PUBLIC declarations
  182.          c=A Clear All PUBLIC declarations
  183.          c=D Clear PUBLIC User Area Drive
  184.          c=U Clear PUBLIC User
  185.         Dd - Declare Drive=d, PUBLIC
  186.         Uu - Declare User=u, PUBLIC
  187.  
  188. B0:WORK>
  189.  
  190.      In the following example we will setup user areas 4 and 8 on
  191. drive A as PUBLIC user areas.
  192.  
  193.  
  194. B0:WORK>PUBLIC /CA,DA,U4,U8    ; Here we first clear any existing
  195.                                  settings, then declare drive 'A'
  196.                                  user '4' and '8' to be public.
  197.  
  198.                                  Note: The commas are optional.
  199.  
  200.      PUBLIC  then preforms the requested operation  and  displays
  201. the results as follows:
  202.  
  203. PUBLIC Version 1.0
  204.  
  205. Public User Area Drive(s): A
  206. Public User Area(s): 4, 8
  207.  
  208. B0:WORK>
  209.  
  210.      If  we  only want to display the current settings,  we  only
  211. need enter the program name as follows:
  212.  
  213. B0:WORK>PUBLIC
  214. PUBLIC Version 1.0
  215.  
  216. Public User Area Drive(s): A
  217. Public User Area(s): 4, 8
  218.  
  219. B0:WORK>
  220. .pa
  221.  
  222.  
  223.                         VTYPE VERSION 2.0
  224.  
  225.  
  226. An Introduction to VTYPE
  227.  
  228.      VTYPE  is  a  bi-directional  video  oriented  file  display
  229. utility  that allows the user to brows through a file in much the
  230. same  manner he would a book.  VTYPE has the ability to find  and
  231. display user selected text strings. VTYPE quickly moves around in
  232. a text file with simple Wordstar like control commands.
  233.  
  234.      VTYPE  uses  the  ZCPR3 environmental and  Z3TCAPS  data  to
  235. determine  the  chacteristics of your terminal.  Displayed  lines
  236. which  exceed  the length of your terminal are truncated.  A  hi-
  237. lighted  +  is displayed at the end of the line to indicate  this
  238. condition.
  239.  
  240.      The form of the VTYPE command is as follows:
  241.  
  242.           VTYPE DU:ufn
  243.  
  244.  
  245. The VTYPE Command Menu
  246.  
  247.  
  248.                   <<<<< VTYPE Version 2.0 >>>>>
  249.  
  250.                           Command Menu
  251.  
  252.            SCREEN COMMANDS               FIND COMMANDS
  253.      ^R -- Backup one screen       ^F -- Find String
  254.      ^C -- Advance one screen      ^N -- Find again
  255.      ^S -- Backup n screens
  256.      ^D -- Advance n screens              OPTIONS
  257.                                     P -- Printer on/off
  258.            LINE COMMANDS            R -- Scroll Rate: 0
  259.      ^W -- Backup one line          S -- Status Line on/off
  260.      ^Z -- Advance one line         T -- Tab Size: 8
  261.      SP -- Scroll start/stop        V -- ZCPR3 Video Mode on/off
  262.                                     W -- WS Mode on/off
  263.            FILE COMMANDS            / -- Menu/Text
  264.      ^T -- Go to top of file
  265.      ^B -- Go to bottom of file     X -- Exit
  266.  
  267. .pa
  268.  
  269.                          SCREEN COMMANDS
  270.  
  271.  
  272. Control-R Backup one screen        Moves display back one screen.
  273.  
  274. Control-C Advance one screen       Advances to the next screen.
  275.  
  276. Control-S Backup n screens         Prompts  - NUMBER OF  SCREENS?
  277.                                    and pages the display backward
  278.                                    the number of screens entered.
  279.  
  280. Control-D Advance n screens        Prompts  - NUMBER OF  SCREENS?
  281.                                    and  pages the display forward
  282.                                    the number of screens entered.
  283.  
  284.  
  285.                    ---------------------------
  286.  
  287.  
  288.                           LINE COMMANDS
  289.  
  290.  
  291. Control-W Backup one line          Moves display back one line.
  292.  
  293. Control-Z Advance one line         Advances display by one line.
  294.  
  295. SPACE Scroll start/stop            Starts   and   stops    screen
  296.                                    scrolling.
  297.  
  298.  
  299.                    ---------------------------
  300.  
  301.  
  302.                           FILE COMMANDS
  303.  
  304.  
  305. Control-T Go to top of file        Reads  in and  displays  first
  306.                                    full screen of file.
  307.  
  308. Control-B Go to bottom of file     Reads  in  and  displays  last
  309.                                    full screen of file.
  310.  
  311.  
  312. .pa
  313.  
  314.                           FIND COMMANDS
  315.  
  316.  
  317. Control-F Find String      Prompts  FIND? and accepts a string of
  318.                            up  to  80  characters.  Then  prompts
  319.                            IGNORE  CASE (Y/N)?.  Where N  is  the
  320.                            default.  A  'Y'  responce will  cause
  321.                            VTYPE  to find any string in the  file
  322.                            that   matchs   the   entered   string
  323.                            regardless of case. Any other responce
  324.                            will cause VTYPE to match only strings
  325.                            which match in both context and case.
  326.  
  327. Control-N Find again       Finds  the next occurance of the  last
  328.                            found string.
  329.  
  330.  
  331.      Found strings are displayed in hi-lighted video.
  332.  
  333.                    ---------------------------
  334.  
  335.  
  336.                              OPTIONS
  337.  
  338. P Printer on/off                   Toggles output to list  device
  339.                                    on and off.
  340.  
  341. R Scroll Rate                      Prompts SCROLL RATE (0-9)? and
  342.                                    accepts  a numeric entry  that
  343.                                    controls  the  speed at  which
  344.                                    characters  are  sent  to  the
  345.                                    screen  during scrolling.  The
  346.                                    larger  the number the  slower
  347.                                    the display.
  348.  
  349. S Status Line on/off               Toggles  the  display   Status
  350.                                    Line on and off.
  351.  
  352. T Tab Size                         Prompts TAB SIZE?  and accepts
  353.                                    a  numeric entry from 0 to  99
  354.                                    that determines the  expansion
  355.                                    size of tabs.
  356.  
  357. V ZCPR3 Video Mode on/off          Toggles  the ZCPR3 Video  Mode
  358.                                    on  and off.  ZCPR3 Video Mode
  359.                                    causes characters bracketed by
  360.                                    ^A and ^B to be hi-lighted.
  361.  
  362. W WS Mode on/off                   Toggles  Wordstar Mode on  and
  363.                                    off.  Wordstar mode causes all
  364.                                    Wordstar  control codes to  be
  365.                                    displayed  as '^char'  in  hi-
  366.                                    lighted video.
  367. .pa
  368.  
  369. / Menu/Text                        Toggles  between the text  and
  370.                                    the command menu.
  371.  
  372. X Exit                             Exits VTYPE.
  373.  
  374.  
  375.