1  –  LIBRARY

    Converts libraries that were created with Version 2.n of CMS for
    use with Version 3.n of CMS.

       Format:

          CONVERT LIBRARY  V2-library-directory-specification
                           V3-library-directory-specification

1.1  –  Command Parameters

 V2-library-directory-specification

    Specifies the directory specification of the existing CMS library
    you want to convert.

 V3-library-directory-specification

    Specifies the directory specification of the new CMS library you
    want to create. This directory must be empty.

1.2  –  Description

    The CONVERT LIBRARY command creates a copy of an existing CMS
    library and converts the copy for use with this version of
    CMS. Libraries created with CMS Version 3.0 do not need to be
    converted.

    To convert a library, you must first create an empty directory
    to contain the new, converted library. Conversion maintains
    everything in your existing library, including the reference
    copy directory. After the library is converted, CMS automatically
    executes the VERIFY/REPAIR command to ensure that any existing
    reference copy directory is valid and current.

    The CONVERT LIBRARY command causes an unusual occurrence to be
    logged in the history file.

1.3  –  Example

    $ CREATE/DIRECTORY [PROJECT.CMSLIB_V3]
    $ CMS
    CMS> CONVERT LIBRARY
    _V2 library: [PROJECT.CMSLIB_V2]
    _Directory for V3 library: [PROJECT.CMSLIB_V3]
    %CMS-S-CREATED, CMS Library DISKX:[PROJECT.CMSLIB_V3] created
    %CMS-I-LIBINSLIS, Library DISKX:[PROJECT.CMSLIB_
    V3] inserted into the library list
    %CMS-I-CONELE, element DATAPROG.BAS converted
    %CMS-I-CONGRP, group TESTGRP converted
    %CMS-I-CONCLS, class ETMETAL converted
    %CMS-I-CONRES, all reservations converted
    %CMS-I-CONHIS, history file converted
    %CMS-S-CONVERTED, Version 2 library converted to Version 3 format
    %CMS-I-VERCLS, class list verified
    %CMS-I-VERCMD, command list verified
    %CMS-I-VERELE, element list verified
    %CMS-I-VERGRP, group list verified
    %CMS-I-VERRES, reservation list verified
    %CMS-I-VERFRE, internal free space list verified
    %CMS-I-VERFRE, internal free space list verified
    %CMS-I-VERFRE, internal free space list verified
    %CMS-I-VERFRE, internal free space list verified
    %CMS-I-VERFRE, internal free space list verified
    %CMS-I-VERFRE, internal free space list verified
    %CMS-I-VERFRE, internal free space list verified
    %CMS-I-VERARC, archive control block verified
    %CMS-I-VER2, internal contiguous space verified
    %CMS-I-VERCON, control file verified
    %CMS-I-VEREDF, element DATAPROG.BAS verified
    %CMS-I-VEREDFS, element data files verified
    %CMS-I-REPAIRED, library [PROJECT.CMSLIB_V3] repaired

      This example first creates a new directory to contain the
      converted library, and then converts the old library.

      CMS automatically issues VERIFY/REPAIR to ensure that both
      the library and any reference copies are valid. If there are
      invalid reference copies, VERIFY/REPAIR repairs them. Even
      if you receive reference copy errors, your library is still
      converted and available for use.