N: SIO Command $20 Rename File

N: SIO Command Rename File($20)

Description

Rename the file pointed to by a valid N: Devicespec to a new name. If the desired protocol does not support rename, an ERROR 146 will be returned.

The old filename and new filename are to be separated by a comma, for example:

N:TNFS://TMA-1/OLD.TXT,NEW.TXT

Parameters

DCB	Value
DDEVIC	$71
DUNIT	$01 - $04
DCOMND	$20
DSTATS	$80
DBUF	256 byte long EOL terminated N: Devicespec
DTIMLO	$0F
DBYT	256
DAUX1	not used
DAUX2	not used

Examples

CC65

const char filespec="N:TNFS://TMA-1/OLD.TXT,NEW.TXT\x9b"; // \x9b is EOL.

OS.dcb.ddevic=0x71;
OS.dcb.dunit=1;
OS.dcb.dcomnd=0x20;
OS.dcb.dstats=0x80;
OS.dcb.dbuf=&filespec;
OS.dcb.dtimlo=0x0f;
OS.dcb.dbyt=256;
OS.dcb.daux1=0;
OS.dcb.daux2=0;

See Also

Put other related command links here.