Positional parameters immediately follow the set command
and precede the optional parameters.
The following positional parameters specify the values
in the
Data Protection for Microsoft Exchange configuration
file. You can set one value for each
tdpexcc set command
that you run:
- BACKUPDESTination=TSM|LOCAL|BOTH
- Use
the BACKUPDESTINATION positional parameter to
specify the storage location for your backup. You can specify these
options:
- TSM
- The backup is stored on Tivoli® Storage Manager server storage
only. This option is the default.
- LOCAL
- The backup is stored only on local shadow volumes.
- BOTH
- The backup is stored on both Tivoli Storage Manager server storage
and local shadow volumes.
- CLIENTACcessserver=servername
- The servername variable refers to the name
of the server you use to access the client.
- /DAGNODe=nodename
- Specify the node name that you want to use to
back up the databases in an Exchange Server Database Availability
Group. With this setting, backups from all Database Availability Group
members that are configured to use the DAG node are backed up to a
common file space on the Tivoli Storage
Manager server.
The database copies are managed as a single entity, regardless of
which Database Availability Group member they were backed up from.
This setting can prevent Data Protection for Exchange from
making too many backups of the same database.
- DATEformat=dateformatnum
- Use
the DATEformat positional parameter to select
the format that you want to use to display dates.
The dateformatnum variable
displays the date in one of the following formats. Select the format
number that corresponds to the format that you want to use.
- 1
- (Default) MM/DD/YYYY
- 2
- DD-MM-YYYY
- 3
- YYYY-MM-DD
- 4
- DD.MM.YYYY
- 5
- YYYY.MM.DD
- 6
- YYYY/MM/DD
- 7
- DD/MM/YYYY
Changes to the value
of the
dateformat parameter can result in an
undesired pruning of the
Data Protection for Microsoft Exchange log
file (
tdpexc.log by default). You can avoid losing
existing log file data by doing one of the following actions:
- After you change the value of the dateformat parameter,
make a copy of the existing log file before you run Data Protection for Microsoft Exchange.
- Specify a new log file with the /logfile parameter.
- IMPORTVSSSNAPSHOTSONLYWhenneeded=Yes|No
- By default, the parameter is set to No. This
default setting means that local persistent VSS snapshots are automatically
imported to the Windows system where the snapshots are created. By
importing the VSS snapshots only when needed, the snapshots are imported
to a host for FlashCopy Manager operations. To automatically import
local persistent snapshots to the Windows system where the snapshots
are created, set the parameter to Yes.
- LANGuage=language
- Specify
the three-character code of the language that you want to use to display
messages:
- CHS
- Simplified Chinese
- CHT
- Traditional Chinese
- DEU
- Standard German
- ENU
- (Default) American English
- ESP
- Standard Spanish
- FRA
- Standard French
- ITA
- Standard Italian
- JPN
- Japanese
- KOR
- Korean
- PTB
- Brazilian Portuguese
- LOCALDSMAgentnode=nodename
- Specify
the node name of the local system that runs the VSS backups. This
positional parameter must be specified for VSS operations to be processed.
- LOGFile=logfilename
- Use the LOGFile positional
parameter to specify the name of the activity log file that is generated
by Data Protection for Microsoft Exchange.
The Data Protection for Microsoft Exchange activity
log records significant events, such as completed commands and error
messages.
The logfilename variable identifies
the name of the activity log file.
If the specified log file does
not exist, a new log file is created. If the specified log file exists,
new log entries are appended to the file. The logfilename variable
can include a fully qualified path. However, if no path is specified,
the log file is assigned to the Data Protection for Microsoft Exchange installation
directory.
- LOGPrune=numdays|No
- Use
the LOGPrune positional parameter to disable
log pruning or to set log pruning parameters. By default, log pruning
is enabled and done once per day. The numdays variable
represents the number of days to save log entries. You can specify
a value of No or 0 - 9999. By default, 60 days
of log entries are saved in the pruning process.
- MOUNTWait=Yes|No
- Use
the MOUNTWait positional parameter to specify
whether Data Protection for Microsoft Exchange wait
for removable media to mount (such as tapes or CDs) or to stop the
current operation. This situation occurs when the Tivoli Storage Manager server is
configured to store backup data on removable media and waits for a
required storage volume to be mounted.
Specify Yes for Data Protection for Microsoft Exchange to
wait until all initial volumes of any required removable media are
made available to the Tivoli Storage Manager server before
the command completes.
Specify No for Data Protection for Microsoft Exchange to
end the command (if removable media are required). An error message
displays.
- NUMberformat=fmtnum
- Use
the NUMberformat positional parameter to specify
the format you want to use to display numbers.
The
fmtnum variable
displays numbers by using one of the following formats. Select the
format number that corresponds to the format you want to use.
- 1
- (Default) n,nnn.dd
- 2
- n,nnn,dd
- 3
- n nnn,dd
- 4
- n nnn.dd
- 5
- n.nnn,dd
- 6
- n'nnn,dd
- REMOTEDSMAgentnode=nodename
- Specify
the node name of the system that moves the VSS data to Tivoli Storage Manager server storage
during offloaded backups.
- STOREMAILBOXInfo=Yes|No
- The STOREMAILBOXInfo parameter is used to
track mailbox history for moved and deleted mailboxes. By default,
this parameter is set to Yes. If you do not plan
to use mailbox restore, you can set this option to No.
When the option is set to No, Data Protection for Microsoft Exchange does
not back up the mailbox history.
In large or geographically dispersed
domains, more time is required to complete the backup mailbox history
task. In this scenario, you can reduce the amount of time that is
required to complete the backup mailbox history task by setting the
option for STOREMAILBOXInfo to No.
When you set the option for STOREMAILBOXInfo to No,
mailboxes that are not moved or are not deleted can be restored normally.
Moved and deleted mailbox restores can use the /MAILBOXORIGLOCATION parameter
(of the Restoremailbox command) to specify the
mailbox location at the time of the backup.
- TEMPDBRESTorepath=pathname
- To
specify the default temporary path to use with mailbox database files,
use the TEMPDBRESTorepath positional parameter.
If
you do not enter a path, the default value is the value of the TEMP
environment variable.
If the path name includes
spaces, you must enclose the entire
TEMPDBRESTorepath positional
parameter entry in double quotation marks. For example:
TDPEXCC SET TEMPDBRESTorepath="h:\Exchange Restore Directory"
Attention: Do not specify a value of
TEMPDBRESTorepath that
is the same value as the location of the active database. If the value
is the same, the database might become corrupted.
Choose a temporary
database-restore location that has enough space to hold the entire
restore for the database.
Tip: For better performance,
the current active-transaction logger should be on a different physical
device from the paths that are specified by the values of the templogrestorepath parameter
setting and the tempdbrestorepath parameter setting.
The paths that are specified by the values of the templogrestorepath parameter
setting and the tempdbrestorepath parameter setting
can be on the same or separate physical devices from each other.
Restriction: Do not specify double-byte characters (DBCS) within
the temporary database-restore path.
- TEMPLOGRESTorepath=pathname
- To
specify the default temporary path to use when you are restoring logs
and patch files, use the TEMPLOGRESTorepath positional
parameter.
If you do not enter a path, the default value is the
value of the TEMP environment variable.
If the path name includes
spaces, you must enclose the entire
TEMPDBRESTorepath positional
parameter entry in double quotation marks. For example:
TEMPLOGRESTorepath="c:\Program Files\templog"
Attention: Do not specify a value of
TEMPDBRESTorepath that
is the same value as the current location for the database that is
used for recovery. If the value is the same, the database might become
corrupted.
Choose a temporary log-restore location that has enough
space to hold all the log and patch files.
Tip: For
better performance, the current active-transaction logger is to be
on a different physical device from the paths that are specified by
the values of the templogrestorepath parameter
setting and the tempdbrestorepath parameter setting.
The paths that are specified by the values of the templogrestorepath parameter
setting and the tempdbrestorepath parameter setting
can be on the same or separate physical devices from each other.
Restriction: Do not specify double-byte characters (DBCS) within
the temporary log-restore path.
- TIMEformat=formatnumber
- Use
the TIMEformat positional parameter to specify
the format in which you want system time that is displayed.
The
formatnumber variable
displays time in one of the following formats. Select the format number
that corresponds to the format you want to use.
- 1
- (Default) HH:MM:SS
- 2
- HH,MM,SS
- 3
- HH.MM.SS
- 4
- HH:MM:SSA/P