MPE/iX Intrinsics Reference Manual (32650-90905)

430 Chapter8
Command Definitions (HPMERGEEND-LOGSTATUS)
HPSELECT
The timeout value is specified by a 64-bit record containing the following
two fields:
32-bit unsigned integer = seconds
32-bit integer = microseconds
Values up to 2**32 seconds can be specified.
Default: HPSELECT blocks until one of the specified conditions is true.
status 32-bit integer by reference (optional)
Returns the status of the HPSELECT 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
condition, and a positive value indicates a warning condition. Refer to the
MPE/iX Error Message Manual Volumes 1, 2 and 3 for a description of its
value.
Bits (16:16) comprise
status.subsys . The value represented by these bits
defines the subsystem that set the status information. The subsystem
identifier for HPSELECT is 143.
Possible error values of
status.info are:
Value Meaning
-9 Illegal parameter - the value of
numfiles is negative or
an invalid
timeout value was specified.
-18 Bounds violation - one or more parameters point to an
invalid address or to an address the user does not have
access to.
-30 Invalid file reference - one or more of the bit masks
specified an invalid file number.
-90 Timeout - the time limit expired before any selected events
occurred.
-91 Soft interrupt - a soft interrupt occurred before any
selected events occurred or before the time limit expired.
No status If status is not passed in, no status is returned.
NOTE HPSELECT will not ESCAPE if an error is detected and the status parameter
was not supplied. Errors are also indicated by a -1 in the
numselect
parameter (functional return). For assurance of a successful completion,
check the functional return.
The only file type supported by HPSELECT is Net IPC. For all other file types,
HPSELECT always returns TRUE.