How to use DLO macros in backup selections

You can type macros into the Type a folder name field of the backup selection dialog box to automatically back up specific folders.

See Defining general DLO backup selection properties.

The following macros are supported:

Table: Folder macros for use with backup selections

Backup Selection Macro

Folders backed up

%LOCALFIXEDDRIVES%

All local fixed drives.

Note:

DLO is not designed to back up removable media. Trying to back up a floppy disk or CDROM may result in errors.

%MACHINENAME%

Represents the desktop user's computer name.

Example: C:\documents\%machine name% represents C:\documents\UsersMachineName.

%CURRENTUSERNAME%

Represents the user name of the currently logged-on user.

Example: If the local administrator is logged on to the computer, C:\documents\%current username% represents 'C:\documents\Administrator'

%CURRENTUSERPROFILE%

All files and folders in the C:\Documents and Settings\current user profile directory (for Windows XP) or the C:\Users\current user profile directory (for Windows Vista).

%CURRENTUSERMYDOCS%

The My Documents directory for the user who is logged on.

%CURRENTUSERFAVORITES%

The Favorites directory for the user who is logged on.

%CURRENTUSERPRINTHOOD%

The Printers directory for the user who is logged on.

%CURRENTUSERNETHOOD%

The Network Locations directory for the user who is logged on.

%CURRENTUSERDESKTOP%

The Desktop directory for the user who is logged on.

%CURRENTUSERRECENT%

The Recent Files directory for the user who is logged on.

%PROGRAMFILES%

The Windows Program Files directory. Example:

%PROGRAMFILES%\lotus\notes\data\archives

%LOCALAPPDATA%

The Windows local application data directory:

  • On Windows XP:

    Documents and Settings\<user_name>\Local Settings\Application Data

  • On Windows Vista:

    Users\<user_name>\AppData\Local

The following additional pre-defined folder macros are available for selection in the backup selection dialog box:

Table: Macros for pre-defined folders in the backup selection dialog box

Folder Name

Pre-Defined Folder Macro

Folders Backed Up

My Documents

%CURRENTUSERMYDOCS%

The My Documents directory for the user who is logged on.

My Music

%CURRENTUSERMYMUSIC%

The My Music folder for the user who is logged on.

My Pictures

%CURRENTUSERMYPICTURES%

The My Pictures folder for the user who is logged on.

My Videos

%CURRENTUSERMYVIDEO%

The My Videos folder for the user who is logged on.

Desktop

%CURRENTUSERDESKTOP%

The Desktop directory for the user who is logged on.

Favorites

%CURRENTUSERFAVORITES%

The Favorites directory for the user who is logged on.

PrintHood

%CURRENTUSERPRINTHOOD%

The Printers directory for the user who is logged on.

NetHood

%CURRENTUSERNETHOOD%

The Network Locations directory for the user who is logged on.

Recent

%CURRENTUSERRECENT%

The Recent Files directory for the user who is logged on.

All local fixed drives

%LOCALFIXEDDRIVES%

All local fixed drives.

When you enter a path that uses a macro, a backslash is automatically added immediately following the macro. For example, if you type %LOCALFIXEDDRIVES%\Documents, an extra backslash is added and it appears as "x:\\Documents" in the Desktop Agent backup selection advanced view. It does not show at all in the Desktop Agent backup selection Standard view. The correct way to type this macro is%LOCALFIXEDDRIVES%Documents. This macro properly resolves to x:\Documents.