HP XP20000XP24000 Disk Array - Manual (Page 182)

6-28 Performing File Access Library (FAL) Operations
Hitachi USP V Cross-OS File Exchange User’s Guide
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
g_error
ffd
Return value: datasetError
-1 void**
long*
DATASET_FIND_DATA
long 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)