6. Subcommand

(1) Keyword and parameter notation

Keywords and parameters are written in the following fonts.

• Keywords (reserved words of the system): normal characters
• Parameters (user-specified value): Italic characters

(2) List of subcommands

Table 6.1 List of subcommands

function		Subcommand	number
Specifying the operation mode			1.0
	CD creation	unspecified	1.1
	Real-time emulation	r	1.2
	Direct DOS file access	p	1.3 1.3
	On-the-fly writing	otf	1.4
Operating environment settings			2.0
	Maximum number of ISO files	i	2.1
	Maximum number of DOS files	d	2.2
	String area size	c	2.3
	Sector table area size	s	2.4
	Maximum number of channel interleaves	ci	2.5
	Maximum number of file interleaves	fi	2.6
	Number of submode controls	sm	2.7 2.7
	Subcommand file specification	sub	2.8
	VCDBUILD compatibility mode	vcd	2.9

6.1 Specifying the operation mode

List

Title Subcommand specifications

Subcommand CD creation

Keyword unspecified

No 1.1

Form:

unspecified

Parameters:

unspecified

function:

Generate disc image files and TOC files required for creating a CD.
If no subcommand is specified, it operates in CD burning mode.

remarks:

(a) Output files in CD creation mode The output files when the CD builder is started by the standard boot method are summarized for each of XBLD and VCDBUILD.

Table 6.2 Output files in CD creation mode

Output file	XBLD	VCDBUILD
DSK file	Output	Output
RTI file	Do not output * 1	Output
TOC file	Output	Do not output * 2

* 1 : Output when the r subcommand and p subcommand are specified.

* 2 : Output using the TOC information generation program VCDMKTOC.

(b) XBLD outputs the TOC file in any operation mode. There is no need to output the TOC file using VCDMKTOC.

List

Title Subcommand specifications

Subcommand Real-time emulation

Keyword r

No 1.2

Form:

r

Parameters:

none

function:

Specify when performing real-time emulation with the VCD emulator.

remarks:

(a) Output file

• DSK file
• RTI file
• TOC file

example :

r

List

Title Subcommand specifications

Subcommand Direct DOS file access

Keyword p

No 1.3 1.3

Form:

p

Parameters:

none

function:

Specify this when performing direct DOS file access emulation with the VCD emulator.

remarks:

(a) Output file

• PVD file
• RTI file
• QSB file
• TOC file

example :

p

List

Title Subcommand specifications

Subcommand On-the-fly writing

Keyword otf

No 1.4

Form:

otf

Parameters:

none

function:

Outputs a file for on-the-fly writing using ADDCDW.

remarks:

1. If you use a script file that contains the following keywords, you cannot perform on-the-fly writing (an error will occur when parsing the script file).
   • Supplementary Volume
   • SameName
   • Escape Sequences
   • BootIdentifier
   • Boot Record
   • BootSystemIdentifier
   • Trigger
   • Eors

2. Output file
   • PVD file
   • TOC file
   • SCT file
   • OTI file

example :

otf

6.2 Operating environment settings

List

Title Subcommand specifications

Subcommand Maximum number of ISO files

Keyword i

No 2.1

Form:

i = isonum

Parameters:

isonum: Maximum number of ISO files

function:

Set the maximum number of ISO files (files to be placed on the created CD).

remarks:

1. The default value for the maximum number of ISO files is 10000.

2. If you are building a disc with more than 10000 ISO files, increase the maximum number of ISO files as needed.

3. If the program cannot be started due to insufficient memory, set the maximum number of ISO files to a small value to reduce the memory used inside the system.

example :

i = 1024

List

Title Subcommand specifications

Subcommand Maximum number of DOS files

Keyword d

No 2.2

Form:

d = dosnum

Parameters:

dosnum: maximum number of DOS files

function:

Sets the maximum number of DOS files (source files that are the source of ISO files).

remarks:

1. The default value for the maximum number of DOS files is 10000.

2. If you are building a disk with more than 10000 DOS files, increase the maximum number of DOS files as needed.

3. If the program cannot be started due to insufficient memory, set the maximum number of DOS files to a small value to reduce the memory used inside the system.

example :

d = 2048

List

Title Subcommand specifications

Subcommand String area size

Keyword c

No 2.3

Form:

c = strsz

Parameters:

strsz: size of string area

function:

Sets the size of the string area that stores the strings used in the script file.

remarks:

1. The default value for the string area size is 400000 bytes.

2. The string area stores the ISO file name, directory name, DOS file name, macro definition contents, and other script command argument values.

3. If you receive the error message "Insufficient string space", increase the string space size.

4. If the program cannot be started due to insufficient memory, set a small string area size to reduce the memory used inside the system.

example :

c = 65536

List

Title Subcommand specifications

Subcommand Sector table area size

Keyword s

No 2.4

Form:

s = sctsz

Parameters:

sctsz: size of sector table area

function:

Sets the size of the sector table area (the table that manages the sector structure of an optical disc).

remarks:

1. The default value for the sector table area size is 30,000.

2. The sector table area stores information related to the sector structure of the disk, such as DOS files, gap sectors, and volume descriptors.

3. If you receive the error message "Insufficient sector table area", increase the sector table area size.
   Set the sector table area size to a value sufficiently larger than the maximum number of DOS files.

4. If the program cannot be started due to insufficient memory, set the sector table area size to a small size to reduce the memory used inside the system.

example :

s = 32768

List

Title Subcommand specifications

Subcommand Maximum number of channel interleaves

Keyword ci

No 2.5

Form:

ci = cinum

Parameters:

cinum: Maximum number of channel interleaves

function:

Sets the maximum number of channel interleaves.
This number of settings includes the number of ISO11172 streams (MPEG multiplex files) in addition to the number of channel interleaved files.

remarks:

1. The default value for the maximum number of channel interleaves is 256.

2. Increase the maximum number of channel interleaves if you have a large number of channel interleave files or ISO11172 streams.

example :

ci = 512

List

Title Subcommand specifications

Subcommand Maximum number of file interleaves

Keyword fi

No 2.6

Form:

fi = finum

Parameters:

finum: Maximum number of file interleaves

function:

Sets the maximum number of file interleaves.

remarks:

1. The default value for the maximum number of file interleaves is 256.

2. Increase the maximum number of file interleaves if you have a large number of file interleaves.

example :

fi = 512

List

Title Subcommand specifications

Subcommand Number of submode controls

Keyword sm

No 2.7 2.7

Form:

sm = smnum

Parameters:

smnum: Maximum number of submode controls

function:

Sets the maximum number of times the Trigger and Eors commands that perform submode control can be used.

remarks:

1. The default value for the maximum number of submode controls is 10000.

2. If the number of uses exceeds 10000, increase the maximum number of uses.

example :

sm = 1024

List

Title Subcommand specifications

Subcommand Subcommand file specification

Keyword sub

No 2.8

Form:

sub = subfile

Parameters:

subfile: pathname of the subcommand file

function:

Specify the subcommand file.

remarks:

1. When entering a command from the DOS prompt, specify it in the subcommand file that describes the subcommand instead of the command line.

2. Interprets and executes subcommands line by line from the beginning of the subcommand file.

3. Use ";" to write a comment in the subcommand file.
   The character string from ";" to the end of the line is ignored.

example :

C:> xbld -sub = sample.bld

sample.bld

---

; sample.bld
-r; realtime emulation
-i = 1024; number of isofiles
-d = 2048; number of dosfiles
sample; script file

---

List

Title Subcommand specifications

Subcommand VCDBUILD compatibility mode

Keyword vcd

No 2.9

Form:

vcd

Parameters:

none

function:

Specify this to make the same operation as VCDBUILD.
XBLD handles the failure of VCDBUILD and may behave differently from VCDBUILD.
In such a case, use the vcd subcommand to operate in VCDBUILD compatibility mode.

remarks:

1. A place that operates in the same way as VCDBUILD by using VCDBUILD compatibility mode

   1. Use files with subheaders in direct DOS file access mode.
      (An error will occur in XBLD mode, but it will be possible to operate in compatibility mode)

example :

vcd