move-file Command

The move-file BASIC program moves a file descriptor from one master dictionary to another. The dictionary may be file-level, account-level (master dictionary), or system-level (master dictionaries or system).

This implementation allows moving data from FSI files to FSI files and from VME files to VME files.

NOTE

Moving files from FSI files to VME files or from VME files to FSI files is not implemented. Moving an account is also not implemented. To move an account, use rename database from the File Manager.

Syntax

move-file file.reference {file.name}

to: (file.reference {file.name}

The command requests the destination dictionary with the to: prompt. These responses are allowed:

(dict.name

or

(dict.name file.name

or

file.name

 

NOTE

  • If the dictionary name is missing, the source file dictionary is assumed.

  • If the file name is missing, the source file name is assumed.

  • If both the dictionary name and the file name are omitted, no action is taken.

The move-file command follows a hierarchical approach to file transfer. A file must be moved to the same level as it was created. That is, a data file to a data file, master dictionary to master dictionary, and so on.

Example(s)

Changes the name of the data-level D-pointer for the bp file to another item in the dictionary of bp called old.bp. The old.bp would subsequently be available using the reference bp,old.bp. This also removes the default D-pointer to the bp file, and any reference to the bp data section would result in the message data level descriptor missing.

move-file dict bp bp

to: old.bp

Changes the bp file to old.bp.

move-file md bp

to: old.bp

 

NOTE

This does not change the name of the data file within the dictionary of bp.

Moves the bp file from the current account to the archive account master dictionary.

move-file md bp

to:(archive,,

Moves the data portion of the bp file from the current account to the account called archive, to a dictionary called bp, and renames it bp.old.

move-file dict bp bp

to:(dict archive,bp,old.bp,

Renames the account pa to pete.

move-file mds,, pa

to:pete

 

NOTE

The rename-file command does not work at the master dictionary’s system level.

See Also

copy Command

create-file Command

delete-file Command

File Control Block

rename-file Command

steal-file Command