Versions Compared

Key

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

Purpose

Used to unlock all locks set previously by this station.

Arguments

Argument

Input/Output

Value

CODE

Input

20

 

Output

unchanged

BFS

Input

MFS name

 

Output

unchanged

HANDLE

Input

null

 

Output

unchanged

NAME

Input

null

 

Output

unchanged

FMC

Input

null

 

Output

unchanged

RECORD

Input

null

 

Output

unchanged

STATUS

Input

1

 

Output

always returns true


Info
When this code is called, the system makes individual calls to all filing systems currently installed. The MFS should not attempt to pass this call to subsequent filing systems. Because this is a filing-system specific call, the BFS argument contains only the name of the current filing system.

Called by

BASIC+ Unlock subroutine, or when exiting from the debugger

...

Purpose

...

Used the first time an MFS is loaded for the current session to provide the MFS with an opportunity to initialize any buffers, caches, files, or other system resources required by the filing system. If the INSTALL call returns successfully, the system loads the name of the MFS into the system list of current filing systems. The MFS name will remain in this list until logoff.

...

Arguments

...

Argument

...

Input/Output

...

Value

...

CODE

...

Input

...

22

...

 

...

Output

...

unchanged

...

BFS

...

Input

...

MFS name

...

 

...

Output

...

unchanged

...

HANDLE

...

Input

...

null

...

 

...

Output

...

unchanged

...

NAME

...

Input

...

null

...

 

...

Output

...

unchanged

...

FMC

...

Input

...

null

...

 

...

Output

...

unchanged

...

RECORD

...

Input

...

null

...

 

...

Output

...

unchanged

...

STATUS

...

Input

...

number indicating the installation order of this MFS in the list of installed filing systems

...

 

...

Output

...

true if MFS is available

Info

When this code is called, the system makes individual calls to the current MFS only. The MFS should not attempt to pass this call to subsequent filing systems. Because this is a filing-system specific call, the BFS argument contains only the name of the current filing system.

 

Info
If Status is set to false, the MFS will not be loaded into the list of currently available filing systems.

RECORD.COUNT

...

Purpose

...

If supported by the BFS, used to return a record count for the file. The call is typically fulfilled within the filing system by reading a stored parameter.

...

Arguments

...

Argument

...

Input/Output

...

Value

...

CODE

...

Input

...

28

...

 

...

Output

...

unchanged

...

BFS

...

Input

...

BFS list

...

 

...

Output

...

unchanged

...

HANDLE

...

Input

...

file handle

...

 

...

Output

...

unchanged

...

NAME

...

Input

...

null

...

 

...

Output

...

unchanged

...

FMC

...

Input

...

0

...

 

...

Output

...

record count

...

RECORD

...

Input

...

null

...

 

...

Output

...

unchanged

...

STATUS

...

Input

...

0

...

 

...

Output

...

true if BFS is providing a record count in the FMC argument, false if the call is not supported by the BFS

Info
This call was designed specifically for RTP57, which stores a record count as part of the file header. If the BFS does not support the call, a status of false is returned. In this case, processes that require a record count should execute a READNEXT loop to return a true record count.

Called by

BASIC+ Get.RecCount function, or a direct call