Reference Guide › Command Reference › RECLAIM Command

RECLAIM Command

Use the RECLAIM command to reclaim DASD from minidisks that were moved while users were linked to them.

RECLAIM    [vaddr| *] [("Options"]

Options:

[ACCess | NOAccess]
[FILE [filename]]
[Format | NOFormat]
[MSG | NOMSG]
[STACK [FIFO | LIFO]]
[FIFO] 
[LIFO] 
[Wait | NOWait]

Note: Options can be specified in any order.

Definitions

[vaddr | *]

Specifies a moved read‑only disk in the virtual address range 600 to 6FF. The default is asterisk (*), which tells CA VM:Director to check all addresses in the range for minidisks to reclaim.

[ACCess | NOAccess]

Checks all accessed minidisks (ACCESS) of the CA VM:Director service virtual machine, or skips checks of the accessed minidisks (NOACCESS) of the CA VM:Director service virtual machine. Skipping checks performs the RECLAIM command faster.

[Format | NOFormat]

Indicates whether to format the minidisk after reclaiming and scratching it.

[FILE [ filename]]

[MSG | NOMSG]

[STACK [FIFO | LIFO]

[FIFO]

[LIFO]

[Wait | NOWait]

These options are explained in the Common API Command Options.

Description

The RECLAIM command allows you to reclaim DASD after the links are removed without initializing CA VM:Director again. This command is issued automatically when CA VM:Director is initialized if the Servant Facility is turned on.

If you are authorized (you have MOVERO authorization), CA VM:Director lets you move minidisks even if users are linked to them read‑only. To accommodate the read‑only links, CA VM:Director removes the minidisks from the directory entry but does not format them. Instead, it holds the space the minidisks occupied until you use the RECLAIM command against them, and maintains them by redefining them to the CA VM:Director directory entry in the virtual address range 600 to 6FF. You cannot reclaim this DASD until the read‑only links are removed, which can be done with either the CP DETACH or the CP LOGOFF command.

During dynamic reconfiguration using the CONFIG PRODUCT command, CA VM:Director allocates a new COMMON disk if you have an ACCESS COMMON record. This new disk is allocated with an address in the 600‑6FF range. When the RECLAIM command runs it will reclaim this COMMON disk if it is no longer current or in use by any servant process.

Important! Do not assign minidisks to the CA VM:Director server in the virtual address range from 600 to 6FF. CA VM:Director will attempt to reclaim minidisks in this range, and will eventually format and scratch them.