6. subcommand

(1) How to express keywords and parameters

Keywords and parameters are written in the following fonts.

• Keyword (system reserved word): Normal character
• Parameters (values specified by the user): italic text

(2) List of subcommands

Table 6.1 List of subcommands

function		keyword	number
Operating environment settings			1.0
	Specifying the working directory	work	1.1
	Specifying write speed	speed	1.2
	Specifying test mode (with writing execution confirmation)	test	1.3
	Test mode specification 2 (no write execution confirmation)	testgo	1.4
	Specifying the display language (English)	english	1.5

function		keyword	number
Editing disc contents			2.0
	Creating a master disk	master	2.1
	Creating a fully recordable disc	debug	2.2
	Add files	add	2.3
	Delete file	delete	2.4
	File replacement	replace	2.5
	Writing system area	system	2.6
	Specifying sector type	scttype	2.7
	Specifying the reference directory	chdir	2.8
	Creating a raw append disc	raw	2.9

function		keyword	number
write on the fly			3.0
	Performing on-the-fly writes	otf	3.1
	On-the-fly write file deletion	rmv	3.2

6.1 Setting up the operating environment

one View table

Title Subcommand specifications

Subcommand Specifying the working directory

Keyword work

No 1.1

Format

work=dosdir

parameters

dosdir: working directory

Shortened form

w

function

Specify the directory where the additional image file will be created.

remarks

The default value is the current directory.
It can also be specified with the environment variable "ADDCDW". The priority order is as follows.

1. Directory specified with this subcommand.

2. Directory specified by environment variable ADDCDW.

3. current directory.

-Example-

work=d:\tmp

one View table

Title Subcommand specifications

Subcommand Specifying write speed

Keyword speed

No 1.2

Format

speed=speedpara

parameters

speedpara: access speed

Shortened form

s

function

Specify the access speed. 1, 2, 4 can be specified. (Standard speed, 2x speed, 4x speed)

remarks

The default value for access speed is 4.

-Example-

speed=2

one View table

Title Subcommand specifications

Subcommand Specifying test mode

Keyword test

No 1.3

Format

test

parameters

none

Shortened form

t

function

Specifies writing in test mode. (Writing execution confirmed)

remarks

1. If writing in test mode is completed successfully, the writing process begins after confirming whether writing will actually be performed on the CD-R disc.

-Example-

test

one View table

Title Subcommand specifications

Subcommand Specifying test mode 2

Keyword testgo

No 1.4

Format

testgo

parameters

none

Shortened form

tg

function

Specifies writing in test mode. (No writing execution confirmation)

remarks

1. Immediately writes to the CD-R disc when writing in test mode is successful.

-Example-

testgo

one View table

Title Subcommand specifications

Subcommand Specifying the display language (English)

Keyword english

No 1.5

Format

english

parameters

none

Shortened form

e

function

Display messages in English.

remarks

If this subcommand is omitted, the language mode of DOS is determined and a message is displayed in either Japanese or English.

-Example-

english

6.2 Editing disc contents

one View table

Title Subcommand specifications

Subcommand Creating a master disk

Keyword master

No 2.1

Format

master=dospath

parameters

dospath: Path name of disk image file (excluding extension)

Shortened form

m

function

Creates a master disk based on the specified disk image file.

remarks

1. If the keyword is omitted in the command line specification, it is treated as this subcommand.

2. If this subcommand is specified, subcommands related to editing other disc contents cannot be specified.

3. When using a new disk, you must specify either this subcommand, debug subcommand, or raw subcommand.

-Example-

master=c:\newdisc

one View table

Title Subcommand specifications

Subcommand Creating a fully recordable disc

Keyword debug

No 2.2

Format

debug=dospath

parameters

dospath : Path name of disk image file (excluding extension)

Shortened form

d

function

Creates a debugging disk by adding data entirely based on the specified disk image file.

remarks

1. If this subcommand is specified, subcommands related to editing other disc contents cannot be specified.

2. When using a new disk, you must specify either this subcommand, the master subcommand, or the raw subcommand.

-Example-

debug=c:\newdisc

one View table

Title Subcommand specifications

Subcommand Add files

Keyword add

No 2.3

Format

add=discpath,dospath

parameters

discpath: Pathname of additional files on disk

dospath: Path name of additional files on DOS

Shortened form

a

function

Adds the specified DOS file to disk.

-Example-

add=\stage1.dat,\newfiles\stage1.dat

one View table

Title Subcommand specifications

Subcommand Delete file

Keyword delete

No 2.4

Format

delete=discpath

parameters

discpath: Path name of the deleted file on disk

Shortened form

del

function

Removes a file on the specified disk from a directory entry.

-Example-

delete=\bbb.dat

one View table

Title Subcommand specifications

Subcommand File replacement

Keyword replace

No 2.5

Format

replace=discpath,dospath

parameters

discpath: pathname of replacement file on disk

dospath: Path name of replacement file on DOS

Shortened form

rep

function

Replaces the file on the specified disk with the file on DOS.

remarks

1. Replacement is not possible if the original file is interleaved.

-Example-

replace=\bbb.dat,\newfiles\stage1.dat

one View table

Title Subcommand specifications

Subcommand Writing system area

Keyword system

No 2.6

Format

system=dospath

parameters

dospath: Path name of the file on DOS to be written to the system area

Shortened form

sy

function

Writes the specified file to the disk's system area.

remarks

1. If this command is omitted, the contents of the system area will not be changed.

-Example-

system=\new\ip.bin

one View table

Title Subcommand specifications

Subcommand Specifying sector type

Keyword scttype

No 2.7

Format

scttype=sectortype

parameters

sectortype: sector type

Shortened form

sc

function

Specify the sector type of the file to be edited.
Valid for files to be added or replaced.

Sector type	Contents
MODE1	Mode1 sector (2048 bytes)...Default value
FORM1	Mode2Form1 sector (2048 bytes)
FORM2	Mode2Form2 sector (2324 bytes)
FORM1V	Mode2Form1 sector (Video file)
FORM1A	Mode2Form1 sector (Audio file)
FORM1D	Mode2Form2 sector (Data file)
FORM1V	Mode2Form2 sector (Video file)
FORM1SUBH	Mode2Form1 sector (file with subheader)
FORM2SUBH	Mode2Form2 sector (file with subheader)
CDDA2	2 channel CD-DA (no pre-emphasis)
CDDA2PE	2 channel CD-DA (with pre-emphasis)
CDDA4	4 channel CD-DA (no pre-emphasis)
CDDA4PE	4 channel CD-DA (with pre-emphasis)

remarks

1. The specified sector type remains valid until the next time it is changed using the scttype subcommand.

2. b) The presence of 4 channels of CD-DA and pre-emphasis is a special case, and normally CDDA2 (2-channel CD-DA, no pre-emphasis) is specified.

3. FORM1SUBH and FORM2SUBH are specified when the source file has a subheader.
   The contents of the source file's subheader are written to disk unchanged.

-Example-

┌──Subcommand file──┐
  scttype=FORM1                  
  add=\prog.bin,prog.bin         A Mode2 Form1 sector file PROG.BIN is created in the root directory.
  scttype=FORM2                  
  add=\music\aaa.snd,aaa.snd     
  add=\music\bbb.snd,bbb.snd     Mode2 Form2 sector files AAA.SND and BBB.SND are created in the \MUSIC directory.
└───────────────────┘

one View table

Title Subcommand specifications

Subcommand Specifying the reference directory

Keyword chdir

No 2.8

Format

chdir=discdir

parameters

discdir: Reference directory name on disk

Shortened form

cd

function

Specify the reference directory on the disk.

remarks

1. Specifies the reference directory when specifying a relative path to a file on disk with other subcommands.

2. The initial value is the root directory.

-Example-

┌──Subcommand file──┐
  add=prog.bin,prog.bin          PROG.BIN is created in the root directory.
  chdir=music
  add=aaa.snd,aaa.snd            AAA.SND and BBB.SND are created in the \MUSIC directory.
  add=bbb.snd,bbb.snd
└───────────────────┘

one View table

Title Subcommand specifications

Subcommand Creating a raw append disc

Keyword raw

No 2.9

Format

raw=dospath

parameters

dospath: Path name of disk image file (excluding extension)

Shortened form

r

function

Appends the entire disk image based on the specified disk image file. However, the volume descriptor set, path table, and directory are not checked or updated.
This makes it possible to write data that does not meet the ISO9660 standard, but care must be taken as the information indicating the frame address position will not be updated.

remarks

1. If this subcommand is specified, subcommands related to editing other disc contents cannot be specified.

2. When using a new disk, you must specify either this subcommand, master subcommand, or debug subcommand.

3. When writing with this subcommand, the data from track 2 onward will be shifted backward by 2 sectors relative to the DSK file.

4. This subcommand is used only for special purposes and is not used for general CD creation work.

-Example-

raw=c:\newdisc

6.3 Writing on the fly

one View table

Title Subcommand specifications

Subcommand Performing on-the-fly writes

Keyword otf

No 3.1

Format

otf=sctpath

parameters

sctpath: Path name of sector information file (excluding extension)

Shortened form

o

function

Creates a debug disk by on-the-fly writing based on the specified sector information file.

remarks

1. In order to perform on-the-fly writing, it is necessary to create a sector information file for on-the-fly writing using CD builder XBLD.

2. When performing on-the-fly writing, it is automatically written in debug mode. Since it is written in debug mode, additional writing to the CD-R disc is possible.

3. Writing in master mode is not supported.

4. Disks containing secondary volume descriptors and boot record descriptors are not supported.

5. Discs whose submodes are controlled using CD Builder's "Trigger" and "Eors" commands are not supported.

one View table

Title Subcommand specifications

Subcommand On-the-fly write file deletion

Keyword rmv

No 3.2

Format

rmv

parameters

none

Shortened form

none

function

Delete files for on-the-fly writing.
Used with the otf subcommand to delete associated files after completing on-the-fly writing.

remarks

1. Files deleted by rmv subcommand

Interleaved intermediate file :

Interleaved intermediate files created for on-the-fly writing.
(File extension is "oti")