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.
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
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.
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
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