Previous Topic

Next Topic

Book Contents

Book Index

Macro Keywords

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: /pub/reports. This is used primarily in per-file Next Actions.

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, [LEFT([FileDateStamp],10)] yields the YYYY-MM-DD date part and [MID([FileDateStamp],12,2)] will yields the hour from the date and time information of the original source file..

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: 1236518.

MOVEit

FolderName

Name of remote folder. This macro returns only the last part of the path. Example: Given a full remote path of frog\dog\cat, this macro returns cat.

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: 251660214.

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: Example.txt

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 C:\outgoing and the file in question is C:\outgoing\reports\Fred.txt, then when used in a destination path, [RelativePath] is reports.

Filesystem, FTP, MOVEit, SSH

Rnd

A random decimal number. Use the format [Rnd:len] where len is the desired number of digits. The random number generator is of cryptographic quality.

All

SyncReport()

Synchronization tasks can use a [SyncReport()] macro that allows a complete report of all synchronization actions to be sent in a Next Action email notification. For more information, see Synchronization - Next Actions. documentation.

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 618116254.

All

TaskName

The name of the task that is running

All

TaskStatus

The status of the task that is running. Values:

  • Success - the task encountered no errors and processed at least one file or ran at least one script
  • Failure - the task encountered one or more errors
  • No xfers - the task encountered no errors but did not process any files or run any scripts.

All

Date specification (see below)

Current date and time. Example: Given a time of 10:06 and a macro of [HH][TT], the macro returns 1006.

Filesystem, FTP, MOVEit, SSH

Macro function
(see below)

Returns the results of a string operation

All

Examples: (Given January 3, 2002 13:11:01, original filename=myfile.txt)