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-3.LBR / P.LBR / PAUSE.HZP / PAUSE.HLP
Text File  |  2000-06-30  |  2KB  |  57 lines
  1. ;
  2.                                   PAUSE.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                2k (12)   939E  1.1        Jay Sage 9/87            Z3COM7
  6.  
  7.   1- Syntax/Options  2- Notes  3- Examples of Use                             
  8.  
  9.    PAUSE is derived from SAK.COM and is used: 
  10.  
  11.       1) to  wait for user interaction before continuing and to allow the user
  12.          to abort a multiple command line, abort ZEX, or set/clear the program
  13.          error flag; and/or
  14.       
  15.       2) to command the user's attention by ringing the bell at his console.
  16.  
  17.    PAUSE includes an F option to set  or reset  the program error flag instead
  18. of aborting command line or ZEX.   Thus PAUSE can  be  like "IF INPUT"  except 
  19. that a a default answer of TRUE is given after pause time elapses.
  20. :1
  21.  
  22.    Syntax:  PAUSE text    
  23.       or    PAUSE /o... text
  24.  
  25.   Options:  A     -- DO NOT Allow the User to Abort MCL
  26.          B     -- Ring Bell
  27.             F     -- Set/Reset Program Error Flag (No Abort)
  28.             Pnnnn -- Pause nnnn seconds and continue if no
  29.                        response by that time
  30.             Z     -- Allow the User to Abort ZEX
  31.  
  32.    The line of prompting text can  contain special characters for allowing the
  33. generation of lowercase output and control characters.  In the default version
  34. '^' preceding a character causes that character  to be converted to  a control
  35. character.   The sequence '%>' causes all subsequent output to be converted to
  36. lowercase.   The sequence '%<' causes uppercase output  to resume.   Any other
  37. character after '%' is displayed as is ('%^' will give a caret).
  38. :2
  39.  
  40. PAUSE Notes:
  41.  
  42.    a. Vs 1.1 fixes bug in message display configuration control.   The FLAGMSG 
  43.       code was  never  implemented,  and  the  configuration  setting  at  the 
  44.       beginning of the code was ignored.
  45. :3
  46.  
  47. Examples of Use:
  48.  
  49.    a. A0>PAUSE P%>ROGRAM PAUSED^M^J^I%<P%>RESS A KEY TO RESUME: <cr>
  50.     Program paused
  51.         Press a key to resume: _
  52.  
  53.       The most useful control characters are ^M (carriage return), ^J 
  54.       (linefeed), and ^I (tab).  Since the 'text' begins with the first 
  55.       nonblank character, putting in '% ' allows one to include leading
  56.       blank space.
  57.