VMS Help SET, DIRECTORY  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Modifies the characteristics of one or more directories.

    See the qualifier descriptions for restrictions.

    Format

      SET DIRECTORY  [device-name[:]]directory-spec[,...]

1 - Parameters

 device-name[:]

    Specifies the device on which the directory that you want to
    modify is located. The device name parameter is optional.

 directory-spec[,...]

    Specifies one or more directories to be modified. If you specify
    more than one directory, separate the directory specifications
    with commas. The asterisk (*)  and the percent sign (%) wildcard
    characters are allowed.

2 - Qualifiers

 2.1 - /BACKUP

    Modifies the time value specified with the /BEFORE or the /SINCE
    qualifier. The /BACKUP qualifier selects directories according
    to the dates of their most recent backups. This qualifier
    is incompatible with the /CREATED, /EXPIRED, and /MODIFIED
    qualifiers, which also allow you to select directories according
    to time attributes. If you specify none of these four time
    qualifiers, the default is the /CREATED qualifier.

 2.2 - /BEFORE

       /BEFORE[=time]

    Selects only those directories dated prior to 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, LOGIN, TODAY (default), TOMORROW, or YESTERDAY. Specify
    one of the following qualifiers with the /BEFORE qualifier
    to indicate the time attribute to be used as the basis for
    selection: /BACKUP, /CREATED (default), /EXPIRED, or /MODIFIED.

    For complete information on specifying time values, refer to the
    OpenVMS User's Manual or the online help topic DCL_Tips (subtopic
    Date_Time).

 2.3 - /BY_OWNER

       /BY_OWNER[=uic]

    Selects only those directories whose owner user identification
    code (UIC) matches the specified owner UIC. The default UIC is
    that of the current process.

    Specify the UIC by using standard UIC format as described in the
    OpenVMS Guide to System Security.

    The /OWNER_UIC qualifier requires control access, a system UIC,
    or privilege.

 2.4 - /CONFIRM

       /CONFIRM
       /NOCONFIRM (default)

    Controls whether a request is issued before each SET DIRECTORY
    operation to confirm that the operation should be performed on
    that file. The following responses are valid:

    YES      NO       QUIT
    TRUE     FALSE    Ctrl/Z
    1        0        ALL
             <Return>

    You can use any combination of uppercase and lowercase letters
    for word responses. Word responses can be abbreviated to one or
    more letters (for example, T, TR, or TRU for TRUE), but these
    abbreviations must be unique. Affirmative answers are YES, TRUE,
    and 1. Negative answers include: NO, FALSE, 0, and pressing
    Return. Entering QUIT or pressing Ctrl/Z indicates that you want
    to stop processing the command at that point. When you respond by
    entering ALL, the command continues to process, but no further
    prompts are given. If you type a response other than one of
    those in the list, DCL issues an error message and redisplays
    the prompt.

 2.5 - /CREATED

       /CREATED (default)

    Modifies the time value specified with the /BEFORE or the /SINCE
    qualifier. The /CREATED qualifier selects directories based on
    their dates of creation. This qualifier is incompatible with the
    /BACKUP, /EXPIRED, and /MODIFIED qualifiers, which also allow
    you to select directories according to time attributes. If you
    specify none of these four time qualifiers, the default is the
    /CREATED qualifier.

 2.6 - /EXCLUDE

       /EXCLUDE=(filespec[,...])

    Excludes the specified directories from the SET DIRECTORY
    operation. You can include a directory but not a device in the
    file specification. The asterisk (*)  and the percent sign (%)
    wildcard characters are allowed in the file specification;
    however, you cannot use relative version numbers to exclude a
    specific version. If you specify only one directory, you can omit
    the parentheses.

 2.7 - /EXPIRED

    Modifies the time value specified with the /BEFORE or the /SINCE
    qualifier. The /EXPIRED qualifier selects directories according
    to their expiration dates. (The expiration date is set with
    the SET FILE/EXPIRATION_DATE command.) The /EXPIRED qualifier
    is incompatible with the /BACKUP, /CREATED, and /MODIFIED
    qualifiers, which also allow you to select directories according
    to time attributes. If you specify none of these four time
    qualifiers, the default is the /CREATED qualifier.

 2.8 - /LOG

       /LOG
       /NOLOG (default)

    Controls whether the system displays the directory specification
    of each directory that is modified as the command executes.

 2.9 - /MODIFIED

    Modifies the time value specified with the /BEFORE or the /SINCE
    qualifier. The /MODIFIED qualifier selects directories according
    to the dates on which they were last modified. This qualifier is
    incompatible with the /BACKUP, /CREATED, and /EXPIRED qualifiers,
    which also allow you to select directories according to time
    attributes. If you specify none of these four time modifiers, the
    default is the /CREATED qualifier.

 2.10 - /OWNER_UIC

       /OWNER_UIC[=uic]

    Requires control access, a system UIC, or privilege.

    Specifies an owner UIC for the directory. The default UIC is that
    of the current process.

 2.11 - /SINCE

       /SINCE[=time]

    Selects only those directories 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, LOGIN, TODAY (default), TOMORROW, or YESTERDAY. Specify one
    of the following 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 on specifying time values, refer to the
    OpenVMS User's Manual or the online help topic DCL_Tips (subtopic
    Date_Time).

 2.12 - /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.

    Refer to the OpenVMS Guide to Extended File Specifications for
    more information.

 2.13 - /VERSION_LIMIT

       /VERSION_LIMIT[=n]

    Specifies the total number of versions that a file in the
    specified directory can have. If you do not specify a version
    limit, a value of 0 is used, indicating that the number of
    versions of a file is limited only to the Files-11 architectural
    limit-32,767. If you change the version limit for the directory,
    the new value applies only to files created after the change has
    been made.

    The SET DIRECTORY version limit value refers to the number of
    files with the same file name and type that can exist in the
    directory at one time. It has no effect on the version number
    field of a particular file specification. Use the SET FILE
    command to set limits on file version numbers.

    To find out the current version limit for a directory, use the
    DIRECTORY/FULL command on a directory file and look at the File
    Attributes component of the output.

3 - Examples

    1.$ SET DIRECTORY/VERSION_LIMIT=5/CONFIRM [VERCAMMEN...]

      The SET DIRECTORY command in this example sets a version
      limit of five for all files in the VERCAMMEN directory and
      all subdirectories of [VERCAMMEN]. The /CONFIRM qualifier
      requests that you confirm whether the specified directory
      should actually be modified. Note that it affects only the
      files created after the command is entered.

    2.$ SET DIRECTORY/OWNER_UIC=[360,020] [WOERTMAN],[MOSER]

      The SET DIRECTORY command in this example modifies both the
      [WOERTMAN] and [MOSER] directories, changing their owner
      UICs. Using the OWNER_UIC qualifier requires SYSPRV (system
      privilege).