MPE/iX Intrinsics Reference Manual (32650-90875)

460 Chapter8
Command Definitions (HPMERGEEND-LOGSTATUS)
HPVOLINFO
Item and Itemnum Pairs
All
item
parameters are passed by reference.
2 Number of volume sets
Function = MPE/iX, MPE V: DSTAT
Returns the number of system and nonsystem volume sets that are
configured on the system. It returns a 32-bit signed integer containing the
number of volumes sets. Zero (0) is the only valid
volspecifiernum
.
May be used with
Item
=3.
3 List of volume set names
Function = MPE/iX, MPE V: DSTAT
Returns a list of all system and nonsystem volume set names mounted on
the system. The item must be a character array where the list of set names
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 are mapped to a list of
32-byte names.
May be used with
Item
=2 to determine the maximum number of names
that could be returned.
4 Number of volume classes
Function = MPE/iX: VOLUTIL command
Returns the number of volume classes that a volume or volume set is
associated with. Returns a 32-bit signed integer containing the number of
volume classes. On MPE/iX, this number includes only classes whose
members are logically mounted.
A volume can be associated with more than one volume class. So, when the
specifier is 1 or 4, the number returned is the number of volume classes
that the volume is a member of. When the specifier is 2, the number
returned is the number of volume classes that are a subset of the volume
set.
May be used with
Item
=5
5 List of volume class names
Function = MPE/iX:VOLUTIL
Returns a list of volume class names. On MPE/iX, the list includes only the
names of classes whose members are all logically mounted.
The item must be a character array where the list of class names 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