Copyright Digital Equipment Corp. All rights reserved.
Qualifiers
/BACKUP
Modifies the time value specified with the /BEFORE or the
/SINCE qualifier. The /BACKUP qualifier selects files according
to the dates of their most recent backups. This qualifier
is incompatible with the /CREATED, /EXPIRED, and /MODIFIED
qualifiers, which also allow you to select files according to
time attributes. If you do not specify any of these four time
qualifiers, the default is the /CREATED qualifier.
/BEFORE
/BEFORE[=time]
Selects only those files dated prior to the specified time. You
can specify time as absolute time, as a combination of absolute
and delta times, or as one of the following keywords: BOOT,
LOGIN, TODAY (default), TOMORROW, or YESTERDAY. Specify one of
the following qualifiers with the /BEFORE qualifier to indicate
the time attribute to be used as the basis for selection:
/BACKUP, /CREATED (default), /EXPIRED, or /MODIFIED.
For complete information about specifying time values, see the
OpenVMS User's Manual or the online help topic Date.
/BY_OWNER
/BY_OWNER[=uic]
Selects only those files whose owner user identification code
(UIC) matches the specified owner UIC. The default UIC is that of
the current process.
Specify the UIC by using standard UIC format as described in the
VSI OpenVMS Guide to System Security.
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether a request is issued before each file transfer
operation to confirm that the operation should be performed on
that file. The following responses are valid:
YES NO QUIT
TRUE FALSE Ctrl/Z
1 0 ALL
<Return>
You can use any combination of uppercase and lowercase letters
for word responses. Word responses can be abbreviated to one or
more letters (for example, T, TR, or TRU for TRUE), but these
abbreviations must be unique. Affirmative answers are YES, TRUE,
and 1. Negative answers include: NO, FALSE, 0, and pressing
Return. Entering QUIT or pressing Ctrl/Z indicates that you want
to stop processing the command at that point. When you respond by
entering ALL, the command continues to process, but no further
prompts are given. If you type a response other than one of
those in the list, DCL issues an error message and redisplays
the prompt.
/CREATED
/CREATED (default)
Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /CREATED qualifier selects files based on their
dates of creation. This qualifier is incompatible with the
/BACKUP, /EXPIRED, and /MODIFIED qualifiers, which also allow
you to select files according to time attributes. If you do not
specify any of these four time qualifiers, the default is the
/CREATED qualifier.
/EXCLUDE
/EXCLUDE=(filespec[,...])
Excludes the specified files from the file transfer operation.
You can include a directory but not a device in the file
specification. The asterisk (*) and the percent sign (%)
wildcard characters are allowed in the file specification;
however, you cannot use relative version numbers to exclude a
specific version. If you specify only one file, you can omit the
parentheses.
/EXPIRED
Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /EXPIRED qualifier selects files according to
their expiration dates. (The expiration date is set with the
SET FILE/EXPIRATION_DATE command.) The /EXPIRED qualifier
is incompatible with the /BACKUP, /CREATED, and /MODIFIED
qualifiers, which also allow you to select files according to
time attributes. If you do not specify any of these four time
qualifiers, the default is the /CREATED qualifier.
/FDL
/FDL=fdl-filespec
Specifies that the output file characteristics are described
in the File Definition Language (FDL) file. Use this qualifier
when you require special output file characteristics. For more
information about FDL files, see the OpenVMS Record Management
Utilities Reference Manual.
Use of the /FDL qualifier implies that the transfer mode is
block by block; however, the transfer mode you specify with the
/TRANSFER_MODE qualifier prevails.
/LOG
/LOG
/NOLOG (default)
Controls whether the EXCHANGE/NETWORK command displays the file
specifications of each file copied.
When you use the /LOG qualifier, the EXCHANGE/NETWORK command
displays the following for each copy operation:
o The file specifications of the input and output files
o The number of blocks or the number of records copied
(depending on whether the file is copied on a block-by-block
or record-by-record basis)
/MODIFIED
Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /MODIFIED qualifier selects files according to
the date on which they were last modified. This time qualifier
is incompatible with the /BACKUP, /CREATED, and /EXPIRED
qualifiers, which also allow you to select files according to
time attributes. If you do not specify any of these four time
qualifiers, the default is the /CREATED qualifier.
/SINCE
/SINCE[=time]
Selects only those files dated on or after the specified time.
You can specify time as absolute time, as a combination of
absolute and delta times, or as one of the following keywords:
BOOT, JOB_LOGIN, LOGIN, TODAY (default), TOMORROW, or YESTERDAY.
Specify one of the following time qualifiers with the /SINCE
qualifier to indicate the time attribute to be used as the
basis for selection: /BACKUP, /CREATED (default), /EXPIRED, or
/MODIFIED.
For complete information about specifying time values, see the
OpenVMS User's Manual or the online help topic Date.
/STYLE
/STYLE=keyword
Specifies the file name format for display purposes.
The valid keywords for this qualifier are CONDENSED and EXPANDED.
Descriptions are as follows:
Keyword Explanation
CONDENSED Displays the file name representation of what is
(default) generated to fit into a 255-length character string.
This file name may contain a DID or FID abbreviation
in the file specification.
EXPANDED Displays the file name representation of what is
stored on disk. This file name does not contain any
DID or FID abbreviations.
The keywords CONDENSED and EXPANDED are mutually exclusive. This
qualifier specifies which file name format is displayed in the
output message, along with the confirmation if requested.
File errors are displayed with the CONDENSED file specification
unless the EXPANDED keyword is specified.
See the VSI OpenVMS System Manager's Manual, Volume 1: Essentials
for more information.
/SYMLINK
/SYMLINK=keyword
The valid keywords for this qualifier are [NO]WILDCARD and
[NO]ELLIPSIS. Descriptions are as follows:
Keyword Explanation
WILDCARD Indicates that symlinks are enabled during wildcard
searches.
NOWILDCARD Indicates that symlinks are disabled during directory
wildcard searches.
ELLIPSIS Equivalent to WILDCARD (included for command
symmetry).
NOELLIPSIS Indicates that symlinks are matched for all wildcard
fields except for ellipsis.
If the file named in the EXCHANGE/NETWORK command is a symlink,
the command operates on the symlink target.
/TRANSFER_MODE
/TRANSFER_MODE=option
Specifies the I/O method to be used in the transfer. This
qualifier is useful for all file formats. You can specify any
one of the following options:
Option Function
AUTOMATIC Allows the EXCHANGE/NETWORK command to
determine the appropriate transfer mode.
This is the default transfer mode.
BLOCK Opens both the input and output files for
block I/O and transfers the files block by
block.
CONVERT[=option[,...]]Reads records from the input file, packs
them into blocks, and writes them to the
output file in block mode. The options
listed in the following table determine
what additional information is inserted
during the transfer.
RECORD Opens both the input and output files for
record I/O and transfers the files record
by record. The target system must support
record operations, and the input file must
be record oriented.
The following four options are available with the CONVERT
transfer mode to control the insertion of special characters
in the records:
Option Function
CARRIAGE_CONTROL Any carriage control information in the
input file is interpreted, expanded into
actual characters, and included with each
record.
COUNTED The length of each record, in bytes, is
included at the beginning of the record.
The length includes all FIXED_CONTROL,
CARRIAGE_CONTROL, and RECORD_SEPARATOR
information in each record.
FIXED_CONTROL All variable length with fixed control
record (VFC) information is written to
the output file as part of the data. This
information follows the record length
information, if the COUNTED option was
specified.
RECORD_SEPARATOR= A 1- or 2-byte record separator is inserted
separator between each record. Record separator
characters are the last characters in the
record. The three choices for separator
characters are as follows:
o CR: Specifies carriage return only.
o LF: Specifies line feed only.
o CRLF: Specifies carriage return and line
feed.