How To Automate CD / DVD Recording with GEAR Batch Files
Consumer Products
GEAR Video GEAR DVD GEAR CD-RW
Professional Products
GEAR PRO Mastering Edition GEAR PRO Professional Edition GEAR PRO UNIX GEAR PRO Linux
GEAR Powered Products
discWelder - Minnetonka Software
GEAR Partner Products
Image Broadway from Filestream Turbo Browser from Filestream
Get Support Now! Activate GEAR! Drivers Updates Supported Recorders User Forums User Manuals (PDF) Knowledgebase/Wiki Register Your Product
How To Guides
• Windows Products • GEAR PRO UNIX • GEAR PRO Linux
GEARWorks SDK • AudioWorks • DataWorks • VideoWorks • DuplicationWorks • MasterWorks Developer Support Login
Awards Press Customer Testimonials Contact Us

GEAR Linux Commands

Examples of batch files

API version 3.52.001.01

Syntax: command [optional] <required>

For a complete list of commands and reference, please see the manual.

General
BATCH GETAPIVERSION GETCDRDEFAULTS GETDISKDEFAULTS
GETDISKSPACE GETGENDEFAULTS GETTAPEDEFAULTS GETWORKINGDIR
HELP INITCDR INITGEN INITTAPE
LOG MP3TOWAVE PLAYMP3 PLAYWAVE
SCANCDR SCANDISK SCANJUKE SCANSCSI
SCANTAPE SETCDRDEFAULTS SETDISKDEFAULTS SETGENDEFAULTS
SETTAPEDEFAULTS SETWORKINGDIR VDIR VERIFYFILECRC
WAIT      
Generator
ADDCDTEXT ADDCHAPTER ADDDVDFILE ADDDVDSTILL
ADDVCDITEM CD CHGRP CHMOD
CHOWN CLOSEVIDEOSESSION CLOSEVIDEOTRACK CLOSEVOL
COPY COPYTREE CP CREATEBOOTIMAGE
CREATEVIDEOTRACK DELDIR DELETE DELTREE
DELTRK DELVOL DIR EXITGEN
FREE GETGENPARMS GETTRACKINFO GETTRACKPARMS
GETVOLINFO GETVOLPARMS IMPORTBOOTIMAGE IMPORTVIDEOTS
LN LS MKDIR MKNOD
MV NEWDIR NEWTRK NEWTRKEXT
NEWVOL OPENVOL PHYSTRK PHYSVOL
RENAME RM RMDIR SELTRK
SELVOL SETGENPARMS SETTRACKPARMS SETVCDITEMPROP
SETVOLPARMS STARTVCDCREATION STOPVCDCREATION TDIR
VERTRK VERVOL    
CD/DVD Recorder
CHECKDRIVE COPYCD DISCINFO EJECT
ERASECD ERASESESSION ERASETRACK EXITCDR
FIXATION FORMAT GETCDRPARMS READCD
READFILE READSECTOR READTRACK RECORDERINFO
RETRACT SESSION SETCDRPARMS WRITECD
Jukebox
JUKEINFO JUKEMEDIASCAN MOVEMEDIUM  
Tape
CDTODDPDIR CDTOTAPE ERASETAPE EXITTAPE
GETTAPEPARMS READTAPE SETTAPEPARMS TAPEUNITINFO
UNLOADTAPE VERIFYTP WRITEDDPDIR WRITETP


General Commands

BATCH BATCH [-a] <batch_file_name>
    Parameters:
  • <batch_file_name> The name of a batch file to run, a full path is allowed.
  • [-a] Execute the batch file in unattended mode.

Description: Starts executing a batch file (text file) with GEAR commands.

Back to Top
GETAPIVERSION GETAPIVERSION

Description: Used to return information about the version of the GEAR.wrks API.

Back to Top
GETCDRDEFAULTS GETCDRDEFAULTS

Description: Retrieves the default parameters of the GEAR CD/DVD Recorder module, which will be used for initializing a CD/DVD device with the next INITCDR command.

Back to Top
GETDISKDEFAULTS GETDISKDEFAULTS

Description: Retrieves the default parameters for opening a driver interface for raw hard disk devices.

Back to Top
GETDISKSPACE GETDISKSPACE [<dir_spec>]
    Parameters:
  • <dir_spec> Optional name of an existing directory in which the available hard disk space is determined(default is the current working directory).

Description: Returns the free disk space in KBytes.

Back to Top
GETGENDEFAULTS GETGENDEFAULTS

Description: Retrieves the default parameters of the GEAR generator/formatting module, which will be used for initializing the generator module, with the next INITGEN command.

Back to Top
GETTAPEDEFAULTS GETTAPEDEFAULTS

Description: Retrieves the default parameters of the GEAR tape module, which will be used for initializing the GEAR tape module with the next INITTAPE command.

Back to Top
GETWORKINGDIR GETWORKINGDIR

Description: Returns with the current working directory.

Back to Top
HELP HELP [<command>]
    Parameters:
  • <command> Name of the command you are seeking help for.

Description: Displays short help information on a GEAR command.

Back to Top
INITCDR INITCDR [-b <bus_id>] [-t <target_id>]
    Parameters:
  • <bus_id> Bus ID of of the CD/DVD (recorder) device to initialize.
  • <target_id> Target ID of of the CD/DVD (recorder) device to initialize.

Description: Initializes the GEAR CD/DVD Recorder module and the selected SCSI driver interface, scans for CD/DVD recorders on all SCSI/IDE busses driven by the SCSI driver, and initializes a CD/DVD recorder for usage (if any is found).

Back to Top
INITGEN INITGEN

Description: Initializes the generator (formatting) engine and adds all generator commands as available Toolkit commands.

Back to Top
INITTAPE INITTAPE

Description: Initializes the tape module and the selected SCSI driver interface, scans for tape drives on all SCSI busses driven by the SCSI driver, and initializes a tape drive for usage (if any is found).

Back to Top
LOG LOG [-o] [<file_name>]
    Parameters:
  • <file_name> The name of the log file.
  • [-o] If this option is used, an existing log file will be overwritten without prompt.

Description: In combination with a filename this command starts the logging of information into a log file.

Back to Top
MP3TOWAVE MP3TOWAVE <mp3_file> <wave_file>
    Parameters:
  • <mp3_file> Source MP3 audio file to convert.
  • <wave_file> Output Wave audio file to create.

Description: Converts a MP3 audio file to a wave audio file.

Back to Top
PLAYMP3 PLAYMP3 <mp3_file>
    Parameters:
  • <mp3_file> Source MP3 audio file to play.

Description: Plays a MP3 audio file.

Back to Top
PLAYWAVE PLAYWAVE <wave_file>
    Parameters:
  • <wave_file> Wave audio file to play.

Description: Plays a wave audio file.

Back to Top
SCANCDR SCANCDR

Description: Scans for CD/DVD devices on all target/SCSI ID's on all SCSI and/or IDE busses/adapters, using the currently selected driver interface.

Back to Top
SCANDISK SCANDISK

Description: Scans for hard drives on all target/SCSI ID's on all SCSI and/or IDE busses/adapters, using the currently selected SCSI driver interface.

Back to Top
SCANJUKE SCANJUKE

Description: Scans for medium changer (Jukebox) devices on all target/SCSI ID's on all SCSI and/or IDE busses/adapters, using the currently selected driver interface.

Back to Top
SCANSCSI SCANSCSI

Description: Scans the SCSI bus(ses) in the system for SCSI devices and reports by BusID, TargetID and LUN of a device and displays their vendor and product information.

Back to Top
SCANTAPE SCANTAPE

Description: Scans for (premaster) tape units on all target/SCSI ID's on all SCSI and/or IDE busses/adapters, using the currently selected driver interface.

Back to Top
SETCDRDEFAULTS SETCDRDEFAULTS [<parameter>] [<value>]
    Parameters:
  • <parameter> Name of the parameter to set.
  • <value> New value to assign to the parameter.

Description: Sets the default parameters of the GEAR Recorder module, which will be used for initializing the GEAR CD/DVD Recorder module with the next INITCDR.

Back to Top
SETDISKDEFAULTS SETDISKDEFAULTS [<parameter>] [<value>]
    Parameters:
  • <parameter> Name of the parameter to set.
  • <value> New value to assign to the parameter.

Description: Sets the default parameters of the GEAR Hard Disk module.

Back to Top
SETGENDEFAULTS SETGENDEFAULTS [<parameter>] [<value>]
    Parameters:
  • <parameter> Name of the parameter to set.
  • <value> New value to assign to the parameter.

Description: Sets the default parameters of the generator engine, which will be used for initializing the generator engine of the Toolkit with the next INITGEN.

Back to Top
SETTAPEDEFAULTS SETTAPEDEFAULTS [<parameter>] [<value>]
    Parameters:
  • <parameter> Name of the parameter to set.
  • <value> New value to assign to the parameter.

Description: Sets the default parameters of the GEAR Tape engine, which will be used for initializing the GEAR Tape engine of the Toolkit with the next INITTAPE.

Back to Top
SETWORKINGDIR SETWORKINGDIR <work_dir>
    Parameters:
  • <work_dir> New name of the working directory.

Description: Changes the current working directory of the GEAR.

Back to Top
VDIR VDIR

Description: Produces a list of the GEAR volumes present in the current working directory, containing the following information: Volume name and size, Session number, Number of tracks in the volume, Type of volume, Status of volume, Date and time stamp for the volume.

Back to Top
VERIFYFILECRC VERIFYFILECRC [-d] <name> [<crc_value>]
    Parameters:
  • [-d] If specified, the name is interpreted as a directory containing a DDP image including aCHECKSUM.TXT file.
  • <name> Path of the DDP image directory, or name (path) of the single file to verify the CRC on.
  • <crc_value> Original CRC value (string containing hex value) to compare with.

Description: Returns the free disk space in KBytes.

Back to Top
WAIT WAIT [<nr_of_seconds>]
    Parameters:
  • <nr_of_seconds> Number of seconds to wait.

Description: Wait for a number of seconds or display a prompt and wait for a user interaction to continue.

Back to Top

Generator Commands

ADDCDTEXT ADDCDTEXT [-TRK <trknr>] [- t <title>] [-p <performer>] [-s <songwriter>] [-c <composer>] [-a <arranger>]
[-m <message>] [-i <IDCode>] [-g <genre>] [-pr <providerinfo>] [-gc<genrecode>] [-lc <languagecode>]
[-cc <charactercode>] [-cf]
    Parameters:
  • -TRK <trknr> If not specified, the passed arguments are taken to be the CD information.
  • -t,p,s,c,a,m,pr,g <string> String with maximally 160 bytes.
  • -gc <genrecode> Genre code.
  • -i <IDCode> User own identification code.
  • -lc <languagecode> Code for the language the text is in.
  • -cc <charactercode> Code for the charset being used for the text.
  • -cf <charactercode> If specified, the CD Text information is fully copyright protected.

Description: CD Text is additional information written in the subcode band of the LEAD IN.

Back to Top
ADDCHAPTER ADDCHAPTER -V <video_file> -A <audio_file> -P <private_file> -T <thumbnail_file> -D <description>
    Parameters:
  • <video_file> Name of file to use as video source.
  • <audio_file> Name of file to use as audio source.
  • <private_file> Name of file to use as a private MPEG video source.
  • <thumbnail_file> Name of file to use as thumbnail image for graphical menus.
  • <description> The menu description to be used if text menus and chapter menus are defined.

Description: Add a video chapter to the current open track.

Back to Top
ADDDVDFILE ADDDVDFILE <file_name>
    Parameters:
  • <file_name> The filename of the file to copy to the media.

Description: Appends data files to the streaming media -- please note that if the output is to hard disk then the copyfile command should be used.

Back to Top
ADDDVDSTILL ADDDVDSTILL -s <file_name> -du <duration> [ -d <description_text>][-t <thumbnail_file>]
    Parameters:
  • <file_name> Name of file to add as still (jpeg/jpg/bmp/mpg)
  • <duration> Duration is seconds to display the still 1-254 (255=indefinate)
  • <description_text> Description to be used as menu item if text menus and chapter menus are defined.
  • <thumbnail_file> Name of file to use as thumbnail image for graphical menus.

Description: Add a still image as a chapter to the current open track.

Back to Top
ADDVCDITEM ADDVCDITEM -ID <ItemID> -FN <filepath> -MSI
    Parameters:
  • -ID <ItemID> Required.
  • -FN <filepath> Required. The still, sound or stream item to be loaded.
  • [-MSI] <wave_file> If this flag is used, the item will be loaded in the segment item area in the first XA track,regardless of the size in number of sectors.

Description: It adds an item to a dynamic VideoCD volume.

Back to Top
CD CD <dir_name>
    Parameters:
  • <dir_name> Directory name in the virtual image.

Description: Changes to the specified directory in the virtual image.

Back to Top
CHGRP CHGRP [-r] <GID> <file_dir_spec>
    Parameters:
  • <file_dir_spec> Refers to directories or files in the current directory of the image.
  • <GID> Is a numerical value between 0 and some system specific limit (see man limits) indicating thenew group id.
  • [-r] If this option is specified, sub directories are traversed as well.

Description: Changes the group id for all files in the current directory that match file_dir_spec.

Back to Top
CHMOD CHMOD [-r] -m <mode> <file_dir_spec>
    Parameters:
  • <file_dir_spec> Refers to files/directories in the current directory of the image.
  • -m <mode> New mode for the entry.
  • [-r] If the -r option is specified sub directories are traversed as well.

Description: Changes the Unix (Rock Ridge) permissions on a file or directory.

Back to Top
CHOWN CHOWN [-r] <UID> <file_dir_spec>
    Parameters:
  • <file_dir_spec> Refers to directories or files in the current directory of the image.
  • <UID> Is a numerical value between 0 and some system specific limit (see man limits) indicating thenew group id.
  • [-r] If the -r option is specified sub directories are traversed as well.

Description: Changes the user id for all files in the current directory that match fil_dir_spec.

Back to Top
CLOSEVIDEOSESSION CLOSEVIDEOSESSION

Description: Finalizes the DVD structures, writing out the video_ts.ifo/vob/bup files, and closing out the session.

Back to Top
CLOSEVIDEOTRACK CLOSEVIDEOTRACK

Description: Closes the video track/title and writes out the appropriate ifo/bup for that title.

Back to Top
CLOSEVOL CLOSEVOL

Description: Closes the current open volume.

Back to Top
COPY COPY <file_name>
    Parameters:
  • <file_name> Name (spec) of the file(s) to copy.

Description: Copies the specified data file(s) into the current directory of the selected track in the virtual image.

Back to Top
COPYTREE COPYTREE <source_dir> [<target_dir>]
    Parameters:
  • <source_dir> The source directory tree to be copied.
  • <target_dir> The target directory specifies where the directory will be loaded in the virtual image, it cannotcontain a path.

Description: Copies a complete directory tree into the specified directory of a selected track in the virtual image or into the current directory when the target directory is not supplied.

Back to Top
CP CP [-r] <source_spec> <dest_spec>
    Parameters:
  • <source_spec> Files(s) which match the specified source_spec.
  • <dest_spec> If a directory exists in the image, files are placed in it otherwise the files are copied into theimage under the named dest spec.
  • [-r] Indicates that all sub directories must be copied as well (equivelent to copytree).

Description: Copies the files which match the specified <source_spec> in the image.

Back to Top
CREATEBOOTIMAGE CREATEBOOTIMAGE <drive_letter> <image_file>
    Parameters:
  • <drive_letter> Source drive that image must be created from i.e. a: c:
  • <image_file> File name for image.

Description: Creates a boot image file from a drive, that can be used with IMPORTBOOTIMAGE.

Back to Top
CREATEVIDEOTRACK CREATEVIDEOTRACK [-d [<target_dir>] [-m [<title_text>] [-f <title_base>] [-t] [-g] [-c]] [-pal]
    Parameters:
  • [-d] If TRUE, output should be saved on local hard disk and not streamed to DVD.
  • <target_dir> This specifies the directory where the VIDEO_TS files will be written, this is only used inconjunction with the -d option.
  • [-m] This option specifies the type of menu that must be created.
  • <title_text> This text, if defined, is used to create the title name that is used on the menu.
  • <title_base> If user defined menus are being used this specifies the name of the base file to build all bmpand control file names from.
  • [-pal] The PAL video format will be used, all subsequent tracks and mpeg images must match theformat or the AddChapter command will fail.

Description: Prepares the current track for DVD Video authoring/menuing.

Back to Top
DELDIR DELDIR <dir_name>
    Parameters:
  • <dir_name> Existing directory name in a virtual image, wildcards are not allowed.

Description: Deletes the specified directory from the selected track in the current volume.

Back to Top
DELETE DELETE <file_name>
    Parameters:
  • <file_name> Name of the file to delete in the currently selected volume and track.

Description: Deletes the specified file(s) from the virtual track image.

Back to Top
DELTREE DELTREE <dir_name>
    Parameters:
  • <dir_name> Directory tree to delete, wildcards are not allowed.

Description: Deletes the specified directory tree from the virtual image.

Back to Top
DELTRK DELTRK <track_nr>
    Parameters:
  • <track_nr> Track number to delete.

Description: Deletes the specified track in the selected GEAR volume.

Back to Top
DELVOL DELVOL <vol_name> [-nodelphys]
    Parameters:
  • <vol_name> The name of the volume that will be deleted.
  • [-nodelphys] If this option is specified, the physical image(s) created for the volume will not be deleted.

Description: Deletes the specified volume.

Back to Top
DIR DIR [-s] [-p]
    Parameters:
  • [-s] If this option is used all sub directories will be listed as well.
  • [-p] If this option is used, listing is done a page at a time.

Description: Shows all the files and directories present in the selected directory of the selected track.

Back to Top
EXITGEN EXITGEN

Description: Closes the GEAR generator module.

Back to Top
FREE FREE

Description: Shows the free space in a volume.

Back to Top
GETGENPARMS GETGENPARMS

Description: Retrieves the current values of the generator parameters.

Back to Top
GETTRACKINFO GETTRACKINFO

Description: Retrieves information about the currently selected track in a GEAR volume.

Back to Top
GETTRACKPARMS GETTRACKPARMS

Description: Retrieves the editable parameters of the currently selected track in the currently selected GEAR volume.

Back to Top
GETVOLINFO GETVOLINFO

Description: Retrieves global information about the currently selected GEAR volume.

Back to Top
GETVOLPARMS GETVOLPARMS

Description: Retrieves the editable parameters of the currently selected volume.

Back to Top
IMPORTBOOTIMAGE IMPORTBOOTIMAGE <image_file> <media_type>
    Parameters:
  • <image_file> Name of image file to use as boot image
  • <media_type> Boot media type emulation.

Description: Imports an existing boot image into the volume/track, to create a bootable disc aacording to the El Torito Specification.

Back to Top
IMPORTVIDEOTS IMPORTVIDEOTS <path_name>
    Parameters:
  • <path_name> The name of the directory on the hard drive containing the VIDEO_TS contents (files) toimport.

Description: Imports the contents of a VIDEO_TS directory, present on the hard drive, into the VIDEO_TS directory of a DVD Video track.

Back to Top
LN LN [-u <uid>] [-g <gid>] <target> <file_name>
    Parameters:
  • [-u <uid>] The user id.
  • [-g <gid>] The group id.
  • <target> Target for the link.
  • <file_name> Name of the link to create.

Description: Creates a new symbolic link referring from <file_name> to <target>.

Back to Top
LS LS [-r] [-org] [-pg] [<file_spec>]
    Parameters:
  • <file_spec> Is the name of the file or directory to be listed.
  • [-r] If the -r options is present sub directories are listed as well.
  • [-org] Also list the original file name of the file loaded in the track.
  • [-pg] If the -pg options is used listing is done a page at a time.

Description: Produces a list of the file/directory entries present in the current directory of the current GEAR track image.

Back to Top
MKDIR MKDIR [-m <mode>] [-u <uid>] [-g <gid>] <dir_name>
    Parameters:
  • <dir_name> Name of a new directory to create.
  • [-m <mode>] The access mode.
  • [-u <uid>] The user id.
  • [-g <gid>] The group id.

Description: Creates a new directory in the selected track of the current GEAR volume.

Back to Top
MKNOD MKNOD [-m <mode>] [-u <uid>] [-g <gid>] <file_name> p
MKNOD [-m <mode>] [-u <uid>] [-g <gid>] <file_name> (b / c) <major> <minor>
    Parameters:
  • <file_name> The file to which a pipe is attached or the special block
  • [-m <mode>] The access mode.
  • [-u <uid>] The user id.
  • [-g <gid>] The group id.
  • [p / b / c] Creates a named pipe (p), character (c) or block (b) special file.
  • <major> Creates a character (c) or block (b) special file with major number set to <major>
  • <minor> Creates a character (c) or block (b) special file with minor number set to <minor>

Description: Creates a new named pipe, or a character(c) or block(b) device special file in the currently selected GEAR track image.

Back to Top
MV MV <old_name> <new_name>
    Parameters:
  • <old_name> File or directory name in the virtual volume.
  • <new_name> New file or directory name.

Description: Moves (renames) a directory or file in the virtual image to the desired name, relative to the current directory.

Back to Top
NEWDIR NEWDIR <dir_name>
    Parameters:
  • <dir_name> Name of a new directory to create.

Description: Creates a new directory in the selected track of the current volume.

Back to Top
NEWTRK NEWTRK [-f / -v] [-o] [-macro] [-offline] <track_type> [<track_nr>]
    Parameters:
  • [-f] The -f option forces the track to be used for incremental writing with fixed packets.
  • [-v] The -v option forces the track to be used for incremental writing with variable packets.
  • [-o] Can be used in combination with fixed packet writing to force new creation (overwrite) of theexisting FPW structure (UDF directory structure) on the disc.
  • [-macro] Enable Macrovision protection on DVD Video disks.
  • [-css] Enable CSS protection on DVD Video disks.
  • [-offline] Use offline formatting - this will arrange the layout of the media to have the directory structuresfirst followed bye the files.
  • <track_type> Type of the virtual track to create.
  • <track_nr> Track number for the new track to create in the volume.

Description: Creates a new empty virtual track of the specified type in the selected GEAR volume.

Back to Top
NEWTRKEXT NEWTRKEXT <track_image_file_name> <track_type> [SES:<session_nr>] [N:<track_nr>] [S:<sector_size>]
[+P/-P:<pause>] [IDX:<index>:<size>] [+POST/-POST:<postgap_size>] [DVD:OTP:<layer_break> or DVD:PTP:<layer_break>] [O:<offset>] [L:<length>] [ISRC:<isrc_code>]
    Parameters:
  • <track_image_file_name> A full path specification of an existing physical track image file on your computer.
  • <track_type> The type of track to create.
  • <session_nr> Session number to which the new track belongs.
  • <track_nr> Track number for the new track to create in the volume.
  • <sector size>> The sector size (bytes per CD sector) of the track image file.
  • DVD:OTP:<layer_break> or DVD:PTP:<layer_break>The layer break for a DVD-9 image.
  • +P/-P:<pause>, IDX:<index>:<size> The size of the pause/pregap (index 0) and of other indexes within the track in sectors/frames.
  • +POST/-POST:<postgap_size> Indicates whether a postgap is included in the image.
  • L:<length> The length in frames of the track (within an image file). The default value is the complete filelength.
  • O:<offset> The offset in frames where the track should start within an image file.
  • ISRC:<isrc_code> The ISRC code of the track.

Description: Creates a new track with the given external track image file as 'physical track image' in the selected volume.

Back to Top
NEWVOL NEWVOL <volume_name> <capacity>
    Parameters:
  • <volume_name> The name of the volume to be created.
  • <capacity> TIndicates the length in minutes of the CD/DVD image.

Description: Creates a new empty virtual GEAR volume with the name and capacity in minutes or sectors you specify.

Back to Top
OPENVOL OPENVOL <volume_name>
    Parameters:
  • <volume_name> The name of an existing GEAR volume to be opened (selected).

Description: Opens (selects) an existing GEAR volume.

Back to Top
PHYSTRK PHYSTRK [<file_name>] [-s <sector_size>] [-eccedc] [-scramble]
PHYSTRK -d <target_id> -b <bus_id>
    Parameters:
  • <file_name> Name of the physical image file to create.
  • [-d] Create the physical image on a raw (SCSI) hard disk instead of a file.
  • <bus_id> Bus ID of of a raw (SCSI) hard disk, on which to create the physical image.
  • <target_id> Target ID of of a raw (SCSI) hard disk, on which to create the physical image.
  • <sector_size> Number of bytes per sector to write: 2048, 2336, 2340 or 2352. For audio only 2352 is valid.
  • [-eccedc] Forces calculation of ECC/EDC information, if the sector size is 2336, 2340 or 2352. This onlyapplies to data tracks.
  • [-scramble] Forces scrambling of data sectors, only if sector size 2352 is specified.

Description: Assuming you have selected a volume and a track, PHYSTRK creates a physical image file of this track.

Back to Top
PHYSVOL PHYSVOL [<file_name>]
    Parameters:
  • <file_name> Optional physical file name that may include a full path.

Description: Creates the physical image files of the selected volume.

Back to Top
RENAME RENAME <old_name> <new_name>
    Parameters:
  • <old_name> File or directory name in the virtual volume.
  • <new_name> New file or directory name.

Description: Renames or moves a directory or file in the virtual image.

Back to Top
RM RM [-r] <file_spec>
    Parameters:
  • <file_spec> Name of the file to delete in the currently selected volume and track.
  • [-r] Recursively delete.

Description: Deletes the specified file(s) from the virtual track image.

Back to Top
RMDIR RMDIR <dir_name>
    Parameters:
  • <dir_name> Existing directory name in a virtual image, wildcards are not allowed.

Description: Deletes the specified directory from the selected (data) track in the current volume.

Back to Top
SELTRK SELTRK <track_nr>
    Parameters:
  • <track_nr> Track number between 1 and the number of tracks in the volume.

Description: Selects an existing track in a selected GEAR volume.

Back to Top
SELVOL SELVOL <vol_name>
    Parameters:
  • <vol_name> Volume to select.

Description: Selects an existing volume.

Back to Top
SETGENPARMS SETGENPARMS <parameter> <value>
    Parameters:
  • <parameter> Name of the parameter to set.
  • <value> New value to assign to the parameter.

Description: Changes one of the current parameters of the generator module.

Back to Top
SETTRACKPARMS SETTRACKPARMS [<parameter>] [<value>]
    Parameters:
  • <parameter> Name of the parameter to set.
  • <value> New value to assign to the parameter.

Description: Sets the parameters for the currently selected track, that has already been created with NEWTRK command.

Back to Top
SETVCDITEMPROP SETVCDITEMPROP -ID <ItemID> [-PAR <ParentItemID>] [-PREVL <PrevItemID>] [-NEXTL <NextItemID>]
[-DEFTL <DefItemID>] [-RETNL <ReturnListID>] [-TIMOL<TimeOutItemID>] [-WTTO <TimeVal>]
[-LCJT <LCJTVal>]
    Parameters:
  • -ID <ItemID> Required.
  • [-PAR <ParentItemID>] THook the child-item (ItemID) into the parent item (ParentItemID).
  • [-PREVL <PrevItemID>] Playing the item (ItemID) and pressing 'previous', then the selection list associated with<PrevItemID> is played (this can be one item or a menu).
  • [-NEXTL <NextItemID>] Playing the item (ItemID) and pressing 'next', then the selection list associated with<NextItemID> is played (this can be one item or a menu).
  • [-DEFTL <DefItemID>] When waiting for interaction (user input) during item (ItemID) and pressing play, then theselection list associated with <DefItemID> is played (this can be one item or a menu).
  • [-RETNL <ReturnListID>] The ID of the item being jumped to when 'return' is being selected.
  • [-TIMOL <TimeOutItemID>] When the play item wait time (WTTO) has been specified, the player accepts user input.
  • [-WTTO <TimeVal>] If the wait time for time-out is set to TimeVal then the player - after playing the item - thefollowing nr of seconds:
    TimeVal == 0xff then wait for interaction.
    TimeVal > 60 and $ff then wait (TimeVal-60)*10+60 seconds.
    TimeVal > 0 and TimeVal == 0 then do not wait.
  • [-LCJT <LCJTVal>] The Loop-Count and Jump-Timing value specifies nr of times the item will be displayed and the behavior when the user interacts:bit 0..6 = Loop Count:
    0 Infinite
    1-127 Loop Count
    bit 7 = Jump Timing:
    0 Stop playing the item and jump to the selected item
    1 Wait until completion of playing the item and jump to the selected item. Loop count is ignored.

Description: This command is to be called after STARTVCDCREATION and before STOPVCDCREATION.

Back to Top
SETVOLPARMS SETVOLPARMS [<parameter>] [<value>]
    Parameters:
  • <parameter> Name of the parameter to set.
  • <value> New value to assign to the parameter.

Description: Changes the current volume settings used by the generator engine, valid for the currently selected GEAR volume.

Back to Top
STARTVCDCREATION STARTVCDCREATION -NPF <filepath> [-ID <CDid>] [-PAL] [-SVCD] [-PR] [-IR] [-A <nr>] [-N <nr>]
[-CDI <dirpath>]
    Parameters:
  • -NPF <filepath> Required.
  • -ID <CDid> Disc ID that is set in the INFO control file.
  • [-A <nr>] Set the album set sequence number.
  • [-N <nr>] Set the number of volumes in the album set.
  • [-PAL] If specified, PAL video format is used.
  • [-SVCD] If specified, Super Video CD format (SVCD) will be created.
  • [-PR] If specified, prompting (on inclusion of an incompliant item) is turned off.
  • [-IR] If specified, inclusion reply is TRUE (ignored when user is prompted).
  • [-CDI <dirpath>] If specified, the CDI simulation application file(s) will be copied from dirpath into the volume'sCDI dir (ignored for SVCD).

Description: This command is to be called when the volume is empty to dedicate the volume to dynamic creation of Video CD.

Back to Top
STOPVCDCREATION STOPVCDCREATION

Description: This command is to be called after STARTVCDCREATION to end further VideoCD volume related operations.

Back to Top
TDIR TDIR

Description: Returns or displays a list of all tracks in the currently selected volume, which contains the following information for each track: Track number, Track size, Type of track, Required writing mode for track, Status of track, Date and time stamp.

Back to Top
VERTRK VERTRK

Description: Verifies the contents of the virtual image of the currently selected track and checks if a physical track image can be created.

Back to Top
VERVOL VERVOL

Description: Verifies the contents of all virtual tracks in the selected volume and checks if physical (track or volume) images can be created.

Back to Top

CD/DVD Recorder Commands

CHECKDRIVE CHECKDRIVE

Description: Checks (returns) the status of the CD/DVD drive (tray and disc status), without performing any eject or retract operations.

Back to Top
COPYCD COPYCD [-t] [<output_dir_spec>]
COPYCD [-t] -d [-b <source_bus_id>] [-i <source_target_id>]
    Parameters:
  • [-t] If this option is specified, a test run will be performed before a real write, if writing wasenabled initially.
  • <output_dir_spec> Optional name of an existing output directory where the track images will be stored.
  • [-b <source_bus_id>] [-i <source_target_id>] <source_bus_id> is the bus id of the source drive to use, and <source_target_id> is it's target id.

Description: The COPYCD command performs direct (on the fly) and indirect copying of CD/DVD media.

Back to Top
DISCINFO DISCINFO [-upcean] [-isrc] [-cdtext]
    Parameters:
  • [-upcean] If this option is specified, the Toolkit will also try to read the UPCEAN code of the disc.
  • [-isrc] If this option is specified, the Toolkit will also try to read the ISRC codes of audio tracks.
  • [-cdtext] If this option is specified, the Toolkit will also try to read the CD-TEXT information from thedisc.

Description: Obtains information on the disc currently loaded in the CD/DVD drive initialized.

Back to Top
EJECT EJECT

Description: Ejects the caddy/tray from the currently selected recorder.

Back to Top
ERASECD ERASECD [-quick] [-force] [-noblock]
    Parameters:
  • [-quick] Quick (minimal) erase.
  • [-force] Forces to erase a disc that is already blank.
  • [-noblock] Do not wait for the completion of the erase (immediate return).

Description: Erases a CD-RW (or DVD-RW) disc, resulting in a blank disc.

Back to Top
ERASESESSION ERASESESSION [-uncloseonly]
    Parameters:
  • [-uncloseonly] If this option is specified the last session is unclosed only.

Description: This command erases an entire session or uncloses a session, i.e., erases LEAD IN and LEAD OUT only.

Back to Top
ERASETRACK ERASETRACK

Description: This command erases a single track.

Back to Top
EXITCDR EXITCDR

Description: Closes the CD/DVD Recorder module and the recorder initialized.

Back to Top
FIXATION FIXATION

Description: Writes the lead-in and lead-out to a CD-R disc that is not yet fixated (last session was not yet closed).

Back to Top
FORMAT FORMAT <format_type>
    Parameters:
  • <format_type> Type of format to perform.

Description: Formats a blank CD-RW, DVD-RW or DVD+RW for fixed packet writing.

Back to Top
GETCDRPARMS GETCDRPARMS

Description: Retrieves the current settings for the CD/DVD device and the GEAR CD/DVD Recorder module.

Back to Top
READCD READCD <track_list_file> [<output_dir_spec>] [-tao / -dao / -rawdao] [-logsub]
    Parameters:
  • <track_list_file> Track list (text) file that will be created containing all the entries for the track image files.
  • <output_dir_spec> Name of an existing output directory where the track images will be stored (default is theGEAR Toolkit's working directory).
  • [-tao / -dao / -rawdao] Track-at-once (TAO), disc-at-once (DAO) or raw disc-at-once write method.
  • [-logsub] During reading, the contents of the PQ subcode data will be logged for each sector (for CDaudio tracks only).

Description: Reads all tracks of a CD/DVD disc onto the hard drive and creates a track list.

Back to Top
READFILE READFILE <source_file_name> <destination_path>
    Parameters:
  • <source_file_name> The filename (without path) in the current directory of the volume created with SESSION orMOUNT.
  • <destination_path> The destination file (including path name) on the hard disk.

Description: Copies the specified source file, present in the virtual track image, from it's original location to the destination path (on the hard disk).

Back to Top
READSECTOR READSECTOR

Description: Retrieves CD sector data from any type of disc loaded in selected recorder device.

Back to Top
READTRACK READTRACK <track_nr>gt> <file_name> [-s <sector_size>] [-msb / -lsb / -wave]
    Parameters:
  • <file_name> The name of the physical track image file that will be created on the hard drive.
  • <track_nr> Specifies the track number on the CD to read.
  • <sector_size> Number of bytes per sector to read: 2048, 2336, 2340, 2352 or 2368. For audio only 2352 and2368 are valid.
  • [-msb / -lsb / -wave] This is only applicable when reading audio tracks.

Description: Read all sectors of specified track from the CD/DVD disc and store them in the specified file on the hard drive.

Back to Top
RECORDERINFO RECORDERINFO [-nocheck]
    Parameters:
  • [-nocheck] Do not check the drive and media again.

Description: Retrieves information about the name and capabilities of the currently selected CD/DVD drive, like the Vendor ID, Product ID, Firmware revision information, and its supported features.

Back to Top
RETRACT RETRACT

Description: Closes the tray of the CD/DVD drive.

Back to Top
SESSION SESSION [-d] [-notrk] [<session_nr>] [<track_nr>] [<ISO / XA / DA>] [<new_volume_name>]
    Parameters:
  • [-d] Forces automatic deletion of a GEAR volume with the same name as the new session to create.
  • [-notrk] Avoids the creation of a new track in the volume created by SESSION.
  • <session_nr> Specifies the session number on the multi session disc to append to.
  • <track_nr> Specifies the track number on the multi session disc to append to.
  • <new_volume_name> Volume name of the new GEAR volume to create for the new session.

Description: Reads the specified session/track from the disc and creates a GEAR volume that can be appended to the disc.

Back to Top
SETCDRPARMS SETCDRPARMS [<parameter>] [<value>]
    Parameters:
  • <parameter> Name of the parameter to set.
  • <value> New value to assign to the parameter.

Description: Sets the current parameters for the CD/DVD recorder.

Back to Top
WRITECD WRITECD [-t] [<volume_name>]
WRITECD [-t] -ext <type> <file_name>
WRITECD [-t] -ddp <ddp_dir>
    Parameters:
  • [-t] If specified, only a test write to the recorder is performed (no real recording).
  • <volume_name> Name of the GEAR volume to write.
  • <file_name> Name of an external physical track image file ('type' = 1-11), or a track list file ('type' = 12).
  • <type> Type number indicating the type of the external image file.
  • <ddp_dir> Directory containing the files of the DDP image (DDPID, DDPMS, IMAGE.DAT, etc).

Description: This command can be used for writing a CD/DVD disc from several possible sources: 1) A GEAR volume specified by <volume_name> 2) An external physical image file or track list file specified by <file_name> 3) An existing DDP image folder (DDP files in a source dir).

Back to Top

Jukebox Commands

JUKEINFO JUKEINFO

Description: Retrieves information about the connected CD/DVD jukebox device: - The SCSI Vendor and Product ID of the jukebox device. - The adresses and number of elements in the jukebox (slots, drives, mailbox and grippers). - An indication in which elements a medium (disc) is present.

Back to Top
JUKEMEDIASCAN JUKEMEDIASCAN

Description: Forces the jukebox device to perform an internal media scan (media initialization), to update its internal status on the loaded media inside the slots.

Back to Top
MOVEMEDIUM MOVEMEDIUM <src_address> <dest_address>
    Parameters:
  • <src_address> Original location of caddy/disc.
  • <dest_address> New location of caddy/disc.

Description: Moves a caddy/disc from one element (address) to another in the jukebox.

Back to Top

Tape Commands

CDTODDPDIR CDTODDPDIR -d <output_dir> [-s <sub_dir>] [-o] [-e]
    Parameters:
  • <output_dir> Existing directory where to create a folder with the DDP files and image files.
  • <sub_dir> Optional name (without path) of the DDP folder to create in the output dir.
  • [-o] Force overwriting of the DDP and image files if they already exist.
  • [-e] Do not create default sub folder if f_pszSubDir ( ) is empty.
  • [-subc] Also copy the RW subcode from the source disc.

Description: This operation performs a conversion from a CD/DVD disc to a DDP image directory in the hard disk for mastering purposes.

Back to Top
CDTOTAPE CDTOTAPE [-d] [<output_dir_spec>]
    Parameters:
  • [-d] Use a direct 'on the fly' copy method copy operation
  • <output_dir_spec> Optional name of an existing output directory where the temporary track images will be stored,incase the direct method (-d) is not used.
  • [-subc] Also copy the RW subcode from the source disc.

Description: This command performs a conversion from a CD/DVD disc to a premaster tape.

Back to Top
ERASETAPE ERASETAPE

Description: Erases a tape completely.

Back to Top
EXITTAPE EXITTAPE

Description: Closes the tape module.

Back to Top
GETTAPEPARMS GETTAPEPARMS

Description: Retrieves the current parameters of the Tape engine.

Back to Top
READTAPE READTAPE [<output_dir_spec>]
    Parameters:
  • <output_dir_spec> Name of an existing output directory where the files will be stored that will be read back fromthe tape (default is the Toolkit's working directory).

Description: Reads a premaster tape and restores all the files to the hard disk.

Back to Top
SETTAPEPARMS SETTAPEPARMS [<parameter>] [<value>]
    Parameters:
  • <parameter> Name of the parameter to set.
  • <value> New value to assign to the parameter.

Description: Sets the current parameters of the GEAR Tape/Mastering module.

Back to Top
TAPEUNITINFO TAPEUNITINFO

Description: Retrieves the vendor, product and firmware revision information and information about the capabilities of the currently selected tape unit.

Back to Top
UNLOADTAPE UNLOADTAPE

Description: Unload (ejects) the tape.

Back to Top
VERIFYTP VERIFYTP [<volume_name>]
VERIFYTP -ext <type> <file_name>
    Parameters:
  • <volume_name> Name of the GEAR volume to verify.
  • <file_name> Name of an external physical track image file ('type' = 1-11), or a track list file ('type' = 12).
  • <type> Type number indicating the type of the external image file.

Description: Verifies the specified source with a written premaster tape.

Back to Top
WRITEDDPDIR WRITEDDPDIR -d <output_dir> [-s <sub_dir>] [<volume_name>] [-o] [-e]
WRITEDDPDIR -d [-s ] -ext [-o] [-e]
    Parameters:
  • <volume_name> Name of the GEAR volume to write.
  • <file_name> Name of an external physical track image file ('type' = 1-11), or a track list file ('type' = 12).
  • <type> Type number indicating the type of the external image file.
  • <output_dir> Existing directory where to create a folder with the DDP files and image files.
  • <sub_dir> Optional name (without path) of the DDP folder to create in the output dir.
  • [-o] Force overwriting of the DDP and image files if they already exist.
  • [-e] Do not create default sub folder.

Description: Writes the specified source to a DDP image on the hard disk.

Back to Top
WRITETP WRITETP [<volume_name>]
WRITETP -ext <type> <file_name>
    Parameters:
  • <volume_name> Name of the GEAR volume to write.
  • <file_name> Name of an external physical track image file ('type' = 1-11), or a track list file ('type' = 12).
  • <type> Type number indicating the type of the external image file.

Description: Writes the specified source to an ANSI labeled premaster tape.

Back to Top

Examples of Batch Files

Create a bootable disc

Select All and copy to a text editor. Then edit the parameters to what you need.
Back to Top

Create a data disc

Select All and copy to a text editor. Then edit the parameters to what you need.
Back to Top

Create a DVD video disc

Select All and copy to a text editor. Then edit the parameters to what you need.
Back to Top

Create a SCSI Log

Select All and copy to a text editor. Then edit the parameters to what you need.
Back to Top

Create a Physical Volume

Select All and copy to a text editor. Then edit the parameters to what you need.
Back to Top

Write a Physical Volume

Select All and copy to a text editor. Then edit the parameters to what you need.
Back to Top