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

    Copies one or more existing groups to form one or more new
    groups. If you copy a group to the same library, the new
    group must have a different name. The COPY GROUP transaction
    preserves all group attributes and inserts elements and groups
    that belong to each input group. The elements to be inserted
    into the new group must already exist in the target library.

       Format:

          COPY GROUP  old-group-expression new-group-name "remark"

1 - Command Parameters

 old-group-expression

    Specifies one or more existing groups to be copied. If you
    specify more than one group to be copied, you must use a
    wildcard character for the new group name. An old group
    expression can be a group name, a wildcard expression, or a
    list of these separated by commas.

 new-group-name

    Specifies the name for the new group. The name cannot be the
    same as any existing group name in the target library. Wildcards
    are allowed. If you specify more than one group with COPY GROUP,
    you must use a wildcard character for the new group name.

 remark

    Specifies a character string for the creation remark of the new
    group to be logged in the history file with this command. The
    remark is enclosed in quotation marks. If no remark was entered,
    then the remark from the old group is used for the creation
    remark of the new group, but a null remark ("") is logged in
    the history file.

2 - Description

    The COPY GROUP command uses an existing library group to copy
    and create a new group in the same library or in another library.
    The original group is left unchanged. The group attributes are
    copied in full and an identical set of elements and groups are
    inserted into the new group. The elements to be inserted into
    the new group must already exist in the target library.

    CMS must be able to create one new group for each old group.
    When you use wildcards, or a comma list in the input group
    specification you must specify a wildcard ("*") as the output
    group specification.

3 - Qualifiers

 3.1 - /CONFIRM

    Controls whether CMS prompts you for confirmation before each
    transaction.

    When you specify /CONFIRM and run CMS in interactive mode, CMS
    prompts you for confirmation. If you type YES, ALL, TRUE, or 1,
    CMS executes the transaction.  If you type NO, QUIT, FALSE, 0,
    or press RETURN or CTRL/Z, no action is performed. If you type
    any other character, CMS continues to prompt until you type an
    acceptable response.

    CMS does not prompt for confirmation in batch mode.

 3.2 - /LIBRARY[=directory-specification]

    Identifies a valid CMS library that is the location of the group
    specified by the old-group-expression parameter. When you
    specify an alternative library, the new-group-name parameter is
    optional. If you do not specify a value for /LIBRARY, the current
    CMS library is used.

 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 - /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 GROUP
       GROUP (D)
       NOGROUP
       NONE--equivalent to GROUP

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

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

4 - Example

        CMS> COPY GROUP INIT_GROUP INITX_GROUP "experimental version"
        %CMS-S-COPIED, class DISKX:[PROJECT.CMSLIB]INIT_GROUP copied
        to INITX_GROUP

      This command creates a new group named INITX_GROUP in the same
      library as the old group.