1  CDDVD
   The COPY/RECORDABLE_MEDIA (CDDVD) Utility allows users to create
   Compact Disk (CD) and Digital Versatile Disk (DVD) media directly
   on OpenVMS, using an optional optical disk recorder.

   CDDVD generates ISO/IEC 10149 Mode 1 (2048-byte blocks, data)
   single-session optical media recordings.

   CDDVD supports the recording of various optical media formats,
   including CD Recordable (CD-R), CD Rewritable (CD-RW), DVD
   Recordable (DVD+R) and DVD Rewritable (DVD+RW) formats. For a
   successful recording operation, one or more of these formats must
   be available within the target optical disk recording device.
   Compatible recording media must also be loaded into the recording
   device.
 

2  COPY
 

3  /RECORDABLE_MEDIA
   Opens the specified input disk image file or input master device
   and records the entire contents to the specified CD-R, CD-RW,
   DVD+R, and DVD+RW media formats.

   Format

     COPY/RECORDABLE_MEDIA  source-path-name target-path-name
 

4  Parameter
 

source-path-name

   This is the data source for the recording operation.

   Specify the name of a disk file containing a disk image to be
   copied onto the target recording media, or the device name of the
   input device containing the disk volume master for the recording.

   On OpenVMS systems, this is usually a Logical Disk (LD) Utility
   LDAu: device.
 

target-device-name

   The device name of the target recordable media device.

   This is usually the name of an ATAPI (DQcu:) SCSI (DKcu:), or USB
   (DNcu:): CD-R/RW or DVD+R/RW recording device, or both.
 

4  Description
   The COPY/RECORDABLE_MEDIA command records the entire contents
   of the specified input disk image file or input device onto
   the media loaded into the specified output CD or DVD recording
   device.

   The output media format is sensed automatically, and the utility
   automatically configures the recording appropriately for the
   particular target device and for the output media that are
   loaded.

   You cannot record more than the capacity of the target media
   permits. Therefore, you need to select the size of the input disk
   image or the master appropriate for the capacity of the target
   media. The input data source must also be an even multiple of
   the sector size on optical media; the size of the input must be a
   multiple of four blocks.

   The recording operation is independent of the input volume
   structure or input file data used for the master, and is based
   solely on the block-level contents of the specified input master.
 

4  Qualifiers
 

/BELL

   Sounds an audible signal when the requested recording operation
   completes successfully.
 

/FORMAT

      /FORMAT[=keyword]
      /NOFORMAT (default)

   Requests that rewritable (RW) media be formatted or reformatted
   prior to use. This qualifier is required for writing to blank
   rewritable media or rewriting rewritable media.

   If the target media cannot be formatted, this command qualifier
   is ignored.

   If not specified, the appropriate keyword is automatically
   selected for the fastest formatting speed available for the
   target recording media.

   Keywords for the /FORMAT Qualifier lists available keywords.

   Table 1-1 Keywords for the /FORMAT Qualifier

   Keyword  Function, Comments

   WAIT     Applies to DVD+RW. The default for the /FORMAT qualifier
            is not to wait for the formatting to complete because
            waiting is usually unnecessary and far slower.

            Selecting WAIT causes the entire format to run
            synchronously to completion before beginning the
            recording operation.

            The default is to:

            o  Operate asynchronously

            o  Perform background formatting

            o  Run both the media format operation and the recording
               operations concurrently

   ERASE    Applies to CD-RW.

            The default for the /FORMAT qualifier is to perform a
            quick erasure because a full erasure is usually both
            unnecessary and far slower.

            Selecting ERASE causes the CD-RW rewritable disk to
            be entirely erased as part of the format operation.
            This erasure is performed and is completed before the
            recording operation begins.

            The default is to perform a quick erasure.
 

/LOG

      /LOG (default)
      /NOLOG

   Shows basic device information and the progress of the recording
   operation. Use /NOLOG to disable the normal output from the
   utility.
 

/SPEED

   If you must use the lower-speed or poor-quality CD recording
   media, the /SPEED qualifier is often required for successful
   completion of the recording process. You might need to select
   a recording speed below the rated speed of the CD drive itself.
   Specifically, you might need to select a recording speed that
   is compatible with both the CD drive and the CD recording media
   loaded in the drive.

   The /SPEED qualifier accepts a single keyword for a requested
   device speed:

      1X
      2X
      4X
      8X
      16X
      32X
      MAXIMUM

   The CDDVD utility attempts to match the requested speed to a
   speed that the device supports. (Not all devices support all
   speeds, including the lowest speed, 1X, or the highest speed
   available.) The default speed is the maximum speed that the
   target device supports. DVD+R/RW drives select the maximum
   recording speed based on information encoded on the media.

   You need to specify this qualifier only under one of the
   following circumstances:

   o  When incompatibilities or recording errors are reported during
      a previous failed recording operation.

   o  If the CD media in use has a rated recording speed below the
      drive default recording settings.

   o  If CDDVD application, processor, or system I/O performance
      constraints exist.

   CD drives can select speeds faster than those supported by the
   particular media loaded in the drive. VSI recommends that you
   select only media that match the recording capabilities of the
   drive. In other words, do not attempt to exceed the recording
   speed limits of the particular CD media. Selecting faster media
   will not make a slow drive record any faster, and selecting
   faster speeds with slow media can trigger recording errors and
   corrupt media.

   If the recording process fails during the recording operation,
   discard the write-once media and try a slower recording speed.
   (Note that you can attempt to reformat and rerecord on rewritable
   media.)
 

/VERIFY

   Specifies that the contents of the output media be compared to
   the contents of the input source after the recording operation.
   Any data comparison errors detected are displayed.
 

/WRITE

      /WRITE (default)
      /NOWRITE

   Allows you to test the system and device I/O throughput and the
   command syntax without recording on the target media.

   If you specify /NOWRITE and if the target drive supports the
   underlying test-write hardware capability, all I/O operates as
   usual although /NOWRITE disables writing to the media.

   /WRITE is the default, and causes the target optical media to be
   written.
 

4  Examples

   1.$  $ COPY/RECORDABLE_MEDIA -
     $_      [/BELL] -
     $_      [/DATA_CHECK=WRITE] -
     $_      [/DIAGNOSTICS=(DETAILS,COMMANDS,ALL)] -
     $_      [/EXTENSIONS[=(keywords)]] -
     $_      [/[NO]LOG] -
     $_      [/SPEED={1X|2X|4X|8X|16X|32X|MAXIMUM}] -
     $_      source-path-name target-device-name
     $

     This example shows the generic format of the COPY/RECORDABLE_
     MEDIA command.

   2.$ COPY/RECORDABLE_MEDIA/FORMAT LDA1 DQA1

     VSI OpenVMS CD-R/RW and DVD+R/RW Utility  V1.0-3
     Copyright 2015 VMS Software, Inc.

     Output device vendor: HP
     Output device product name: DVD Writer 740b
     Commencing media format operation
     Formatting may require up to an hour
     Output medium format: DVD+RW
     Input data being read from: LDA1:
     Output data being written to: DQA1:
     Input data size: 1200000 blocks

     Starting operation at: 15:28:16

     16 sectors written

     30000 sectors written; estimated completion in 00:06:52; at 15:35:55
     37000 sectors written; estimated completion in 00:06:54; at 15:36:07
     46000 sectors written; estimated completion in 00:06:36; at 15:36:03
     57000 sectors written; estimated completion in 00:06:08; at 15:35:51
     71000 sectors written; estimated completion in 00:06:00; at 15:36:04
     88000 sectors written; estimated completion in 00:05:26; at 15:35:56
     110000 sectors written; estimated completion in 00:04:55; at 15:35:58
     137000 sectors written; estimated completion in 00:04:12; at 15:35:56
     171000 sectors written; estimated completion in 00:03:14; at 15:35:48
     213000 sectors written; estimated completion in 00:02:10; at 15:35:48
     266000 sectors written; estimated completion in 00:00:54; at 15:35:50
     300000 sectors written; operation completed

     Operation completed at: 15:35:47
     Elapsed time for operation: 00:07:30
     Synchronizing with output device cache
     Processing completed

     This example demonstrates recording the contents of LDA1:
     device onto the DVD+RW media loaded into device DQA1:.
