Closing A Dataset; Acquiring Error Information; Format Requirements For Writing Variable-Length Records; Datasetclose Function - HP StorageWorks P9000 User Manual

dataset. When the data is written into the dataset, multiple records are blocked within the extent
defined by the VTOC of the dataset.
Figure 78 Format Requirements for Writing Variable-Length Records
.
When the datasetPut function terminates successfully, it returns the length of the data entity written
to the dataset. If the datasetPut function terminates unsuccessfully, it returns a value of -1. To get
the error code information, execute the datasetGetLastError function (see
Information" on page 127).

Closing a Dataset

datasetError = datasetClose (datasetHandle)
The datasetClose function closes the dataset specified by datasetHandle, which is returned by
the datasetOpen function.
values.
Table 44 DatasetClose Function
Item
Argument
Return value
When the datasetClose function terminates successfully, it returns a value of 0. If it terminates
unsuccessfully, it returns a value of -1. To get the error code information, execute the
datasetGetLastError function (see

Acquiring Error Information

datasetLastError = datasetGetLastError()
The datasetGetLastError function acquires the error code information for the most recent error.
Errors in FAL functions are defined in dataset.h (see
defined by a standard error file (errno.h). Errors in Windows systems are defined by errno.h
Table 44 on page 127 shows the datasetClose arguments and return
Value
datasetHandle DATASET_HANDLE
0
-1
"Acquiring Error
HP StorageWorks P9000 Data Exchange User Guide
Type
The datasetHandle value returned by the
datasetOpen function.
Normal end
Abnormal end
Information" on page 127).
Chapter 7 on page 149). Errors in UNIX are
"Acquiring Error
Description
127