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 / BEEHIVE / ZSUS / Z3HELP-2.LBR / E.LBR / ERROR.HZP / ERROR.HLP
Text File  |  2000-06-30  |  3KB  |  110 lines
  1. ;
  2.                                 ERROR.COM                                     
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Release    Disk
  5. ERROR1.COM     2k (13)   BA38  1.3a       Jay Sage 1/85            Z3COM3
  6. ERROR2.COM     3k (20)   C880  1.3a       Jay Sage 1/85            Z3COM3
  7. ERROR3.COM     1k (5)    7C98  1.0        R. Conn 3/84             Z3COM3
  8. ERROR4.COM     1k (5)    1F98  1.0        R. Conn 3/84             Z3COM3
  9.  
  10.   1- ERROR1 and ERROR2  2- ERROR3 and ERROR4  3- Examples of Use              
  11.  
  12.  
  13.  
  14.    Error Handlers  are programs  which handle command  line errors in a "nice" 
  15. way.  They  may be  used anywhere, including within  ZEX command files.  ZCPR3
  16. has four error handlers dynamically installed by entering their command name.
  17. :1
  18.  
  19. ERROR1 and ERROR2:
  20.  
  21.    Both ERROR1 and ERROR2 display the error line to the user and provide him 
  22. with four options as to how to process this line:
  23.  
  24.    1) replace the command in error with a new command
  25.    2) skip the command in error and resume execution with the next command
  26.    3) replace the entire command
  27.    4) throw away the command line and resume user control
  28.  
  29.    Unlike ERROR1,  ERROR2 is screen-oriented,  using the Z3TCAP for support in 
  30. order to provide a much 'flashier' display.  
  31. :2
  32.  
  33. ERROR3 and ERROR4:
  34.  
  35.    ERROR3  displays  the  name of the COM file which was not  found  and  then 
  36. flushes the command line, returning control to the user.  
  37.  
  38.    ERROR4  prints  the  name  of the COM file which was  not  found  and  then 
  39. advances to the next command in the command line buffer.   If there is no next 
  40. command,  user  control  is  resumed.   If there is a  next  command,  command 
  41. execution resumes there.
  42. :3
  43.  
  44. Examples of Use:
  45.  
  46.    a) ERROR4.COM
  47.  
  48. B1:WORK2>error4
  49. ERROR4, Version 1.0
  50.  Error Handler Installed
  51.  
  52. B1:WORK2>NOTE ERROR4 is a simpler error handler
  53. B1:WORK2>NOTE with the invalid command "XXXX";xxxx
  54.  
  55.  File XXXX.COM Not Found
  56.  
  57. B1:WORK2>NOTE ERROR4 simply says what happened
  58.  
  59.  
  60. Examples of Use (continued):
  61.  
  62.    b) ERROR1.COM
  63.  
  64. B1:WORK2>error1;NOTE ERROR1 is a more sophisticated error handler
  65. ERROR1, Version 1.0
  66.  Error Handler Installed
  67.  
  68. B1:WORK2>xxxx
  69.  
  70. ERROR1, Version 1.0
  71. Error Line is:
  72.    XXXX
  73. Options are: 
  74.  1. Replace Command in Error with a New Command
  75.      Replace XXXX
  76.  2. Advance to Next Command and Resume Processing
  77.      Advance to 
  78.  3. Replace Entire Line with a New Line
  79.      Replace XXXX
  80.  4. Throw Away Entire Line and Continue
  81.      Throw Away XXXX
  82. Select Option - 1
  83. Replacement Command?
  84.   dir
  85.  DEMO    .BAK    0 | DEMO    .TXT    2 | DEMO    .ZEX    2 | DEMO1   .TXT    2 
  86.  DEMO2   .TXT    2 | DEMO3   .TXT    2 | RHEX    .COM    2r| RHEX2   .COM    2r
  87.              B1:WORK2 --     8 Files Using    14K (  288K Left)
  88.  
  89. B1:WORK2>xxxx;dir *.com
  90.  
  91. ERROR1, Version 1.0
  92.  
  93. Error Line is:
  94.    XXXX;DIR *.COM
  95.  
  96. Options are: 
  97.  1. Replace Command in Error with a New Command
  98.      Replace XXXX
  99.  2. Advance to Next Command and Resume Processing
  100.      Advance to DIR *.COM
  101.  3. Replace Entire Line with a New Line
  102.      Replace XXXX;DIR *.COM
  103.  4. Throw Away Entire Line and Continue
  104.      Throw Away XXXX;DIR *.COM
  105.  
  106. Select Option - 2
  107.  
  108.  RHEX    .COM    2r| RHEX2   .COM    2r
  109.             B1:WORK2 --     2 Files Using     4K (  288K Left)
  110.