Save As

Saves the current SA file with the provided filename and path. An optional serial number will be appended to the filename.

 

Input Arguments

 

0

File Path or Embedded File

File Name

The .XIT file to use when saving the current file.

1

Boolean

Add Serial Number?

Specify whether or not to append a serial number to the filename.

2

Integer

Optional Number

The serial number to append to the file-

name. Only applies when Argument 1 is TRUE.

Return Arguments

None.

 

Returned Status

 

SUCCESS

The file was saved successfully.

FAILURE

The file could not be saved. (Perhaps the path was not accessible).

Remarks

This command supports both absolute paths (ex. C:\test.xit) and relative paths (ex. .\test.xit).

If a relative path is provided and the MP is embedded, the path will be relative to the current SA file location.

 

Examples

The following absolute path saves the SA file at the given specific drive location:

 

0

File Path or Embedded File Name

SA File Name

c:\Analyzer Data\sample.xit

 

The following relative path saves the SA file in the “sub” subdirectory of the currently executing MP’s location:

 

0

File Path or Embedded File Name

SA File Name

.\sub\sample.xit

 

This means that if the executing external MP is located at c:\myMPs, the file that will be saved will be c:\myMPs\ sub\sample.xit.