Japanese
PROGRAMMER'S GUIDEP.S. Write Once
BackForward
P.S. Write Once System User's Manual

Appendix A. Related tool “ADDGEN”


A.1 Overview

ADDGEN is a tool that automatically generates subcommand files for ADDCDW.
Modifying both the VCDBUILD script file (hereinafter referred to as script file) and the ADDCDW subcommand file in order to update the files on the CD-R disc is time consuming and likely to cause inconsistencies.
To solve this problem, simply modify the script file and the corresponding ADDCDW subcommand file will be automatically generated.

A.2 Function

Compares the script file with the CD-R disc and outputs a subcommand file for ADDCDW to add/delete/replace changed files. In other words, use ADDCDW to find out what kind of update processing should be performed on the CD to make it the same as the file structure described in the script file.
Compares the date and time of the file on DOS and the file on the CD-R disk, and determines that the file has been changed if the file on DOS is newer.

Figure A.1 ADDGEN data flow

A.3 How to start

Enter the command in the following format from the DOS prompt.

C:> addgen script file name [subcommand file name] [options]

(1) Script file name
Name of the script file that describes the contents of the updated CD-ROM.
If the extension is omitted, ".scr" is assumed to be omitted.

(2) Subcommand file name
Name of the ADDCDW subcommand file to be output.
If omitted, a subcommand file with the script file name extension ".cdw" will be output.

(3) Options

-c :
Compares the contents of the file on DOS and the file on the CD-R disk, and replaces the file if there is a change. Required if you want to update a file with an older date/time.
However, interleaved files, MPEG streams, and CDDA files are compared by date and time.

-e :
Display messages in English. If omitted, the language mode of DOS is determined and the message is displayed in either Japanese or English.

A.4 Operation details

Compares the script file with the last session on the CD-R disc and outputs the subcommand file. Outputs each subcommand in the following cases.

(1) Full-page append subcommand
  1. If the CD-R disc set in the CD-R drive is new.
  2. If you want to update the directory structure.
  3. When updating files that are interleaved.

(2) File addition subcommand
  1. When the script file contains a file that is not on the CD-R disc.

(3) File deletion subcommand
  1. If the file on the CD-R disc is not in the script file.

(4) File replacement subcommand
  1. Compares files in the way specified in the options and if the files have changed.

A.5 Error level

The following error levels are returned to DOS according to the execution results.

(1) Error level: 0
Successfully completed. A subcommand file will be output and you can run ADDCDW.

(2) Error level: 1
It is necessary to add the entire file, but no disk image file or TOC file has been created.
A subcommand file will be output, and you can run ADDCDW by executing VCDBUILD and VCDMKTOC.

(3) Error level: 2
Processing cannot continue. See error message for details.

A.6 Limitations

  1. The number of files that can be written in the script file must be less than or equal to the number displayed in "MAX FILE" at startup.


BackForward
PROGRAMMER'S GUIDEP.S. Write Once
Copyright SEGA ENTERPRISES, LTD. 1997