Japanese
★ PROGRAMMER'S GUIDE ★ XBLD User's Manual
▲ Back ｜ Forward ▼
XBLD User's Manual

6. subcommand

(1) How to express keywords and parameters
Keywords and parameters are written in the following fonts:

(2) List of subcommands

Table 6.1 List of subcommands
 function
 subcommand
 number
 Specifying the operating mode
 1.0
 CD creation
 unspecified
 1.1
 real-time emulation
 r
 1.2
 Direct DOS file access
 p
 1.3
 write on the fly
 otf
 1.4
 Operating environment settings
 2.0
 Maximum number of ISO files
 i
 2.1
 Maximum number of DOS files
 d
 2.2
 String area size
 c
 2.3
 Sector table area size
 s
 2.4
 Maximum number of channel interleave
 ci
 2.5
 Maximum number of file interleave
 fi
 2.6
 Submode control count
 sm
 2.7
 Subcommand file specification
 sub
 2.8
 VCDBUILD compatibility mode
 vcd
 2.9

6.1 Specifying the operating mode

 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 CD creation
 Keyword
 unspecified
 No
 1.1
Format:
unspecified
Parameters:
unspecified
function:
Generates the disc image file and TOC file necessary for creating a CD.
If no subcommand is specified, it operates in CD creation mode.
remarks:

(a) Output file in CD creation mode
We have summarized the output files for XBLD and VCDBUILD when CD Builder is started using the standard startup method.

Table 6.2 Output files in CD creation mode
 output file
 XBLD
 VCDBUILD
 DSK file
 Output
 Output
 RTI file
 Do not output *1
 Output
 TOC file
 Output
 Do not output *2
*1 : Output when r subcommand or p subcommand is specified.
*2 : Output using the TOC information generation program VCDMKTOC.

(b) XBLD outputs TOC files in any operating mode. There is no need to use VCDMKTOC to output a TOC file.

 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 real-time emulation
 Keyword
 r
 No
 1.2
Format:
r
Parameters:
none
function:
Specify this when performing real-time emulation with a VCD emulator.
remarks:
(a) Output file
example :
r
 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 Direct DOS file access
 Keyword
 p
 No
 1.3
Format:
p
Parameters:
none
function:
Specify this when performing direct DOS file access emulation with the VCD emulator.
remarks:
(a) Output file
example :
p
 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 write on the fly
 Keyword
 otf
 No
 1.4
Format:
otf
Parameters:
none
function:
Outputs a file for on-the-fly writing using ADDCDW.
remarks:

  1. When using a script file containing the following keywords, on-the-fly writing is not possible (an error will occur when parsing the script file).
    • SupplementaryVolume
    • SameName
    • Escape Sequences
    • BootIdentifier
    • BootRecord
    • Boot System Identifier
    • Trigger
    • Eors

  2. output file
    • PVD file
    • TOC file
    • SCT file
    • OTI file

example :
otf

6.2 Setting up the operating environment

 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 Maximum number of ISO files
 Keyword
 i
 No
 2.1
Format:
i=isonum
Parameters:
isonum : Maximum number of ISO files
function:
Sets the maximum number of ISO files (files to be placed on the CD you create).
remarks:

  1. The default value for the maximum number of ISO files is 10000.

  2. If you are building a disc with more than 10,000 ISO files, increase the maximum number of ISO files as necessary.

  3. If you are unable to start the program due to insufficient memory, reduce the maximum number of ISO files to reduce the memory used internally by the system.
example :
i=1024
 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 Maximum number of DOS files
 Keyword
 d
 No
 2.2
Format:
d=dosnum
Parameters:
dosnum : Maximum number of DOS files
function:
Set the maximum number of DOS files (source files from which the ISO file is based).
remarks:

  1. The default value for the maximum number of DOS files is 10000.

  2. If you are building a disk with more than 10,000 DOS files, increase the maximum number of DOS files as necessary.

  3. If you are unable to start a program due to insufficient memory, reduce the maximum number of DOS files to reduce the memory used internally by the system.

example :
d=2048
 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 String area size
 Keyword
 c
 No
 2.3
Format:
c=strsz
Parameters:
strsz: Size of string area
function:
Set the size of the string area that stores strings used in script files.
remarks:

  1. The default value of string area size is 400000 bytes.

  2. The string area stores ISO file names, directory names, DOS file names, macro definition contents, and other script command argument values.

  3. If the error message "Insufficient string area" is displayed, increase the string area size.

  4. If you are unable to start the program due to insufficient memory, set the string area size to a smaller value to reduce the memory used internally by the system.

example :
c=65536
 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 Sector table area size
 Keyword
 s
 No
 2.4
Format:
s=sctsz
Parameters:
sctsz: Size of sector table area
function:
Set the size of the sector table area (table that manages the disk sector structure).
remarks:

  1. The default value of sector table area size is 30000 pieces.

  2. The sector table area stores information related to the disk's sector structure, such as DOS files, gap sectors, and volume descriptors.

  3. Increase the sector table area size if the error message "Insufficient sector table area" is displayed.
    Set the sector table area size to a value that is sufficiently larger than the maximum number of DOS files.

  4. If you are unable to start a program due to insufficient memory, reduce the sector table area size to reduce the memory used internally by the system.

example :
s=32768
 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 Maximum number of channel interleave
 Keyword
 ci
 No
 2.5
Format:
ci=cinum
Parameters:
cinum: Maximum number of channel interleave
function:
Sets the maximum number of channel interleave.
This number includes the number of ISO11172 streams (MPEG multiplex files) in addition to the number of channel interleaved files.
remarks:

  1. The default value for the maximum number of channel interleave is 256.

  2. Increase the maximum number of channel interleave when there are many channel interleaved files or ISO11172 streams.

example :
ci=512
 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 Maximum number of file interleave
 Keyword
 fi
 No
 2.6
Format:
fi=finum
Parameters:
finum: maximum number of file interleave
function:
Sets the maximum number of file interleave.
remarks:

  1. The default value for the maximum number of file interleave is 256.

  2. Increases the maximum number of file interleavers when the number of file interleavers is large.

example :
fi=512
 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 Submode control count
 Keyword
 sm
 No
 2.7
Format:
sm=smnum
Parameters:
smnum: Maximum number of submode control
function:
Set the maximum number of times the Trigger command and Eors command can be used to control submodes.
remarks:

  1. The default value for the maximum number of submode control is 10000 times.

  2. If the number of uses exceeds 10,000, increase the maximum number of uses.

example :
sm=1024
 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 Subcommand file specification
 Keyword
 sub
 No
 2.8
Format:
sub=subfile
Parameters:
subfile: Path name of subcommand file
function:
Specify a subcommand file.
remarks:

  1. When entering commands from the DOS prompt, specify them using a subcommand file instead of the command line.

  2. Subcommand Interprets and executes subcommands line by line from the beginning of the file.

  3. Use ";" to write comments in the subcommand file.
    The string from ";" to the end of the line is ignored.

example :
C:> xbld -sub=sample.bld

sample.bld
; sample.bld
-r          ; realtime emulation
-i=1024     ; number of isofiles
-d=2048     ; number of dosfiles
sample      ; script file


 one
 View
 table
 Title
 Subcommand specifications
 Subcommand
 VCDBUILD compatibility mode
 Keyword
 vcd
 No
 2.9
Format:
vcd
Parameters:
none
function:
Specify this to perform the same operation as VCDBUILD.
XBLD supports failures of VCDBUILD, and may behave differently than VCDBUILD.
In such cases, use the vcd subcommand to operate in VCDBUILD compatibility mode.
remarks:

  1. Places that behave the same as VCDBUILD by using VCDBUILD compatibility mode

    1. Use files with subheaders in direct DOS file access mode.
      (An error will occur in XBLD mode, but it will work in compatibility mode.)

example :
vcd
▲ Back ｜ Forward ▼
★ PROGRAMMER'S GUIDE ★ XBLD User's Manual
Copyright SEGA ENTERPRISES, LTD. 1997