;
                                ERROR.COM                                     

             Size (recs) CRC   Version    Author/Latest Release    Disk
ERROR1.COM     2k (13)   BA38  1.3a       Jay Sage 1/85            Z3COM3
ERROR2.COM     3k (20)   C880  1.3a       Jay Sage 1/85            Z3COM3
ERROR3.COM     1k (5)    7C98  1.0        R. Conn 3/84             Z3COM3
ERROR4.COM     1k (5)    1F98  1.0        R. Conn 3/84             Z3COM3

  1- ERROR1 and ERROR2  2- ERROR3 and ERROR4  3- Examples of Use              



   Error Handlers  are programs  which handle command  line errors in a "nice" 
way.  They  may be  used anywhere, including within  ZEX command files.  ZCPR3
has four error handlers dynamically installed by entering their command name.
:1

ERROR1 and ERROR2:

   Both ERROR1 and ERROR2 display the error line to the user and provide him 
with four options as to how to process this line:

   1) replace the command in error with a new command
   2) skip the command in error and resume execution with the next command
   3) replace the entire command
   4) throw away the command line and resume user control

   Unlike ERROR1,  ERROR2 is screen-oriented,  using the Z3TCAP for support in 
order to provide a much 'flashier' display.  
:2

ERROR3 and ERROR4:

   ERROR3  displays  the  name of the COM file which was not  found  and  then 
flushes the command line, returning control to the user.  

   ERROR4  prints  the  name  of the COM file which was  not  found  and  then 
advances to the next command in the command line buffer.   If there is no next 
command,  user  control  is  resumed.   If there is a  next  command,  command 
execution resumes there.
:3

Examples of Use:

   a) ERROR4.COM

B1:WORK2>error4
ERROR4, Version 1.0
 Error Handler Installed

B1:WORK2>NOTE ERROR4 is a simpler error handler
B1:WORK2>NOTE with the invalid command "XXXX";xxxx

 File XXXX.COM Not Found

B1:WORK2>NOTE ERROR4 simply says what happened


Examples of Use (continued):

   b) ERROR1.COM

B1:WORK2>error1;NOTE ERROR1 is a more sophisticated error handler
ERROR1, Version 1.0
 Error Handler Installed

B1:WORK2>xxxx

ERROR1, Version 1.0
Error Line is:
   XXXX
Options are: 
 1. Replace Command in Error with a New Command
     Replace XXXX
 2. Advance to Next Command and Resume Processing
     Advance to 
 3. Replace Entire Line with a New Line
     Replace XXXX
 4. Throw Away Entire Line and Continue
     Throw Away XXXX
Select Option - 1
Replacement Command?
  dir
 DEMO    .BAK    0 | DEMO    .TXT    2 | DEMO    .ZEX    2 | DEMO1   .TXT    2 
 DEMO2   .TXT    2 | DEMO3   .TXT    2 | RHEX    .COM    2r| RHEX2   .COM    2r
             B1:WORK2 --     8 Files Using    14K (  288K Left)

B1:WORK2>xxxx;dir *.com

ERROR1, Version 1.0

Error Line is:
   XXXX;DIR *.COM

Options are: 
 1. Replace Command in Error with a New Command
     Replace XXXX
 2. Advance to Next Command and Resume Processing
     Advance to DIR *.COM
 3. Replace Entire Line with a New Line
     Replace XXXX;DIR *.COM
 4. Throw Away Entire Line and Continue
     Throw Away XXXX;DIR *.COM

Select Option - 2

 RHEX    .COM    2r| RHEX2   .COM    2r
            B1:WORK2 --     2 Files Using     4K (  288K Left)
