MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 8 429
Command Definitions (HPMERGEEND-LOGSTATUS)
HPSELECT
Bits representing file numbers greater than numfiles (minus 1) are
ignored. The buffer containing the bit mask only needs to be as large as
the number of 32-bit words required to contain the bits for
numfiles files.
If a timeout is specified and the time limit has elapsed, the mask is cleared
on return.
Default: No files are checked for reading.
writemask character array by reference (optional)
Specifies which file numbers are to be examined to see if the file is ready
for writing. The last significant bit of each 32-bit word represents the
lowest file number in the word. The first word contains the bits for the first
32 files. Subsequent words contain the bits for additional groups of 32 files.
For each file number less than numfiles , the corresponding bit in the
mask is set at return if the bit was set at entry and the file is ready for
writing.
Bits representing file numbers greater than
numfiles (minus 1) are
ignored. The buffer containing the bit mask only needs to be as large as
the number of 32-bit words required to contain the bits for
numfiles files.
If a timeout is specified and the time limit has elapsed, the mask is cleared
on return.
Default: No files are checked for writing.
exceptionmask character array by reference (optional)
Specifies which file numbers are to be examined to see if the file has
detected an exception condition. The last significant bit of each 32-bit word
represents the lowest file number in the word. The first word contains the
bits for the first 32 files. Subsequent words contain the bits for additional
groups of 32 files.
For each file number less than
numfiles , the corresponding bit in the
mask is set at return if the bit was set at entry and the file has detected an
exception condition.
Bits representing file numbers greater than
numfiles (minus 1) are
ignored. The buffer containing the bit mask only needs to be as large as
the number of 32-bit words required to contain the bits for
numfiles files.
If a timeout is specified and the time limit has elapsed, the mask is cleared
on return.
Default: No files are checked for exception conditions.
timeout record by reference (optional)
Specifies a maximum interval to wait for the selection to complete. If a
timeout value of 0 is supplied, HPSELECT checks for the specified
conditions, sets the return mask, and returns without blocking even if
none of the specified conditions are true. If a
timeout value is not
specified, HPSELECT waits until an event causes one of the masks to be
returned with a non-zero value.