QUERY VDISK

Authorization

Privilege Class: B

Purpose

Use QUERY VDISK to display a list of all existing virtual disks in storage, or to display information about the system or user limits on the storage available for virtual disks in storage.

Operands

Syslim: displays the maximum amount of system storage that may be allocated for virtual disks in storage on the system.
Userlim: displays the maximum amount of system storage that may be allocated for virtual disks in storage defined by a single user using the DEFINE command.
Default: displays the default limit. If an installation default is defined in the system configuration file, that value is displayed. If an installation default is not defined in the system configuration file, or if the file is not found, the built-in default is displayed.

Responses

Response 1:

If QUERY VDISK or QUERY VDSK is entered with no additional operands:

VDISK userid vdev nnnnnnnn BLK [nnnn LINKS]

is displayed for each virtual disk in storage that currently exists.

userid: is the owner of the virtual disk in storage.
vdev: is the virtual device number of the virtual disk in storage in the owner's virtual machine.
nnnnnnnn BLK: is the size of the virtual disk in storage in 512-byte blocks.
nnnn LINKS: is the number of links to this virtual disk in storage. This value is displayed only for a virtual disk in storage defined in the directory.

Response 2:

userid vdev {R/O}, ...
            {R/W}

is displayed following Response 1 for each current link to the virtual disk in storage. Up to three responses are displayed on each line.

userid: is the user ID of the linking user.
vdev: is the virtual device number of the virtual disk in storage in the linking user's virtual machine.
R/O
R/W: identifies the type of access the linking user has to the virtual disk in storage.

Response 3:

VDISKS NOT FOUND

is displayed for a QUERY VDISK or QUERY VDSK command with no additional operands if no virtual disks in storage are in use.

Response 4:

VDISK SYSTEM LIMIT IS {nnnnnnnnnn BLK,} nnnnnnnnnn
                      {INFINITE,      }
BLK IN USE

is displayed if the command is entered with the SYSLIM operand.

Response 5:

VDISK USER LIMIT IS {nnnnnnnnnn BLK}
                    {INFINITE      }

is displayed if the command is entered with the USERLIM operand.

Messages

HCP002E Invalid operand - operand
HCP003E Invalid option - [command contains extra option(s) starting with] option
HCP026E Operand missing or invalid