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

    Enables access to an existing CMS library or libraries. Subsequent
    CMS commands automatically refer to the libraries identified by
    this command.

       Format:

          SET LIBRARY  directory-specification[,...]

1 - Command Parameters

 directory-specification

    Specifies one or more existing CMS libraries. The directory
    that is used as the CMS library cannot be your current default
    directory. The directory specification must conform to VMS
    conventions; it can also be a logical name. If you specify
    more than one VMS directory, you must separate the directory
    specifications with commas. Wildcards are not allowed.

2 - Description

    The SET LIBRARY command enables access to an existing CMS library
    or list of libraries. Subsequent CMS commands automatically refer
    to the library or libraries identified in the SET LIBRARY command.
    The SET LIBRARY command defines logical names beginning with CMS$
    that allow CMS commands to refer implicitly to the library. You
    should not define logical names beginning with CMS$ because this
    prefix is reserved for CMS.

    The SET LIBRARY command performs some consistency checks on the
    directory to verify that it is a valid CMS library (unless you
    specify the /NOVERIFY qualifier). If the library is not valid, you
    receive an error message.

    The library must have been created with the CREATE LIBRARY
    command. During each session in which you want to use your CMS
    library, you must use the SET LIBRARY command before you access
    a library. The command is not required, however, if you have
    just created a library (see the description of the CREATE LIBRARY
    command) because the CREATE LIBRARY command performs an implicit
    SET LIBRARY.

    You create a search list by specifying multiple libraries on
    the SET LIBRARY command. This enables you to manipulate several
    libraries with one command. You must include commas between the
    directory specifications.

3 - Qualifiers

 3.1 - /AFTER[=directory-specification]

    Instructs CMS to insert new libraries into the existing library
    search list (that you previously specified by using a comma list
    with the CREATE LIBRARY or SET LIBRARY command) immediately
    following the existing specified directory. If you omit the
    directory specification, CMS adds the libraries to the end of
    the list. You cannot specify both /AFTER and /BEFORE on the same
    command line. By default, the SET LIBRARY command's library list
    supersedes any existing search list.

 3.2 - /BEFORE[=directory-specification]

    Instructs CMS to insert new libraries into the existing library
    search list (that you previously specified by using a comma list
    with the CREATE LIBRARY or SET LIBRARY command) immediately
    in front of the existing specified directory. If you omit the
    directory specification, CMS adds the libraries to the front of
    the list. You cannot specify both /AFTER and /BEFORE on the same
    command line. By default, the SET LIBRARY command's library list
    supersedes any existing search list.

 3.3 - /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.4 - /VERIFY (D)

    Allows you to set a library without performing the locking and
    verification process CMS normally performs. This speeds up the SET
    LIBRARY operation and allows a CMS library to be set even if the
    library is locked by another user. However, if the library needs
    recovery, the condition is not detected until another transaction
    is attempted.

4 - Examples

    (1) CMS> SET LIBRARY [WORK.CMSLIB]
        %CMS-S-LIBIS, CMS library is DISKX:[WORK.CMSLIB]

      This command sets the CMS library to the existing library
      [WORK.CMSLIB].

    (2) CMS> SET LIBRARY [WORK.CMSLIB],[TEST.CMSLIB]
        %CMS-I-LIBIS, library is DISK$:[WORK.CMSLIB]
        %CMS-I-LIBINSLIS, library DISK$:[TEST.CMSLIB] inserted at
        end of library list
        %CMS-S-LIBSET, library set
        -CMS-I-SUPERSEDE, library list superseded

      This command sets (or resets, if there was an existing library
      or libraries) the current library to contain two libraries.

    (3) CMS> SET LIBRARY [PROJECT.CMSLIB]/AFTER=[WORK.CMSLIB]
        %CMS-I-LIBINSLIS, library DISK$:[PROJECT.CMSLIB] inserted after
        DISKX:[WORK.CMSLIB]
        %CMS-S-LIBSET, library set

      Assuming you set your library as in example 2, this command
      directs CMS to insert the library [PROJECT.CMSLIB] after the
      library [WORK.CMSLIB]. The library list now contains the three
      libraries [WORK.CMSLIB], [PROJECT.CMSLIB], and [TEST.CMSLIB],
      in that order. Use the SHOW LIBRARY command to display the
      library search list.