TCL

change-file command

The change-file command changes the File Definition Code of a file.

Syntax

CHANGE-FILE filename [(options)]

CHANGE-FILE account-name,dict-name,data-name [(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:
	A	Changes the file or account and all sub-files.
	R	Changes the definition code of a file in another account.
	U	Changes the file to a DT-type file.
	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 DX-type file, indicating that the file will not be saved during a file-save. The file will not exist following a file-restore.

Description

If the change-file command is used without an option, the default definition code is D. The X or Z and Y options cannot be specified together.

The options are not added in this case, but they replace whatever is there.

Example(s)

Changing a File Definition Code

The following example changes the definition code of a data file (SALES) to a DX-type file:

>CHANGE-FILE DATA SALES (X

See also

set-dptr command→