Console Commands › Console Commands › SET BACKSTORE=

SET BACKSTORE=

This command controls Backstore processing.

The following syntax conventions are used for all the commands in this section:

• "SET BACKstore=" or "SET BACKstore," (equal sign or command) can be used interchangeably.
• For the SubGroup parameter, S equals Short, M equals Medium, and L equals Long.
• For the Type parameter, P equals Primary, D equals Duplex, and B equals both Primary and Duplex
• An asterisk (*) indicates all, as in Group=* equals all groups, Type=* equals all tape types.

Syntax

SVTn SET BACKstore=

Auto,Group={nn|*} [,SubGroup={S|M|L|*}]

Where nn is a valid group number.

DEQueue,VOLser =volser

Where volser is a Virtual Volume VOLSER.

EXCLVOL,Group={nn|*}[,SubGroup={S|M|L|*}] [,Type={P|D|B|*}]

Where nn is a valid group number.

EXCLVOL,VOLser=volser

Where volser is a physical tape VOLSER.

Hold|Release,Group={nn|*} [,SubGroup={S|M|L|*}]

Where nn is a valid group number.

-Hold|-Release,Group={nn|*} [,SubGroup={S|M|L|*}]

Where nn is a valid group number.

reseT,Group={nn|*} [,SubGroup={S|M|L|*}]

Where nn is a valid group number.

The following describes each line of the syntax:

Auto,Group=nn [,SubGroup={S|M|L|*}]

This option temporarily turns on automation for a group or group and subgroup combination. Automated subgroups are dynamically held or released based on cache utilization thresholds established through parmlib attributes.

The automation status set by this command is temporary and is reset based on parmlib values if the Backstore Engine is restarted, the Groups are refreshed, or the Backstore settings are RESET.

DEQueue,VOLser=volser

This option causes the GRR (GRoup Request control block), which documents the need to Externalize a particular Virtual Volume, to be removed from the Externalization queue.

EXCLVOL,Group={nn|*} [,SubGroup={S|M|L|*}] [,Type=P|D|B|*]

This option releases the Backstore Tape (of the type specified) last used for Externalization by the specified group or group and subgroup combination. The next Externalization for the specified group or group and subgroup combination will use a scratch tape.

Note: The standard version of the command used to release all Duplex tapes last used by the Backstore Engine from further processing so they can be moved off-site is:

SVTn SET BACK=EXCLVOL,G=*,T=D

EXCLVOL,VOLser=volser

This option releases a specific Backstore Tape from Externalization. Instead of remounting that Backstore Tape Externalization performs a scratch mount.

Hold|Release,Group={nn|*} [,SubGroup={S|M|L|*}]

This option is used to hold or release for Externalization the Externalization subgroup queues associated with non-automated groups or a group and subgroup combination.

Queues associated with Automated Subgroups are not processed by this command. Automated subgroup queues are dynamically held or released based on cache utilization thresholds as defined by parmlib attributes.

Note: When the CacheWarningThreshold is set to 0, the Group parameter is not allowed. The Externalization Server queues can only be held or released in mass, not individually. When the CacheWarningThreshold is set to a value greater than 0, the Group parameter must be coded. To hold or release all groups in mass, use Group=*.

When a subgroup queue is held, Externalization subtasks processing that queue are stopped at completion of the current Virtual Volume.

To immediately start or stop a group subtask, use the SVTn START GROUP or SVTn STOP GROUP console commands. You can use the SVTn CHECK BACKSTORE console command to immediately trigger an internal check for work so that the Externalization tasks can be started sooner.

-Hold|-Release,Group={nn|*} [,SubGroup={S|M|L|*}]

This option is used to temporarily turn off automation for the selected groups or a group and subgroup combination and then hold or release the now manual Externalization subgroup queues for the selected groups or a group and subgroup combination.

Note: When a subgroup queue is held, Externalization subtasks processing that queue are stopped at completion of the current Virtual Volume.

Use the SVTn SET BACK=RESET, G= command to restore the automation status based on the attributes specified in parmlib.

When a subgroup queue is released, Externalization subtasks are started based on available tape drives and subgroup priority.

To immediately start or stop a group subtask, use the SVTn START GROUP or SVTn STOP GROUP console commands. You can use the SVTn CHECK BACKSTORE console command to immediately trigger an internal check for work so that the Externalization tasks can be started sooner.

reseT,Group={nn|*} [,SubGroup={S|M|L|*}]

This option reactivates Subgroup Automation for a group or group and subgroup combination after accessing the group definitions in parmlib to determine whether automation should be activated. This option is typically used after Subgroup Automation has been temporarily deactivated with the -HOLD or -RELEASE options.