Variables

<< Click to Display Table of Contents >>

Navigation:  Using SyncBackPro > Technical Reference >

Variables

Previous pageReturn to chapter overviewNext page

 

Defining Variables

 

SyncBackPro includes a whole range of variables that can be used in various profile settings, e.g. the Source and Destination. Variables are values which are not known until the profile is run. At runtime the variables are replaced by their value. Note that you can also define your own profile variables, both at the group level and at the profile level. You can also get values from the registry.

 

For variables see the following sections on this page:

 

Days

Weeks

Months

Years

Dates

Times

Drives, Files, and Folders

Misc.

Backup to email

Backup from email

Emailing the log

Registry

SyncBack Touch

Order of evaluation

Important notes

 

Examples of variable usage

 

Although variables appear to be complex, they are in fact very simple. Just remember that a variable is replaced with its value when the profile is run. A couple of examples will make it clear:

 

You are the administrator for a number of employees computers and want to create a backup profile that makes a backup of all the users documents. This profile will be imported on each users computer so you don't need to manually create it on each computer. Each user has their own 'My Documents' folder on a computer, so if you set the source folder to one users folder then it wouldn't work for other users (because they have different usernames, so the path would be different). To avoid this you can simply set the source to %CSIDL_PERSONAL%. Now when the profile is run it will replace the %CSIDL_PERSONAL% string with the users My Documents path.

 

You want to backup to a Zip file and use the current date in the filename of the Zip file. To do this simply set your destination (for example) to X:\Backup\%DATE%.Zip

 

Variables are user specific

 

Remember that the value of a variable may be user-specific. For example, the variable %CSIDL_PERSONAL% (see the example above) has a different value for each user (because every users has their own My Documents folder). So if you have a profile set to run as a specific user, e.g. via Run As or via the scheduler, then keep in mind that the value returned depends on the user who is running the profile.

 

Changes in SyncBackPro V7

 

In SyncBackPro V6 and earlier the Windows environment variables (system and user) that were available once the SyncBackPro process started were the variables that were always used. This meant that if a variable was changed, created or deleted while SyncBackPro was already running then those changes would not be recognized until SyncBackPro was restarted. From V7 onwards this has changed so that the current state of the variables is used instead of the state they were in when the program was started. This means variables can now be changed in batch files, scripts, other programs, etc. and those changes will be seen by SyncBackPro.

 

Windows security and environment variables

 

Windows Vista introduced the concept of elevation, meaning a program run by an administrator didn't run with full privileges unless it requested them and the user explicitly granted them. In Windows terms it is called UAC (User Account Control):

 

 http://windows.microsoft.com/en-us/windows/what-is-user-account-control#1TC=windows-7

 

For example, when SyncBackPro is run you are asked, by Windows, to allow it to run elevated. By running elevated SyncBackPro can copy locked files, for example. One side effect of this is that processes that run elevated, like SyncBackPro and SyncBackSE, cannot access some things that were set by non-elevated processes. For example, using the Windows File Explorer you can map a network drive to a drive letter. Windows File Explorer does not run elevated. When SyncBackPro and SyncBackSE is run it cannot see the mapped drive. This is because of the security introduced in Windows Vista. The same applies to environment variables. If you open a command prompt (not elevated), set an environment variable and then run SyncBackPro or SyncBackSE, it will not be able to see those environment variables. This is also because of the security introduced in Windows Vista. One option is to use SETX to set the variables and the other option would be to run the command prompt elevated.

 

SyncBackFree does not have these Windows security related issues because it does not run elevated.

 

Days

 

The following variables are related to days of the week, month, etc:

 

%DAY% Current day of the month, e. g. 10

 

%DAYOFMONTH% Alias for %DAY%

 

%DAYODDEVEN% Odd or even day of the year (O = odd day, E = even day)

 

%DAY_P% Yesterdays day of the month (could be previous month)

 

%DAY_N% Tomorrows day of the month (could be next month)

 

%DAYOFWEEK% Current day of the week, (1 = Monday, 7 = Sunday)

 

%DAYOFWEEK_P% Yesterdays day of the week

 

%DAYOFWEEK_N% Tomorrows day of the week

 

%DAYOFYEAR% Current day of the year (January 1st = 1)

 

%DAYOFYEAR_P% Yesterdays day of the year

 

%DAYOFYEAR_N% Tomorrows day of the year

 

%DAYOFQUARTER% Current day of the current quarter of the year (January 1st, April 1st, July 1st, October 1st = 1)

 

%DAYOFQUARTER_P% Yesterdays day of the quarter of the year

 

%DAYOFQUARTER_P% Tomorrows day of the quarter of the year

 

%NTHDAYOFWEEK% Note that this value may differ from the value that the WeekOfTheMonth variable returns, because NthDayOfWeek counts every occurrence of the given weekday, while WeekOfTheMonth only counts a week if it includes 4 or more days in the month. Thus, for example, if today is a Saturday and is the first day of a month, NthDayOfWeek returns 1, while WeekOfTheMonth returns 5 (or maybe 4), indicating the last week of the previous month.

 

%DAYSINMONTH% Number of days in current month.

 

%DAYSINYEAR% Number of days in current year.

These new variables allow you, for example, to keep 7 days worth of backups, e. g. you could set your destination to D:\Backup\%DAYOFWEEK%\ so that you'll always have backups of the last seven days worth of files.

 

%DAYOFWEEKNAME% The first three letters of the day of the week, e.g. Mon. Note that English is always used.

 

%DAYOFWEEKNAME_P% The first three letters of yesterday

 

%DAYOFWEEKNAME_N% The first three letters of tomorrows

 

%LASTRUNDAY% The day of the month that the profile was last run (empty string if it has not yet been run)

 

%LASTSUCCESSRUNDAY% The day of the month that the profile was last run without error (empty string if it has not yet been run without error)

 

Weeks

 

The following variables are related to weeks of the month, year, etc:

 

%WEEKOF% Week of the year (1 to 53). WeekOf uses the ISO 8601 standard to define the week of the year. That is, a week is defined as running from Monday through Sunday, and the first week of the year is defined as the one that includes the first Thursday of the year (the first week that includes four or more days in the year). This means that if the first calendar day of the year is a Friday, Saturday, or Sunday, then for the first three, two, or one days of the calendar year, WeekOf returns the last week of the previous year. Similarly, if the last calendar day of the year is a Monday, Tuesday, or Wednesday, then for the last one, two, or three days of the calendar year, WeekOf returns 1 (the first week of the next calendar year).

 

%WEEKOFODDEVEN% Odd or even week of the year (O = odd week, E = even week)

 

%WEEKOFTHEMONTH% Week of the month (1 to 6). WeekOfTheMonth uses the ISO 8601 standard definition of a week. That is, a week is considered to start on a Monday and end on a Sunday. The first week of a month is defined as the first week with four or more days in that month. Thus, if the first day of the month is a Friday, Saturday, or Sunday, the first one, two, or three days of the month are defined as belonging to the last week of the previous month. Similarly, if the last day of the month is a Monday, Tuesday, or Wednesday, then the last one, two, or three days of the month are defined as belonging to the first week of the next month.

 

%WEEKOFQUARTER% Current week of the current quarter of the year (January 1st, April 1st, July 1st, October 1st = 1)

 

%WEEKOFQUARTER_P% Yesterdays week of the quarter of the year

 

%WEEKOFQUARTER_P% Tomorrows week of the quarter of the year

 

%WEEKSINYEAR% The number of weeks in the year (52 or 53). WeeksInYear defines the first week of the year according to the ISO 8601 standard. That is, the first week of the year is the one that includes the first Thursday of the year (the first week that has 4 or more days in the year). This means that WeeksInYear always returns either 52 or 53.

 

Months

 

The following variables are related to months of the year:

 

%MONTH% Current month, e. g. 12

 

%MONTH_P% Previous month

 

%MONTH_N% Next month

 

%MONTH_Y% Yesterdays month

 

%MONTH_T% Tomorrows month

 

%MONTHNAME% The first three letters of the current month, e.g. Jan. Note that English is always used.

 

%MONTHNAME_P% The first three letters of last month

 

%MONTHNAME_N% The first three letters of next month

 

%MONTHNAME_Y% The first three letters of yesterdays month

 

%MONTHNAME_T% The first three letters of tomorrows month

 

%LASTRUNMONTH% The month that the profile was last run (empty string if it has not yet been run)

 

%LASTSUCCESSRUNMONTH% The month that the profile was last run without error (empty string if it has not yet been run without error)

 

%MONTHOFQUARTER% The number of the month of the quarter of the year. For example, January=1, February=2, March=3, April=1, May=2, etc.

 

%MONTHOFQUARTER_P% The number of the previous month of the quarter of the year. For example, if it is April then this returns 3 (for March), and if it is March then it would return 2 (for February).

 

%MONTHOFQUARTER_N% The number of the next month of the quarter of the year. For example, if it is March then this returns 1 (for April), and if it is April then it would return 2 (for May).

 

%MONTHOFQUARTER_Y% The number of yesterdays month of the quarter of the year.

 

%MONTHOFQUARTER_T% The number of tomorrows month of the quarter of the year.

 

Years

 

The following variables are related to years:

 

%YEAR% Current year in 4 digits, e. g. 2010

 

%YEAR2% Last two digits of current year, e. g. 09

 

%YEAR_P% Previous year

 

%YEAR_N% Next year

 

%YEAR_Y% Yesterdays year

 

%YEAR_T% Tomorrows year

 

%QUARTEROFYEAR% Returns the current quarter for the current year, i.e. 1 for January to March, 2 for April to June, 3 for July to September, and 4 for October to December.

 

%QUARTEROFYEAR_P% Returns the previous quarter for the current year. For example, if the current quarter is 2 then it returns 1, and if it is 1 then it returns 4.

 

%QUARTEROFYEAR_N% Returns the next quarter for the current year. For example, if the current quarter is 1 then it returns 2, and if it is 4 then it returns 1.

 

%QUARTEROFYEAR_Y% Returns yesterdays quarter for the current year.

 

%QUARTEROFYEAR_T% Returns tomorrows quarter for the current year.

 

%LASTRUNYEAR% The year that the profile was last run (empty string if it has not yet been run)

 

%LASTSUCCESSRUNYEAR% The year that the profile was last run without error (empty string if it has not yet been run without error)

 

Dates

 

The following variables are related to dates:

 

%DATE% Current date (it will be in the short date format configured in your installation of Windows)

 

%DATE_P% Yesterdays date

 

%DATE_N% Tomorrows date

 

Times

 

The following variables are related to times:

 

%TIME% Current time (it will be in the short time format configured in your installation of Windows)

 

%HOUR% Current hour (24 hour clock format), e. g. 19

 

%MINUTE% Current minute

 

%SECOND% Current second

 

%MILLISECOND% Current millisecond (0 to 999)

 

%HOUROFTHEYEAR% The number of complete hours between the current date & time and 12:00 AM on Jan 1 of the year.

 

%HOUROFTHEMONTH% The number of complete hours between the current date & time and 12:00 AM on the first day of the month.

 

%HOUROFTHEWEEK% The number of complete hours between the current date & time and 12:00 AM on Monday of the week.

 

%MINUTEOFTHEYEAR% The number of minutes between the current date & time and 12:00:00:00 AM on Jan 1 of the year.

 

%MINUTEOFTHEMONTH% The number of minutes between the current date & time and

12:00 AM on the first day of the month.

 

%MINUTEOFTHEWEEK% The number of minutes between the current date & time and 12:00 AM on Monday of the week (the week starts on Monday).

 

%MINUTEOFTHEDAY% The number of minutes between the current date & time and 12:00 AM on the same day.

 

%SECONDOFTHEYEAR% The number of seconds between the current date & time and 12:00:00:00 AM on Jan 1 of the year.

 

%SECONDOFTHEMONTH% The number of seconds between the current date & time and 12:00:00 AM on the first day of the month.

 

%SECONDOFTHEWEEK% The number of seconds between the current date & time and 12:00:00 AM on Monday of the week (the week starts on Monday).

 

%SECONDOFTHEDAY% The number of seconds between the current date & time and 12:00:00 AM on the same day.

 

%SECONDOFTHEHOUR% The number of seconds between the current date & time and the start of the same hour on the same day.

 

%MILLISECONDOFTHEYEAR% The number of milliseconds between the current date & time and 12:00:00:00 AM on Jan 1 of the year.

 

%MILLISECONDOFTHEMONTH% The number of milliseconds between the beginning (Midnight on the first day) of the month and the current date & time.

 

%MILLISECONDOFTHEWEEK% The number of milliseconds between the current date & time and 12:00:00:00 AM on Monday of the current week (the week starts on Monday).

 

%MILLISECONDOFTHEDAY% The number of milliseconds between the current date & time and the beginning (midnight) on the same day.

 

%MILLISECONDOFTHEHOUR% The number of milliseconds between the current time and the start of the same hour on the same day.

 

%MILLISECONDOFTHEMINUTE% The number of milliseconds between the current time and the start of the same minute on the same day.

 

Drives, Files, and Folders

 

The following variables are related to drives, files, and folders:

 

%THISDRIVE% The drive that SyncBackPro is running on, e. g. C:

 

%THISPATH% The path that SyncBackPro is running from, e.g. C:\Program Files\2BrightSparks\SyncBackPro\

 

%THISPROGRAM% The path and filename of the SyncBackPro program itself.

 

%SYNCBACKFOLDER% The default local (not roaming) folder that SyncBackPro stores it’s profiles in, e.g. %LOCALAPPDATA%\SyncBack\. Note that this is not necessarily where the user has decided to store his profiles (you may have configured it to store them in %THISPATH%, for example). If SyncBackPro is being run from an external drive then it is the same as %THISPATH%

 

%SYNCBACKBACKUPFOLDER% The default (not roaming) folder that SyncBackPro stores it’s profile backup files in, e.g. C:\Users\[username]\AppData\Local\2BrightSparks\SyncBackPro\Profiles Backup\. Note that this is not necessarily where the user has decided to store his profile backups. If SyncBackPro is being run from an external drive then it is the same as %THISPATH%Profiles Backup\

 

There are several special variables than can be used to identify drives based on their label or serial number. These are very useful when using external USB drives, for example, which may have a different drive letter each time they are plugged-in:

 

%LABEL=?% The entry is replaced by the drive letter with that label. For example, if your C drive is labeled My Disk then %LABEL=My Disk%Documents would be translated into C:\Documents. Note that you can only use one label per string but can use it multiple times. Also, the drives A and B are ignored (use LABELALL to include drives A and B, see below).

 

%LABELALL=?% This is the same as the LABEL variable except it also includes the drives A and B, which are typically floppy disk drives. When the floppy drive is accessed to get the label of the disk in it may become irritating, which is why you should use LABEL unless you need the label of a disk in drive A or B.

 

%SERIAL=?% The entry is replaced by the drive letter with that serial number. For example, if your D drive has a serial number of BC46-F69E then %SERIAL=BC46-F69E%Program Files will be translated at runtime into D:\Program Files. Note that you can only use one serial per string but can use it multiple times. Also, the drives A and B are ignored (use SERIALALL to include drives A and B, see below).

 

%SERIALALL=?% This is the same as the SERIAL variable except it also includes the drives A and B, which are typically floppy disk drives. When the floppy drive is accessed to get the serial number of the disk in it may become irritating, which is why you should use SERIAL unless you need the label of a disk in drive A or B.

 

%HWSERIAL=?% The entry is replaced by the drive letter with that hardware serial number. There are important differences between the hardware serial number and the volume (also called a partition) serial number used by the variables SERIAL and DISKSERIAL. The volume serial number is changed every time a volume is formatted. However, the hardware serial number is stored in the drive hardware itself and never changes. Another important difference is that the hardware serial number is the same for all volumes on a physical drive. For example, if you have a hard drive you could have two volumes on it, e.g. C: and D:. The hardware serial numbers for the volumes C: and D: will be identical because they are stored on the same physical drive. Because of this you should not use a hardware serial number if there is more than one volume on the drive (because which volume is returned is undefined in that case). If the drive is one of two or more connected to a RAID controller then the RAID controller will likely (but not guaranteed) return the serial number of the first available drive in the RAID array. Hardware serial numbers can only be used with Windows Vista or newer. Note that you can only use one serial per string but can use it multiple times.

 

%DISKLABEL% The label of the disk (volume) in the drive.

 

%DISKSERIAL% The unique serial number of the disk (volume) in the drive.

 

%DISKHWSERIAL% The hardware serial number of the drive. Hardware serial numbers can only be used with Windows Vista or newer. Note that if the hardware serial number cannot be retrieved then the variable is not expanded.

 

%CSIDL_DESKTOP% The virtual folder representing the Windows desktop, the root of the namespace.

 

%CSIDL_PROGRAMS% The file system directory that contains the user's program groups (which are themselves file system directories). A typical path is C:\Documents and Settings\[username]\Start Menu\Programs.

 

%CSIDL_PERSONAL% The virtual folder representing the My Documents desktop item. A typical path is C:\Documents and Settings\[username]\My Documents\

 

%CSIDL_FAVORITES% The file system directory that serves as a common repository for the user's favorite items. A typical path is C:\Documents and Settings\[username]\Favorites.

 

%CSIDL_STARTUP% The file system directory that corresponds to the user's Startup program group. The system starts these programs whenever any user logs onto Windows. A typical path is C:\Documents and Settings\[username]\Start Menu\Programs\Startup.

 

%CSIDL_RECENT% The file system directory that contains shortcuts to the user's most recently used documents. A typical path is C:\Documents and Settings\[username]\My Recent Documents.

 

%CSIDL_SENDTO% The file system directory that contains Send To menu items. A typical path is C:\Documents and Settings\[username]\SendTo.

 

%CSIDL_STARTMENU% The file system directory containing Start menu items. A typical path is C:\Documents and Settings\[username]\Start Menu.

 

%CSIDL_DESKTOPDIRECTORY% The file system directory used to physically store file objects on the desktop (not to be confused with the desktop folder itself). A typical path is C:\Documents and Settings\[username]\Desktop.

 

%CSIDL_NETHOOD% A file system directory containing the link objects that may exist in the My Network Places virtual folder. A typical path is C:\Documents and Settings\[username]\NetHood.

 

%CSIDL_FONTS% A virtual folder containing fonts. A typical path is C:\Windows\Fonts.

 

%CSIDL_TEMPLATES% The file system directory that serves as a common repository for document templates. A typical path is C:\Documents and Settings\[username]\Templates.

 

%CSIDL_COMMON_STARTMENU% The file system directory that contains the programs and folders that appear on the Start menu for all users. A typical path is C:\Documents and Settings\All Users\Start Menu.

 

%CSIDL_COMMON_PROGRAMS% The file system directory that contains the directories for the common program groups that appear on the Start menu for all users. A typical path is C:\Documents and Settings\All Users\Start Menu\Programs.

 

%CSIDL_COMMON_STARTUP% The file system directory that contains the programs that appear in the Startup folder for all users. A typical path is C:\Documents and Settings\All Users\Start Menu\Programs\Startup.

 

%CSIDL_COMMON_DESKTOPDIRECTORY% The file system directory that contains files and folders that appear on the desktop for all users. A typical path is C:\Documents and Settings\All Users\Desktop. Valid only for Windows NT systems.

 

%CSIDL_APPDATA% The file system directory containing application data for all users. A typical path is C:\Documents and Settings\All Users\Application Data.

 

%CSIDL_PRINTHOOD% The file system directory that contains the link objects that can exist in the Printers virtual folder. A typical path is C:\Documents and Settings\[username]\PrintHood.

 

%CSIDL_LOCAL_APPDATA% The file system directory that serves as a data repository for local (non-roaming) applications. A typical path is C:\Documents and Settings\[username]\Local Settings\Application Data.

 

%CSIDL_ALTSTARTUP% The file system directory that corresponds to the user's non-localized Startup program group. This is usually an empty value.

 

%CSIDL_COMMON_ALTSTARTUP% The file system directory that corresponds to the non-localized Startup program group for all users. This is usually an empty value.

 

%CSIDL_COMMON_FAVORITES% The file system directory that serves as a common repository for favorite items common to all users.

 

%CSIDL_INTERNET_CACHE% The file system directory that serves as a common repository for temporary Internet files. A typical path is C:\Documents and Settings\[username]\Local Settings\Temporary Internet Files.

 

%CSIDL_COOKIES% The file system directory that serves as a common repository for Internet cookies. A typical path is C:\Documents and Settings\[username]\Cookies.

 

%CSIDL_HISTORY% The file system directory that serves as a common repository for Internet history items.

 

%CSIDL_PROFILE% The user's profile folder. A typical path is C:\Documents and Settings\[username]

 

%CSIDL_COMMON_MUSIC% The file system directory that serves as a repository for music files common to all users. A typical path is C:\Documents and Settings\All Users\Documents\My Music

 

%CSIDL_MYMUSIC% The users music files folder.

 

%CSIDL_COMMON_PICTURES% The file system directory that serves as a repository for image files common to all users. A typical path is C:\Documents and Settings\All Users\Documents\My Pictures

 

%CSIDL_MYPICTURES% The users image files folder.

 

%CSIDL_COMMON_VIDEO% The file system directory that serves as a repository for video files common to all users. A typical path is C:\Documents and Settings\All Users\Documents\My Videos

 

%CSIDL_MYVIDEO% The users video files folder.

 

%CSIDL_CDBURN_AREA% The file system directory acting as a staging area for files waiting to be written to CD. A typical path is C:\Documents and Settings\username\Local Settings\Application Data\Microsoft\CD Burning

 

%CSIDL_WINDOWS% The Windows directory. This corresponds to the %windir% or %SYSTEMROOT% environment variables. A typical path is C:\Windows

 

%CSIDL_SYSTEM% The Windows System folder. A typical path is C:\Windows\System32 for both 32-bit and 64-bit versions of Windows.

 

%CSIDL_SYSTEMX86% The 32-bit Windows System folder (even if you are using 64-bit Windows). For 64-bit versions of Windows this may be C:\Windows\SYSWOW64

 

%CSIDL_PROGRAM_FILES% The 32-bit program files folder. A typical path is C:\Program Files for 32-bit versions of Windows, and C:\Program Files (x86) for 64-bit versions of Windows.

 

%CSIDL_PROGRAM_FILESX86% The 32-bit program files folder (even if you are using 64-bit Windows).

 

%CSIDL_PROGRAM_FILES_COMMON% A folder for 32-bit components that are shared across applications. A typical path is C:\Program Files\Common for 32-bit versions of Windows, and C:\Program Files (x86)\Common for 64-bit versions of Windows.

 

%CSIDL_PROGRAM_FILES_COMMONX86% The folder for 32-bit components that are shared across applications (even if you are using 64-bit Window).

 

%CSIDL_COMMON_APPDATA% The file system directory containing application data for all users. A typical path is C:\Documents and Settings\All Users\Application Data

 

%CSIDL_2BS_APPDATA% This is the same as %SYNCBACKFOLDER% and %CSIDL_2BS_LOCAL_APPDATA%

 

%CSIDL_2BS_LOCAL_APPDATA% This is the same as %SYNCBACKFOLDER% and %CSIDL_2BS_APPDATA%

 

%CSIDL_2BS_ROAM_APPDATA% The default roaming (not local) folder that SyncBackPro would store it’s profiles. This is not necessarily where the user has decided to store the profiles.

 

%CSIDL_2BS_APPDATA_PROFILESBACKUP% This is the same as %SYNCBACKBACKUPFOLDER% and %CSIDL_2BS_LOCAL_APPDATA_PROFILESBACKUP%

 

%CSIDL_2BS_LOCAL_APPDATA_PROFILESBACKUP% This is the same as %SYNCBACKBACKUPFOLDER% and %CSIDL_2BS_APPDATA_PROFILESBACKUP%

 

%CSIDL_2BS_ROAM_APPDATA_PROFILESBACKUP% The default roaming (not local) folder that SyncBackPro would store backups of profiles. This is not necessarily where the user has decided to store the profile backups.

 

%SMARTSTATUSSRC% If the profile is configured to log the S.M.A.R.T. status of the drives then this variable is set with the S.M.A.R.T. status of the source/left drive (sbpro-feature-16x16 Pro version). The variable is set just before scanning for changes begins.

 

%SMARTSTATUSDEST% If the profile is configured to log the S.M.A.R.T. status of the drives then this variable is set with the S.M.A.R.T. status of the destination/right drive (sbpro-feature-16x16 Pro version). The variable is set just before scanning for changes begins.

 

Misc.

 

%SBVERSION% The complete version number of the SyncBackPro program itself, e.g. 8.0.3.0

 

%SBLATESTVERSION% The complete version number of the latest version of SyncBackPro, e.g. 8.1.7.0. IMPORTANT: This will check online what the latest version number is so an Internet connection is required. The latest version number is cached and not updated more than once every 30 minutes.

 

%SBNEWVERSION% Returns Y if a newer version of SyncBackPro is available for download else returns N. IMPORTANT: This will check online what the latest version number is so an Internet connection is required. An update check is not performed more than once every 30 minutes.

 

%PROFILENAME% The profile name. This can be used in the source/left and/or destination/right path.

 

%GROUPNAME% The group name. This can be used in the source/left and/or destination/right path. If the profile is not being run as part of a group then the value returned is an empty string. See also %VISUALGROUPNAME%

 

%ISINTEGRITYCHECK% If the current profile run is a file integrity check run, then Y is returned, else N. This variable is new to V8.

 

%CONTAINERMOUNT% If a SyncBack container is being used, then this is the path where the container is mounted. This is typically used in the source or destination path. This variable is new to V8.

 

Backup to email

 

Some special variables can be used in the subject and email body when performing a backup to an email server (Pro version only).

 

%FILENAME% The filename of the file being backed up

 

%UPLOADDATETIME% The date & time the file was sent to the email server

 

%UPLOADDATETIME_GMT% As per %UPLOADDATETIME% except the GMT/UTC date & time is used

 

%MODIFIEDDATETIME% The last modification date & time of the file sent to the email server

 

%MODIFIEDDATETIME_GMT% As per %MODIFIEDDATETIME% except the GMT/UTC date & time is used

 

%CREATEDDATETIME% The creation date & time of the file sent to the email server

 

%CREATEDDATETIME_GMT% As per %CREATEDDATETIME% except the GMT/UTC date & time is used

 

%FILEATTRIBS% The attributes of the file sent to the email server

 

%FILESIZE% The size of the file (in bytes) sent to the email server

 

%FILEHASH% The hash value of the file sent to the email server

 

%ISCATALOG% Y if this is a catalog email, else N. A catalog email is an email that contains details on the files that are on the email server.

 

Backup (from) email

 

Some special variables can be used in the EML filename and sub-folder when performing a backup of email (Pro version only).

 

%EMAIL_ID% Unique email message ID. The format is decided by the email server. Note that this value can be empty so you may wish to use EMAIL_IDORMD5 instead.

 

%EMAIL_MD5% The MD5 hash value of the email header.

 

%EMAIL_IDORMD5% If the email has a message ID, then it is the message ID, otherwise it is the MD5 hash value of the header.

 

%EMAIL_UIDL% MD5 hash value of unique email ID, also called the UIDL. Note that it is unique for the email folder it is in. For POP3 this is ENVSPECIAL_S_EMAIL_IDORMD5 as POP3 does not have unique UIDL values for emails.

 

%EMAIL_SUBJECT% Email subject. Note that the subject can be very long, so it is recommended that you let SyncBackPro truncate it by using %EMAIL_SUBJECT32% or %EMAIL_SUBJECT64%

 

%EMAIL_SUBJECT32% The first 32 characters of the email subject.

 

%EMAIL_SUBJECT64% The first 64 characters of the email subject.

 

%EMAIL_SIZE% Size of email in bytes. This is not the size of the EML file.

 

%EMAIL_DATE% Date email sent. The format used is the short date format set in Windows.

 

%EMAIL_TIME% Time email sent. The format used is the long time format set in Windows.

 

%EMAIL_DATEYEAR% Date email sent (year).

 

%EMAIL_DATEMONTH% Date email sent (month). This is always two digits, e.g. 03 for April.

 

%EMAIL_DATEDAY% Date email sent (day). This is always two digits, e.g. 05 for the 5th day of the month.

 

%EMAIL_DATEHOUR% Date email sent (hour) in 24-hour format. This is always two digits, e.g. 09 for 9am.

 

%EMAIL_DATEMIN% Date email sent (minute). This is always two digits, e.g. 05 for 5 minutes past the hour.

 

%EMAIL_DATESEC% Date email sent (second). This is always two digits, e.g. 03 for 3 seconds past the minute.

 

%EMAIL_FROMNAME% From friendly name. If there is no sender's friendly name then the email address is returned (as per %EMAIL_FROMADDRESS%).

 

%EMAIL_FROMADDRESS% From email address.

 

%EMAIL_REPLYTO% Email address to reply to.

 

%EMAIL_FIRSTTONAME% To friendly name (of first recipient). Note that an email can be sent to more than one person, so this refers to the first person in the To list. If there is no friendly name then the email address is returned (as per %EMAIL_FIRSTTOADDRESS%).

 

%EMAIL_FIRSTTOADDRESS% To email address (of first recipient). Note that an email can be sent to more than one email address, so this refers to the first email address in the To list.

 

%EMAIL_IMAPFOLDER% The name of the IMAP4/Exchange folder the email is being retrieved from. Note that this will be an empty string if POP3 is being used. The value is modified to ensure it is a valid Windows file/folder name. This means it can be used in the EML filename and sub-folder settings. Starting with SyncBackPro V7 you can backup multiple email folders in the same profile, so this value may change during the profile run.

 

Emailing the log and late setting variables

 

There are a number of special variables that cannot be used in the source or destination settings, for example, because their value is not set until the profile is run (or at some later stage during the profile run). Some variables values are not set until near the end of a profile run. Because of this they can only be used correct in certain settings, e.g. the email body.

 

%_SOURCE% The source/left path.

 

%_DESTINATION% The destination/right path.

 

%LOGFILENAME% Filename of first page of latest log file. This is not set until the log file is closed, so it can only be used in Run After when the profile has been configured to run the 'after' program after the log file has been closed.

 

%SNAPSOURCE% If a shadow volume is being used to copy locked files from the source/left then this is the path of that shadow volume.

 

%SNAPDEST% If a shadow volume is being used to copy locked files from the destination/right then this is the path of that shadow volume.

 

%VISUALGROUPNAME% If the profile is part of a group, and it is run on its own from the main user interface (not necessarily as part of the group), then this is the name of the group. It is different from %GROUPNAME% because that value is only set if it is run as part of a group.

 

%ISFULLBACKUP% If this is a full-backup, i.e. a rescan is being done of the destination, then this is Y, else N

 

%ISUNATTENDED% If this is an unattended profile run then Y is returned, else N

 

%ISRESTORE% If this is a restore then Y is returned, else N

 

%ISSIMULATION% If this is a simulated run then Y is returned, else N

 

%RUNRESULT% A textual description of the result of the profile run, e.g. Success, Failure, Aborted, Timelimit Reached, etc.

 

%PROFILEFAILED% If the profile run was a success then 0 is returned, else 1 is returned on error/abort (this is the same variable that can be used in Run After).

 

%ATTACHMENTSTOTAL% The total number of attachments for the email.

 

%CRITICALERROR% If there was a critical error then this is the error message, otherwise it is an empty string.

 

%DELETEDTOTAL% The total number of files that were deleted.

 

%SKIPPEDTOTAL% The total number of files that were skipped, e.g. only in the destination and the profile was configured to ignore files that are only in the destination.

 

%COPIEDTOTAL% The total number of files that were copied.

 

%MOVEDTOTAL% The total number of files that were moved.

 

%DATECHANGEDTOTAL% The total number of files whose last modification date & time were copied.

 

%ATTRIBCHANGEDTOTAL% The total number of files whose attributes were copied.

 

%SECURITYCHANGEDTOTAL% The total number of files and folders whose security was changed.

 

%RUNBEFOREERROR% If the Run Before program failed (e.g. because it doesn't exist, or couldn't be started) then this is the error message.

 

%RUNAFTERERROR% If the Run After program failed (e.g. because it doesn't exist, or couldn't be started) then this is the error message.

 

%COPYERRORSTOTAL% The total number of file copy/delete errors.

 

%COMPRESSERRORSTOTAL% The total number of errors related to compression.

 

%NONCRITICALERRORSTOTAL% The total number of non-critical errors.

 

%WARNINGSTOTAL% The total number of warnings.

 

%STARTTIME% The date & time the profile was ready to run. If the profile was started as a part of a group then the date & time returned by this variable is not necessarily the date & time the profile actually started (for that see %STARTTIME2%). When a group (that is set to run profiles serially and not in parallel) is run SyncBackPro prepares all the profiles in the group so they can be started immediately once the proceeding profile has finished. So the %STARTTIME% value is the date & time when the profile was prepared but not necessarily started. To get the date & time when the profile was actually started use the variable %STARTTIME2%. If the profile is not part of a group then the time returned by %STARTTIME% and %STARTTIME2% will be almost identical. To get the date & time when the group was started (if the profile was run as part of a group) use the variable %GROUPSTARTTIME%. If you ran a group with just one profile in it then the times returned by %STARTTIME%, %STARTTIME2%, and %GROUPSTARTTIME% would be almost identical.

 

%STARTTIME2% The date & time the profile actually started to run. See %STARTTIME% for an explanation of the differences between that variable and this.

 

%GROUPSTARTTIME% The date & time when the (root) group started. If the profile is not part of a group then an empty string is returned. You can have groups within groups, so this is the date & time when the root group started. To get the date & time when the profile started see %STARTTIME% and %STARTTIME2%. See %STARTTIME% for an explanation of the differences between the three start time variables.

 

%ENDTIME% The date & time the profile completed.

 

%TOTALTIME% The amount of time between %STARTTIME% and %ENDTIME%, e.g. 5 hours 15 mins. 30 secs. This value isn't set until just before the log file is closed.

 

%TOTALTIME2% The amount of time between %STARTTIME2% and %ENDTIME%. This value isn't set until just before the log file is closed.

 

%STARTSCANTIME% The date & time the scan for changes started.

 

%ENDSCANTIME% The date & time the scan for changed ended.

 

%TOTALSCANTIME% The amount of time between %STARTSCANTIME% and %ENDSCANTIME%, e.g. 3 mins. 2 secs.

 

%BYTESCOPIED% The total number of bytes that were copied. See also %KBYTESCOPIED% and %MBYTESCOPIED%.

 

%KBYTESCOPIED% The total number of kilobytes that were copied. This is a whole (integer) number that is rounded up or down as appropriate.

 

%MBYTESCOPIED% The total number of megabytes that were copied. This is a whole (integer) number that is rounded up or down as appropriate.

 

%BYTESDELETED% The total number of bytes that were deleted. See also %KBYTESDELETED% and %MBYTESDELETED%.

 

%KBYTESDELETED% The total number of kilobytes that were deleted. This is a whole (integer) number that is rounded up or down as appropriate.

 

%MBYTESDELETED% The total number of megabytes that were deleted. This is a whole (integer) number that is rounded up or down as appropriate.

 

%BYTESREPLACED% The total number of bytes that were replaced/overwritten. See also %KBYTESREPLACED% and %MBYTESREPLACED%.

 

%KBYTESREPLACED% The total number of kilobytes that were replaced/overwritten. This is a whole (integer) number that is rounded up or down as appropriate.

 

%MBYTESREPLACED% The total number of megabytes that were replaced/overwritten. This is a whole (integer) number that is rounded up or down as appropriate.

 

%COMPARECHANGEDTOTAL% The total number of files that have changed.

 

%COMPAREHASHCHANGEDTOTAL% The total number of files which have different hash values.

 

%COMPAREDESTONLYTOTAL% The total number of files in the destination only.

 

%COMPARESOURCEONLYTOTAL% The total number of files in the source only.

 

%COMPAREDATETIMETOTAL% The total number of files whose last modification date & time is different.

 

%COMPARECREATEDATETIMETOTAL% The total number of files whose creation modification date & time is different.

 

%COMPARENTFSSECURITYTOTAL% The total number of files NTFS file security is different.

 

%COMPARESIZETOTAL% The total number of files whose size is different.

 

%COMPAREATTRIBTOTAL% The total number of files whose attributes are different.

 

%COMPARECASETOTAL% The total number of files whose filename case are different, e.g. the source file is called ABC and the destination file is called abc.

 

%COMPAREHASHERRORTOTAL% The total number of files whose hash value could not be calculated to compare them.

 

%TOSKIPCNT% The number of files that are going to be skipped.

 

%TOPROMPTCNT% The number of files where the user will be prompted on the action to take.

 

%TODELETESRCCNT% The total number of files that are to be deleted from the source/left. Files that are to be moved to the destination/right do not count.

 

%TODELETESRCONLYCNT% The total number of files that are to be deleted from the source/left that are only on the source/left. Files that are to be moved to the destination/right do not count. This is different from %TODELETESRCCNT% because it does not include files that are both in the source/left and destination/right.

 

%TODELETEDESTCNT% The total number of files that are to be deleted from the destination/right. Files that are to be moved to the source/left do not count.

 

%TODELETEDESTONLYCNT% The total number of files that are to be deleted from the destination/right that are only on the destination/right. Files that are to be moved to the source/left do not count. This is different from %TODELETEDESTCNT% because it does not include files that are both in the source/left and destination/right.

 

%TODELETEBOTHCNT% The total number of files that are to be deleted from both the source/left and destination/right. Files that are to be moved do not count.

 

%TOCOPYTODESTCNT% The number of files to be copied to the destination/right.

 

%TOCOPYTOSRCCNT% The number of files to be copied to the source/left.

 

%TOMOVETODESTCNT% The number of files to be moved to the destination/right.

 

%TOMOVETOSRCCNT% The number of files to be moved to the source/left.

 

%TOREPLACEDESTCNT% The number of files to be replaced on the destination/right. This variable is new to V8.

 

%TOREPLACESRCCNT% The number of files to be replaced on the source/left. This variable is new to V8.

 

%TOCHANGESRCATTRIBSCNT% The number of files in the source/left that will have their attributes/date & time changed.

 

%TOCHANGEDESTATTRIBSCNT% The number of files in the destination/right that will have their attributes/date & time changed.

 

%TORENAMESRCCNT% The number of files in the source/left that will be renamed.

 

%TORENAMEDESTCNT% The number of files in the destination/right  that will be renamed.

 

%BYTESCOPYTOSRC% The total number of bytes to be copied (includes moved files) to the source/left.

 

%KBYTESCOPYTOSRC% The total number of kilobytes to be copied (includes moved files) to the source/left. This is a whole (integer) number that is rounded up or down as appropriate.

 

%MBYTESCOPYTOSRC% The total number of megabytes to be copied (includes moved files) to the source/left. This is a whole (integer) number that is rounded up or down as appropriate.

 

%BYTESCOPYTODEST% The total number of bytes to be copied (includes moved files) to the destination/right.

 

%KBYTESCOPYTODEST% The total number of kilobytes to be copied (includes moved files) to the destination/right. This is a whole (integer) number that is rounded up or down as appropriate.

 

%MBYTESCOPYTODEST% The total number of megabytes to be copied (includes moved files) to the destination/right. This is a whole (integer) number that is rounded up or down as appropriate.

 

%BYTESDELETEFROMSRC% The total number of bytes to be deleted (includes moved files) from the source/left.

 

%KBYTESDELETEFROMSRC% The total number of kilobytes to be deleted (includes moved files) from the source/left. This is a whole (integer) number that is rounded up or down as appropriate.

 

%MBYTESDELETEFROMSRC% The total number of megabytes to be deleted (includes moved files) from the source/left. This is a whole (integer) number that is rounded up or down as appropriate.

 

%BYTESDELETEFROMDEST% The total number of bytes to be deleted (includes moved files) from the destination/right.

 

%KBYTESDELETEFROMDEST% The total number of bytes to be deleted (includes moved files) from the destination/right. This is a whole (integer) number that is rounded up or down as appropriate.

 

%MBYTESDELETEFROMDEST% The total number of bytes to be deleted (includes moved files) from the destination/right. This is a whole (integer) number that is rounded up or down as appropriate.

 

%PAGE% Used only in log filename.

 

%COMPAREDIRSCHANGEDTOTAL% The number of directories that have been changed.

 

%COMPAREDIRSDESTONLYTOTAL% The number of directories that are only in the destination.

 

%COMPAREDIRSSOURCEONLYTOTAL% The number of directories that are only in the source.

 

%FTPCONNECTCNT% The number of (re)connections made to the FTP server

 

%VERSIONSRESTOREDTOTAL% The total number of versions restored

 

%COMPAREUNCHANGEDTOTAL% The total number of unchanged files

 

%TORESTOREVERSRCCNT% The total number of versions files to be restored on the source/left

 

%TORESTOREVERDESTCNT% The total number of versions files to be restored on the destination/right

 

%FREEBYTESSOURCEBEFORE% The number of free bytes on the source/left before the profile started copying, moving, and deleting files

 

%FREEKBYTESSOURCEBEFORE% The number of free kilobytes on the source/left before the profile started copying, moving, and deleting files. This is a whole (integer) number that is rounded up or down as appropriate.

 

%FREEMBYTESSOURCEBEFORE% The number of free megabytes on the source/left before the profile started copying, moving, and deleting files. This is a whole (integer) number that is rounded up or down as appropriate.

 

%FREEBYTESDESTBEFORE% The number of free bytes on the destination/right before the profile started copying, moving, and deleting files

 

%FREEKBYTESDESTBEFORE% The number of free kilobytes on the destination/right before the profile started copying, moving, and deleting files. This is a whole (integer) number that is rounded up or down as appropriate.

 

%FREEMBYTESDESTBEFORE% The number of free megabytes on the destination/right before the profile started copying, moving, and deleting files. This is a whole (integer) number that is rounded up or down as appropriate.

 

Registry

 

As well as variables, you can also get values from the registry. For example, the following will retrieve the current version of Firefox that is installed:

 

%@HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox\CurrentVersion%

 

To get values from the registry you must use %@ followed by one of the following (these define which part of the registry to read):

 

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

HKEY_PERFORMANCE_DATA

HKEY_CURRENT_CONFIG

HKEY_DYN_DATA

 

Then specify the path in the registry, e.g. \SOFTWARE\Mozilla\Mozilla Firefox\CurrentVersion, and finally finish with a single percentage sign (%). If there is no such value in the registry then the variable is not expanded.

 

If you are using a 64-bit version of Windows then note that because SyncBackPro is a 32-bit program it will read from the 32-bit registry by default. To read from the 64-bit registry you must use %64@, e.g.

 

%64@HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox\CurrentVersion%

 

If you are not using a 64-bit version of Windows, and try to read from the 64-bit registry, then it will instead try to get the value from the 32-bit registry (because there is no 64-bit registry on 32-bit versions of Windows). Because of this it is recommend that you always use %64@ instead of %@ because it will work correctly on both 64-bit and 32-bit versions of Windows.

 

SyncBack Touch variables

 

When using a SyncBack Touch device you can use some special variables in the path (source or destination, depending on which is using SyncBack Touch). They can only be used in the path and nowhere else. These variables are expanded by SyncBack Touch on the remote device and not locally, so they are only expanded when the profile is run. All the variables start with SBT_ so it's clear to see if it's a SyncBack Touch variable.

 

%SBT_VERSION% The version number of the SyncBack Touch software on the device, e.g. 1.0.0.0

 

%SBT_COMMON_MUSIC% The shared music folder on the device running SyncBack Touch. On Windows this is %CSIDL_COMMON_MUSIC% (see the Drives, Files, and Folders section above). On macOS and Android it will be returned as appropriate.

 

%SBT_COMMON_PICTURES% The shared pictures folder on the device running SyncBack Touch. On Windows this is %CSIDL_COMMON_PICTURES% (see the Drives, Files, and Folders section above). On OS X and Android it will be returned as appropriate.

 

%SBT_COMMON_VIDEO% The shared videos folder on the device running SyncBack Touch. On Windows this is %CSIDL_COMMON_VIDEO% (see the Drives, Files, and Folders section above). On OS X and Android it will be returned as appropriate.

 

%SBT_COMMON_APPDATA% The shared downloads folder on the device running SyncBack Touch. On Windows this is %CSIDL_COMMON_APPDATA% (see the Drives, Files, and Folders section above). On OS X and Android it will be returned as appropriate.

 

%SBT_MYMUSIC% The personal music folder of the user account running SyncBack Touch. On Windows this is %CSIDL_MYMUSIC% (see the Drives, Files, and Folders section above). On OS X and Android it will be returned as appropriate.

 

%SBT_MYVIDEO% The personal video folder of the user account running SyncBack Touch. On Windows this is %CSIDL_MYVIDEO% (see the Drives, Files, and Folders section above). On OS X and Android it will be returned as appropriate.

 

%SBT_MYPICTURES% The personal pictures folder of the user account running SyncBack Touch. On Windows this is %CSIDL_MYPICTURES% (see the Drives, Files, and Folders section above). On OS X and Android it will be returned as appropriate.

 

%SBT_LOCAL_APPDATA% The personal downloads folder of the user account running SyncBack Touch. On Windows this is %CSIDL_LOCAL_APPDATA% (see the Drives, Files, and Folders section above). On OS X and Android it will be returned as appropriate.

 

%SBT_DESKTOP% If the SyncBack Touch device is running on Windows then this is %CSIDL_DESKTOP%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_PROGRAMS% If the SyncBack Touch device is running on Windows then this is %CSIDL_PROGRAMS%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_PERSONAL% If the SyncBack Touch device is running on Windows then this is %CSIDL_PERSONAL%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_FAVORITES% If the SyncBack Touch device is running on Windows then this is %CSIDL_FAVORITES%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_STARTUP% If the SyncBack Touch device is running on Windows then this is %CSIDL_STARTUP%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_RECENT% If the SyncBack Touch device is running on Windows then this is %CSIDL_RECENT%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_SENDTO% If the SyncBack Touch device is running on Windows then this is %CSIDL_SENDTO%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_STARTMENU% If the SyncBack Touch device is running on Windows then this is %CSIDL_STARTMENU%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_DESKTOPDIRECTORY% If the SyncBack Touch device is running on Windows then this is %CSIDL_DESKTOPDIRECTORY%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_NETHOOD% If the SyncBack Touch device is running on Windows then this is %CSIDL_NETHOOD%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_FONTS% If the SyncBack Touch device is running on Windows then this is %CSIDL_FONTS%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_TEMPLATES% If the SyncBack Touch device is running on Windows then this is %CSIDL_TEMPLATES%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_COMMON_STARTMENU% If the SyncBack Touch device is running on Windows then this is %CSIDL_COMMON_STARTMENU%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_COMMON_PROGRAMS% If the SyncBack Touch device is running on Windows then this is %CSIDL_COMMON_PROGRAMS%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_COMMON_STARTUP% If the SyncBack Touch device is running on Windows then this is %CSIDL_COMMON_STARTUP%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_COMMON_DESKTOPDIRECTORY% If the SyncBack Touch device is running on Windows then this is %CSIDL_COMMON_DESKTOPDIRECTORY%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_APPDATA% If the SyncBack Touch device is running on Windows then this is %CSIDL_APPDATA%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_PRINTHOOD% If the SyncBack Touch device is running on Windows then this is %CSIDL_PRINTHOOD%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_ALTSTARTUP% If the SyncBack Touch device is running on Windows then this is %CSIDL_ALTSTARTUP%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_COMMON_ALTSTARTUP% If the SyncBack Touch device is running on Windows then this is %CSIDL_COMMON_ALTSTARTUP%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_COMMON_FAVORITES% If the SyncBack Touch device is running on Windows then this is %CSIDL_COMMON_FAVORITES%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_INTERNET_CACHE% If the SyncBack Touch device is running on Windows then this is %CSIDL_INTERNET_CACHE%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_COOKIES% If the SyncBack Touch device is running on Windows then this is %CSIDL_COOKIES%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_HISTORY% If the SyncBack Touch device is running on Windows then this is %CSIDL_HISTORY%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_PROFILE% If the SyncBack Touch device is running on Windows then this is %CSIDL_PROFILE%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_CDBURN_AREA% If the SyncBack Touch device is running on Windows then this is %CSIDL_CDBURN_AREA%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_WINDOWS% If the SyncBack Touch device is running on Windows then this is %CSIDL_WINDOWS%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_PROGRAM_FILES% If the SyncBack Touch device is running on Windows then this is %CSIDL_PROGRAM_FILES%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_PROGRAM_FILESX86% If the SyncBack Touch device is running on Windows then this is %CSIDL_PROGRAM_FILESX86%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_PROGRAM_FILES_COMMON% If the SyncBack Touch device is running on Windows then this is %CSIDL_PROGRAM_FILES_COMMON%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_PROGRAM_FILES_COMMONX86% If the SyncBack Touch device is running on Windows then this is %CSIDL_PROGRAM_FILES_COMMONX86%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_SYSTEM% If the SyncBack Touch device is running on Windows then this is %CSIDL_SYSTEM%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

%SBT_SYSTEMX86% If the SyncBack Touch device is running on Windows then this is %CSIDL_SYSTEMX86%. See the Drives, Files, and Folders section above. For other device types, e.g. OS X, then this variable is invalid and will not be expanded.

 

The following variables are used with SyncBack Touch profiles but are evaluated by SyncBack itself and not on the SyncBack Touch device:

 

%SBTNAME% The name (or hostname or IP address, depending on what is set in the profile) of the SyncBack Touch device.

 

%SBTUSERNAME% The username used to connect to the SyncBack Touch device.

 

Order of evaluation

 

Variables are evaluated in the following order:

 

1.Registry variables

2.Windows environment variables

3.User defined (profile and group) variables and run-time variables, e.g. %PROFILENAME%

4.Group variables

5.SyncBack variables

6.SyncBack Touch variables

 

If a user defined profile variable has the same name as a user defined group variable then the profile variable replaces the group variable.

 

Important note about Variable usage

 

An important point to remember is that Windows has its own environment variables, e.g. %USERNAME%. When these variables are used in a batch file, or on the command line, then Windows automatically expands them. Unknown variables are simply deleted. For example, if you had the following batch file:

 

@echo off

"c:\program files\2brightsparks\SyncBackPro\SyncBackPro.exe" -source "x:\%DAY%\"

 

Then when run it would actually be expanded to do the following:

 

@echo off

"c:\program files\2brightsparks\SyncBackPro\SyncBackPro.exe" -source "x:\\"

 

Note that the %DAY% has been removed because it's an unknown Windows variable (it's a SyncBackPro variable). To stop Windows from changing SyncBackPro variables you must use two percentage signs, e.g.

 

@echo off

"c:\program files\2brightsparks\SyncBackPro\SyncBackPro.exe" -source "x:\%%DAY%%\"

 

 

 

All Content: 2BrightSparks Pte Ltd © 2003-2017