HP XP P9500 Storage - Manual (Page 128)

attached with Microsoft Visual C++. Table 45 on page 128 shows the datasetClose arguments
and return values.
Table 45 DatasetGetLastError Function
Description Type Value Item
— — none Argument
Error code Long datasetLastError Return value
Acquiring Dataset Attributes
FAL provides several functions for acquiring the complete dataset attribute information for one or more
datasets: datasetGetFileInformation, datasetFindFirstFile, datasetFindNextFile,
and datasetFindClose. The dataset attribute information returned by these functions contains:
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 record number) */
} DATASET_FIND_DATA;
Acquiring Attribute Information for a Specific Dataset
datasetError = datasetGetFileInformation (pathname, &ffd)
The datasetGetFileInformation function acquires the attribute information for the dataset
specified by pathname and returns the data into ffd.
Table 46 on page 128 shows the datasetGetFileInformation arguments and return values.
Table 46 DatasetGetFileInformation Function
Description Type Value Item
Path name (VolumeName:DatasetName
(VSN identification))
• Volume name = 6-character VSN
• Delimiter = : (colon, no spaces)
• Dataset name: 44 characters maximum,
no spaces
• VSN = Same VSN identification in the
volume definition file. (It is possible to
omit this parameter.)
char * Pathname Argument
Attribute information (area where dataset
attribute information is stored)
DATASET_FIND_DATA
ffd
Return value
Normal end 0
Abnormal end -1
Performing FAL Operations 128