HELPLIB.HLB  —  SET  DIRECTORY
    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, see the
    OpenVMS User's Manual or the online help topic Date.

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
    VSI 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, JOB_LOGIN, 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, see the
    OpenVMS User's Manual or the online help topic Date.

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.

    See the OpenVMS User's Manual for more information.

2.13    /SYMLINK

       /SYMLINK=keyword

    The valid keywords for this qualifier are [NO]WILDCARD and
    [NO]ELLIPSIS. Descriptions are as follows:

    Keyword     Explanation

    WILDCARD    Indicates that symlinks are enabled during wildcard
                searches.
    NOWILDCARD  Indicates that symlinks are disabled during directory
                wildcard searches.
    ELLIPSIS    Equivalent to WILDCARD (included for command
                symmetry).
    NOELLIPSIS  Indicates that symlinks are matched for all wildcard
                fields except for ellipsis.

    If the file named in the SET DIRECTORY command is a symlink, the
    command operates on the symlink target.

2.14    /VERSION_LIMIT

       /VERSION_LIMIT[=n]

    Sets the maximum number of versions that files in a specified
    directory can have. If you do not set a version limit, a value
    of 0 is used, indicating that the number of file versions is
    limited only to the Files-11 architectural limit of 32,767.
    If you change the version limit for a directory, the new version
    limit applies only to files created after the change has been made.
    When creating a file, if the total number of versions of that file
    name exceeds the specified version limit, then the file with the
    lowest version number is deleted from the directory without
    notification to the user.

    The version limit set on a directory has no effect on the version
    limit set on a particular file in that directory. To set a
    version limit on a particular file in a directory, use the
    SET FILE/VERSION_LIMIT[=n] command.

    To view the version limit on a directory, use the DIRECTORY/FULL
    command on a directory file and look at the File Attributes
    field 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 5 for all files in the VERCAMMEN directory (the
      root directory) and all subdirectories of [VERCAMMEN]. The
      /CONFIRM qualifier requests that you confirm whether the
      specified directory should actually be modified. Note that this
      version limit applies only to files created after the command
      is entered.

    2.$ SET DIRECTORY/VERSION_LIMIT=8 [.JAIMON...]

      In this example, the SET DIRECTORY command sets a version
      limit of 8 for all files in the JAIMON subdirectory and any
      of its subdirectories (for example, [.JAIMON.ADRIAN]). The
      setting for these specific directories overrides any version
      limit that might be set for the root directory and its other
      subdirectories.

    3.$ 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).
Close Help