HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, September 2010)

•
When this function ends normally, reclen (record length) is returned. (0 record
length 32760).
• When this function ends abnormally, “- 1” is returned.
• When this function detects EOF, “DATASET_ERROR_END_OF_FILE” is returned.
NOTE:
When “- 1” is returned, see the content of g_error for error code details. For further
information, see Chapter 7 on page 149.
Write Data
• Format: recren= dataset_ Put(global, g_error, buf, buflen)
recren= dataset_ Put2(global, g_error, buf, buflen)
Table 55 Arguments, Types, and Descriptions for Write Data
DescriptionTypeArgument
Global memory area
void
1
global
An error information stored area
long
1
g_error
Read buffer
char
1
buf
Data length transferred to buffer
long
1
buflen
Data length read to buffer
long
1
reclen
Return value:
Abnormal end-1
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.)
When a full data error occurs, the return value of dataset_Put2 is “- 1”, but the 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 “Reading
Data” on page 125.
• Argument:
• global: Global memory area (specify a global memory area gotten by dataset_AllocG-
lobal).
• g_error: Specify an address to store FAL error code.
• buf: Specify a buffer to store write data.
• buflen: Specify the 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, see the contents of
g_error for error code details. For further information, see Chapter 7 on page 149.
Performing FAL Operations140