|VCS Scripts: Script Command: CGM|
The CGM command specifies the creation of a cgm file. If a file name is given with no path, then the
directory path will be prefixed to the file name. If neither is given, or if the path and file name matches a previously opened cgm file, then this will be used. If neither is given, and if no previous cgm file is open, then a file named
where xx is a two digit number will be used unless all 99 defaults already exist, in which case no cgm file will be written.
If the path and file name does not match the open cgm file name, then the latter will be closed, and an attempt will be made to open the new file. If the new file already exists, then a file named
will be opened instead (see above). If the new file does not exist, and therefore cannot receive output, then no cgm output will be written. Otherwise, the new file is opened.
There are two modes for saving a cgm file: `append' mode appends cgm output to an existing cgm file; `replace' mode overwrites an existing cgm file with new cgm output.
CGM([path/file name], mode)
where mode is either `append' or `replace'.
Append to an existing file:
Replace an existing file: