Hitachi MK-96RD647-01 manual Get Dataset Attribute Information

/* Block length */ /* Record length */

/* Dataset type */ /* Record format */ /* Dataset name */

/* Last block address(relative track number) */ /* Last block address(relative block number) */

/* Mainframe OS(MVS･ VOS3･ MSP/VSE/VOS1/XSP) */

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	void (see Note 2)	Global memory area
g_error	long (see Note 1)	An error information stored area
ffd	DATASET_FIND_DATA	A dataset attribute information stored area
Return value: datasetError	long	Abnormal end
-1

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; unsigned short recordSize; unsigned char dsorg[2]; unsigned char recfm;

char name[44];

unsigned short lastBlockTt; unsigned char lastBlockR; unsigned char mftype;

}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.

Performing File Access Library (FAL) Operations 6-27

Hitachi USP V Cross-OS File Exchange User’s Guide