Wiki Home >> N:-SIO-Command-$20---Rename-File

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