HP XP P9500 Storage - Manual (Page 143)

• global: Global memory area (specify a global memory area gotten by dataset_AllocG-
lobal ).
• g_error: Specify an address to store the FAL error code.
• ffd: A first dataset attribute information stored area.
The dataset attribute information format is shown below:
typedef struct DATASET_FIND_DATA {
unsigned short blockSize; /* Block length */
unsigned short recordSize; /* Record length */
unsigned char dsorg[2]; /* Dataset type */
unsigned char recfm; /* Record format */
char name[44]; /* Dataset name */
unsigned short lastBlockTt; /* Last block address(relative track number) */
unsigned char lastBlockR; /* Last block address(relative block number) */
unsigned char mftype; /* Mainframe OS(MVS VOS3 MSP/VSE/VOS1/XSP) */
} DATASET_FIND_DATA;
• Return Value:
• When this function ends normally, “0” is returned.
• When this function ends abnormally, “- 1” is returned.
• When “- 1” is returned, see the contents of g_error for details. For further information, see
Chapter 7 on page 149.
NOTE:
You must issue dataset_Open() before this function.
Get Multiple Dataset Attribute Information
• Format (1): datasetHandle=dataset_FindFirstFile(global, g_error, pathname,
voltype, and ffd)
Table 60 Arguments, Types, and Descriptions for Get Multiple Dataset Attribute Information (1)
Description Type Argument
Global memory area void** global
An error information stored area long* g_error
raw device name char* pathname
Device emulation type char* voltype
A dataset attribute information
stored area
DATASET_FIND_DATA ffd
DATASET_HANDLE
datasetError
Return value:
Abnormal end -1
This function returns the top dataset attribute information specified by the raw device name to ffd.
This function is used with dataset_FindFirstFile, dataset_FindNextFile, and data-
set_FindClose
.
• Argument (1):
HP StorageWorks P9000 Data Exchange User Guide 143