Reference Guide › Command Reference › MDSKSCAN Command

MDSKSCAN Command

Use the MDSKSCAN command to report on the minidisks allocated within specified directory entries.

MDSKSCAN [entry| *] [("Options"]

Options:

[FILE [filename ]]
[MANAGER {mgrid | *}]
[NOWAIT]

Note: Options can be entered in any order.

Authorizations

If the MDSKSCAN command is to be issued from an EXEC, the issuing user ID must have NOPASS MDSKSCAN authorization in the AUTHORIZ CONFIG file.

Definitions

[entry | *]

Specifies the USER, IDENTITY, or SUBCONFIG directory entry containing minidisks to scan. You can specify entry names with a trailing asterisk to scan minidisks belonging to all entries that start with the indicated characters. If you specify *, which is the default, the scan includes minidisks of all directory entries that you manage.

[FILE [filename]]

Places the report in a file with the specified filename and a filetype of SCAN on your A-disk. You must have a read/write A-disk if you use the FILE option. The default filename is MDSKSCAN.

If you use the NOWAIT option with the FILE option, the command sends the report to your reader.

[MANAGER {mgrid | *}]

Specifies the directory manager whose userids’ minidisks to scan. An asterisk for mgrid scans minidisks of all directory managers and displays their userids.

[NOWAIT]

Does not wait while the minidisk scan is done. A servant user ID sends you a reader file when the scan completes. This option is valid only if the Servant Facility is enabled.

Description

The MDSKSCAN command reports on the minidisks allocated to specified user IDs. It reports only on minidisks allocated on volumes that are defined in the DASD CONFIG file.

This command provides information such as the virtual address of the minidisk, the minidisk type, block size, number of files, total size, percent of utilization, and date and time of last update. It does this by calling the VMXAQD MODULE to access and query each minidisk in a read‑only mode.

The minidisk type can be any of the following:

If you are not using the Servant Facility, the VMXAQD MODULE must be accessible, preferably on a public minidisk, for MDSKSCAN to execute properly.

Example

To get a report of minidisks for user IDs that begin with TEST that are under all directory managers, enter the following:

vmdirect mdskscan test* (manager *

CA VM:Director produces a report similar to the one below:

USERID    VADR  TYPE BLKSZ  FILES  SIZE   %   DATE      TIME      MANAGER 
TEST1     191   CMS  4096   1      300K   2   99/10/17  13:07:22  CARLAT
TEST2     191   CMS  4096   25     300K   80  99/10/17  13:07:26  CARLAT
TEST2     192   OS              
TEST3     191   CMS  4096   8      1024K  4   99/10/17  13:07:30  WOODYB
TEST4     191   CMS  4096   15     300K   52  99/10/17  13:07:33  WOODYB