The CHANGE-FILE command changes the File Definition Code of a file.
Format
|
CHANGE-FILE filename [(options)] CHANGE-FILE DICT filename [(options)] CHANGE-FILE DATA {filename | dict-name,data-name} [(options)] CHANGE-FILE M/DICT account-name [(options)] |
Parameter(s)
|
DICT |
Specifies the file dictionary. |
|
|
DATA |
Specifies the data file. |
|
|
M/DICT |
Specifies the system dictionary. |
|
|
filename |
Name of the file. |
|
|
dict-name,data-name |
Full name of the file. Use this format to change a data file that is one of multiple files associated with a single dictionary. |
|
|
options |
The following options are supported: |
|
|
C |
Changes the file to a DC-type file, indicating that the file may contain BASIC programs. The dictionary usually contains items that are pointers to frames containing object code and the data file contains the source code. You can specify DCX and DCY. |
|
|
R |
Changes the definition code of a file in another account. |
|
|
U |
Changes the file to a DU-type file, indicating that file updates will not be logged by the Update Logger. U may be specified with other options. |
|
|
X |
Changes the file to a DX-type file, indicating that the file will not be saved during a file-save. The file will not exist following a file-restore. |
|
|
Y |
Changes the file to a DY-type file, indicating that only the file sizing parameters will be saved, not its data, during a file-save. The file will be empty following a file-restore. |
|
|
Z |
Changes the file to a DZ-type file, indicating that files will not be saved on a floppy disk. |
|
Description
If CHANGE-FILE is used without an option, the default definition code is D. The X and Y options may not be specified together.
Also note that CHANGE-FILE does not retain the B option on the D/Code. For example, if you wish to change a DC file type to DCX, execute this command line:
|
>CHANGE-FILE (DCX |
The options are not added in this case, but they replace whatever is there.
Changing a File Definition Code
The following example changes the definition code of a data file called SALES to a DX-type file:
|
>CHANGE-FILE DATA SALES (X |