HP OpenVMS DCL Dictionary


Previous Contents Index


COPY/RCP

Copies files from host to host over a TCP/IP connection by invoking the RCP utility.

Format

COPY/RCP input-filespec output-filespec


Parameters

input-filespec

Specifies the name of an existing file (the source file) to be copied.

output-filespec

Specifies the name of the output file (the destination file) into which the input file is copied.

Description

The COPY/RCP command copies one or more files (or directory trees) to or from a remote host using the RCP utility.

The OpenVMS DCL commands for TCP/IP support the same remote file specification format as the DCL commands for DECnet network connections. Some implementations of the file transaction applications support file transfers in which both the source file and the destination file are remote file specifications.

The full format for a remote file specification is as follows:

node"username password account"::filename.ext

If a file resides on a system other than OpenVMS, enclose the name of the file in quotation marks. For example, to access a file named /usr/users/user/Orders on a Tru64 UNIX node named U32, you would use the following format for the file specification:


U32"user password"::"/usr/users/user/Orders" 

Note that UNIX® systems support case sensitive file specifications.


Qualifiers

/AUTHENTICATE

Specifies that Kerberos authentication should be used for acquiring access to the remote node.

/LOG

Displays a message in SYS$OUTPUT when a file is transferred.

/PRESERVE

Preserves the file protection codes.

/RECURSIVE

Requests a subdirectory copy operation.

/TRUNCATE=USERNAME

Truncates the user name to 8 characters.

/USERNAME=username

Optional qualifier that specifies the remote user name. The standard operation is to log in to a remote system using the same user name as at the local terminal. The command supports quoted parameters in the /USERNAME value.

Example


$ COPY/RCP local_file.c remotehst4"Smith smpw"::rem_file.c
 
      

This example copies local_file.c to rem_file.c on the remote host remotehst4 over a TCP/IP connection.


COPY/RECORDABLE_MEDIA

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.

The COPY/RECORDABLE_MEDIA command 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


Parameters

input-filespec

Specifies the name of an existing file (the source file) to be copied.

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.


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.


Qualifiers

/BELL

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

/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.
Keyword Description
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:

  • Operate asynchronously
  • Perform background formatting
  • 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 (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:

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:

CD drives can select speeds faster than those supported by the particular media loaded in the drive. HP 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 (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.


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
HP OpenVMS CD-R/RW and DVD+R/RW Utility  V1.0-0 
Copyright 1976, 2006 Hewlett-Packard Development Company, L.P. 
 
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: 
 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:.


Previous Next Contents Index