HP XP20000XP24000 Disk Array - Manual (Page 181)

Performing File Access Library (FAL) Operations 6-27
Hitachi USP V Cross-OS File Exchange User’s Guide
Get Dataset Attribute Information
Get Specified Dataset Attribute Information
• Format: datasetError= dataset_GetFileInformation(global, g_error,
&ffd)
Table 6-19 Arguments, Types and Descriptions for Get Specified Dataset
Attribute Information
Argument Type Description
global
g_error
ffd
Return value: datasetError
-1 void (see Note 2)
long (see Note 1)
DATASET_FIND_DATA
long Global memory area
An error information stored area
A dataset attribute information stored area
Abnormal end
An attribute of the opened dataset is returned to ffd.
• Argument:
– global: Global memory area (Specify a Global memory area gotten by
dataset_AllocGlobal.).
– g_error: Specify an address to store FAL error code.
– ffd: A first dataset attribute information stored area.
The dataset attribute information format is shown below:
typedef struct DATASET_FIND_DATA {
unsigned short blockSize; /* Block length */
unsigned short recordSize; /* Record length */
unsigned char dsorg[2]; /* Dataset type */
unsigned char recfm; /* Record format */
char name[44]; /* Dataset name */
unsigned short lastBlockTt; /* Last block address(relative track number) */
unsigned char lastBlockR; /* Last block address(relative block number) */
unsigned char mftype; /* Mainframe OS(MVS ･ VOS3 ･ MSP/VSE/VOS1/XSP) */
} DATASET_FIND_DATA;
• Return Value:
– When this function ends normally, “0” is returned.
– When this function ends abnormally, “- 1” is returned.
– When “- 1” is returned, refer to the contents of g_error for details. For
further information, see Appendix B.
Note: * You must issue dataset_Open() before this function.