HP OpenVMS DCL Dictionary
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:
- 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:
- When incompatibilities or recording errors are reported during a
previous failed recording operation.
- If the CD media in use has a rated recording speed below the drive
default recording settings.
- If CDDVD application, processor, or system I/O performan
constraints exist.
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:.
| 
