HP XP20000XP24000 Disk Array - Manual (Page 177)

Performing File Access Library (FAL) Operations 6-23
Hitachi USP V Cross-OS File Exchange User’s Guide
Write Data
• Format: recren= dataset_ Put(global, g_error, buf, buflen)
recren= dataset_ Put2(global, g_error, buf, buflen)
Table 6-15 Arguments, Types and Descriptions for Write Data
Argument Type Description
global
g_error
buf
buflen
Return value: reclen
-1
void (see Note 1)
long (see Note 1)
char (see Note 1)
long (see Note 1)
long (see Note 1) Global memory area
An error information stored area
Read buffer
Data length transferred to buffer
Data length read to buffer
Abnormal end
Note 1: When buflen is “0”, the dataset_Put function has ended abnormally,
but the dataset_Put2 function ends normally. (It is possible to handle 0
data.)
Note 2: When a full data error occurs, a return value of dataset_Put2 is “-
1”, but a return value of dataset_Put is “Y”. G_error is “- 50”.
This function writes a record of the previous opened dataset to a buffer. For
variable length record formats, this function writes real data to a buffer with
record length. For more detail, see section Reading Data.
• Argument:
– global: Global memory area (Specify a Global memory area gotten by
dataset_AllocGlobal.)
– g_error: Specify an address to store FAL error code.
– buf: Specify a buffer to store write data.
– buflen: Specify buffer size.
• Return Value: When this function ends normally, reclen (record length) is
returned. When this function ends abnormally, “- 1” is returned. When “- 1”
is returned, refer to the contents of g_error for error code details. For
further information, see Appendix B.