MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 8 425
Command Definitions (HPMERGEEND-LOGSTATUS)
HPPIPE
HPPIPE
Creates a pipe file type object defined as device type of streams, file type of pipes, and
record format of byte streams.
Syntax
I32 I32 I32
HPPIPE(
read_fd, write_fd, status )
Parameters
read_fd 32-bit signed integer by reference (required)
Returns the
read file descriptor for the pipe. Attempts to write to a
read file descriptor results in an error.
write_fd 32-bit signed integer by reference (required)
Returns the
write file descriptor for the pipe. Attempts to read from
a
write file descriptor results in an error.
status 32-bit signed integer by reference (optional)
Returns the
status of the HPPIPE call. If no errors or warnings are
encountered, status returns 32-bits of zero. If errors or warnings are
encountered, status if 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.
bits (16:16):
comprise status.subsys . The value represents the subsystem that
sets the status information. The subsystem identifier for HPPIPE is the
file system subsystem 143.
CAUTION If an error or warning is encountered and the status parameter was not
specified, HPPIPE causes the calling process to abort.
The following
status.info values can be returned by HPPIPE:
Status Code Meaning
-461 Maximum open files for operating system exceeded.
-18 Bounds violation on
read_fd parameter.
-18 Bounds violation on
write_fd parameter.
-80 An internal error occurred.
-81 The operation failed due to a lack of system resources.
-179 The user lacks the ability to create an object.