N: SIO Command $20 Rename File

N: SIO Command Rename File($20)

This is a command for Devices $71-$78 - The N: Device (see SIO-Commands-for-Device-IDs-$71-to-$78).

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 144 will be returned, with an extended error of 146 returned by the subsequent STATUS call.

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;
siov();

See Also

Put other related command links here.