Chapter 4 CD Image Partial Update Tool VCDUTL

4.1 Command specifications

command:

VCDUTL

Command name:

Partial update of CD image

Form:

VCDUTL project file name ISO file name Old DOS file name New DOS file name [-f Update information file name]

argument:

Project file name:

Project file used when creating the CD image

ISO file name:

Filename in the updated CD image

Old DOS fa

File name in the updated ISO file

New DOS file name:

DOS file to be replaced

Update information file name:

The CD image is not updated, only the update information file is generated.

A file that records the updated information. Used with a virtual CD emulator.

function:

It is a tool to update the files in the CD image generated by VCDBUILD.

1. Replaces some ISO files in the CD image with the specified DOS files and updates the CD image. The ISO file may be file-interleaved or channel-interleaved. Emulation can be done in a shorter time than regenerating the entire disk.

2. Replaces some of the ISO files in the CD image with the specified DOS files, leaving the CD image intact and creating the modified information. The ISO file can be file-interleaved, but channel-interleaved is not subject to modification. Only the updated part is emulated with direct DOS file access.

caution:

In case of (1.), the DOS file to be replaced must be the same size as or smaller than the size of the DOS file to be replaced. If the new file is larger than the old file, an error will be displayed and the image will not be updated.
Currently, the DOS files to be changed are files other than MPEG and CD-DA.
In the case of (2.), there are no particular restrictions.

Example of use:

VCDUTL △ TSTGAME △ ISO1FILE.DDD △ DOSFILE.D01 △ DOSFILE.D02 △ [-f △ TSTGAME.PAT] [ENTER]

VCDUTL	Executable file name
TST GAME	The name of the project that created the CD image to be changed
ISO1FILE.DDD	ISO file name containing the DOS file to be changed
DOSFILE.D01	DOS file name to be changed
DOSFILE.D02	DOS file name to replace

Option specification:

-f:

TSTGAME.PAT is the update information file name (optional) that accompanies DOS file replacement.
This option does not update the CD image itself. It is played based on the update information file during emulation.
If this option is not specified, the update information file will not be output and the CD image will be rewritten and updated.

If you want to change multiple DOS files for the data of one CD image, there are the following two methods.

1. Execute the command multiple times without the "-f" option.

2. Execute the command multiple times without changing the update information file name with the "-f" option.

Note that with method (2.), the CD image remains as it is.

remarks:

With the "-f" option, if the ISO file containing the specified DOS file to be changed is configured with channel interleaving, the command will not be executed and an error will occur.
If the "-f" option is not provided and the DOS file size does not match, an error will occur.

VCDUTL error message

Cannot open CD image file.

The CD image file to update does not exist or the file failed to open.
Check for the existence of the CD image file to be updated.

Cannot found iso file [test].

The ISO file "test" was not found in the CD image file. Refer to the script file and enter the name of the existing ISO file.

Cannot found dos file [test].

The file "test" to be updated could not be found in the RTI file. Refer to the script file and enter the name of the existing DOS file.

Cannot found Project file [test].

The project file "test" does not exist or the file failed to open. Specify the correct project name.

Cannot found RTI file [test].

The RTI file "test" does not exist or the file failed to open. Check the existence of the RTI file described in the project file.

DOS file [test] is channel interleaved.

When creating the update information file with the [-f] option, the file "test" is channel interleaved. This file cannot be specified because channel-interleaved files cannot be emulated in direct DOS mode.

New DOS file [test] open error.

There is no new DOS file to replace, or the file failed to open. Specify an existing DOS file.

New DOS file size [a byte] is larger than old DOS [b byte].

The size of the newly replaced DOS file is larger than the size of the replaced DOS file. Specify a DOS file that is the same size as or smaller than the size of the DOS file to be replaced.

4.2 Execution example of partial update

(1) Sample script

test1.scr
;
Disc ". \ Test1.dsk"
Session SEMIXA
LeadIn MODE1
EndLeadIn
    Track MODE1
                   Volume ISO9660 test1.pvd; Not an ISO file name PrimaryVolume 0:02:16
                              EndPrimaryVolume
                   End Volume
                   PostGap 75
    EndTrack
    Track MODE1
                   PreGap 150
                   File ISOF_1.DAT; 1 ; ISO file name FileSource "pat_7.dat"
                              EndFileSource ↓
                   EndFile Replace this DOS file with pat_1.dat and PostGap 75.
    EndTrack
    Track CDDA
                   Pause 150
                   File CDDA1.DAT; 1 ; ISO file name FileSource "sound1.dat"
                              EndFileSource ↓
                    EndFile This DOS file is a CDDA and cannot be updated with the current EndTrack VCDUTL.EXE Ver. 1.0 LeadOut CDDA.
    Empty 300
EndLeadOut
EndSession
EndDisc

(2). Execution of partial update

• Replace the DOS file (pat_7.dat) in the ISO file (ISOF1_1.DAT; 1) that composes the disk image (test1.dsk) with the project file name test1 with the DOS file (pat_1.dat), and update the disk image. If you do, enter the following: The ISO file name to be specified must be entered in uppercase letters.

  Correct: VCDUTL test1 ISOF1_1.DAT; 1 pat_7.dat pat_1.dat
  Wrong: VCDUTL test1 TEST1.PVD pat_7.dat pat_1.dat
  

  * VCDUTL.EXE does not directly update the volume descriptor set (test1.pvd).

  As a result, if the file size of pat_1.dat is the same as or smaller than pat_7.dat, the pat_7.dat part of the disk image will be replaced with pat_1.dat.
  If you want to continue emulation

  VCDEMU △ test1

  To emulate real-time mode.

• Also, if the -f option is added, the disk image will not be updated and an update information file will be created.

  VCDUTL △ test1 △ ISOF1_1.DAT; 1 △ pat_7.dat △ pat_1.dat △ -f △ test1.pat

  As a result, an update information file (test1.pat) is created.
  If you want to continue emulating, start the VCD emulator with the -u option.

  VCDEMU △ test1 △ -u △ test1.pat

  Enter to emulate the direct DOS access mode.
  simply

  VCDEMU △ test1

  Please note that typing will result in real-time mode emulation using the created disk image test1.dsk.