HELP APPEND — MicroVMS 4.5B
Adds the contents of the specified input file(s) to the end of the specified output file. Format APPEND input-file-spec,... output-file-spec
Additional information available:
Parameters
input-file-spec The specification of the input file(s). Multiple input files are appended to the output file in the order specified; separate file specifications with commas or plus signs. Wildcard characters are allowed. output-file-spec A valid file specification. You must specify at least one field of the file specification. Device and directory default to your current default device and directory. Other fields default to the corresponding field of the first input file specification.
Qualifiers
Additional information available:
/ALLOCATION/BACKUP/BEFORE/BY_OWNER/CONFIRM
/CONTIGUOUS/CREATED/EXCLUDE/EXPIRED/EXTENSION
/LOG/MODIFIED/NEW_VERSION/PROTECTION/READ_CHECK
/SINCE/WRITE_CHECK
/ALLOCATION=number-of-blocks
Qualifies output-file-spec. Forces the initial allocation of the output file to the specified number of 512-byte blocks. If you do not specify the /ALLOCATION qualifier, the initial allocation of the output file is determined by the size of the input file. Relevant only with the /NEW_VERSION qualifier.
/BACKUP
/CREATED (default) /EXPIRED /MODIFIED Selects files for the append operation according to the dates of their most recent backups, their creation dates, their expiration dates, or the dates of their last modifications. Relevant only with the /BEFORE and /SINCE qualifiers.
/BEFORE[=time]
Selects for the append operation only those files created or modified before the specified time. You can specify time as an absolute time, as a combination of absolute and delta times, or as one of the following keywords: TODAY (default), TOMORROW, YESTERDAY.
/BY_OWNER[=uic]
Selects for the append operation only those files with the specified user identification code. The default user identification code is that of the current process.
/CONFIRM
/NOCONFIRM (default) Issues a request for confirmation before each append operation. The following responses are valid: +----------+-----------------------------------------------+ | YES | Perform the append operation | +----------+-----------------------------------------------+ | NO | Do not perform the append operation | +----------+-----------------------------------------------+ | TRUE | Perform the append operation | +----------+-----------------------------------------------+ | FALSE | Do not perform the append operation | +----------+-----------------------------------------------+ | 1 | Perform the append operation | +----------+-----------------------------------------------+ | 0 | Do not perform the append operation | +----------+-----------------------------------------------+ | <RETURN> | Perform the append operation | +----------+-----------------------------------------------+ | ALL | Continue execution of the command with no | | | further confirmation prompts | +----------+-----------------------------------------------+ | <CTRL/Z> | Stop execution of the command | +----------+-----------------------------------------------+ | QUIT | Stop execution of the command | +----------+-----------------------------------------------+
/CONTIGUOUS
/NOCONTIGUOUS Qualifies output-file-spec. Specifies that the output file must occupy physically contiguous disk blocks. By default, the APPEND command creates an output file in the same format as the corresponding input file and does not report an error if not enough space exists for a contiguous allocation.
/CREATED
See /BACKUP.
/EXCLUDE=(file-spec,...)
Omits the specified file(s) from the append operation. You can include a directory but not a device in the file specification(s). Wildcard characters are supported for file specifications. However, you cannot use relative version numbers to exclude a specific version.
/EXPIRED
See /BACKUP.
/EXTENSION=n
Qualifies output-file-spec. Sets the default extend quantity for the output file. Relevant only with the /NEW_VERSION qualifier.
/LOG
/NOLOG (default) Displays file specifications of input and output files as well as the number of blocks or records appended after each append operation. Displays the number of new files created after the entire append operation.
/MODIFIED
See /BACKUP.
/NEW_VERSION
/NONEW_VERSION (default) Qualifies output-file-spec. Creates a new output file if the specified output file does not exist. If the output file does exist, the /NEW_VERSION qualifier appends the input file to the output file.
/PROTECTION=(ownership[:access],...)
Qualifies output-file-spec. Specifies protection for the output file. Specify ownership as SYSTEM, OWNER, GROUP, or WORLD and access as R, W, E, or D. The default protection is that of the existing output file; if no output file exists, the current default protection applies.
/READ_CHECK
/NOREAD_CHECK (default) Qualifies input-file-spec. Reads each record in the input file(s) twice to verify that it has been read correctly.
/SINCE[=time]
Selects for the append operation only those files dated (creation, modification, expiration, or backup) after the specified time. You can specify time as an absolute time, a combination of absolute and delta times, or as one of the following keywords: TODAY (default), TOMORROW, YESTERDAY.
/WRITE_CHECK
/NOWRITE_CHECK (default) Qualifies output-file-spec. Reads each record in the output file(s) after the record is written to verify that it is written correctly.