SET DRMPLANPREFIX (Specify a prefix for recovery plan file names)

Use this command to specify a prefix for a recovery plan file name.

If you issue this command, IBM Spectrum® Protect uses the specified prefix if the PREPARE command does not include the PLANPREFIX parameter.

Use the QUERY DRMSTATUS command to display the current value for the recovery plan prefix.

Privilege class

To issue this command, you must have system privilege.

Syntax

Parameters

prefix (Required)

Specifies the prefix for a recovery plan file name. The maximum length of the prefix is 250 characters. If you enter a null string (""), the current prefix is removed, and the server uses the algorithm described in the PLANPREFIX parameter in the PREPARE command.

For the prefix, you can specify:

A directory path followed by a forward slash (/): IBM Spectrum Protect appends to the prefix the date and time in the yyyymmdd.hhmmss format. For example, the SET DRMPLANPREFIX is set to the following:
```
/adsmsrv/recplans/
```
The resulting recovery plan file name is:
```
/adsmsrv/recplans/19971115.051421
```
A directory path followed by a string: IBM Spectrum Protect uses the string as part of the file name. IBM Spectrum Protect appends to the prefix the date and time in the .yyyymmdd.hhmmss format (note the initial period). For example, the SET DRMPLANPREFIX is set to the following:
```
/adsmsrv/recplans/accounting
```
The resulting recovery plan filename is:
```
/adsmsrv/recplans/accounting.19971115.051421
```
A string that is not preceded by a directory path: IBM Spectrum Protect appends to the prefix the date and time information in the .yyyymmdd.hhmmss format (note the initial period). IBM Spectrum Protect determines the directory path as follows:
- IBM Spectrum Protect uses the directory path name of the current working directory of the IBM Spectrum Protect server. For example, the current IBM Spectrum Protect working directory is /opt/tivoli/tsm/server/binThe SET DRMPLANPREFIX command is set to the following:
```
shipping
```
  The resulting recovery plan file name is:
```
/opt/tivoli/tsm/server/bin/shipping.19971115.051421
```

prefix (Required)

Specifies a prefix for the path name used to generate the recovery plan file name. The prefix can be up to 200 characters. IBM Spectrum Protect uses the prefix if the PREPARE command is issued without the PLANPREFIX parameter. IBM Spectrum Protect builds a unique recovery plan file name by appending to the prefix the date and time format: yyyymmdd.hhmmss (for example, 19951115.051421). If you enter a null string (""), the current prefix is removed, and the server uses the algorithm described in the PLANPREFIX parameter in the PREPARE command.

For the prefix, you can specify:

A directory path
A directory path followed by a string
A string

The following describes the rules for possible prefix specifications:

To specify a directory path for the prefix, end the prefix with a back slash (\). IBM Spectrum Protect appends to the prefix the date and time information using the yyyymmdd.hhmmss format. For example the SET DRMPLANPREFIX is set to the following:
```
c:\adsmsrv\recplans\
```
The resulting recovery plan file name is:
```
c:\adsmsrv\recplans\19951115.051421
```
Important: If you issue the SET DRMPLANPREFIX command from a command line client and the last character in the command line is a back slash, IBM Spectrum Protect interprets it as a continuation character. To avoid this, enclose the prefix in quotation marks. For example: "c:\adsmsrv\recplans\"
If the prefix is a directory path followed by a string, IBM Spectrum Protect uses the string as part of the file name. IBM Spectrum Protect appends to the prefix the date and time in the .yyyymmdd.hhmmss format (note the initial period). For example, the SET DRMPLANPREFIX is set to the following
```
c:\adsmsrv\recplans\accounting
```
The resulting recovery plan filename is the following:
```
c:\adsmsrv\recplans\accounting.19951115.051421
```
If the prefix is a string that is not preceded by a directory path, IBM Spectrum Protect appends to the prefix the date and time information in the .yyyymmdd.hhmmss format (note the initial period). The directory path that IBM Spectrum Protect uses is the directory path representing this instance of the IBM Spectrum Protect server (typically the directory that the IBM Spectrum Protect server was originally installed from). For example, the directory representing this instance of the server is c:\Program Files\Tivoli\TSM;\server2, and you set the prefix to:
```
shipping
```
The resulting recovery plan filename is:
```
c:\Program Files\Tivoli\TSM;\server2\shipping.19951115.051421
```

Example: Specify a prefix for recovery plan file names

Specify a prefix so that the generated recovery plan files are stored in the following directory:

/drmplan/primsrv
c:\drmtest\prepare\

Issue the command: Linux operating systems

set drmplanprefix /drmplan/primsrv/

set drmplanprefix c:\drmtest\prepare\

Related commands

Table 1. Commands related to SET DRMPLANPREFIX
Command	Description
PREPARE	Creates a recovery plan file.
QUERY DRMSTATUS	Displays DRM system parameters.