HPPIPE
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index | |
| Edition 7 E0701 ♥ | |
| Edition 7 E0300 | |
| Edition 6 E0195 |
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.
Operation Notes
Enables creation of a pipe, which is a nameless object that can only be reached from members of its process's family. Returns two file numbers to the calling process that represent the write and read ends of the pipe. Use the FWRITE and FREAD intrinsics to read and write to the pipe. Data is returned in a first in, first out manner.
Related Information
| Intrinsics | FCLOSE, FOPEN, FRENAME, HPFDUPLICATE, HPFOPEN |
| Manuals | Resource Management Programmer's Guide |
|
HPMYPROGRAM |
HPRESETDUMP |