Hitachi MK-96RD647-01 manual Converting do and RF Information, DatasetGetDsorgString Function

Converting DO and RF Information

The FAL provides two functions for converting specific attribute information from a dataset into character strings: datasetGetDsorgString, and datasetGetRecfmString.

Converting the Dataset Organization (DO) Type Value

datasetError = datasetGetDsorgString (dsorg, text)

The datasetGetDsorgString function converts the dataset organization (DO) type to a three-byte character string. The DO type is specified by dsorg[2] in DATASET_FIND_DATA. Table 6-10lists the datasetGetDsorgString arguments and return values.

Table 6-10 DatasetGetDsorgString Function

Item	Value	Type		Description
Argument	dsorg	u_char[	Value of dsorg[2] (two bytes) obtained by the attribute acquisition function
		]	datasetGetFileInformation, datasetFindFirstFile, or
	text		datasetFindNextFile.
		char [3]	Character string indicating the dataset organization (DO) type (3 bytes):
			PS	physical sequential organization
			VS	VSAM organization
			DA	direct access organization
			PO	Partial organization
			**	Other than above types
Return value	0		Normal end
	-1		Error end

Converting the Record Format (RF) Type Value

datasetError = datasetGetRecfmString (recfm, text)

The datasetGetRecfmString function converts the record format (RF) type to a five-byte character string. The RF type is specified by recfm in DATASET_FIND_DATA. Table 6-11lists the datasetGetRecfmString arguments and return values.

Table 6-11 DatasetGetRecfmString Function

Item

Value

Type

Description

6-12 Performing File Access Library (FAL) Operations

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