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 Spectrum® Protect 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.

Linux operating systemsAIX operating systemsthe prefix is the current IBM Spectrum Protect server working directory.

Windows operating systemsIf 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 diagramSet DRMINSTRPrefix prefix

Parameters

Linux operating systemsAIX operating systemsprefix (Required)
Linux operating systemsAIX operating systems

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

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: IBM Spectrum Protect 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: IBM Spectrum Protect specifies the directory path and appends the appropriate recovery plan file stanza name.
    • IBM Spectrum Protect 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 systemsprefix (Required)
Windows operating systems

Specifies a path name prefix for the files that contain the recovery instructions. When processing the PREPARE command, IBM Spectrum Protect 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: IBM Spectrum Protect 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: IBM Spectrum Protect specifies the directory path and appends the appropriate recovery plan file stanza name. The directory path is the directory representing this instance of the IBM Spectrum Protect server (typically the original IBM Spectrum Protect 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

Linux operating systemsAIX operating systemsSpecify reading the recovery plan instructions from directory /drmplan/primesrv.
set drminstrprefix /drmplan/primesrv/
Windows operating systemsSpecify 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.