dealloc - Deallocate a volume

Purpose

Deallocate a volume. Deallocating a volume results in a deletion of the volume name from the database. The cartridge the volume was associated with goes back to the "allocatable" state and in case it does not belong to a scratchpool it is "moved" back to a scratchpool the application which issued this command has access to.

Syntax

dealloc volume_name [...] -app application_name

Parameters

volume_name [...]
Specifies the name of the volume to deallocate. Multiple names must be separated with a blank character between each name.
-app application_name
Specifies the application for which the volume should be deallocated.

Results

Beyond the general error code, the following command-specific error codes are returned:

  • EMM1304I - if a volume could not be deallocated because of existing references; most probably the volume is still mounted.
  • EMM1302E- in case the volume specified by name could not be found.

Examples

dealloc a00002 -app ERMMSystem

Related commands