home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / scheme / pcscheme / ti / pcscm3_3 / pkxli.arc / EXEC.DOC < prev    next >
Encoding:
Text File  |  1988-06-07  |  2.5 KB  |  72 lines
  1. "exec"
  2.  
  3. "exec" runs an application program from PC Scheme.
  4.  
  5.  
  6. Format:      (XCALL "exec" <program> <args>)
  7.  
  8. Parameter:    <program> is a string containing the name of an executable
  9.         file; the file extension need not be supplied.  The path
  10.         will be searched if the program does not reside in the
  11.         current directory.
  12.  
  13.         <args> is a string containing all the arguments to
  14.         <program>.
  15.  
  16. Explanation:    "exec" runs an executable file from PC Scheme.
  17.         "exec" operates similarly to DOS-CALL, but when used
  18.         in the proper circumstances it can be much faster.
  19.         The following three expressions, the first using "exec",
  20.         the second using DOS-CALL, and the third as you
  21.         would type it from DOS, have equivalent effect:
  22.         
  23.             (XCALL "exec" "prog" "arg1 arg2")
  24.  
  25.             (DOS-CALL "prog.exe" "arg1 arg2")
  26.  
  27.             prog arg1 arg2
  28.  
  29.         By default "exec" allocates a 64K memory
  30.         block in which to run programs.  The space allocated
  31.         can be changed through the DOS environment variable
  32.         "XLI"; its value is the number of kilobytes to reserve.
  33.         This must be done before entering PC Scheme.  For
  34.         example, to reserve 32K, you would type in this
  35.         expression to DOS before invoking PC Scheme:
  36.  
  37.             set XLI = 32
  38.  
  39.         The space reserved by "exec" is unavailable for Scheme's
  40.         heap, thereby diminishing the "usual" heap size.
  41.  
  42.         The return value from "exec" is the exit code
  43.         provided by the called program if it successfully
  44.         executed or -1 if the program could not be found 
  45.         anywhere in the path.
  46.  
  47.         "exec" is superior to DOS-CALL when you need quick
  48.         access to programs and you can give up heap space to do
  49.         so.  "exec" also provides for path searching and returning
  50.         a program's exit code.  DOS-CALL is preferable in those
  51.         cases where larger programs are run or you need maximal
  52.         heap space, and these considerations outweigh the loss
  53.         of speed that comes from having to move Scheme out of the
  54.         way to make room for the program.
  55.  
  56. Examples:    
  57.         (XCALL "exec" "edlin" "\\autoexec.bat")    
  58.             ;edit the file \autoexec.bat with DOS EDLIN editor;
  59.             ;remember the double backslash inside Scheme strings
  60.  
  61.         (XCALL "exec" "chkdsk")
  62.             ;runs the DOS CHKDSK program
  63.  
  64.         (XCALL "exec" "command" "/c dir *.s")
  65.             ;this shows how to execute DOS intrinsic commands
  66.             ;such as the DOS directory command--this lists
  67.             ;all Scheme source files in the current directory;
  68.             ;control returns immediately to PC Scheme
  69.  
  70.         (XCALL "exec" "command")
  71.             ;starts a secondary DOS command processor;
  72.             ;use DOS EXIT command to return to PC Scheme