Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The OPEN.MEDIA and CREATE.MEDIA calls use the NAME argument to pass a filing system qualifier. The actual definition of this argument is BFS-specific, and can vary from BFS to BFS.  Typically, the filing system qualifier is used to pass information about DOS file locations to the BFS.  This corresponds to the path name passed as the physical volume name in commands such as CREATE_TABLE.

CREATE.FILE

...

Purpose

...

Used to establish a new file.

...

Arguments

...

Argument

...

Input/Output

...

Value

...

CODE

...

Input

...

12

...

 

...

Output

...

unchanged

...

BFS

...

Input

...

BFS List

...

 

...

Output

...

unchanged

...

HANDLE

...

Input

...

media map handle

...

 

...

Output

...

unchanged

...

NAME

...

Input

...

filename*account, as read from @FILES<2> and @FILES<3>

...

 

...

Output

...

unchanged

...

FMC

...

Input

...

file creation options (BFS specific) passed as a dynamic array

...

 

...

Output

...

unchanged

...

RECORD

...

Input

...

null

...

 

...

Output

...

unchanged

...

STATUS

...

Input

...

1

...

 

...

Output

...

true if the file is successfully created

...

 

...

Info
This call can be trapped by an MFS only if the MFS is installed on the volume being accessed.  File creation options are passed as a dynamic array.  The first field contains the options, and the second field contains the literal "D" if a dictionary file is being created

...

Called by

...

BASIC+ CREATE_TABLE statement

 

Non-Volume Media Calls

Three media calls are available even if the MFS is installed only on the file, and not on the volume:

As with other calls, these can be disabled by setting STATUS to false and returning.