MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 8 459
Command Definitions (HPMERGEEND-LOGSTATUS)
HPVOLINFO
•For
volspecifiernum
4 on MPE V, a volume name consists of as many as eight
alphanumeric characters. The first character must be a letter. For private volumes,
names may be partially or fully qualified (
vname.group.acct
). Each field of the name
must be one to eight alphanumeric characters, the first of which must be a letter. The
maximum number of characters allowed is 55.
%SETxxxxx.GROUPxxx.ACCOUNTx:NAMExxxx.GROUPxxx.ACCOUNTx%
This name has six 8-character fields, four periods, a colon, and two delimiters.
When the volume name is not fully qualified, it refers to the volume name in the logon
group and/or account.
•For
volspecifiernum
4 on MPE/iX, the volume name consists of any string of one to
16 alphanumeric characters, including the underscore and the period. The first
character must be a letter.
On MPE V, there is no volume class for the system volume set. In order to access a
subset of the system volume set, devices classes are used.
On MPE/iX, volume classes exist for both system and nonsystem volume sets. Volume
classes take the place of device classes.
The
volspecifiernum
5, for items #6 and #7, provides compatibility between MPE/iX
and MPE V. Specifier 5 passes the device class of a group of volumes as they apply to the
I/O configuration. The maximum number of characters allowed in the string is 8. On
MPE V, specifier 5 must refer to a device class that is configured to a group of volumes.
ON MPE/iX, when a device class name is specified, a configured and mounted volume
class with the same name must exist in the system volume set. Data is returned based
on this volume class in the system volume set if it exists. Otherwise, an error results.
itemnum
16-bit signed integer by value (optional).
This is the cardinal number of the item desired. It specifies which item
value is to be returned. See Item and Itemnum Pairs.
item
Type varies (optional).
On MPE V, the item must be declared as a byte array. The actual type of
the
item
is specified by the corresponding
itemnum
. See Item and
Itemnum Pairs.
Special Considerations
You do not need special capabilities to use the HPVOLINFO intrinsic.
Split-stack calls are illegal.
When an error is returned, the values in the
item
parameters are all undefined. It is
not guaranteed that the data returned in an
item
is meaningful if any negative status
value is returned.
On MPE V, real values are accepted from the caller and returned to the caller in 64-bit
Hewlett-Packard 3000 format. This is the default format for MPE V.
On MPE/iX, real values are accepted from the caller and returned to the caller in the