Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (n - p) PUT_READUPDATEX(2)
Queue Files PUT_READUPDATEX() is not supported on queue files. An attempt to use
PUT_READUPDATEX() is rejected with Guardian file-system error 2.
Interprocess communication
PUT_READUPDATEX() reads a message from the $RECEIVE file that is
answered in a later call to the Guardian REPLYX procedure. Each message read
by PUT_READUPDATEX( ) must be replied to in a corresponding call to
REPLYX.
For programming information about the READUPDATEX procedure, see the Enscribe
Programmer’s Guide and the Guardian Programmer’s Guide.
To use this function on systems running J06.10 or later RVUs or H06.21 or later RVUs, you must
perform all of the following tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library.
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit applications.
To use this function in a 32-bit application on systems running H06.24 or later RVUs or J06.13 or
later RVUs, perform the same tasks (described above) used to enable the function on systems
running H06.21/J06.10 or later RVUs.
To use this function in a 64-bit application on systems running H06.24 or later RVUs or J06.13 or
later RVUs, you must perform all of the following tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Compile the application using the -Wlp64 compiler command option.
• Link the application to the yputdll library (/G/system/zdllnnn/yputdll).
Considerations
Buffer use PUT_READUPDATEX( ) is intended for use with 32-bit extended addresses
and 64-bit extended addresses. The data buffer for PUT_READUPDATEX()
can be either in the caller’s stack segment or any extended data segment.
Random processing and positioning
A call to PUT_READUPDATEX() returns the record from the current position
in the file. Because PUT_READUPDATEX() is designed for random process-
ing, it cannot be used for successive positioning through a subset of records as
the PUT_READX() function does. Rather, PUT_READUPDATEX() reads a
record after a call to the Guardian POSITION or KEYPOSITION procedure, in
anticipation of a subsequent update through a call to the Guardian WRITEUP-
DATEX procedure.
527186-023 Hewlett-Packard Company 5−241