You are here: Commands > Set with No Preference Equivalents > Set Folder

Set Folder

Specifies default project folder or returns default to the root for the current Analyzer Project. Used to specify the output location for table layouts created by Analyzer commands if other than root folder for the current Analyzer Project.

For local-based data, using Set Folder will also cause the output data to be placed in the specified folder.

For server-based data, regardless of the Set Folder command, the output data will automatically be placed in the location specified by the output prefix for the active server profile (unless you manually override the output path for the Analyzer command creating the output table).

For scheduled jobs on the Arbutus Windows Server, you are necessarily scheduling jobs where all tables you are utilizing must be server-based tables. Therefore, regardless of the Set Folder command, the output data will always be placed in the location specified in the output prefix for the active server profile. However, if the output type for a scheduled job is set to Shared, then the output prefix is ignored and the output data is automatically placed in the root of the shared folder for the scheduled job.

Command Mode Syntax

SET FOLDER <KEEP> <TO> <folder>

SET FOLDER <OFF>

• folder is relative to the current (default) folder. If a folder does not exist, it is automatically created. You can specify multiple and/or “absolute” folders by using either the “\” or “/” separator which act substantially the same as backslashes in a DOS path. By default, the set folder is always reset if a subsequent table is accessed from a different folder.
• KEEP ensures that the issued Set Folder command is maintained regardless of whether a table is subsequently accessed from a different folder and until the current project is changed, the Analyzer session is closed or another Set Folder command is issued.
• OFF turns off the KEEP folder. The next time a table is opened Analyzer resets the folder to that of the opened table.

Examples

Assuming the Analyzer Project root folder is “C:\Data\” and the current (default) folder is initially set to “C:\Data\Clients\:

SET FOLDER TO TEMP

• will set the current folder to “C:\Data\Clients\Temp\”

SET FOLDER TO TEMP\OUTPUT

• will set the current folder to “C:\Data\Clients\Temp\Output\”

SET FOLDER TO \TEMP\OUTPUT

• will set the current folder to “C:\Data\Temp\Output\”

SET FOLDER KEEP TO \TEMP

• will set the folder for the session permanently to “C:\Data\Temp\”

SET FOLDER OFF

• will set the permanent KEEP folder off

SET FOLDER

• will set the current folder to the Analyzer Project root “C:\Data\”

Note: For information on deleting folders, see the Folder option of the Delete command.