Next: , Previous: INCLUDE, Up: Utilities


13.15 INSERT

          INSERT [FILE=]'file-name'
             [CD={NO,YES}]
             [ERROR={CONTINUE,STOP}]
             [SYNTAX={BATCH,INTERACTIVE}].

INSERT is similar to INCLUDE (see INCLUDE) but somewhat more flexible. It causes the command processor to read a file as if it were embedded in the current command file.

If ‘CD=YES’ is specified, then before including the file, the current directory will be changed to the directory of the included file. The default setting is ‘CD=NO’. Note that this directory will remain current until it is changed explicitly (with the CD command, or a subsequent INSERT command with the ‘CD=YES’ option). It will not revert to its original setting even after the included file is finished processing.

If ‘ERROR=STOP’ is specified, errors encountered in the inserted file will cause processing to immediately cease. Otherwise processing will continue at the next command. The default setting is ‘ERROR=CONTINUE’.

If ‘SYNTAX=INTERACTIVE’ is specified then the syntax contained in the included file must conform to interactive syntax conventions. See Syntax Variants. The default setting is ‘SYNTAX=BATCH’.