Attribute |
Description |
Applicable Host Types |
---|---|---|
DestFileName |
The filename of the most recent destination file, not including any directory names. For example: "report12.txt". This is used primarily in per-file Next Actions. |
All |
DestFolderPath |
The folder path, including all folder components but not the filename, of the most recent destination file. For example: |
All |
ErrorCodeFile |
The last error code encountered for the current file, or 0 if no error. For an example of how to use this macro to report errors, see Next Actions. |
All |
ErrorDescriptionFile |
The last error description encountered for the current file, or empty if no error. For an example of how to use this macro to report errors, see Next Actions. |
All |
ErrorCodeTask |
The last error code encountered for this task, or 0 if no error. For an example of how to use this macro to report errors, see Next Actions. |
All |
ErrorDescriptionTask |
The last error description encountered for this task, or empty if no error. For an example of how to use this macro to report errors, see Next Actions. |
All |
FileDateStamp |
The date stamp of the file as recorded by the source, in the form YYYY-MM-DD HH:MM:SS. Not all sources provide date stamps. When using this macro in a destination filename or folder name, you usually combine it with macro string functions. For example, |
Filesystem, FTP (most), MOVEit, SSH |
FileSize |
The size of the file, in bytes, as recorded by the source. Note: some unusual FTP servers do not provide the file size; in these cases, a size of 0 is used. |
Filesystem, FTP (most), MOVEit, SSH |
FolderID |
Unique number identifying a MOVEit folder. For example: |
MOVEit |
FolderName |
Name of remote folder. This macro returns only the last part of the path. Example: Given a full remote path of |
Filesystem, FTP, MOVEit, SSH |
FullPath |
The full path of the file as it was on the source, including all directories and the filename. |
Filesystem, FTP, MOVEit, SSH |
ID |
Unique number identifying a MOVEit file. For example: |
MOVEit |
NominalStart |
The time this task was officially started in YYYY-MM-DD HH:MM:SS format (for example, 2006-07-18 11:33:16). This value combined with the TaskID yields a key that uniquely identifies a single task run (e.g., in the "stats" database table). |
All |
OrigComment |
The upload comment that was specified when the file was uploaded. (This is often blank.) |
MOVEit |
OrigName |
Original name of this file. Example: |
Filesystem, FTP, MOVEit, SSH |
OrigUser |
The username of the user who uploaded the file. |
MOVEit |
OrigUserEmail |
The email address of the user who uploaded the file. |
MOVEit, POP3 |
OrigUserFull |
The full name of the user who uploaded the file. |
MOVEit |
OrigUserID |
The UserID of the user who uploaded the file, if the MOVEit Transfer host is version 5.5 or later. If the MOVEit Transfer host is an earlier version, this will be the empty string. (The UserID is typically a long string starting with the username; a typical UserID might be "fred9zyupmuxa6dk".) |
MOVEit |
OnlyName |
The original filename minus the extension and the period. Example: Given "frog.txt", this macro returns "frog". |
Filesystem, FTP, MOVEit, SSH |
OnlyExt |
The original filename extension. Example: Given "frog.txt", this macro returns "txt". |
Filesystem, FTP, MOVEit, SSH |
Parm:ParmName |
Returns the task parameter named ParmName. If there is no such parameter, the empty string is returned. |
All |
RelativePath |
The pathname of the directory for this file, relative to the originally specified source path. This applies only when Include Subdirectories is selected, and cannot be used for source paths. For example, if the source path is |
Filesystem, FTP, MOVEit, SSH |
Rnd |
A random decimal number. Use the format |
All |
SyncReport() |
Synchronization tasks can use a |
Next Actions Following Sync Tasks |
TaskID |
The ID of the task that is running. This number is used internally in the configuration files and the database to identify tasks. A typical value would be a nine-digit number such as |
All |
TaskName |
The name of the task that is running |
All |
TaskStatus |
The status of the task that is running. Values:
|
All |
Date specification (see below) |
Current date and time. Example: Given a time of |
Filesystem, FTP, MOVEit, SSH |
Macro function |
Returns the results of a string operation |
All |
Examples: (Given January 3, 2002 13:11:01, original filename=myfile.txt)
[WW][AAA].[OnlyExt]
Returns 00Thu.txt
gotit[JJJ]-[YYYY].log
Returns gotit002-2002.log
[OrigName]
Returns myfile.txt
[OnlyName]_[MM]-[DD]-[YY].[OnlyExt]
Returns myfile_01-03-02.txt
ReallyBigText [AAA], [MM]-[DD]-[YY]
Returns ReallyBigText Tue, 01-03-02