Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameters

Qualifiers

/ALLOCATION

/BACKUP

/BEFORE

/BY_OWNER

/CONFIRM

/CONTIGUOUS

/CREATED

/EXCLUDE

/EXPIRED

/EXTENSION

/LOG

/MODIFIED

/NEW_VERSION

/PROTECTION

/READ_CHECK

/SINCE

/WRITE_CHECK

HELP APPEND — MicroVMS 4.4

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:

ParametersQualifiers

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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026