BBjFileSystem::convertMKeyedToXKeyed

Description

Converts a MKEYED file into an XKEYED file.

Syntax

Return Value

Method

void

convertMKeyedToXKeyed(string filename, int shouldForceRecoverable)

Parameters

Variable

Description

filename

Specifies the name of the MKEYED file to be converted.

shouldForceRecoverable

Specifies whether the new XKEYED file will be recoverable.

0 = Non recoverable

1 = Recoverable

Return Value

None.

Remarks

This method requires the full path name for the file to be converted and attempts to create a backup file by adding the extension .bak to the original file name. If a file with this name already exists, the method will generate an !ERROR=12.

Example

REM Convert a MKEYED file to an XKEYED file

REM Set the file name of the MKEYED file to be converted
FILE_NAME$="C:\TEST\CUSTOMER.DAT"

REM Obtain the instance to the BBjAPI object
myAPI!=BBJAPI()

REM Obtain the instance to the BBjFileSystem object
myFileSystem!=myAPI!.getFileSystem()

REM Convert the file to the highly recoverable XKEYED format
myFileSystem!.convertMKeyedToXKeyed(FILE_NAME$,myAPI!.TRUE)

See Also

BBjAPI

See the BBj Object Diagram for an illustration of the relationship between BBj Objects.