Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameters

Qualifiers

/ACL

/BACKUP

/BEFORE

/BRIEF

/BY_OWNER

/COLUMNS

/CREATED

/DATE

/EXCLUDE

/EXPIRED

/FILE_ID

/FULL

/GRAND_TOTAL

/HEADING

/MODIFIED

/OUTPUT

/OWNER

/PRINTER

/PROTECTION

/SECURITY

/SELECT

/SINCE

/SIZE

/TOTAL

/TRAILING

/VERSIONS

/WIDTH

HELP DIRECTORY — MicroVMS 4.6

Displays the names and attributes of files in a directory or
directories.

Format
 DIRECTORY [file-spec,...]

 Requires READ access to the directories or sufficient privilege to
 override the protection to obtain information other than the file
 names.

Additional information available:

ParametersQualifiers

Parameters

file-spec
 Specification(s) of file(s) being listed. Wildcard characters are
 allowed. If no file is specified, all files in your default directory
 are listed. If just a directory name is specified, all files in that
 directory are listed. If the file type and version number are omitted,
 all versions of all file types of the specified file are listed. If
 the version number is omitted, all versions of the specified file are
 listed. The plus sign can be used in place of the comma between file
 specifications.

Qualifiers

Additional information available:

/ACL/BACKUP/BEFORE/BRIEF/BY_OWNER/COLUMNS
/CREATED/DATE/EXCLUDE/EXPIRED/FILE_ID/FULL/GRAND_TOTAL
/HEADING/MODIFIED/OUTPUT/OWNER/PRINTER/PROTECTION
/SECURITY/SELECT/SINCE/SIZE/TOTAL/TRAILING/VERSIONS
/WIDTH

/ACL

 Requires the Secure User Environment option.
 Displays the access control list (ACL) for each file. The /ACL
 qualifier overrides the /COLUMNS qualifier.

/BACKUP

 /CREATED (default)
 /EXPIRED
 /MODIFIED
 Selects files for the directory 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]

 Lists only those files with dates (creation, modification, expiration,
 or backup) that precede the specified time. You can specify time as an
 absolute time, a combination of absolute and delta times, or one of
 the following keywords: TODAY (default), TOMORROW, and YESTERDAY.

/BRIEF (default)

 Displays only a file's name, type, and version number. You can use the
 /ACL, /DATE, /FILE_ID, /NOHEADING, /OWNER, /PROTECTION, /SECURITY, and
 /SIZE qualifiers to expand a brief display.

/BY_OWNER[=uic]

 Displays only those files with the specified user identification code.
 The default UIC is that of the current process.

/COLUMNS=columns

 Specifies the number of columns in a brief display. The default is
 four. The number of columns is restricted by the value of the /WIDTH
 qualifier. The /COLUMNS qualifier is incompatible with /ACL and /FULL.

/CREATED

 See /BACKUP.

/DATE[=option]

 /NODATE (default)
 Expands the display to include date(s). Possible options are:

 +----------+-----------------------------------------------+
 | ALL      | Creation, expiration, backup, and last        |
 |          | modification dates                            |
 +----------+-----------------------------------------------+
 | BACKUP   | Last backup date                              |
 +----------+-----------------------------------------------+
 | CREATED  | Creation date                                 |
 +----------+-----------------------------------------------+
 | EXPIRED  | Expiration date                               |
 +----------+-----------------------------------------------+
 | MODIFIED | Last modification date                        |
 +----------+-----------------------------------------------+

/EXCLUDE=(file-spec,...)

 Excludes files from the display. The file specification can include a
 directory but not a device name. Wildcard characters are supported for
 file specifications.  However, you cannot use relative version numbers
 to exclude a specific version.

/EXPIRED

 See /BACKUP.

/FILE_ID

 Displays the file's identification number (FID). By default, a file's
 identification is not displayed unless the /FULL qualifier is
 specified.

/FULL

 Displays the following information: file specification, size (blocks
 used, blocks allocated), creation date, last backup date, last
 modification date, expiration date, owner UIC, protection, file
 identification number (FID), file organization (sequential or
 indexed), file attributes, record attributes, and record format,
 access control list (ACL).

/GRAND_TOTAL

 Displays only the totals for all specified files and directories.

/HEADING (default)

 /NOHEADING
 Prints headers consisting of the device and directory in which the
 files reside. When /NOHEADING is specified, the display is in single
 column format and the device and directory information appears with
 each file name. The /NOHEADING qualifier overrides /COLUMNS.

/MODIFIED

 See /BACKUP.

/OUTPUT[=file-spec]

 /NOOUTPUT
 Specifies the name of a file to which the directory display is
 written.  Wildcard characters are not allowed. By default, the
 display is written to SYS$OUTPUT.

/OWNER

 /NOOWNER (default)
 Displays the owner UIC of the file.

/PRINTER

 Requires the Secure User Environment Option.
 Puts the display in a file and queues the file to SYS$PRINT for
 printing. The name of the file is as specified in the /OUTPUT
 qualifier (or, if /OUTPUT is not specified, a temporary file named
 DIRECTORY.LIS which is queued for printing and then deleted).

/PROTECTION

 /NOPROTECTION (default)
 Displays the protection on the file.

/SECURITY

 Displays information about file security (equivalent to the /ACL,
 /OWNER, and /PROTECTION qualifiers together).

/SELECT=SIZE=(MINIMUM=n,MAXIMUM=n)

 Selects files for display according to size.  Possible options are:

 +-----------+----------------------------------------------+
 | MAXIMUM=n | Displays files that have fewer blocks than   |
 |           | the  value of n, which defaults to           |
 |           | 1073741823                                   |
 +-----------+----------------------------------------------+
 | MINIMUM=n | Displays files that have more blocks than    |
 |           | the  value of n, which defaults to 0         |
 +-----------+----------------------------------------------+

/SINCE[=time]

 Selects for display 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 one
 of the following keywords: TODAY (default), TOMORROW, and YESTERDAY.

/SIZE[=option]

 /NOSIZE (default)
 Displays the size of each file. If you omit option, the default
 lists the file size in blocks used (USED). Specify option as one
 of the following:

 +------------+-----------------------------------------+
 | ALL        | Lists blocks allocated and blocks used  |
 +------------+-----------------------------------------+
 | ALLOCATION | Lists blocks allocated                  |
 +------------+-----------------------------------------+
 | USED       | Lists blocks used                       |
 +------------+-----------------------------------------+

/TOTAL

 Displays only the directory name and total number of files.

/TRAILING (default)

 /NOTRAILING
 Displays summary information: the number of files listed, the total
 number of blocks used, and the total number of blocks allocated. If
 more than one directory is listed, the summary includes the total
 number of directories, total number of blocks used, and total number
 of blocks allocated. The /SIZE and /FULL qualifiers determine more
 precisely what summary information is included.

/VERSIONS=versions

 Specifies the number of versions of a file to describe and defaults to
 all versions.

/WIDTH=(keyword,...)

 Formats the width of the display. Possible keywords are:

 +------------+---------------------------------------------+
 | DISPLAY=n  | Specifies the total width of the display as |
 |            | an  integer in the range 1 through 256 and  |
 |            | defaults to 0 (setting the display  width   |
 |            | to the terminal width)                      |
 +------------+---------------------------------------------+
 | FILENAME=n | Specifies the width of the file name field; |
 |            | defaults to 19                              |
 +------------+---------------------------------------------+
 | OWNER=n    | Specifies the width of the owner field;     |
 |            | defaults to 20                              |
 +------------+---------------------------------------------+
 | SIZE=n     | Specifies the width of the size field;      |
 |            | defaults to 6                               |
 +------------+---------------------------------------------+

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