CHNGE - Change TFT entry

Macro type: type S (E form/L form); see "Macro types"

The CHNGE macro changes the file link name in an entry in the task file table (TFT), i.e. a new file link name is assigned to the file. All other values in the TFT entry remain unchanged.

CHNGE cannot be used on the TFT entry of a file which is currently open.

Format

Operation	Operands
CHNGE	[name1],name2[,MF = L]
	MF = (E,adr / E,(r))

Operand descriptions

The forms of the MF operand are described in detail in the appendix, "Macro types".

name₁
The file link name (1-8 characters long) which is to be replaced by “name₂”.

Default setting:

the first TFT entry with file link name C''BLANK''BLANK''BLANK''BLANK''BLANK''BLANK''BLANK''BLANK'' is processed (e.g. created via the LOCK-FILE-LINK function).

name₂
The new file link name (1-8 characters long) which is to replace the old name “name₁”.

Programming note

The following return codes are placed in register 15:

X'00' -	call was executed successfully
X'05A6' -	second operand errored
X'05C2' -	file link name contains illegal binary zeros
X'05D5' -	file link name not found
X'05D6' -	file with specified file link name is currently open
X'05DD' -	second file link name already exists