HP StorageWorks P9000 Data Exchange User Guide (T1620-96016, September 2010)

• When this function ends abnormally, it returns a 0. For further information, see Chapter
7 on page 149.
• Example:
void *memptr; /* global memory area */
long err; /* global err information */
int retcode;
:
retcode = dataset_AllocGlobal(&memptr, &err, malloc, free);
:
retcode = dataset_FreeGlobal(&memptr, &err)
Open Dataset
Format: datasetError=dataset_Open(global,g_error,devname,dsname,voltype,mode)
Table 53 Arguments, Types, and Descriptions for Open Dataset
DescriptionTypeArgument
Global memory area
void
1
global
An error information stored area
long
1
g_error
raw device name
char
1
devname
dataset name
char
1
dsname
volume emulation type
char
1
voltype
open mod
char
1
mode
long
datasetError
Return value:
Abnormal end-1
1
When you issue this function, you must issue dataset_ Close() in the end process.
You must issue this function before dataset_Open(), Get(), dataset_Get2(), dataset_Put(),
dataset_Put2(), dataset_Rewind(), and dataset_GetFileInformation().
This function opens a specified dataset (file) with a specified open mode.
• Argument:
• global: Global memory area (specify a global memory area gotten by dataset_AllocG-
lobal).
• g_error: Specify an address to store FAL error code.
• devname: Raw device name (special file).
• dsname: Dataset name.
• voltype: Device emulation type (3390-3A/9A/LA, 3390-3B/9B/LB, 3380-3A, and 3380-
3B).
• mode: “r”: Read only, “w” Write only
• Return Value: When this function ends abnormally, it returns -1.
• Example:
Performing FAL Operations138