home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / ibm1 / do101j2.arj / SCRIPTS.SCR < prev    next >
Encoding:
Text File  |  1991-12-03  |  2.7 KB  |  78 lines
  1. .ma
  2.     DO SCRIPTS»#«
  3.  
  4.     »%t«DO»#« scripts are standard »cy«DOS ASCII text files»#«. They can be
  5.     created with any text editor or word processor which does
  6.     »re«NOT»#« introduce special formatting characters into the script.
  7.     »%t«DO»#« scripts can be of any length. However, scripts containing
  8.     a large number of labels may exceed the memory capacity of your
  9.     computer.
  10.  
  11. .pg clr ye
  12.     DO.CFG »gray«-- »%t«DO»ye« Configuration Script
  13. »#«
  14.     The first thing »%t«DO»#« does when started is look in the DOS PATH
  15.     for a special script "»ma«DO.CFG»#«".  This script, if found, will be
  16.     executed.  It can be used to set up you »%t«DO»#« environment. Typical
  17.     uses would be to set the external editor (»gr«EDIT»#«) and file lister
  18.     (»gr«LIST»#«) you wish to use with »%t«DO»#«.  Since "»ye«DO.CFG»#«" is a standard
  19.     »%t«DO»#« script, any commands can be used there.
  20.  
  21. .pg clr
  22.     »c 2 1«STARTING DO.EXE»#«
  23.  
  24.     To start »%t«DO»#«, from the DOS command line type:
  25.  
  26.     »cy«C> »ye type«DO [{ScriptFile} [{parameters}] [/E|/R]]»pg std«
  27.  
  28.     Where "»ye«{ScriptFile}»#«" is the name of the script you wish to
  29.     run and »ye«{Parameters}»#« are any values to be passed
  30.     to the script. »ye«{ScriptFile}»#« can include a full DOS path
  31.     specification. If only "DO" is entered, »%t«DO»#« starts in
  32.     Interactive mode.
  33. .pg
  34.  
  35.     You can use »%t«DO»#«'s built in editor to edit the script or any
  36.     other file with less than »ye«64,000»#« characters. To do this,
  37.     enter the "/E" or "/R" switch after the {ScriptFile}.
  38.  
  39.     »bo«/E»#«   Edit the indicated file and then return to DOS
  40.     »bo«/R»#«   Edit the indicated script then run the script.
  41.  
  42.     Later in this tutorial, we'll look at the built-in editor in
  43.     connection with the EditFile command.
  44. .pg clr
  45.  
  46.     There is no need to enter the Script file's extension if it
  47.     is the default "»re«SCR»#«". For example:
  48.  
  49.     »cy«C> »ye type pa 2 «DO TEST»std norm«
  50.  
  51.     This command line executes the script TEST.SCR.
  52.  
  53.     »cy«C> »ye type pa 2 «DO TEST.TXT»std«
  54.  
  55.     This command line executes the script TEST.TXT.
  56.  
  57.     »cy«C> »ye type pa 2 «DO TEST 2 XYZ»std«
  58.  
  59.     This command line executes the script TEST.SCR and passes
  60.     the parameters "»cy«2»#«" and "»cy«XYZ»#«". (See "Parameter Passing" for
  61.     more information on passing values to a script).
  62. .pa 2
  63.  
  64.     If you wish to run a script which does »re«NOT»#« have an
  65.     extension, you must enter the trailing period ("»c 10 0«.»#«"):
  66.  
  67. .pg clr
  68.  
  69.  
  70.  
  71.         Because »%t«DO»#« reads its scripts from the disk, it must
  72.         always have access to these files.  »wh«Do »+re«NOT»wh« place
  73.         »%t«DO»wh« scripts on media that will be removed!»#«
  74.  
  75.  
  76. /BOX 4 2 63 8 14 11 " SPECIAL NOTE "
  77. /ENDEXEC CLEAR
  78.