Initialize Target Record Pointer

Format: datasetError=dataset_Rewind(global,g_error)

Table 6-18 Arguments, Types and Descriptions for Initialize Target Record Pointer

Argument

Type

Description

global

void (see Note 2)

Global memory area

g_error

long (see Note 1)

An error information stored area

Return value: datasetError

long

Abnormal end

-1

 

 

 

 

 

Note 1: When this function is issued before dataset_Put, dataset_Put2, dataset_Get, and dataset_Get2, the pointer is returned to the top record. And then next dataset_Put, dataset_Put2, dataset_Get, and dataset_Get2 are performed from the top record.

Argument:

global: Global memory area (Specify a Global memory area gotten by dataset_AllocGlobal.).

g_error: Specify an address to store FAL error code.

Return Value:

When this function ends normally, “0” is returned.

When this function ends abnormally, “- 1” is returned.

When “- 1” is returned, refer to the contents of g_error for error code detail. For further information, see Appendix B.

6-26

Performing File Access Library (FAL) Operations

Hitachi USP V Cross-OS File Exchange User’s Guide

Page 180
Image 180
Hitachi MK-96RD647-01 Initialize Target Record Pointer, Format datasetError=datasetRewindglobal,gerror, Long Abnormal end