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

If you issue this command, Tivoli® Storage Manager 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.

Restriction: The recovery plan file must be created on a file system that supports long file names.

Privilege class

To issue this command, you must have system privilege.

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 (/): Tivoli Storage Manager 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: Tivoli Storage Manager uses the string as part of the file name. Tivoli Storage Manager 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: Tivoli Storage Manager appends to the prefix the date and time information in the .yyyymmdd.hhmmss format (note the initial period). Tivoli Storage Manager determines the directory path as follows:
  • Tivoli Storage Manager uses the directory path name of the current working directory of the Tivoli Storage Manager server. For example, the current Tivoli Storage Manager 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. Tivoli Storage Manager uses the prefix if the PREPARE command is issued without the PLANPREFIX parameter. Tivoli Storage Manager 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:

1. A directory path
2. A directory path followed by a string
3. A string

The following describes the rules for possible prefix specifications:

1. To specify a directory path for the prefix, end the prefix with a back slash (\). Tivoli Storage Manager 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, Tivoli Storage Manager interprets it as a continuation character. To avoid this, enclose the prefix in quotation marks. For example: "c:\adsmsrv\recplans\"
2. If the prefix is a directory path followed by a string, Tivoli Storage Manager uses the string as part of the file name. Tivoli Storage Manager 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

3. If the prefix is a string that is not preceded by a directory path, Tivoli Storage Manager appends to the prefix the date and time information in the .yyyymmdd.hhmmss format (note the initial period). The directory path that Tivoli Storage Manager uses is the directory path representing this instance of the Tivoli Storage Manager server (typically the directory that the Tivoli Storage Manager 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

Related commands