HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, September 2010)
attached with Microsoft Visual C++. Table 45 on page 128 shows the datasetClose arguments
and return values.
Table 45 DatasetGetLastError Function
DescriptionTypeValueItem
——noneArgument
Error codeLongdatasetLastErrorReturn 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
DescriptionTypeValueItem
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 *PathnameArgument
Attribute information (area where dataset
attribute information is stored)
DATASET_FIND_DATA
ffd
Return value
Normal end0
Abnormal end-1
Performing FAL Operations128