home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / t.lbr / TEX.HZP / TEX.HLP
Encoding:
Text File  |  1991-11-18  |  7.1 KB  |  147 lines
  1. ;
  2.                                     TEX.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                9k (70)   9D19  1.3        Jim Lill 8/89            Z3COM9
  6.  
  7.   1- Syntax  2- TEX Commands  3- TEX.VAR  4- Notes  5- Examples of Use        
  8.  
  9.    Time EXecution is a time-scheduling program for ZCPR3.   It allows entry of
  10. entire command lines with associated  absolute execution  times  and  optional  
  11. repeat intervals.  The maximum number of command lines allowable is at present
  12. 20 (but alterable in the source code).   TEX operates as a ZCPR3 shell,  whose 
  13. function is to  determine when a command line should be executed and to put it
  14. in ZCPR3's Multiple Command Line Buffer when it is due.  
  15.  
  16.    TEX requires a Z80 processor, ZCPR3 or ZCPR33,  and a real-time clock.   Vs
  17. 1.0 by Ron Murray (4/88).
  18. :1
  19.  
  20.     Syntax   TEX [command file] /options 
  21.  
  22.    ...where <command file> is  an  optional file containing  TEX  commands  as 
  23. above (these can be prepared using a text editor, and can be useful for often-
  24. used commands).   Default filetype is .TEX  if none  is specified.   The  only 
  25. option at present  is  /C,  which deletes  any current  TEX.VAR file  and thus 
  26. starts TEX with no embedded commands. 
  27.  
  28.    After loading, TEX will install itself as a shell (if possible),  then read 
  29. any specified input file.   It will then try  to read  a  TEX.VAR file (unless 
  30. disabled with  the  /C option)  to load  any pending commands.   It  will then 
  31. display the  user prompt,  which is  similar  to  the  standard  ZCPR3  prompt 
  32. (including any named directory information), but preceded by the current time,
  33. e.g. [21:55] B0:WORK> 
  34.  
  35.    This time is  updated  once  each  minute,  to demonstrate that  TEX hasn't 
  36. fallen over. 
  37.  
  38.  
  39.    At this  point normal commands and TEX  commands can  be typed.   Note that 
  40. even a  simple directory change  requires reloading  of  TEX after completion:  
  41. all  commands (except control-C) are  loaded  into  the  Multiple Command Line 
  42. Buffer and  control  is  passed  to  the  CCP.   There are  also  some control 
  43. functions performed by single keys, as follows: 
  44.  
  45.  Control Keys 
  46.  
  47.    - Line-feed gives a short help display.
  48.    - ESCAPE will cause TEX to terminate (the current commands will be saved in
  49.      the TEX.VAR file).
  50.    - Control-D gives a display of current commands.
  51.    - Control-E will allow commands to be deleted.  The user is prompted with a
  52.      request for  the number of  the  command  (obtained  with  the  Control-D 
  53.      command), the command line is displayed, and the user asked for confirma-
  54.      tion before the line is deleted. 
  55. :2
  56.  TEX Commands - 1/2 
  57.  
  58. The general format of a TEX command line is:
  59.  
  60.    TEX commands;required command line;other commands as normal
  61.  
  62. Note the semicolon required  between the  TEX commands and command line.   TEX
  63. will flag an error if this is omitted.
  64.  
  65.  
  66.    There are presently three TEX commands to specify execution details.  Their
  67. order in the command line is unimportant.
  68.  TEX Commands - 2/2 
  69.  
  70. !X [dd:mm:yy] hh:mm[:ss]
  71.           - Specifies  an absolute  execution time.   The date and seconds are 
  72.             optional,  as  indicated  by the brackets.   If the  date  is  not
  73.             supplied, execution  will proceed on  the current  day.   If no !X 
  74.             command is supplied, execution commences immediately. 
  75.  
  76. !R [/days] hh:mm[:ss]
  77.           - Specifies  a time  period  for repeated  execution  of the command 
  78.             line.   Days  and seconds  are  optional.   If  no !R  command  is 
  79.             entered,  the program  is run  once at  the  specified time,  then 
  80.             deleted from the execution list. 
  81.  
  82. !P number
  83.           - Specifies a priority for the command, in the range 1 to 254, where
  84.             1 is the  highest  priority.   If no  !P command  is entered,  the 
  85.             default  priority (99) is  used.   Priority can  be  specified  to 
  86.             ensure that a given program executes before another,  if they  are 
  87.             scheduled at the same time. 
  88. :3
  89.  TEX.VAR 
  90.  
  91.    When  TEX  executes  a  program,   all  current  commands  and  their  time 
  92. information are saved in a disk file called TEX.VAR.  The distribution version
  93. of TEX saves this file in  the root  directory,  but either  a re-assembly, or 
  94. your favorite patcher,  will allow any other drive/user area combination to be
  95. used.  Either modify the source code at the rootfl: and nrdu: labels (comments 
  96. in the source will assist), or use a file patcher.   To assist this, there are 
  97. two "signposts" just after the  beginning  of the  code (at 0110h).   The byte 
  98. after the  ROOT> signpost  should  be  set  to 0ffh if the ROOT:  directory is 
  99. required.   If not,  this byte should be set to zero,  and the bytes after the 
  100. following signpost (DU:>) modified to the required drive and  user area (drive 
  101. first, (A = 0),  then user area 0-15 (16-31 might work; who knows?)).   If you 
  102. have a RAM disk or hard disk, it's probably better to force the use of this as
  103. TEX will load and save the TEX.VAR file more quickly.
  104. :4
  105.  TEX Notes - 1/2 
  106.  
  107.    a. Since TEX is  a shell,  it can only schedule and run programs when it is 
  108.       itself running (when all other  programs have terminated).   You can use 
  109.       your computer normally while TEX is  running,  with  a short delay after 
  110.       each program is run  while TEX  reloads itself  and  loads  its variable 
  111.       file,  but  programs  scheduled for  execution while other programs  are 
  112.       running  will  not  be executed  until TEX is  entered  after  the first 
  113.       program terminates.  TEX is not a multi-tasking system.
  114.  TEX Notes - 2/2    
  115.  
  116.    b. Vs. 1.1 updates 
  117.       - fixed bug which stopped new commands from a .TEX file from being saved
  118.         in TEX.VAR if there were more commands on the command line.
  119.       - ASCII command file on invocation now defaults to .TEX
  120.  
  121.    c. Vs 1.2 updates
  122.       - fixed bug in shell routine which resulted in bad command lines for 
  123.         user numbers greater than 9 
  124.       - fixed bug which caused bad time addition for repeated execution
  125.  
  126.    d. Vs 1.3 updates          
  127.       - replaced BCDBIN with JBCD2BN from ZSLIB
  128.       - modified GETTIME to use DSLIB/ZSLIB routines so ZSDOS, Z80DOS or CP/M+
  129.         clocks will all work
  130.       - assembled ok as-is with SLR Z80ASM
  131.       - tested with ZSDOS only, see excerpt from DSLIB.HLP below
  132. :5
  133.  Examples of Use 
  134.  
  135.    a. !X 06:30 !R /1;SAK /B WAKE UP! 
  136.  
  137.       - schedules SAK to  ring the  console  bell  continuously every  day  at
  138.         6:30 am!
  139.  
  140.    b. !R /2 10:5:3 !X 15/3/88 12:04;SEND NEATPROG.WOW;SAK /BP10 SENT
  141.       >> IT!;MAKE COFFEE 
  142.  
  143.       - schedules the  program SEND  at 12:04 pm on  March 15,  1988 with  the 
  144.         parameter NEATPROG.WOW,  then schedules SAK to ring the console for 10
  145.         seconds and  type  SENT IT!,  then make the  coffee (!).   Finally the
  146.         whole sequence would be re-scheduled to occur again 2 days,  10 hours,
  147.         5 minutes and 3 seconds later.