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

System Functions (n - p) PUT_WRITEX(2)
NAME
PUT_WRITEX - Writes data from an array in the application program to an open Guardian file
LIBRARY
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yputdll
SYNOPSIS
[#include <cextdecs.h>]
#include <pthread.h>
short PUT_WRITEX(
short filenum,
char *buff er,
#ifdef __LP64
int write_count,
int *count_written,
#else
unsigned short write_count,
unsigned short *count_written,
#endif
long tag);
PARAMETERS
Input
filenum Specifies the file number of a Guardian file open instance that identifies the file
to be written.
buffer Specifies an array in the application process in which the information to be writ-
ten to the file is stored before the call.
write_count Specifies the number of bytes to be written.
tag (Optional) For nowait I/O only. The tag value you define uniquely identifies the
operation associated with this call.
This parameter is supported only for program compatibility; if you provide it, it
is ignored.
Output
count_written (Optional) Returns a count of the number of bytes written to the file from buffer.
DESCRIPTION
The PUT_WRITEX() function is a thread-aware version of the Guardian WRITEX procedure.
This function writes data from an array in the application program to an open Guardian file.
For programming information about the WRITEX 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.
527186-023 Hewlett-Packard Company 5−311