HELP DIRECTORY — MicroVMS 4.4
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:
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 | +------------+---------------------------------------------+