Next: PERMISSIONS, Previous: INCLUDE, Up: Utilities
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’.