home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / articles / archives / limanews.exe / TSHELL.TXT < prev    next >
Text File  |  2006-10-19  |  9KB  |  262 lines
  1. ORIGINALLY PUBLISHED IN LIMA NEWSLETTER FEBRUARY 1990
  2.  
  3.      ^^  T-SHELL ADDS DOS-LIKE COMMANDS TO EXTENDED BASIC  
  4.      ^^^^^^^^^^a brief review by Charles Good 
  5.      ^^^^^^^^^^^^^^^^Lima Ohio User Group 
  6.       
  7.      In recent years several "extended basic enhancements"
  8. have been released commercially, mainly for the benefit of
  9. XB programmers.  These include EZ-KEYS PLUS, SUPERBASIC, and
  10. COMMAND DOS.  Now us ordinary mortal XB USERS have T-SHELL,
  11. one of the most important and useful software packages to
  12. appear for the extanded basic USER in some time.  T-SHELL
  13. is FREE (public domain, not Freeware) and was initially
  14. released recently as part of Barry Travers's GENIAL TRAVelER
  15. v2 #5.  It sits transparent in memory unaffected by any XB
  16. code except CALL INIT, and allows you to do the following
  17. from XB command mode: 
  18.      CATALOG any drive of any name to screen or printer. 
  19.      COPY individual files or entire disks. 
  20.      PROTECT and UNPROTECT a file. 
  21.      RENAME a file or a disk. 
  22.      SWEEP a disk.  (dangerous!!) 
  23.      TYPE a DV80 file to the screen or a printer. 
  24.       
  25.      Although is not specifically stated in the T-SHELL doc,
  26. you can MERGE any XB program that does not contain CALL INIT
  27. onto the end of T-SHELL any place after T-SHELL's line
  28. number 10 and then resave the whole thing to disk.  Then,
  29. every time you OLD or RUN the XB program, T-SHELL will also
  30. be there.  You can't use the T-SHELL commands from within
  31. the program, but when the program ENDs or you BREAK the
  32. program, T-SHELL's commands will be there in memory waiting
  33. for you to use from command mode. 
  34.       
  35.      The only important DOS feature I find lacking in
  36. T-SHELL is a way to INITILAIZE a blank disk (something you
  37. can do from command mode with SUPERBASIC).  For example, you
  38. need a preinitialized disk in order to use the COPY command.
  39. Tony McGovern, in a letter to me, once said that having an
  40. instantly available disk initialization routine is sort of
  41. like having a loaded gun laying around.  Nevertheless, I
  42. would like to see this feature incorporated into future
  43. versions of T-SHELL. 
  44.       
  45.      T-SHELL's author is Travis Watford, the author of the
  46. well known public domain program MAX-RLE and several
  47. commercial TI and Geneve programs.  His T-SHELL doc appears
  48. below and describes in detail the fantastic potential of
  49. this software. 
  50.      ------------------------------------ 
  51.  T-SHELL Notes by Travis Watford 
  52.       
  53.         T-SHELL is a software package
  54.  designed to provide the Extended BASIC
  55.  programmer/user with some of the basic
  56.  disk access utilities that TI, in
  57.  their infinite wisdom, chose not only
  58.  to leave out, but, in fact, to hinder. 
  59.       
  60.         T-SHELL allows you to type disk
  61.  commands at the Extended BASIC command
  62.  line as though they were built in.  A
  63.  list of the commands that T-SHELL adds
  64.  to your system follows in detail, so I
  65.  will not give one here. 
  66.       
  67.  Loading T-SHELL 
  68.         T-SHELL is provided here as a
  69.  program image file.  You simply enter
  70.  RUN "DSK1.T-SHELL" to load and make
  71.  the package active. 
  72.       
  73.         Once loaded, T-SHELL is turned
  74.  off/on by: 
  75.         CALL LINK("UNSET") 
  76.         CALL LINK("SET") 
  77.       
  78.         If for any reason you decide
  79.  to remove T-SHELL by typing in "CALL
  80.  INIT", you must first turn T-SHELL off
  81.  as described above.  The package as
  82.  supplied should work on any 4A system.
  83.  If, however, you use a SYSTEX-like
  84.  package to add additional assembly
  85.  routines to T-SHELL, the resulting
  86.  program may no longer run on any
  87.  machine other than the one on which
  88.  the alterations were made. 
  89.       
  90.  Using T-SHELL 
  91.         T-SHELL commands are typed at
  92.  the command line just like Extended
  93.  BASIC commands.  There are currently
  94.  ten active commands, although more
  95.  will be added as I get around to it.
  96.  Commands may be typed in any mixture
  97.  of upper and lower case.  Arguments in
  98.  brackets are optional. 
  99.       
  100.  VERSION: 
  101.         This command lists the program
  102.  name, version number, date, my name
  103.  and my CompuServe number if you would
  104.  like to leave me any complaints or
  105.  suggestions. 
  106.       
  107.  DRIVE [drivename]: 
  108.         Typed by itself, this command
  109.  displays the current default drive
  110.  name.  The name can be up to 49 char-
  111.  acters long and is initially set to
  112.  "DSK1."  It could be changed to read
  113.  something like "DSK.RAMDISK.", in
  114.  which case it would address the disk
  115.  named "RAMDISK".  Hopefully (although
  116.  I could not test it) it could be
  117.  changed to "HDS1.SUBDIR1.SUBDIR2."
  118.  The drive name must end with a period
  119.  character. 
  120.       
  121.         If the command is followed by
  122.  text, that text becomes the default
  123.  drive name.  The default drive name
  124.  can be abbreviated by "." when it is
  125.  the first character of a string.  This
  126.  will be explained more fully in the
  127.  descriptions of other commands. 
  128.       
  129.  PRINTER [printername]: 
  130.         Typed alone, this command will
  131.  display the current default printer.
  132.  Again the name can be up to 49 char-
  133.  acters long.  It is initially set to
  134.  "PIO" but can be any valid file name
  135.  or a disk name(e.g. "DSK1."). 
  136.       
  137.         If the command is followed by
  138.  text, that text becomes the default
  139.  printer name.  The default printer
  140.  name can be abbreviated by "," when it
  141.  is the first character of a string.
  142.  This will be explained more fully in
  143.  the descriptions of other commands. 
  144.       
  145.  CATALOG [drivename] [printername]: 
  146.         This command catalogs a drive.
  147.  Alone it displays the default drive's
  148.  catalog to the screen.  If it is fol-
  149.  lowed by text, that text is assumed to
  150.  be the name of the drive to catalog,
  151.  for example, "CATALOG DSK2.", or maybe
  152.  "CATALOG ." (though the latter just
  153.  catalogs the default drive, so the "."
  154.  is unneccessary), or maybe "CATALOG ,"
  155.  (if you had set the default printer
  156.  name to something like "DSK1."). 
  157.       
  158.         If the command is followed by
  159.  two text strings, it will assume the
  160.  first is a drive name and the second
  161.  is a printer name.  Thus the command
  162.  "CATALOG DSK.RAMDISK. RS232" will
  163.  print the catalog of the disk named
  164.  "RAMDISK" to the RS232 and the command
  165.  "CATALOG .," will print the catalog
  166.  of the default drive to the default
  167.  printer. 
  168.       
  169.  TYPE filename [printername]: 
  170.         "TYPE .file" will type a DV80
  171.  file named "file" from the default
  172.  drive onto the screen.  If there is a
  173.  second text string, it is assumed to
  174.  be the printer name.  So, the command
  175.  "TYPE .file PIO" will print the file
  176.  named "file" from the default drive to
  177.  the parallel printer. 
  178.       
  179.  RENAME name [filename]: 
  180.         RENAME will change the name of
  181.  a file or a disk.  For example, the
  182.  command "RENAME DSK1.RAMDISK" will
  183.  change the name of the disk in drive
  184.  one to "RAMDISK".  When there is a
  185.  second string, the command will rename
  186.  a file.  "RENAME .TEMP perm" will
  187.  rename the file "TEMP" on the default
  188.  drive to "perm".
  189.         Only the first file name is
  190.  preceded by the drive name. 
  191.       
  192.         This command requires a drive
  193.  name of the form "DSKx.", where "x" is
  194.  a single digit.  While some T-SHELL
  195.  commands can use names such as
  196.  "DSK.RAMDISK.", others require the
  197.  disk number to access DSR subroutines
  198.  to perform their function. 
  199.       
  200.  PROTECT filename: 
  201.         This command protects a file.
  202.  "PROTECT DSK2.FILE" will mark the file
  203.  named "FILE" on DSK2 as protected.
  204.         This command requires a drive
  205.  name of the form "DSKx." 
  206.       
  207.  UNPROTECT filename: 
  208.         This command unprotects a file.
  209.  "UNPROTECT DSK2.FILE" will clear the
  210.  protection flag on the file named
  211.  "FILE" on DSK2.
  212.         This command requires a drive
  213.  name of the form "DSKx." 
  214.       
  215.  COPY source destination: 
  216.         This command will copy a file
  217.  or a disk.  If the names are of the
  218.  form "DSKx.", T-SHELL will attempt to
  219.  copy the named disk.  Otherwise, it
  220.  will copy the named file.
  221.         This command requires a drive
  222.  name of the form "DSKx." 
  223.       
  224.  SWEEP diskname: 
  225.         This command will delete all
  226.  files from a disk.  The target disk
  227.  disk must be explicitly identified.
  228.  This command can be quite destructive
  229.  if used carelessly.  It will not give
  230.  you a chance to back out, so don't
  231.  type it unless you mean it.
  232.         This command requires a drive
  233.  name of the form "DSKx." 
  234.       
  235.  Modifying T-SHELL Defaults: 
  236.         The commands, default drive and
  237.  default printer names have initial
  238.  values that suit me.  If they don't
  239.  suit you, they can be changed with a
  240.  sector editor.  For instance, you may
  241.  want to change "CATALOG" to "CAT" or
  242.  "DIR".  Commands must be uppercase and
  243.  must be exactly ten characters long.
  244.  Shorter commands are to be filled out
  245.  with spaces.  The default drive name
  246.  and default printer name can be up to
  247.  49 characters long, and must be fol-
  248.  lowed by a null character. 
  249.       
  250.         I hope you get some use out of
  251.  these utilities, and you may feel
  252.  free to use them however you wish,
  253.  but please don't change any of the
  254.  VERSION information including my
  255.  name.  I do not want any money for
  256.  this product, but I do want the
  257.  credit. 
  258.       
  259.      ^^^^^^^^^^^^^^^^^--Travis Watford 
  260.      .PL 1 
  261.  
  262.