MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 8 453
Command Definitions (HPMERGEEND-LOGSTATUS)
HPVOLINFO
HPVOLINFO
Returns volume information.
Up to six items of information can be retrieved. They must be specified in pairs (
,itemnum,
item
) and separated by commas
Syntax
I32 I16 *
HPVOLINFO(
status, volspecifiernum, volspecifier
I16 *
[,
itemnum, item ][...]);
Parameters
status 32-bit integer (optional)
Returns the status of the HPVOLINFO call. If no errors or warnings are
encountered,
status returns 32 bits of zero. If errors or warnings are
encountered,
status is interpreted as two 16-bit fields.
Bits (0:16) comprise
status.info . A negative value indicates an error. A
positive value indicates a warning.
Bits (16:16) comprise
status.subsys . This value defines the subsystem
that set the status information. On MPE/iX the volume management
identification number is 163. On MPE V, this field contains a 0 (zero).
NOTE It is good programming practice to specify status and check its value after
the intrinsic call. If you do not specify
status and an error condition is
encountered, HPVOLINFO causes the calling process to abort.
The error (negative) / warning (positive) values of status.info that can
be returned from a call to HPVOLINFO are given here.
Values marked with an asterisk (*) are returned by the MPE/iX version of
HPVOLINFO only.
Value Meaning
0 No errors or warnings (successful call).
150 Array passed in cannot hold all names--list truncated.
151 File label is unreadable.
152* Parts of the set or class are not mounted. Data was
gathered on the portion of the set or class that was
mounted, so the data may be incomplete.
-150 Invalid
itemnum .