You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

The CREATE.FILE call uses the FMC argument to pass file creation options to the BFS. For example, the various options that can be specified at the time a Linear Hash file is being created are passed to RTP57 via the FMC argument.

The file creation options are passed as a two-field dynamic array. The first field contains the command line options, delimited with value marks. The second field contains the literal character "D" if a dictionary file is being created. Unless a user specifies an explicit DATA or DICT parameter, the CREATE_TABLE command will generate two calls to the filing system. The first creates the data portion of the file, and the second generates the dictionary portion.  When a dictionary is being created, the system generates additional calls to create the @CRT record in the dictionary.

RENAME.FILE

Purpose

Used to change the name of an attached file.

Arguments

Argument

Input/Output

Value

CODE

Input

13

 

Output

unchanged

BFS

Input

BFS List

 

Output

unchanged

HANDLE

Input

media map handle

 

Output

unchanged

NAME

Input

new.filename*account

 

Output

unchanged

FMC

Input

old.filename*account

 

Output

unchanged

RECORD

Input

null

 

Output

unchanged

STATUS

Input

1

 

Output

returns true if successful, false if filename could not be changed in the media map

Called by

BASIC+ Rename_Table subroutine

MOVE.FILE

Purpose

Used to copy the contents of a file from one volume to another.

Arguments

Argument

Input/Output

Value

CODE

Input

14

 

Output

unchanged

BFS

Input

BFS List

 

Output

unchanged

HANDLE

Input

target media map handle

 

Output

unchanged

NAME

Input

target filename

 

Output

unchanged

FMC

Input

source media map handle

 

Output

unchanged

RECORD

Input

source file name

 

Output

unchanged

STATUS

Input

1

 

Output

returns true if file copied successfully

Because this is a BFS-level call, the target volume must use the same filing structure as the source volume.

Called by

BASIC+ Copy_Table subroutine

DELETE.FILE

Purpose

Used to remove a file from the system.

Arguments

Argument

Input/Output

Value

CODE

Input

15

 

Output

unchanged

BFS

Input

BFS List

 

Output

unchanged

HANDLE

Input

media map handle

 

Output

unchanged

NAME

Input

filename*application

 

Output

unchanged

FMC

Input

null

 

Output

unchanged

RECORD

Input

null

 

Output

unchanged

STATUS

Input

1

 

Output

returns true if file deleted successfully

Called by

BASIC+ Delete_Table subroutine

  • No labels