Chapter 4 CD image partial update tool VCDUTL

4.1 Command specifications

command:

VCDUTL

Command name:

CD image partial update

Format:

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 CD image

ISO file name:

Filename within the CD image to be updated

Old DOS file

Filename within the ISO file being updated

New DOS file name:

DOS files replaced

Update information file name:

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

A file that records updated information. Use with virtual CD emulator.

function:

This is a tool that updates files in CD images generated by VCDBUILD.

1. Updates the CD image by replacing some ISO files in the CD image with the specified DOS files. ISO files can be file interleaved or channel interleaved. Emulation is faster than regenerating the entire disk.

2. Replaces some ISO files in a CD image with the specified DOS files, leaving the CD image intact and creating its modified information. ISO files may be file interleaved, but channel interleaving is not subject to change. Only the updated part is emulated using direct DOS file access.

Note:

In case (1.), the DOS file to be replaced must be the same size or smaller than the DOS file being 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 subject to change 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
TSTGAME	Project name that created the CD image to be changed
ISO1FILE.DDD	ISO file name containing the DOS file to be modified
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) associated with DOS file replacement.
If this option is specified, the CD image itself will not be updated. Playback is performed 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 modify multiple DOS files for one CD image data, there are two methods:

1. Run 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.

Please note that method (2.) leaves the CD image intact.

remarks:

When using 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 present 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 be updated does not exist, or opening the file failed.
Check the existence of the CD image file to be updated.

Cannot found iso file [ test ].

The ISO file called "test" could not be found in the CD image file. Browse to the script file and enter the existing ISO file name.

Cannot found dos file [ test ].

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

Cannot found Project file [ test ].

The project file called "test" does not exist, or opening the file failed. Specify the correct project name.

Cannot found RTI file [ test ].

The RTI file named "test" does not exist, or opening the file failed. Check the existence of the RTI file written in the project file.

DOS file [ test ] is channel interleaved.

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

New DOS file [ test ] open error.

The DOS file you are trying to replace does not exist, or opening the file failed. Specify an existing DOS file.

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

The size of the new DOS file you are trying to replace is larger than the size of the DOS file being replaced. Specify a DOS file that is the same size or smaller than the DOS file being 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
                   EndVolume
                   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.
                   PostGap    75              
    EndTrack
    Track          CDDA
                   Pause      150
                   File       CDDA1.DAT;1                  ；ISO file name
                              FileSource    "sound1.dat"
                              EndFileSource    ↓
                    EndFile                  This DOS file is CDDA, so it cannot be updated
    EndTrack                                 with the current 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 makes up the disk image (test1.dsk) with project file name test1 with the DOS file (pat_1.dat) and update the disk image. If you want to do so, enter the following. Note that the specified ISO file name must be entered in uppercase letters.

  Correct: VCDUTL test1 ISOF1_1.DAT;1 pat_7.dat pat_1.dat
  Incorrect: 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 or smaller than pat_7.dat, the pat_7.dat portion of the disk image will be replaced with pat_1.dat.
  When continuing to run emulation

  VCDEMU△test1

  Enter to perform real-time mode emulation.

• Also, if you include the -f option, an update information file will be created without updating the disk image.

  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 emulation, start the VCD emulator with the -u option.

  VCDEMU△test1△-u△test1.pat

  Entering will emulate direct DOS access mode.
  simply

  VCDEMU△test1

  Please note that if you enter , you will run real-time mode emulation using the already created disk image test1.dsk.