HP XP P9500 Storage - Manual (Page 124)

FAL Functions
The FAL includes the following C functions (Visual C++ for Windows systems):
• Opening a dataset: datasetOpen (see “ Opening a Dataset ” on page 124)
• Reading one record from a dataset: datasetGet (see “ Reading Data ” on page 125)
• Writing one record to a dataset: datasetPut (see “ Writing Data ” on page 126)
• Closing a dataset: datasetClose (see “ Closing a Dataset ” on page 127)
• Acquiring error information: datasetGetLastError (see “ Acquiring Error Informa-
tion ” on page 127)
• Acquiring dataset attribute information (see “ Acquiring Dataset Attributes ” on page 128):
datasetGetFileInformation
datasetFindNextFile
datasetFindFirstFile
datasetFindClose
Converting Dataset Attribute Information
See “ Converting DO and RF Information ” on page 131:
datasetGetDsorgString
datasetGetRecfmString
Opening a Dataset
datasetHandle = datasetOpen (pathname, mode)
The datasetOpen function opens the dataset specified by pathname for the type of access specified
by mode.
Table 41 on page 124 shows the datasetOpen arguments and return values.
Table 41 DatasetOpen Function
Description Type Value Item
VSN:Dataset name
VSN = 6-character volser.
Volume must be listed in Data
Exchange volume definition file.
Delimiter = : (colon, no spaces
allowed)
Dataset name: 44 characters
maximum, no spaces allowed.
char * pathname
Argument
r = open dataset for read access
w = open dataset for write access
char * mode
Handle DATASET_HANDLE datasetHandle
Return value
Abnormal end -1
Performing FAL Operations 124