Skip to content

N: SIO Command $20 Rename File

Bill Kendrick edited this page May 27, 2022 · 6 revisions

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.

Clone this wiki locally