SET DRMRETENTIONSTGPOOL (Specify the tape retention storage pools to be processed by MOVE RETMEDIA and QUERY RETMEDIA commands)

Edit online

Use this command to specify the tape retention storage pools to be processed by the MOVE RETMEDIA or QUERY RETMEDIA commands. IBM Storage Protect uses these names if the MOVE RETMEDIA or QUERY RETMEDIA command does not use the RETENTIONSTGPOOL parameter.

Restriction: The SET DRMRETENTIONSTGPOOL command cannot be used on cloud retention storage pools. This command can be used only on tape retention storage pools.
If the MOVE RETMEDIA or QUERY RETMEDIA command does not include the RETENTIONSTGPOOL parameter, the command processes the volumes in the MOUNTABLE state that are in the tape retention storage pool that is named by the SET DRMRETENTIONSTGPOOL command. At installation, all tape retention storage pools are eligible for processing by the MOVE RETMEDIA or QUERY RETMEDIA commands.

Use the QUERY DRMSTATUS command to display the current settings.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagramSet DRMRETentionstgpool ,retention_pool_name

Parameters

retention_pool_name (Required)
Specifies the tape retention storage pool name. Separate multiple names with commas and no intervening spaces. You can use wildcard characters. The specified names replace any previous setting. If you enter a null string (""), all current names are removed and no tape retention storage pools are eligible for processing.

Example: Set a tape retention storage pool

Set RETENTIONSTGPOOL1 as the eligible tape retention storage pool.
set drmretentionstgpool retentionstgpool1

Related commands

Table 1. Commands related to SET DRMRETENTIONSTGPOOL
Command Description
MOVE RETMEDIA Moves tape retention storage pool volumes onsite and offsite.
QUERY DRMSTATUS Displays DRM system parameters.
QUERY RETMEDIA Displays information about tape retention storage pool volumes.