IBM Tivoli Storage Manager Extended Edition, Version 7.1

SET DRMINSTRPREFIX (Specify the prefix for recovery instructions file names)

Use this command to specify a prefix to the recovery instructions file name. If you issue this command, IBM® Tivoli® Storage Manager uses the specified prefix if the PREPARE command is issued without the INSTRPREFIX parameter.

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

AIX operating systems HP-UX operating systems Linux operating systems Sun Solaris operating systems the prefix is the current Tivoli Storage Manager server working directory.

Windows operating systems If no prefix is set, the prefix is set to the directory representing this instance of the server, which is typically the directory that the server was originally installed from.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-Set DRMINSTRPrefix--prefix----------------------------------><

Parameters

AIX operating systems HP-UX operating systems Linux operating systems Sun Solaris operating systems prefix (Required)

Specifies a path name prefix for the files that contain the recovery instructions. When processing the PREPARE command, Tivoli Storage Manager appends the name of the appropriate recovery plan file stanza to find the file. The maximum length is 250 characters.

HP-UX operating systems Restriction: The recovery instructions files must be created on a file system that supports long file names.
The prefix can be one of the following:
  • Directory path: End the prefix with a foward slash (/). For example:
       /adsmsrv/recinstr/
    For the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would be:
      /adsmsrv/recinstr/RECOVERY.INSTRUCTIONS.GENERAL
  • Directory path followed by a string: Tivoli Storage Manager treats the string as part of the file name. For example:
       /adsmsrv/recinstr/accounts
    For the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would be:
      /adsmsrv/recinstr/accounts.RECOVERY.INSTRUCTIONS.GENERAL
  • String only: Tivoli Storage Manager specifies the directory path and appends the appropriate recovery plan file stanza name.
    • Tivoli Storage Manager uses the name of the current working directory. For example, the current working directory is/opt/tivoli/tsm/server/bin. You specify the following:
         shipping
      For the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would look like this:
        /opt/tivoli/tsm/server/bin/shipping.RECOVERY.INSTRUCTIONS.GENERAL 
Windows operating systems prefix (Required)

Specifies a path name prefix for the files that contain the recovery instructions. When processing the PREPARE command, Tivoli Storage Manager appends the name of the appropriate recovery plan file stanza to find the file. The maximum length is 200 characters.

The prefix can be one of the following:
  • Directory path: End the prefix with a back slash (\). For example:
       c:\adsmsrv\recinstr\
    For the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would be:
      c:\adsmsrv\recinstr\RECOVERY.INSTRUCTIONS.GENERAL
  • Directory path followed by a string: Tivoli Storage Manager treats the string as part of the file name. For example:
       c:\adsmsrv\recinstr\accounts
    For the RECOVERY.INSTRUCTIONS.GENERAL file, the resulting file name would be:
      c:\adsmsrv\recinstr\accounts.RECOVERY.INSTRUCTIONS.GENERAL
  • String only: Tivoli Storage Manager specifies the directory path and appends the appropriate recovery plan file stanza name. The directory path is the directory representing this instance of the Tivoli Storage Manager server (typically the original Tivoli Storage Manager server installation directory). For example, the directory representing this instance of the server is c:\Program Files\Tivoli\TSM;\server2, and you specify the following prefix:
       shipping
    The resulting recovery plan file name is:
        c:\Program Files\Tivoli\TSM;\server2\shipping.19971115.051421

Example: Specify the recovery plan prefix

AIX operating systems HP-UX operating systems Linux operating systems Sun Solaris operating systems Specify reading the recovery plan instructions from directory /drmplan/primesrv.
set drminstrprefix /drmplan/primesrv/
Windows operating systems Specify reading the recovery plan instructions from directory c:\win32app\ibm\adsm\server2\.
set drminstrprefix c:\win32app\ibm\adsm\server2\

Related commands

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


Feedback