Hitachi MK-96RD647-01 Get Multiple Dataset Attribute Information, Global Void Gerror Long Ffd

Get Multiple Dataset Attribute Information

•Format (1): datasetHandle=dataset_FindFirstFile(global, g_error, pathname, voltype, and ffd)

Table 6-20 Arguments, Types and Descriptions for Get Specified Dataset Attribute Information

Argument

Type

Description

global	void**
g_error	long*
ffd	DATASET_FIND_DATA
Return value: datasetError	long
-1

Global memory area

An error information stored area

A dataset attribute information stored area Abnormal end

This function returns top dataset attribute information specified by raw device name to ffd. This function is used with dataset_FindFirstFile, dataset_FindNextFile and dataset_FindClose.

•Argument (1):

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

–g_error: Specify an address to store FAL error code.

–Pathname: Address of partition name/physical drive name.

–Voltype: Device emulation type (3390-3A/9A/LA, and 3390-3B/9B/LB, 3380-3A, 3380-3B).

–ffd: A first dataset attribute information stored area.

•Return Value (1):

–When this function ends normally, “DATASET_HANDLE” is returned. This handler is used as an argument for next dataset_FindNextFile and dataset_FindClose functions.

–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.

Note: When there is no dataset in the VTOC, the g_error is “DATASET_ERROR_NO_DATASET”.

•Format (2): datasetError=

dataset_FindNextFile(global,g_error,datasetHandle, &ffd)

6-28 Performing File Access Library (FAL) Operations

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