File System - Change Folder
Declaration
<AMCHANGEFOLDER FOLDER="text" />
Description: Changes the current folder or "working directory" for the running task. This is similar to double-clicking the folder you wish to change to in Windows Explorer or using the Cd or Chdir command in MS-DOS (For example: 'chdir c:\' or 'cd c:\').
Practical Usage
Commonly used to change the working directory when using relative paths.
General Parameters
Property |
Type |
Required |
Default |
Markup |
Description |
---|---|---|---|---|---|
Folder |
Text |
Yes |
(Empty) |
FOLDER="C:\Temp\FolderName" |
The full path and folder name of the folder to change to. |
Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.
Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)
On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)
Example
The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.
Description: Change to folder "c:\documents\folder1".
<AMCHANGEFOLDER FOLDER="c:\documents\folder1" />