Acquiring Dataset Attributes; Acquiring Attribute Information For A Specific Dataset; Datasetgetfileinformation Function - HP StorageWorks P9000 User Manual

attached with Microsoft Visual C++.
and return values.
Table 45 DatasetGetLastError Function
Item
Argument
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;
unsigned short recordSize;
unsigned char dsorg[2];
unsigned char recfm;
char name[44];
unsigned short lastBlockTt;
unsigned char lastBlockR;
} 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
Item
Argument
Return value
128 Performing FAL Operations
Table 45
Value
none
datasetLastError Long
/* Block length */
/* Record length */
/* dataset type */
/* record format */
/* dataset name */
/* last block address (relative track number) */
/* last block address (relative record number) */
Value
Pathname char *
ffd
DATASET_FIND_DATA
0
-1
on page 128 shows the datasetClose arguments
Type
Error code
Type
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.)
Attribute information (area where dataset
attribute information is stored)
Normal end
Abnormal end
Description
Description