MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 8 463
Command Definitions (HPMERGEEND-LOGSTATUS)
HPVOLINFO
passed. The remaining bytes are mapped to a list of 32-byte names. On
return, the value has been modified to reflect the actual number of names
returned.
A volume can be associated with more than one volume class. So when the
specifier is 1 or 4, the list returned is a list of volume classes that the
volume is a member of. When the specifier is 2, the list returned is a list of
volume classes that are a subset of the volume set.
May be used with
Item =4 to determine the maximum number of names
that could be returned.
6 Number of member volumes
Function = MPE V: LISTVS MPE/iX: VOLUTIL
Returns the number of member volumes in the specified volume set/class
or device class. This item returns a 32-bit signed integer containing the
number of member volumes.
When the specifier is 2 or 3, the number of member volumes that make up
the volume set or class is returned, including the master volume in the
total count. When the specifier is 5, the number of member volumes
configured with the passed device class is returned.
For example, if a volume set consists of a master volume, MASTER, and two
member volumes, MEMBER1 and MEMBER2, and if the specifier used is a
volume set name, the number returned is 3.
On MPE/iX you can remove some or all of the volumes in a volume set
(excluding the master volume). Therefore, this number depends on the
number of volumes you have mounted at the time the intrinsic call is
made. Mirrored disks maintain identical copies of the same information on
two disks. Therefore, the number returned reflects only one of the volumes
in a mirrored disk pair. Which volume is chosen is random.
On MPE V, the concept of master and member volumes refers only to
private volumes. Therefore, if the system volume set is specified, the count
consists of the number of volumes that are designated as system volumes.
May be used with
Item =7.
7 List of member volume names
Function = MPE/iX: VOLUTIL MPE V: LISTVS
Returns the list of names of the member volumes in the specified volume
set/class or device class.
The item must be a character array where the list of member volumes is
returned. The first four bytes of the array are interpreted as a 32-bit
integer describing the length of the array. The caller must set this value
equal to the maximum number of names that fits into the array being
passed. On return, the value has been modified to reflect the actual
number of names returned. The remaining bytes will be mapped to a list of
32-byte names.