Chapter 5 CD Emulation Related Tools

5.1 CD Builder

5.1.1 About CD Builder

The CD builder interprets the script that describes the data layout of the CD to be created and outputs the CD image file. The created CD image file is used for CD emulation and writing to write-once CDs.

The CD builder includes XBLD and the VCDBUILD we have provided so far.
XBLD is upward compatible with VCDBUILD, and you can use the script file created for VCDBUILD as it is. It also has enhancements such as support for on-the-fly writing.
XBLD will be explained in detail in "CD Builder XBLD User's Manual".
VCDBUILD is explained in the next section.

A script that specifies data placement on a CD consists of multiple command lines, which consist of keywords followed by zero or more parameters.
The script syntax for scripts is described in detail in the CD Builder Script Grammar Manual.

* Please use XBLD to create a CD image.
Use VCDBUILD only if you need to burn a CD in the same environment as before.

5.1.2 VCDBUILD command specifications

command:

VCDBUILD

Command name:

CD image file creation

Form:

VCDBUILD △ Startup file △ [/ i / c / d / f / p / a / e / n / s]

argument:

Startup file:

Specify the script file and disk configuration information file by the startup file

option:

/ i	Display of ISO9660 related processing
/ c	Channel interleaved placement table display
/ d	Display of input DOS file processing
/ f	File interleaved placement table display
/ p	Perform CD emulation with direct DOS file access
/ a	Specify / i, / c, / f, / d all at once
/ e	Set ECC data on the disk image (default)
/ n	Do not set ECC data on the disk image
/ s	Silence mode. Do not display working message

function:

Inputs a script from the specified script file and outputs a disk configuration information file and a CD image that represent the disk configuration.

Example of use:

VCDBUILD TSTGAME.PRM

Contents of the startup file TSTGAME.PRM

---

SCR TSTGAME.SCR
RTI TST GAME.RTI

---

remarks:

If the extension of the startup file is not specified when entering the command, the script file is processed as TSTGAME.SCR and the RTI file is processed as TSTGAME.RTI.

Message at startup

PreProcess for VCDEMU <VCDBUILD> Ver n.nn Released at dd-mmm-yyyy
Copyright (c) 1994 Victor Company of Japan <JVC)

script file = xxxxxxxxxx
rti file = xxxxxxxxxx
vds, path table and directory records output to xxxxxxxxxx

Message when / i option is specified

nnnnnn: write System Area
nnnnnn: write Primary Volume Descriptor
nnnnnn: Boot Record
nnnnnn: Volume Partition Descriptor
nnnnnn: write Volume Description Terminatior
nnnnnn: write M-path Table
nnnnnn: write L-path Table
nnnnnn: write Directory Records for Directory <root>
nnnnnn: write Directory Records for Directory xxxxxxxxxx
nnnnnn: Extent Begin
nnnnnn: ISO-file xxxxxxxxxx Begin

Message when the / d option is specified

nnnnnn: source dos-file xxxxxxxxxx
nnnnnn: Open Subsource file
nnnnnn: LeadOut Begin

Message when the / f option is specified

------: Disposition pattern for File Interleave
nnnn] nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn:
::
nnnnn] nnn: GAP: nnn: nnn: nnn: GAP: nnn: nnn: nnn: GAP: nnn: nnn: nnn: GAP: DMY: DMY:

Message when the / c option is specified

------: Disposition pattern for Channel Interleave
nnnn] nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn: nnn:
::
nnnn] nnn: GAP: nnn: nnn: nnn: GAP: nnn: nnn: nnn: GAP: nnn: nnn: nnn: GAP: DMY: DMY:

VCDBUILD error message

About the meaning and correspondence of error messages.
(Note: **** means a character string, ** means a number.)

General error

Common phrase, syntax error.

String length error

The string is too long. The maximum number of characters per line is 255 bytes.

Out of memory space

There is no memory available. There is no better way than expanding the memory area by removing the driver etc.

Illegal character

An invalid character code is included in the character string.

Syntax error

Syntax error.

Cannot open File ****

The file name indicated by **** cannot be opened. Check if the file name actually exists.

Illegal token

Syntax error. The cause of the error may be that the reserved word at the beginning of the line is incorrect.

Illegal parameter **

Syntax error. The cause of the error may be that the type of the numeric parameter indicated by ** is different.

Illegal nesting of Include

There are too many Include nests. Include can only be up to 2 layers.

Block error

The following error occurs when Block and EndBlock do not correspond. If this error occurs, the subsequent blocks may be out of correspondence, so a similar error will occur after that. Therefore, fixing the first error may also fix the second error.

Illegal nesting of Block

There are too many blocks nested.

Illegal definition of Endblock

There are too many EndBlock definitions.

Expected ****

There doesn't seem to be a block declaration indicated by ****. **** may not be declared or there may be unnecessary End ****.

Illegal difinition in **** block

This command can only be defined within the **** block.

Illegal nesting of Directory

Directory nesting is too deep. The directory level is up to 8 levels.

**** block is not closed

The **** block is not closed. **** may be extra.

Parameter error

It occurs when the parameters are spelled differently or exceed the range of possible values.

Illegal MS-DOS filename ****

The character string indicated by **** has a character or syntax other than that that can be used as an MS-DOS file name.

Illegal ISO filename ****

The character string indicated by **** has a character or syntax other than that that can be used as an ISO9660 file name.

Illegal Directory name ****

The character string indicated by **** has a character or syntax other than that that can be used as an ISO9660 directory name.

Illegal Disc type ****

The disc type **** is incorrect.

Illegal Track type ****

The track type **** is incorrect.

Illegal Offset

The relative position is specified incorrectly.

Illegal Stream type ****

The stream type is incorrect.

Illegal Volume type ****

The volume type is incorrect.

Illegal location of Primary Volume Descriptor

The relative time of the primary volume must be greater than or equal to 00:02:16.

Illegal Catalog number

Characters other than numbers are written on the catalog number.

Illegal Switch ****

The switch can only take TRUE or FALSE.

Illegal Attribute ****

The attribute definition **** is incorrect.

Illegal Date or Time

Either the date or time value is beyond the definition.

Illegal FileNo

FileNo is not a value of 1-255.

Illegal Source type ****

The source type **** is incorrect.

Illegal Data type ****

The data type **** is incorrect.

Illegal Coding Information

The coding information is not a value between 0-255.

Illegal character in Identifier ****

The identifier **** contains characters that cannot be used.

Illegal Escape Sequence ****

Escape Sequence **** is incorrect.

Illegal Unit size

The unit size is 0. The unit size cannot be set to 0.

Illegal Channel count

There are only 2 or 4 channels.

Illegal Channel number

The channel number must be a value between 0 and 255.

Illegal MinLength

The value of MInLength cannot be 0.

Illegal Sector Rate

The sector rate can only be 75 or 150.

Illegal BitRate

The bit rate value cannot be 0.

Illegal Logical Block size

LogicalBlockSize can only take any value of 512, 1024 or 2048.

Attribute error

Although it is syntactically correct, it is an error regarding restrictions due to conditions.

**** is already defined

What is indicated by **** is already defined.

CDDA cannot be defined in the first track

The CDDA track cannot be the first track.

Illegal command in the CDDA track

This command cannot be defined within a CDDA track. Check the track type.

This command can be defined in the CDDA track only

This command can only be defined within a CDDA track. Check the track type.

BeginTime and EndTime cannot be defined in a block

Both BeginTimeX and EndTimeX cannot be defined in the same block.

Filesource type error in an ISO-file

Different types of file sources are defined in one ISO file.

Filesource type error in a Channel

Different types of file sources are defined in one channel.

Definition error of BeginTimeE and EndTimeE

BeginTimeE and EndTimeE can only be defined within the Extent block.

Definition error of **** in a Channel block

**** can only be defined within a channel block.

Illegal BeginTimeS

BeginTimeS must be greater than or equal to 00:02:16.

Illegal ExtentTime

ExtentTime must be greater than or equal to 00:02:17.

SameName can be used when the SupplementaryVolume is defined

SameName is valid when Supplementary Volume is defined.

PrimaryVolume is not defined

No Primary Volume is defined. You must always define one Primary Volume.

LeadIn is not defined

LeadIn is not defined before the Track definition.

Illegal LeadOut tracktype

The LeadOut track type is not the same as the last track. The LeadOut track type must be the same as the last track's track type.

MpegMultiplex can be defined once in a block

MpegMultiplex can only be defined once in a block.

Disc is not defined

Disc is not defined.

BitRateis not defined

BitRate is not defined.

**** block is not defined

**** No block is defined.

Illegal track number

There are too many tracks. The number of tracks is up to 99.

Any track is not defined before LeadOut area is start

No Track is defined before LeadOut.

Filesource definition error in the CDDA track

CDDA tracks have a mix of file sources and file definitions.

Illegal track type on DiscType "CDROM"

When the disc type is CDROM, MODE2 cannot be set as the track type.

This command can be used in the MODE2 track only

This command works when the track type is MODE2.

Illegal track type in LeadIn area

The only track type for Lead In is MODE1.

Illegal track type in first track

The only track type for Track 1 is MODE1.

Channel number is already defined

That channel number is already defined.

Expected Close Bracket

"[" Is not closed in the macro definition.

Macro **** is not defined

Macro name **** is not defined.

All FileNos are not defined

All File Nos are not defined.

FileNo error

The same File No. is defined in File Interleave.

Too many ISO Files

There are too many ISO file definitions in file interleaving.

ISOFile definition error

Multiple ISO files are defined in one file interleave.