HP XP P9500 Storage - Manual (Page 144)

• global: Global memory area (specify a global memory area gotten by dataset_Alloc-
Global ).
• g_error: Specify an address to store the FAL error code.
• Pathname: Address of the partition name/physical drive name.
• Voltype: Device emulation type (3390-3A/9A/LA, 3390-3B/9B/LB, 3380-3A, and
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 the next dataset_FindNextFile and dataset_FindClose
functions.
• When this function ends abnormally, “- 1” is returned.
• When “- 1” is returned, see the contents of g_error for error code detail. For further
information, see Chapter 7 on page 149.
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)
Table 61 Arguments, Types, and Descriptions for Get Multiple Dataset Attribute Information (2)
Description Type Argument
Global memory area void global
An error information stored area long g_error
Dataset handler DATSET_HANDLE datasetHandle
A dataset attribute information
stored area
DATASET_FIND_DATA ffd
long
datasetError
Return value:
Abnormal end -1
This function gets a second dataset and more attribute information. You can get just the next set
of dataset attribute information, or you can use this function until no further dataset information is
available or returned.
• Argument (2):
• global: Global memory area (specify a global memory area gotten by dataset_Alloc-
Global ).
• g_error: Specify an address to store the FAL error code.
• datasetHandle: Specify a dataset handler.
• ffd: Next dataset attribute information stored area.
See dataset_GetFileInformation for dataset attribute information.
• Return Value (2):
Performing FAL Operations 144