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

    Establishes or removes the connection between the current CMS
    library and a reference copy directory.

       Format:

          MODIFY LIBRARY  /qualifier "remark"

1 - Command Parameters

 remark

    Specifies a character string to be logged in the history file
    with this command, usually used to explain why the command was
    entered. The remark is enclosed in quotation marks. If no remark
    was entered, a null remark ("") is logged.

2 - Description

    The MODIFY LIBRARY command establishes or removes the connection
    between the current CMS library and a reference copy directory.
    The reference copy directory cannot be a CMS library. This command
    does not add files to or delete any files from a reference
    copy directory. Once you establish a reference copy directory
    for a library, subsequent transactions that create new element
    generations on the main line of descent also update the reference
    copy directory (provided the element is set to /REFERENCE_COPY).

    You must use the MODIFY ELEMENT/NOREFERENCE_COPY command on
    the elements in the library before you can use the MODIFY
    LIBRARY/NOREFERENCE_COPY command.

    If you specify MODIFY LIBRARY/REFERENCE_COPY and the reference
    copy directory is already set, CMS first verifies all the files
    found in that directory. The contents of the directory must
    exactly correspond with the elements that have /REFERENCE_COPY
    set in the CMS library. If elements are set with /NOREFERENCE_
    COPY and there are existing reference copies for those elements,
    CMS advises you to use VERIFY/REPAIR. No further operations are
    allowed until the reference copies have been repaired.

    Use the SHOW LIBRARY command to display library characteristics.

3 - Qualifiers

 3.1 - /CONCURRENT (D)

    Specifies whether elements in a library can have multiple
    reservations by setting the concurrent attribute on the library.
    Use /NOCONCURRENT to disallow multiple reservations. If this
    qualifier is not specified the status of this attribute remains
    unchanged.

 3.2 - /EXTENDED_FILENAMES

    Change the attribute of a CMS library to allow the use of extended
    file names. This qualifier is only available on OpenVMS V7.2 and
    later. Use /NOEXTENDED_FILENAMES to change the attribute to disallow
    the use of extended file names. If this qualifier is not specified
    the status of this attribute remains unchanged.

 3.3 - /KEEP

    Instructs CMS to not delete all versions of a file used to create
    a new element or generation. If this qualifier is not specified
    the status of this attribute remains unchanged.

 3.4 - /LOG (D)

    Controls whether CMS displays success and informational messages
    on the default output device. By default, if the command executes
    successfully, CMS displays a success message. If you specify
    /NOLOG, success and informational messages are suppressed. Any
    warning, error, or fatal error messages are displayed regardless
    of whether /LOG or /NOLOG is specified.

 3.5 - /LONG_VARIANT_NAMES

    Change the attribute of a CMS library to allow the use of long
    variant names. Use /NOLONG_VARIANT_NAMES to change the attribute
    to disallow the use of long variant names. If this qualifier is
    not specified the status of this attribute remains unchanged.

 3.6 - /OCCLUDE[=option,...]

    Controls whether CMS selects the first instance of the specified
    object, or all instances of the specified object in the library
    search list. The options field contains one or more keywords
    associated with the name of the object. The options field can
    contain the following keywords:

       ALL--equivalent to OTHER
       OTHER (D)
       NOOTHER
       NONE--equivalent to NOOTHER

    You can specify either ALL, NONE, or the [NO]OTHER keyword.

    By default, CMS performs occlusion for all objects; that is, CMS
    selects only the first occurrence of a specified object.

 3.7 - /REFERENCE_COPY=directory-specification

    Specifies a valid VMS directory to be used for reference copies
    of library elements. The directory cannot be a CMS library, nor
    can it be a subdirectory of a CMS library directory. If you use
    the MODIFY LIBRARY command on a search list consisting of more
    than one library, you should specify a reference copy directory
    for each library in the search list. If you specify only one
    reference copy directory for more than one library, CMS uses one
    reference copy directory for the entire search list, not one
    reference copy directory for each library in the search list.

    Use the /NOREFERENCE_COPY qualifier to remove the connection
    between the current CMS library and the current reference copy
    directory. Wildcards are not allowed.

 3.8 - /REVISION_TIME[=option]

    Controls whether CMS uses the original file revision time or the
    file storage time when a file is retrieved from the CMS library.
    The options field can contain of the following keywords:

       ORIGINAL (D)
       STORAGE_TIME

    Use the keyword ORIGINAL to indicate that the original revision
    time of files placed in a CMS library should be restored unchanged
    upon their retrieval.  This is the default behavior.

    Use the keyword STORAGE_TIME to indicate that the time when a file
    was stored in a CMS library (through a CREATE ELEMENT or REPLACE
    transaction) should be substituted for its original revision time
    upon retrieval.

4 - Example

    CMS> MODIFY LIBRARY/REFERENCE_COPY=[WORK.REFCOPY] "current
    test area"
    %CMS-S-MODIFIED, library [WORK.CODELIB] modified

      This command establishes the reference copy directory
      [WORK.REFCOPY] for the current CMS library. In addition, to
      update the reference copy directory, an element must be set to
      /REFERENCE_COPY. Thus, if these two conditions are met, each
      transaction that creates a new main line element generation
      also updates the reference copy directory.