HP XP20000XP24000 Disk Array - Manual (Page 174)

6-20 Performing File Access Library (FAL) Operations
Hitachi USP V Cross-OS File Exchange User’s Guide
Open Dataset
Format:
datasetError=dataset_Open(global,g_error,devname,dsname,voltype,
mode)
Table 6-13 Arguments, Types and Descriptions for Open Data Set
Argument Type Description
global
g_error
devname
dsname
voltypr
mode
Return value: datasetError
-1 void (see Note 1)
long (see Note 1)
char (see Note 1)
char (see Note 1)
char (see Note 1)
char (see Note
1)
long Global memory area
An error information stored area
raw device name
dataset name
volume emulation type
open mod
Abnormal end
Note 1: When you issue this function, you must issue dataset_ Close() in
the end process.
Note 2: 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_AllocGlobal)
– 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,and 3390-3B/9B/LB,
3380-3A, 3380-3B)
– mode:
• “r”: Read only
• “w”: Write only
– Return Value: When this function ends abnormally, it returns -1.
• Example:
void *memptr; /* global memory area */
long err,datasetError; /* global err information */