Use this command to create, rename, or reset any table on a fixed disk or removable drive.

Parameters

action (mandatory)

The desired action to perform on the table.

Range:

create

Creates a DOS entry in the FAT table and updates the DOS directory table.

rename

Changes the name of an existing system table to a new DOS file name (does not update the dms.cfg file).

reset

Initializes an existing table to the value designated by the resetchar parameter.

disk (mandatory)

Target disk. The disk that contains the file.

Range:

remove

Removable drive

fixed

Fixed disk

usb

The flush-mounted (not-latched) USB port on the MASP card.

ext (optional)

Extension. The three character DOS filename extension.

Range:

azz

0–3 ASCII characters

filelength (optional)

The amount of space the file occupies on the disk.

Range:

1 - 32505856

id (optional)

Table identification number.

Range:

0 - 499

name (optional)

Name of the file.

Range:

azzzzzzz

1–8 ASCII characters

prtngrp (optional)

Partition group. The disk partition group to be changed.

Range:

active

inactive

Default:

active

resetchar (optional)

Reset character. The table reset character that is written to every byte of the table.

Range:

0 - 255

Example

chg-tbl:action=create:disk=remove:name=test:ext=sys:filelength=150000

chg-tbl:action=reset:disk=remove:id=0

chg-tbl:action=rename:disk=remove:id=0:name=dms:ext=old

Dependencies

If the action=create/rename parameter is specified, then the name parameter must be specified.

2314 E2314 Cmd Rej: Invalid filename entered

If the action=create parameter is specified, then the name, ext, and filelength parameters must be specified.

2712 E2712 Cmd Rej: RESETCHAR not valid with ACTION=CREATE

If the file type is a directory, the filelength parameter is not required. The directory entry file length is always 1 cluster in length.

N/A N/A

The attributes used during file creation are current date and time of the active MASP. Readable/writable files are allocated contiguously from the last free FAT cluster.

N/A N/A

If the action=reset parameter is specified, then the id parameter must be specified.

2713 E2713 Cmd Rej: FILELENGTH not valid with ACTION=RESET

If the action=rename parameter is specified, then the id, name, and ext parameters must be specified.

2716 E2716 Cmd Rej: RESETCHAR not valid with ACTION=RENAME

This command cannot be used to modify the security log.

3003 E3003 Cmd Rej: Modification of security log not allowed

Notes

None

Output

chg-tbl:action=create:disk=remove:name=test:ext=sys:filelength=150000

chg-tbl: CREATE 0K : filename = test.sys, byte length = 150000 
chg-tbl: command complete 
;

chg-tbl:action=reset:disk=remove:id=0

chg-tbl: RESET OK : Table 0, DMS.CFG 
chg-tbl: command complete 
;

chg-tbl:action=rename:disk=remove:id=0:name=dms:ext=old

chg-tbl: RENAME 0K : Table 0, DMS.CFG to DMS.OLD 
chg-tbl: command complete 
;