Chapter 5 CD emulation related tools

5.1 CD Builder

5.1.1 About CD Builder

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

CD builders include XBLD and the previously provided VCDBUILD.
XBLD is upwardly compatible with VCDBUILD, and script files created for VCDBUILD can be used as is. It also includes enhancements such as support for on-the-fly writing.
XBLD is explained in detail in the " 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, each consisting of a keyword followed by zero or more parameters.
The script syntax of the script is explained in detail in the CD Builder Script Grammar Manual .

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

5.1.2 VCDBUILD command specifications

command:

VCDBUILD

Command name:

CD image file creation

Format:

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

argument:

Startup file:

Specify script files and disk configuration information files using startup files

option:

/i	Display of ISO9660 related processing
/c	Channel interleave arrangement table display
/d	Display input DOS file processing
/f	File interleave arrangement 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 disk image (default)
/n	Do not set ECC data on disk image
/s	Silence mode. Do not display working messages

function:

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

Example of use:

VCDBUILD TSTGAME.PRM

Contents of the startup file TSTGAME.PRM

---

SCR TSTGAME.SCR
RTI TSTGAME.RTI

---

remarks:

If the extension of the startup file is not specified when entering the command, the script file will be processed as TSTGAME.SCR and the RTI file will be 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 specifying /i option

nnnnnn: write System Area
nnnnnn: write Primary Volume Descriptor
nnnnnn: Boot Record
nnnnnn: Volume Partition Descriptor
nnnnnn: write Volume Description Terminal
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 specifying /d option

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

Message when specifying /f option

------: 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 specifying /c option

------: 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 of error messages and how to deal with them.
(Note: **** means a string, ** means a number.)

General error

This is a common lexical or syntactic error.

String length error

String is too long. The maximum number of characters in one line is 255 bytes.

Out of memory space

There is no more memory available. The only option is to expand the memory area by removing drivers, etc.

Illegal character

An invalid character code is included in the string.

Syntax error

Syntax error.

Cannot open File ****

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

Illegal token

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

Illegal parameter **

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

Illegal nesting of Include

Too many nested Includes. You can only include up to 2 layers.

block error

The following error occurs when Block and EndBlock do not correspond. If this error occurs, the correspondence of subsequent blocks may be misaligned, so similar errors will occur thereafter. Therefore, fixing the first error may also fix the later errors.

Illegal nesting of Block

Too many nested blocks.

Illegal definition of Endblock

Too many EndBlock definitions.

Expected ****

It appears that the block declaration indicated by **** is missing. **** may be undeclared or there may be an unnecessary End ****.

Illegal definition in **** block

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

Illegal nesting of Directory

Directories are nested too deeply. There are up to 8 directory levels.

**** block is not closed

**** block is not closed. **** may be redundant.

parameter error

This occurs when the characters in a parameter are spelled incorrectly, or when the value exceeds the range of possible values.

Illegal MS-DOS filename ****

The character string indicated by **** has characters or syntax that cannot be used in MS-DOS file names.

Illegal ISO filename ****

The character string indicated by **** has characters or syntax other than those that can be used in ISO9660 file names.

Illegal Directory name ****

The character string indicated by **** has characters or syntax other than those that can be used in ISO9660 directory names.

Illegal disc type ****

Disc type **** is incorrect.

Illegal track type ****

Track type **** is incorrect.

Illegal Offset

The relative position specification is incorrect.

Illegal Stream type ****

Wrong stream type.

Illegal volume type ****

Wrong volume type.

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

The catalog number contains characters other than numbers.

Illegal Switch ****

The switch can only be TRUE or FALSE.

Illegal Attribute ****

Attribute definition **** is incorrect.

Illegal Date or Time

One of the date or time values is outside the definable range.

Illegal File No.

FileNo is not a value between 1-255.

Illegal Source type ****

Incorrect source type ****.

Illegal data type ****

Data type **** is incorrect.

Illegal Coding Information

Coding information is not a value between 0-255.

Illegal character in Identifier ****

Identifier **** contains characters that cannot be used.

Illegal Escape Sequence ****

Escape Sequence**** is incorrect.

Illegal unit size

Unit size is 0. Unit size cannot be set to 0.

Illegal channel count

The number of channels is only 2 or 4.

Illegal Channel number

Channel number must be a value between 0-255.

Illegal MinLength

The value of MInLength must not be 0.

Illegal Sector Rate

Sector rate can only be 75 or 150.

Illegal BitRate

The bitrate value cannot be 0.

Illegal Logical Block size

LogicalBlockSize can only take values 512, 1024, or 2048.

attribute error

Although the syntax is correct, it is an error due to restrictions such as conditions.

**** is already defined

Items marked **** have already been defined.

CDDA cannot be defined in the first track

A CDDA track cannot be the first track.

Illegal command in the CDDA track

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

This command can be defined in the CDDA track only

This command can only be defined within a CDDA track. Please 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 within one ISO file.

Filesource type error in a Channel

Different types of file sources are defined within one channel.

Definition error of BeginTimeE and EndTimeE

BeginTimeE and EndTimeE can only be defined within an 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 Extent Time

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

SameName can be used when the SupplementaryVolume is defined

SameName is valid when SupplementaryVolume is defined.

PrimaryVolume is not defined

No PrimaryVolume is defined. One PrimaryVolume must be defined.

LeadIn is not defined

LeadIn is not defined before Track definition.

Illegal LeadOut tracktype

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

MpegMultiplex can be defined once in a block

MpegMultiplex can only be defined once within one block.

Disc is not defined

Disc is not defined.

BitRateis not defined

BitRate is not defined.

**** block is not defined

****Block not defined.

Illegal track number

Too many tracks. The number of tracks is up to 99.

Any track is not defined before LeadOut area is start

Track is not 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, the track type cannot be set to MODE2.

This command can be used in the MODE2 track only

This command is effective when the track type is MODE2.

Illegal track type in LeadIn area

LeadIn's track type is only 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 CloseBracket

" [ " is not closed in the macro definition.

Macro **** is not defined

Macro name **** is not defined.

All FileNos are not defined

All FileNos are not defined.

File No error

The same FileNo is defined in file interleaving.

Too many ISOFiles

Too many ISO file definitions in file interleaving.

ISOFile definition error

Multiple ISO files are defined within one file interleave.