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. 3 Examples 1.$ EXCHANGE/NETWORK VMS_FILE.DAT KUDOS::FOREIGN_SYS.DAT In this example, the EXCHANGE/NETWORK command transfers the file VMS_FILE.DAT located in the current default device and directory to the file FOREIGN_SYS.DAT on the non OpenVMS node KUDOS. Because the /TRANSFER_MODE qualifier was not explicitly specified, the EXCHANGE/NETWORK command automatically determines whether the transfer method should be block or record I/O. 2.$ EXCHANGE/NETWORK/TRANSFER_MODE=BLOCK - _$ KUDOS::FOREIGN_SYS.DAT VMS_FILE.DAT In this example, the EXCHANGE/NETWORK command transfers the file FOREIGN_SYS.DAT from the non OpenVMS node KUDOS to the file VMS_FILE.DAT in the current default device and directory. Block I/O is specified for the transfer mode. 3.$ EXCHANGE/NETWORK/FDL=VMS_FILE_DEFINITION.FDL - _$ KUDOS::REMOTE_FILE.TXT VMS_FILE.DAT In this example, the EXCHANGE/NETWORK command transfers the file REMOTE_FILE.TXT on node KUDOS to the file VMS_FILE.DAT. The file attributes for the output file VMS_FILE.DAT are obtained from the File Definition Language (FDL) source file VMS_FILE_DEFINITION.FDL. Because the qualifier /FDL is specified and the /TRANSFER_MODE qualifier is omitted, the transfer mode uses block I/O, by default. For more information about creating FDL files, see the OpenVMS Record Management Utilities Reference Manual. 4.$ EXCHANGE/NETWORK - _$ /TRANSFER_MODE=CONVERT=(CARRIAGE_CONTROL,COUNTED, - _$ RECORD_SEPARATOR=CRLF,FIXED_CONTROL) - _$ PRINT_FILE.TXT KUDOS::* In this example, the EXCHANGE/NETWORK command transfers the file PRINT_FILE.TXT from the current default device and directory to the file PRINT_FILE.TXT on the non OpenVMS node KUDOS. The use of the CONVERT option with the /TRANSFER_MODE qualifier forces the input file to be read in record by record, modified as specified by the CONVERT options that follow, and written to the output file block by block. As many records as will fit are packed into the output blocks. The CONVERT option CARRIAGE_CONTROL specifies that carriage control information is converted to ASCII characters and inserted before the data or appended to the record, depending on whether prefix control or postfix control, or both, are used. The CONVERT option FIXED_CONTROL specifies that any fixed control information be translated to ASCII characters and inserted at the beginning of the record. The CONVERT option RECORD_SEPARATOR=CRLF appends the two specified characters, carriage return and line feed, to the end of the record. The CONVERT option COUNTED specifies that the total length of the record must be counted (once the impact of all the previous convert options have been added), and the result is to be inserted at the beginning of the record, in the first 2 bytes.